46 lines
3.0 KiB
Markdown
46 lines
3.0 KiB
Markdown
## MODIFIED Requirements
|
||
|
||
### Requirement: 本仓库与周边系统的边界
|
||
|
||
`shanxia2.0` 仓库 SHALL 承载一体化门户（Python FastAPI + `web-admin` + `miniprogram`）及已迁入的子域业务（含 CRM、报销 bx、**地磅 db**）。CRM 代码仍在并列仓库 `shanxia/crm/`。地磅业务 SHALL 在本仓库 `backend/` 与 `web-admin/` 内实现；DDL 快照维护于 `docs/sql/shanxia2.0.sql`（`db_*` 表），`docs/sql/dibang.sql` 保留为迁移前原系统只读参考。
|
||
|
||
#### Scenario: 新人定位地磅库表（迁移后）
|
||
|
||
- **WHEN** 在 `shanxia2.0` 仓库内开发地磅、称重单、进出库等业务
|
||
- **THEN** 查阅与变更 DDL SHALL 使用 `docs/sql/shanxia2.0.sql` 中 `db_*` 表，ORM 与 database-conventions 一致
|
||
|
||
#### Scenario: 新人定位地磅代码（迁移后）
|
||
|
||
- **WHEN** 任务描述涉及地磅、称重单、计划、出入库或 `db_*` 表
|
||
- **THEN** Agent SHALL 在 `shanxia2.0/backend/app/api/db/` 与 `shanxia2.0/web-admin/src/views/db/` 查找与修改代码
|
||
|
||
#### Scenario: 跨系统需求评审
|
||
|
||
- **WHEN** 需求同时涉及门户与 CRM
|
||
- **THEN** 设计说明 SHALL 分别标明 SQL 快照与代码路径；地磅与 CRM 通过 API 读主数据，不混改 CRM DDL
|
||
|
||
### Requirement: 多系统 SQL 模型权威文件索引
|
||
|
||
山峡相关产品线 SHALL 将下列 `docs/sql/` 导出文件视为各系统数据库模型的**权威 DDL 快照**（Navicat 导出，MySQL 5.7）；实现或评审时 SHALL 以对应文件为准，不得与 `shanxia2.0` 本仓库后端模型混用。
|
||
|
||
| 系统 | SQL 快照路径 | 典型库名（导出元数据） | 表命名特征 | 对应工程 |
|
||
|------|----------------|------------------------|------------|----------|
|
||
| 地磅系统（迁移前参考） | `docs/sql/dibang.sql` | `dibang-test` | `cargos`、`companies`、`weighing_slips`、`inbound_outbound` 等 | 原 `simple-dibang-xiaoshou`（只读参考） |
|
||
| 山峡一体化门户 | `docs/sql/shanxia2.0.sql` | `shanxia2.0` | `sys_*`、`crm_*`、`bx_*`、**`db_*`**；公共字段含 `tenant_no`、`del_flag` | 本仓库 `backend/` + `web-admin/` + `miniprogram/` |
|
||
| 山峡 CRM 系统 | `docs/sql/sx.sql` | `sx` | `crm_*`（线索/客户/商机/合同/回款等） | 独立仓库 `shanxia/crm/` |
|
||
|
||
#### Scenario: 新人定位门户库表
|
||
|
||
- **WHEN** 在 `shanxia2.0` 仓库内开发细胞存储、系统管理、工作流、地磅等门户能力
|
||
- **THEN** 查阅与变更 DDL SHALL 使用 `docs/sql/shanxia2.0.sql`，且 ORM/迁移与 `database-conventions` 公共字段约定一致
|
||
|
||
#### Scenario: 新人定位 CRM 库表
|
||
|
||
- **WHEN** 开发线索、客户、合同、回款等 CRM 业务
|
||
- **THEN** 查阅 DDL SHALL 使用 `docs/sql/sx.sql`，代码变更 SHALL 在 `shanxia` 仓库的 `crm/` 工程内进行，而非 `shanxia2.0/backend/`
|
||
|
||
#### Scenario: 新人定位地磅原库（历史参考）
|
||
|
||
- **WHEN** 需要对照迁移前地磅表结构或历史数据格式
|
||
- **THEN** 查阅 `docs/sql/dibang.sql`，且 SHALL NOT 将其中表结构直接当作门户库现行标准
|