shanxia2.0/openspec/changes/dibang-migration/specs/ecosystem-landscape/spec.md

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 将其中表结构直接当作门户库现行标准