wuzilong/shanxia2.0: shanxia2.0

ADDED Requirements

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` 等	独立系统（非本仓库 `backend/`）
山峡一体化门户	`docs/sql/shanxia2.0.sql`	`shanxia2.0`	`sys_`、`biz_`、`wf_*`；公共字段含 `tenant_no`、`del_flag`	本仓库 `backend/` + `web-admin/` + `miniprogram/`
山峡 CRM 系统	`docs/sql/sx.sql`	`sx`	`crm_`（线索/客户/商机/合同/回款等）；同库可含 `bx_` 报销子域表	独立仓库 `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 查阅 DDL SHALL 使用 docs/sql/dibang.sql，且 SHALL NOT 假定表结构与本仓库 shanxia2.0.sql 相同

Requirement: 山峡 CRM 工程路径与栈

山峡 CRM 系统 SHALL 视为与 shanxia2.0 分离的 Git 仓库与部署单元；默认工作区路径为同级目录 shanxia/crm/（相对 monorepo 工作区根：与 shanxia2.0 并列的 shanxia 仓库）。

层级	路径（相对 `shanxia` 仓库根）	技术栈
后端	`crm/backend/`	Java 17、Spring Boot 3.4、RuoYi-Vue-Plus、MyBatis-Plus、Sa-Token
Web 管理端	`crm/web/`	Vue 3、TypeScript、Element Plus、Vite

Scenario: Agent 选择正确后端入口

WHEN 任务描述涉及 CRM、线索、客户、合同、回款或 crm_* 表
THEN Agent SHALL 在 shanxia/crm/backend/ 下查找与修改 Java 代码，API 前缀与 RuoYi 约定（如 /prod-api）以该工程为准

Scenario: Agent 选择正确前端入口

WHEN 任务描述涉及 CRM 管理端页面或 crm/web 路由
THEN Agent SHALL 在 shanxia/crm/web/ 下查找与修改 Vue 代码，UI 规范以该仓库 .cursorrules / AGENTS.md 为准（非 shanxia2.0 Fresh Mint 规范）

Requirement: 本仓库与周边系统的边界

shanxia2.0 仓库 SHALL 仅承载一体化门户（Python FastAPI + web-admin + miniprogram）；CRM 与地磅 SHALL NOT 默认在本仓库 backend/ 或 web-admin/ 内实现，除非 OpenSpec 功能变更明确声明集成或迁移。

Scenario: 跨系统需求评审

WHEN 需求同时涉及门户与 CRM 或地磅
THEN 设计说明 SHALL 分别标明所影响的 SQL 快照路径与代码仓库路径，并避免单一 PR 无说明地混改多库 DDL

spec.md 3.4 KB Permalink History Raw