shanxia/openspec/changes/plan-management-platform/proposal.md

Why

安庆山峡化工有限公司需要一套覆盖 CRM、计划、地磅、报销的融合系统；当前缺口集中在计划管理全链路（从合同发起计划到运输、地磅、费用核对归档），并与既有 CRM、地磅系统数据与权限衔接。需求明确但跨多个子系统与技术栈，必须在实现前用可验证的里程碑与制品对齐范围，避免 SQL 模型大改带来的迁移与测试风险。

What Changes

• 新增以 Python 后端 + 工作流引擎 为主的计划域服务，业务表统一 pl_ 前缀；Web 端采用 art-design-pro 体系；移动端在 mobile-frontend（uni-app） 上迭代，风格后续统一。
• CRM 改造：计划从合同模块发起；框架合同支持调价函驱动的价格版本历史；产品主数据增加易制毒 / 易制爆标识；与计划域共享用户、角色、菜单/数据权限策略（复用 CRM 管理能力，计划侧消费或联邦鉴权待设计落地）。
• 地磅系统改造：待入库/待出库计划触发生成地磅单；计划列表可见地磅信息；现场确认后回传地磅单与出入库附件；供应商/目的地规则与需求文档一致。
• 报销系统：本次不纳入范围与接口改造。
• 业务文档与阶段总结归集到仓库内 docs/系统文档/（对应团队约定路径）。
• 数据建模参考 plan/sx.sql（若缺失则先补齐基线导出）；历史表结构尽量少改，以迁移与回归测试为导向。

Capabilities

New Capabilities

• plan-lifecycle: 计划主数据、SXDDH 编号规则、单据类别/跟进/完成状态、字段集、通知模板、从合同生成计划、多产品行、入库价默认与可改、金额与磅差规则、运输费用分支与归档（专员 B/C）。
• crm-contract-versioning: 框架合同商品价格与调价函版本历史；计划引用合同价格口径；与计划发起的衔接点。
• compliance-certificates: 产品易制毒/易制爆属性；计划行在购买证+运输证齐全前禁止进入运输安排。
• transport-dispatch: 自有车/运输公司车辆、运输编号 SXYS、二维码生成与分享、司机扫码回传运输单据与数量、待入/待出库与现场通知。
• dibang-integration: 待入库/待出库判定（供应商或目的地为安庆市山峡化工有限公司/安徽云栋化工有限公司）；地磅单自动生成与展示；附件提交流程。
• freight-settlement: 运输历史总览；多选生成运输结算单；提交审核→通知开票→票据与汇款凭证上传。
• inventory-reporting: 盘存统计分析（口径与数据源在实现阶段与 pl_ 库存模型对齐）。
• cross-system-platform: Python 工作流选型与编排、与 CRM/地磅的账号与菜单权限统一策略、非报销边界、pl_ 命名与 SQL 变更纪律、文档目录约束。

Modified Capabilities

• （仓库内尚无 openspec/specs/ 基线；CRM/地磅既有行为变更以上述 New Capabilities 的 delta 形式在本 change 的 specs 中描述，后续若建立全局 spec 再拆 delta。）

Impact

• 代码与工程：crm/web、crm/backend（及可能的 crm/py-backend）、dibang-xiaoshou/art-design-pro、dibang-xiaoshou/backend、dibang-xiaoshou/mobile-h5、新建/扩展 mobile-frontend、新建计划域 Python API + 工作流 模块（具体目录在 design.md 落定）。
• 数据：新增 pl_* 表；CRM 合同/产品相关表增量；地磅与计划关联表或视图；不要求本次大改报销 schema。
• 运维与合规：统一登录与权限的耦合点；易制毒爆相关证照与运输数据的访问控制与审计要求升高。