# CRM 模块迁移设计文档 > **日期**: 2026-05-30 > **状态**: 待审核 > **决策**: 方案 A+C — 统一规范重建 + 渐进式分迭代交付 --- ## 1. 背景与目标 ### 1.1 背景 山峡化工现有两套独立系统: - **一体化门户** (`shanxia2.0`): Python FastAPI + Vue 3,覆盖系统管理、细胞存储、工作流等 - **CRM 系统** (`shanxia/crm`): Java Spring Boot (若依框架) + Vue 3,覆盖线索/客户/商机/合同等 目标:将 CRM 核心业务模块**迁移至一体化门户**,统一技术栈和运行时。 ### 1.2 迁移范围 **迁移的模块**(8 个业务域,~28 张表): | 模块 | CRM 表 | 页面数 | 优先级 | |------|--------|--------|--------| | 产品分类 | `crm_product_category` | 1 | P0 | | 产品管理 | `crm_product`, `crm_product_price`, `crm_product_price_history`, `crm_product_stock_log`, `crm_product_tag`, `crm_product_tag_relation`(附件复用 `biz_attachment`) | 6 | P0 | | 客户管理 | `crm_customer`, `crm_customer_follow`, `crm_customer_pool`, `crm_customer_pool_rule`, `crm_customer_tag`, `crm_customer_tag_relation` | 12 | P1 | | 联系人 | `crm_contact` | 4 | P1 | | 线索管理 | `crm_clue`, `crm_clue_follow` | 9 | P2 | | 商机管理 | `crm_opportunity`, `crm_opportunity_follow`, `crm_opportunity_product`, `crm_opportunity_stage_log` | 8 | P2 | | 报价管理 | `crm_quote`, `crm_quote_product`, `crm_quote_approval`, `crm_quote_share_log` | 7 | P3 | | 合同管理 | `crm_contract`, `crm_contract_product`, `crm_contract_product_price_tier`, `crm_contract_approval`, `crm_contract_change`, `crm_contract_template` | 12 | P3 | **不迁移**:报销子系统 (bx_*)、拜访管理、发票管理、回款管理、智慧校园 (xg_*) ### 1.3 交付节奏(4 个迭代) ``` 迭代 1(基础层): 产品分类 + 产品管理 + 字典数据迁移 SQL 迭代 2(核心客户): 客户管理 + 联系人 + 标签 + 公海池 迭代 3(销售漏斗): 线索管理 + 商机管理 迭代 4(成交闭环): 报价管理 + 合同管理(含工作流审批对接) ``` --- ## 2. 设计决策 | 决策点 | 结论 | 理由 | |--------|------|------| | 主键策略 | `VARCHAR(64)`,数据迁移 **原样保留源 id** | 见 `docs/data-migration/05-id-preservation-policy.md` | | 租户字段 | 统一 `tenant_no VARCHAR(64)` | 与一体化 sys_* 表一致 | | 用户/部门引用 | `VARCHAR(64)` 指向 sys_user/sys_dept | 复用一体化用户体系 | | 附件策略 | 新建 `sys_oss`(基于 CRM `sys_oss` 结构,id→`str(oss_id)` + 加 `tenant_no` + `biz_type`/`biz_id`),全系统共用 | 与 CRM 源表同名同字段,方便迁移;报销/地磅等也复用 | | 字典策略 | 复用一体化 `sys_dict_data`/`sys_dict_type`,CRM 字典数据迁移 SQL 插入 | 字典功能相同,避免两套字典割裂 | | 工作流 | 复用 `wf_*` 引擎 | 合同审批、报价审批走统一工作流 | | 字典数据 | 编写迁移 SQL 脚本导入 `sys_dict_data` | CRM 使用的行业/来源/等级等字典需导入 | | 前端 UI | 按 Fresh Mint 规范重写,参考现有模板页 | 与一体化 UI 一致 | | 软删除 | `del_flag SMALLINT DEFAULT 0` | 与一体化一致 | | 排序字段 | `order_num INTEGER` | 与一体化一致(列表/弹窗默认不展示) | --- ## 3. 公共字段规范(shanxia2.0 标准) 每张 CRM 业务表 **SHALL** 在业务字段之后包含以下公共字段: ```sql `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记:0-正常 1-已删除', ``` **主键**:`id VARCHAR(64) NOT NULL`;生产数据迁移时写入 `str(源id)`(见 05-id-preservation-policy)。 --- ## 4. 表结构设计(按迭代) ### 4.1 迭代 1 — 产品分类 + 产品管理 > **已排除功能(用户确认)**:产品定价(crm_product_price)、价格历史(crm_product_price_history)、库存日志(crm_product_stock_log)、产品标签(crm_product_tag + crm_product_tag_relation)、复制产品 — 原因:用户确认无此业务需求。 #### crm_product_category(产品分类,树形) ```sql CREATE TABLE `crm_product_category` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `parent_id` VARCHAR(64) NOT NULL DEFAULT '0' COMMENT '父级分类ID(0为顶级)', `category_name` VARCHAR(128) NOT NULL COMMENT '分类名称', `category_code` VARCHAR(64) DEFAULT NULL COMMENT '分类编码', `level` TINYINT NOT NULL DEFAULT 1 COMMENT '层级', `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '状态 1启用 0停用', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_parent_id` (`parent_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-产品分类'; ``` #### crm_product(产品主表) ```sql CREATE TABLE `crm_product` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `product_no` VARCHAR(50) NOT NULL COMMENT '产品编号', `product_name` VARCHAR(200) NOT NULL COMMENT '产品名称', `category_id` VARCHAR(64) DEFAULT NULL COMMENT '分类ID', `category_name` VARCHAR(100) DEFAULT NULL COMMENT '分类名称(冗余)', `model` VARCHAR(100) DEFAULT NULL COMMENT '规格型号', `unit` VARCHAR(20) NOT NULL DEFAULT '件' COMMENT '单位', `price` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT '标准单价', `cost_price` DECIMAL(15,2) DEFAULT 0.00 COMMENT '成本价', `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '状态 1上架 0下架', `description` TEXT DEFAULT NULL COMMENT '产品描述', `package_spec` VARCHAR(200) DEFAULT NULL COMMENT '包装规格', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), UNIQUE KEY `uk_product_no` (`product_no`, `del_flag`), KEY `idx_category_id` (`category_id`), KEY `idx_status` (`status`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-产品主表'; ``` #### crm_product_price(产品定价) ```sql CREATE TABLE `crm_product_price` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `product_id` VARCHAR(64) NOT NULL COMMENT '产品ID', `price_type` VARCHAR(20) NOT NULL DEFAULT 'standard' COMMENT '价格类型 standard-标准价 wholesale-批发价 retail-零售价', `price` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT '价格', `min_quantity` DECIMAL(20,4) DEFAULT 1.0000 COMMENT '最低起订量', `effective_date` DATE DEFAULT NULL COMMENT '生效日期', `expiry_date` DATE DEFAULT NULL COMMENT '失效日期', `status` CHAR(1) NOT NULL DEFAULT '1' COMMENT '状态 1有效 0无效', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_product_id` (`product_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-产品定价'; ``` #### crm_product_price_history(价格变更历史) ```sql CREATE TABLE `crm_product_price_history` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `product_id` VARCHAR(64) NOT NULL COMMENT '产品ID', `old_price` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT '变更前价格', `new_price` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT '变更后价格', `change_reason` VARCHAR(500) DEFAULT NULL COMMENT '变更原因', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_product_id` (`product_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-产品价格历史'; ``` #### crm_product_stock_log(库存变动日志) ```sql CREATE TABLE `crm_product_stock_log` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `product_id` VARCHAR(64) NOT NULL COMMENT '产品ID', `change_type` VARCHAR(20) NOT NULL COMMENT '变动类型 in-入库 out-出库 adjust-调整', `quantity` DECIMAL(20,4) NOT NULL DEFAULT 0.0000 COMMENT '变动数量', `before_qty` DECIMAL(20,4) NOT NULL DEFAULT 0.0000 COMMENT '变动前库存', `after_qty` DECIMAL(20,4) NOT NULL DEFAULT 0.0000 COMMENT '变动后库存', `biz_type` VARCHAR(32) DEFAULT NULL COMMENT '关联业务类型 contract-合同 deliver-发货', `biz_id` VARCHAR(64) DEFAULT NULL COMMENT '关联业务ID', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_product_id` (`product_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-产品库存日志'; ``` #### crm_product_tag(产品标签) ```sql CREATE TABLE `crm_product_tag` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `tag_name` VARCHAR(64) NOT NULL COMMENT '标签名称', `color` VARCHAR(20) DEFAULT NULL COMMENT '标签颜色', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-产品标签'; ``` #### crm_product_tag_relation(产品-标签关联) ```sql CREATE TABLE `crm_product_tag_relation` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `product_id` VARCHAR(64) NOT NULL COMMENT '产品ID', `tag_id` VARCHAR(64) NOT NULL COMMENT '标签ID', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), UNIQUE KEY `uk_product_tag` (`product_id`, `tag_id`), KEY `idx_tag_id` (`tag_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-产品标签关联'; ``` > **注意**:`crm_product_attachment` 不再建独立表。产品附件统一使用 `sys_oss`,`biz_type = 'crm_product'`,`biz_id = 产品ID`。 --- #### sys_oss(统一附件表,基于 CRM sys_oss 结构,全系统共用) > 采用 CRM 系统 `sys_oss` 的字段模型,仅将 `oss_id`(bigint)改为 `id`(`str(oss_id)`),新增 `tenant_no`,新增 `biz_type`/`biz_id` 关联字段。 > 此表为 CRM、报销、地磅等所有子系统的**统一附件存储**,通过 `biz_type` 区分业务归属。 > 方便后续从 CRM 直接迁移 sys_oss 数据(字段名完全一致,仅 id 类型转换)。 ```sql CREATE TABLE `sys_oss` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID(原 CRM sys_oss.oss_id)', `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号(原 CRM sys_oss.tenant_id)', `biz_type` VARCHAR(50) DEFAULT NULL COMMENT '业务类型(crm_product/crm_customer/crm_contract/bx_advance/bx_reimburse/dibang_weigh 等)', `biz_id` VARCHAR(64) DEFAULT NULL COMMENT '业务主键ID', `file_name` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '文件名(原 sys_oss.file_name)', `original_name` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '原始文件名(原 sys_oss.original_name)', `file_suffix` VARCHAR(10) NOT NULL DEFAULT '' COMMENT '文件后缀名(原 sys_oss.file_suffix)', `url` VARCHAR(500) NOT NULL COMMENT '文件URL地址(原 sys_oss.url)', `file_size` BIGINT DEFAULT NULL COMMENT '文件大小(字节)', `file_type` VARCHAR(200) DEFAULT NULL COMMENT 'MIME类型', `attach_type` VARCHAR(32) DEFAULT 'attachment' COMMENT '附件类型 attachment-普通附件 invoice-发票 image-图片 issue_proof-发放截图', `sort_order` INT NOT NULL DEFAULT 0 COMMENT '排序号', `service` VARCHAR(20) NOT NULL DEFAULT 'minio' COMMENT '存储服务商(原 sys_oss.service)', `ext1` TEXT DEFAULT NULL COMMENT '扩展字段(原 sys_oss.ext1)', -- 公共字段 `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id(经 user_mapping)', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id(经 user_mapping)', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记:0-正常 1-已删除', PRIMARY KEY (`id`), KEY `idx_biz` (`biz_type`, `biz_id`), KEY `idx_tenant` (`tenant_no`, `del_flag`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='统一附件表(全系统共用,基于CRM sys_oss结构)'; ``` --- ### 4.2 迭代 2 — 客户管理 + 联系人 + 标签 + 公海池 #### crm_customer(客户主表) ```sql CREATE TABLE `crm_customer` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `customer_no` VARCHAR(50) NOT NULL COMMENT '客户编号', `customer_name` VARCHAR(200) NOT NULL COMMENT '客户名称', `short_name` VARCHAR(100) DEFAULT NULL COMMENT '客户简称', `customer_type` VARCHAR(20) NOT NULL DEFAULT 'company' COMMENT '客户类型 company-企业 person-个人', `mobile` VARCHAR(20) DEFAULT NULL COMMENT '手机号', `telephone` VARCHAR(30) DEFAULT NULL COMMENT '固定电话', `email` VARCHAR(100) DEFAULT NULL COMMENT '邮箱', `website` VARCHAR(500) DEFAULT NULL COMMENT '客户网站', `level` VARCHAR(20) NOT NULL DEFAULT 'normal' COMMENT '客户级别 key-重点 normal-普通 potential-潜在', `source` VARCHAR(20) DEFAULT NULL COMMENT '客户来源', `industry` VARCHAR(50) DEFAULT NULL COMMENT '所属行业', `park_area` VARCHAR(100) DEFAULT NULL COMMENT '所在园区', `payment_terms` VARCHAR(500) DEFAULT NULL COMMENT '收付款条件', `scale` VARCHAR(20) DEFAULT NULL COMMENT '企业规模', `province` VARCHAR(50) DEFAULT NULL COMMENT '省', `city` VARCHAR(50) DEFAULT NULL COMMENT '市', `district` VARCHAR(50) DEFAULT NULL COMMENT '区', `address` VARCHAR(255) DEFAULT NULL COMMENT '详细地址', `status` VARCHAR(20) NOT NULL DEFAULT 'normal' COMMENT '客户状态 normal-正常 pool-公海 invalid-无效', `deal_status` VARCHAR(20) NOT NULL DEFAULT 'not_deal' COMMENT '成交状态 not_deal-未成交 dealed-已成交 lost-已流失', `owner_user_id` VARCHAR(64) DEFAULT NULL COMMENT '负责人ID', `owner_user_name` VARCHAR(50) DEFAULT NULL COMMENT '负责人姓名(冗余)', `last_time` DATETIME DEFAULT NULL COMMENT '最后跟进时间', `next_time` DATETIME DEFAULT NULL COMMENT '下次联系时间', `follow_count` INT NOT NULL DEFAULT 0 COMMENT '跟进次数', `deal_time` DATETIME DEFAULT NULL COMMENT '成交时间', `deal_amount` DECIMAL(15,2) DEFAULT 0.00 COMMENT '累计成交金额', `contact_count` INT NOT NULL DEFAULT 0 COMMENT '联系人数量', `opportunity_count` INT NOT NULL DEFAULT 0 COMMENT '商机数量', `contract_count` INT NOT NULL DEFAULT 0 COMMENT '合同数量', `into_pool_time` DATETIME DEFAULT NULL COMMENT '进入公海时间', `into_pool_by` VARCHAR(64) DEFAULT NULL COMMENT '进入公海操作人ID', `into_pool_reason` VARCHAR(500) DEFAULT NULL COMMENT '进入公海原因', `claim_time` DATETIME DEFAULT NULL COMMENT '领取时间', `assign_time` DATETIME DEFAULT NULL COMMENT '分配时间', `assign_by` VARCHAR(64) DEFAULT NULL COMMENT '分配人ID', `protect_time` DATETIME DEFAULT NULL COMMENT '保护到期时间', `clue_id` VARCHAR(64) DEFAULT NULL COMMENT '关联线索ID', `business_license_images` VARCHAR(1000) DEFAULT NULL COMMENT '营业执照图片(逗号分隔附件ID)', `business_permit_images` VARCHAR(1000) DEFAULT NULL COMMENT '经营许可证图片(逗号分隔附件ID)', `other_cert_images` VARCHAR(1000) DEFAULT NULL COMMENT '其他证件图片(逗号分隔附件ID)', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), UNIQUE KEY `uk_customer_no` (`customer_no`, `del_flag`), KEY `idx_owner` (`owner_user_id`), KEY `idx_status` (`status`), KEY `idx_deal_status` (`deal_status`), KEY `idx_level` (`level`), KEY `idx_source` (`source`), KEY `idx_clue` (`clue_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-客户主表'; ``` #### crm_customer_follow(客户跟进记录) ```sql CREATE TABLE `crm_customer_follow` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID', `customer_name` VARCHAR(200) DEFAULT NULL COMMENT '客户名称(冗余)', `contact_id` VARCHAR(64) DEFAULT NULL COMMENT '联系人ID', `contact_name` VARCHAR(100) DEFAULT NULL COMMENT '联系人姓名(冗余)', `follow_type` VARCHAR(20) NOT NULL COMMENT '跟进方式 电话/微信/邮件/拜访/其他', `follow_content` TEXT NOT NULL COMMENT '跟进内容', `next_time` DATETIME DEFAULT NULL COMMENT '下次联系时间', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id(跟进人)', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '跟进时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_customer_id` (`customer_id`), KEY `idx_create_time` (`create_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-客户跟进记录'; ``` #### crm_customer_pool(公海池操作记录) ```sql CREATE TABLE `crm_customer_pool` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID', `customer_name` VARCHAR(200) DEFAULT NULL COMMENT '客户名称(冗余)', `operation_type` VARCHAR(20) NOT NULL COMMENT '操作类型 into-进入公海 claim-领取 assign-分配 recycle-回收', `from_user_id` VARCHAR(64) DEFAULT NULL COMMENT '原负责人ID', `from_user_name` VARCHAR(50) DEFAULT NULL COMMENT '原负责人姓名(冗余)', `to_user_id` VARCHAR(64) DEFAULT NULL COMMENT '新负责人ID', `to_user_name` VARCHAR(50) DEFAULT NULL COMMENT '新负责人姓名(冗余)', `reason` VARCHAR(500) DEFAULT NULL COMMENT '操作原因', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '操作时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_customer_id` (`customer_id`), KEY `idx_operation_type` (`operation_type`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-公海池操作记录'; ``` #### crm_customer_pool_rule(公海池规则) ```sql CREATE TABLE `crm_customer_pool_rule` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `pool_name` VARCHAR(100) NOT NULL COMMENT '规则名称', `rule_type` VARCHAR(20) NOT NULL COMMENT '规则类型 no_follow-未跟进 no_deal-未成交', `timeout_days` INT NOT NULL COMMENT '超时天数', `protect_days` INT NOT NULL DEFAULT 0 COMMENT '保护期天数', `status` VARCHAR(20) NOT NULL DEFAULT 'enable' COMMENT '状态 enable-启用 disable-禁用', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-公海池规则'; ``` #### crm_customer_tag(客户标签) ```sql CREATE TABLE `crm_customer_tag` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `tag_name` VARCHAR(64) NOT NULL COMMENT '标签名称', `color` VARCHAR(20) DEFAULT NULL COMMENT '标签颜色', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-客户标签'; ``` #### crm_customer_tag_relation(客户-标签关联) ```sql CREATE TABLE `crm_customer_tag_relation` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID', `tag_id` VARCHAR(64) NOT NULL COMMENT '标签ID', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), UNIQUE KEY `uk_customer_tag` (`customer_id`, `tag_id`), KEY `idx_tag_id` (`tag_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-客户标签关联'; ``` #### crm_contact(联系人) ```sql CREATE TABLE `crm_contact` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID', `customer_name` VARCHAR(200) DEFAULT NULL COMMENT '客户名称(冗余)', `contact_name` VARCHAR(100) NOT NULL COMMENT '联系人姓名', `gender` VARCHAR(10) DEFAULT NULL COMMENT '性别 male-男 female-女', `mobile` VARCHAR(20) DEFAULT NULL COMMENT '手机号', `telephone` VARCHAR(30) DEFAULT NULL COMMENT '固定电话', `email` VARCHAR(100) DEFAULT NULL COMMENT '邮箱', `wechat` VARCHAR(100) DEFAULT NULL COMMENT '微信号', `qq` VARCHAR(20) DEFAULT NULL COMMENT 'QQ号', `department` VARCHAR(100) DEFAULT NULL COMMENT '部门', `position` VARCHAR(50) DEFAULT NULL COMMENT '职位', `role` VARCHAR(20) DEFAULT NULL COMMENT '角色 decision-决策人 manager-管理者 user-使用者 other-其他', `birthday` DATE DEFAULT NULL COMMENT '生日', `address` VARCHAR(255) DEFAULT NULL COMMENT '住址', `is_key` TINYINT NOT NULL DEFAULT 0 COMMENT '是否关键决策人 0否 1是', `is_primary` TINYINT NOT NULL DEFAULT 0 COMMENT '是否主要联系人 0否 1是', `status` VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态 active-在职 leave-离职', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_customer_id` (`customer_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-联系人'; ``` --- ### 4.3 迭代 3 — 线索管理 + 商机管理 #### crm_clue(线索主表) ```sql CREATE TABLE `crm_clue` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `clue_name` VARCHAR(100) NOT NULL COMMENT '线索姓名', `mobile` VARCHAR(20) NOT NULL COMMENT '手机号', `company` VARCHAR(200) DEFAULT NULL COMMENT '公司名称', `customer_type` VARCHAR(20) DEFAULT NULL COMMENT '客户类型 company-企业 person-个人', `telephone` VARCHAR(30) DEFAULT NULL COMMENT '固定电话', `email` VARCHAR(100) DEFAULT NULL COMMENT '邮箱', `title` VARCHAR(10) DEFAULT NULL COMMENT '称呼 先生/女士/其他', `position` VARCHAR(50) DEFAULT NULL COMMENT '职位', `source` VARCHAR(20) NOT NULL COMMENT '线索来源', `level` VARCHAR(10) NOT NULL DEFAULT 'unrated' COMMENT '线索等级 A/B/C/unrated', `industry` VARCHAR(50) DEFAULT NULL COMMENT '所属行业', `park_area` VARCHAR(100) DEFAULT NULL COMMENT '所在园区', `province` VARCHAR(50) DEFAULT NULL COMMENT '省', `city` VARCHAR(50) DEFAULT NULL COMMENT '市', `district` VARCHAR(50) DEFAULT NULL COMMENT '区', `address` VARCHAR(255) DEFAULT NULL COMMENT '详细地址', `website` VARCHAR(500) DEFAULT NULL COMMENT '客户网站', `intent_products` VARCHAR(500) DEFAULT NULL COMMENT '意向产品(逗号分隔)', `expect_time` DATE DEFAULT NULL COMMENT '预计购买时间', `budget` VARCHAR(20) DEFAULT NULL COMMENT '预算范围', `requirement` TEXT DEFAULT NULL COMMENT '需求描述', `status` VARCHAR(20) NOT NULL DEFAULT 'new' COMMENT '线索状态 new-新线索 follow-跟进中 invalid-无效 converted-已转化', `owner_user_id` VARCHAR(64) DEFAULT NULL COMMENT '负责人ID', `owner_user_name` VARCHAR(50) DEFAULT NULL COMMENT '负责人姓名(冗余)', `last_time` DATETIME DEFAULT NULL COMMENT '最后跟进时间', `next_time` DATETIME DEFAULT NULL COMMENT '下次联系时间', `follow_count` INT NOT NULL DEFAULT 0 COMMENT '跟进次数', `is_converted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已转化 0否 1是', `converted_time` DATETIME DEFAULT NULL COMMENT '转化时间', `customer_id` VARCHAR(64) DEFAULT NULL COMMENT '转化的客户ID', `converted_by` VARCHAR(64) DEFAULT NULL COMMENT '转化操作人', `assign_time` DATETIME DEFAULT NULL COMMENT '分配时间', `assign_by` VARCHAR(64) DEFAULT NULL COMMENT '分配人', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_mobile` (`mobile`), KEY `idx_owner` (`owner_user_id`), KEY `idx_status` (`status`), KEY `idx_level` (`level`), KEY `idx_source` (`source`), KEY `idx_customer` (`customer_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-线索主表'; ``` #### crm_clue_follow(线索跟进记录) 结构与 `crm_customer_follow` 类似,关联 `clue_id` 而非 `customer_id`。省略重复 SQL,实现时参照 crm_customer_follow 创建。 #### crm_opportunity(商机主表) ```sql CREATE TABLE `crm_opportunity` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `opportunity_name` VARCHAR(200) NOT NULL COMMENT '商机名称', `customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID', `customer_name` VARCHAR(200) DEFAULT NULL COMMENT '客户名称(冗余)', `contact_id` VARCHAR(64) DEFAULT NULL COMMENT '联系人ID', `contact_name` VARCHAR(100) DEFAULT NULL COMMENT '联系人姓名(冗余)', `amount` DECIMAL(15,2) DEFAULT 0.00 COMMENT '预计金额', `stage` VARCHAR(20) NOT NULL DEFAULT 'initial' COMMENT '商机阶段 initial-初步接洽/qualify-需求确认/proposal-方案报价/negotiation-商务谈判/won-赢单/lost-输单', `probability` INT NOT NULL DEFAULT 0 COMMENT '成交概率(%)', `expected_date` DATE DEFAULT NULL COMMENT '预计成交日期', `source` VARCHAR(20) DEFAULT NULL COMMENT '商机来源', `status` VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态 active-进行中 won-已赢 lost-已输', `owner_user_id` VARCHAR(64) DEFAULT NULL COMMENT '负责人ID', `owner_user_name` VARCHAR(50) DEFAULT NULL COMMENT '负责人姓名(冗余)', `last_time` DATETIME DEFAULT NULL COMMENT '最后跟进时间', `next_time` DATETIME DEFAULT NULL COMMENT '下次联系时间', `follow_count` INT NOT NULL DEFAULT 0 COMMENT '跟进次数', `clue_id` VARCHAR(64) DEFAULT NULL COMMENT '关联线索ID', `lose_reason` VARCHAR(500) DEFAULT NULL COMMENT '输单原因', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), KEY `idx_customer_id` (`customer_id`), KEY `idx_owner` (`owner_user_id`), KEY `idx_stage` (`stage`), KEY `idx_status` (`status`), KEY `idx_clue` (`clue_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-商机主表'; ``` #### crm_opportunity_follow / crm_opportunity_product / crm_opportunity_stage_log 结构与 `crm_customer_follow` 类似,分别关联 `opportunity_id`。实现时参照创建。 --- ### 4.4 迭代 4 — 报价管理 + 合同管理 #### crm_quote(报价单) ```sql CREATE TABLE `crm_quote` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `quote_no` VARCHAR(50) NOT NULL COMMENT '报价单号', `quote_name` VARCHAR(200) NOT NULL COMMENT '报价名称', `customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID', `customer_name` VARCHAR(200) DEFAULT NULL COMMENT '客户名称(冗余)', `opportunity_id` VARCHAR(64) DEFAULT NULL COMMENT '商机ID', `contact_id` VARCHAR(64) DEFAULT NULL COMMENT '联系人ID', `contact_name` VARCHAR(100) DEFAULT NULL COMMENT '联系人姓名(冗余)', `amount` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT '报价金额', `discount_amount` DECIMAL(15,2) DEFAULT 0.00 COMMENT '优惠金额', `final_amount` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT '最终金额', `status` VARCHAR(20) NOT NULL DEFAULT 'draft' COMMENT '状态 draft-草稿 pending-待审批 approved-已通过 rejected-已驳回', `valid_until` DATE DEFAULT NULL COMMENT '报价有效期', `wf_instance_id` VARCHAR(64) DEFAULT NULL COMMENT '工作流实例ID', `owner_user_id` VARCHAR(64) DEFAULT NULL COMMENT '负责人ID', `owner_user_name` VARCHAR(50) DEFAULT NULL COMMENT '负责人姓名(冗余)', `contract_id` VARCHAR(64) DEFAULT NULL COMMENT '转化的合同ID', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), UNIQUE KEY `uk_quote_no` (`quote_no`, `del_flag`), KEY `idx_customer_id` (`customer_id`), KEY `idx_opportunity_id` (`opportunity_id`), KEY `idx_status` (`status`), KEY `idx_owner` (`owner_user_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-报价单'; ``` #### crm_quote_product / crm_quote_approval / crm_quote_share_log 参照 CRM 原始表结构,外键类型改为 `VARCHAR(64)`。实现时参照创建。 #### crm_contract(合同主表) ```sql CREATE TABLE `crm_contract` ( `id` VARCHAR(64) NOT NULL COMMENT '主键ID', `contract_no` VARCHAR(50) NOT NULL COMMENT '合同编号', `contract_name` VARCHAR(200) NOT NULL COMMENT '合同名称', `customer_id` VARCHAR(64) NOT NULL COMMENT '客户ID', `customer_name` VARCHAR(200) DEFAULT NULL COMMENT '客户名称(冗余)', `opportunity_id` VARCHAR(64) DEFAULT NULL COMMENT '商机ID', `quote_id` VARCHAR(64) DEFAULT NULL COMMENT '报价单ID', `parent_contract_id` VARCHAR(64) DEFAULT NULL COMMENT '原合同ID(续签)', `renewal_count` INT NOT NULL DEFAULT 0 COMMENT '续签次数', `template_id` VARCHAR(64) DEFAULT NULL COMMENT '合同模板ID', `contract_template` VARCHAR(50) NOT NULL DEFAULT 'shanxia' COMMENT '合同模版 shanxia-山峡 customer-客户', `contact_id` VARCHAR(64) DEFAULT NULL COMMENT '联系人ID', `contact_name` VARCHAR(50) DEFAULT NULL COMMENT '联系人姓名(冗余)', `contact_mobile` VARCHAR(20) DEFAULT NULL COMMENT '联系人手机(冗余)', `contract_type` VARCHAR(20) NOT NULL DEFAULT 'sale' COMMENT '合同类型 sale-销售 service-服务 lease-租赁 other-其他', `contract_nature` VARCHAR(20) NOT NULL DEFAULT 'new' COMMENT '合同性质 new-新签 renewal-续签 change-变更', `amount` DECIMAL(15,2) NOT NULL DEFAULT 0.00 COMMENT '合同金额', `currency` VARCHAR(10) NOT NULL DEFAULT 'CNY' COMMENT '币种', `tax_rate` DECIMAL(5,2) DEFAULT 6.00 COMMENT '税率(%)', `amount_with_tax` DECIMAL(15,2) DEFAULT 0.00 COMMENT '含税金额', `sign_date` DATE DEFAULT NULL COMMENT '签订日期', `actual_sign_date` DATE DEFAULT NULL COMMENT '实际签订日期', `start_date` DATE DEFAULT NULL COMMENT '开始日期', `end_date` DATE DEFAULT NULL COMMENT '结束日期', `contract_period` INT DEFAULT NULL COMMENT '合同期限(月)', `status` VARCHAR(20) NOT NULL DEFAULT 'draft' COMMENT '合同状态 draft-草稿 approving-审批中 approved-已审批 executing-执行中 finished-已完成 invalid-已作废', `performance_status` VARCHAR(20) NOT NULL DEFAULT 'normal' COMMENT '履约状态 normal-正常 delayed-延期 abnormal-异常 completed-已完成', `performance_rate` DECIMAL(5,2) DEFAULT 0.00 COMMENT '履约完成度(%)', `approval_status` VARCHAR(20) DEFAULT NULL COMMENT '审批状态 pending-待审批 approved-已通过 rejected-已驳回', `wf_instance_id` VARCHAR(64) DEFAULT NULL COMMENT '工作流实例ID', `contract_file` VARCHAR(500) DEFAULT NULL COMMENT '合同文件路径', `attachment_files` VARCHAR(1000) DEFAULT NULL COMMENT '附件(逗号分隔附件ID)', `owner_user_id` VARCHAR(64) NOT NULL COMMENT '负责人ID', `owner_user_name` VARCHAR(50) DEFAULT NULL COMMENT '负责人姓名(冗余)', `received_amount` DECIMAL(15,2) DEFAULT 0.00 COMMENT '已回款金额', `unreceived_amount` DECIMAL(15,2) DEFAULT 0.00 COMMENT '未回款金额', `invoice_amount` DECIMAL(15,2) DEFAULT 0.00 COMMENT '已开票金额', `uninvoice_amount` DECIMAL(15,2) DEFAULT 0.00 COMMENT '未开票金额', -- 甲方信息 `party_a` VARCHAR(200) DEFAULT NULL COMMENT '甲方(客户方)', `party_a_address` VARCHAR(255) DEFAULT NULL COMMENT '甲方地址', `party_a_contact` VARCHAR(50) DEFAULT NULL COMMENT '甲方联系人', `party_a_mobile` VARCHAR(20) DEFAULT NULL COMMENT '甲方联系电话', `party_a_legal_person` VARCHAR(50) DEFAULT NULL COMMENT '甲方法定代表人', `party_a_bank` VARCHAR(100) DEFAULT NULL COMMENT '甲方开户银行', `party_a_account` VARCHAR(50) DEFAULT NULL COMMENT '甲方银行账号', -- 乙方信息 `party_b` VARCHAR(200) DEFAULT NULL COMMENT '乙方(我方)', `party_b_address` VARCHAR(255) DEFAULT NULL COMMENT '乙方地址', `party_b_contact` VARCHAR(50) DEFAULT NULL COMMENT '乙方联系人', `party_b_mobile` VARCHAR(20) DEFAULT NULL COMMENT '乙方联系电话', `party_b_legal_person` VARCHAR(100) DEFAULT NULL COMMENT '乙方法定代表人', `party_b_bank` VARCHAR(200) DEFAULT NULL COMMENT '乙方开户银行', `party_b_account` VARCHAR(100) DEFAULT NULL COMMENT '乙方银行账号', -- 条款 `payment_terms` TEXT DEFAULT NULL COMMENT '付款条款', `delivery_terms` TEXT DEFAULT NULL COMMENT '交付条款', `contract_terms` TEXT DEFAULT NULL COMMENT '合同条款', -- 其他 `supplier_id` VARCHAR(64) DEFAULT NULL COMMENT '供方主体ID', `settlement_method` VARCHAR(50) DEFAULT NULL COMMENT '结算方式 arrive_payment-货到付款 advance_payment-款到发货', `invalid_reason` VARCHAR(500) DEFAULT NULL COMMENT '作废原因', `invalid_time` DATETIME DEFAULT NULL COMMENT '作废时间', `template_content` LONGTEXT DEFAULT NULL COMMENT '合同模板内容(富文本HTML)', `settlement_clause_drafts` LONGTEXT DEFAULT NULL COMMENT '结算方式草稿(JSON)', -- 公共字段 `tenant_no` VARCHAR(64) NOT NULL DEFAULT 'zkxw' COMMENT '租户编号', `order_num` INT DEFAULT NULL COMMENT '排序号', `remark` VARCHAR(512) DEFAULT NULL COMMENT '备注', `create_by` VARCHAR(64) DEFAULT NULL COMMENT '创建人id', `create_dept_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID', `create_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_by` VARCHAR(64) DEFAULT NULL COMMENT '更新人id', `update_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `del_flag` SMALLINT NOT NULL DEFAULT 0 COMMENT '删除标记', PRIMARY KEY (`id`), UNIQUE KEY `uk_contract_no` (`contract_no`, `del_flag`), KEY `idx_customer_id` (`customer_id`), KEY `idx_opportunity_id` (`opportunity_id`), KEY `idx_quote_id` (`quote_id`), KEY `idx_owner` (`owner_user_id`), KEY `idx_status` (`status`), KEY `idx_approval_status` (`approval_status`), KEY `idx_sign_date` (`sign_date`), KEY `idx_end_date` (`end_date`), KEY `idx_parent_contract_id` (`parent_contract_id`), KEY `idx_supplier_id` (`supplier_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-合同主表'; ``` #### crm_contract_product / crm_contract_product_price_tier / crm_contract_approval / crm_contract_change / crm_contract_template 参照 CRM 原始表结构,外键类型改为 `VARCHAR(64)`,公共字段统一。实现时参照创建。 --- ## 5. 后端架构设计 ### 5.1 目录结构 ``` backend/ ├── app/ │ ├── models/ │ │ └── crm_models.py — CRM 所有 SQLAlchemy 模型(~20 个类) │ ├── schemas/ │ │ └── crm/ │ │ ├── product.py — 产品/分类 Pydantic schemas │ │ ├── customer.py — 客户/联系人 schemas │ │ ├── clue.py — 线索 schemas │ │ ├── opportunity.py — 商机 schemas │ │ ├── quote.py — 报价 schemas │ │ └── contract.py — 合同 schemas │ ├── crud/ │ │ └── crm/ │ │ ├── product.py — 产品 CRUD │ │ ├── customer.py — 客户 CRUD │ │ ├── clue.py — 线索 CRUD │ │ ├── opportunity.py — 商机 CRUD │ │ ├── quote.py — 报价 CRUD │ │ └── contract.py — 合同 CRUD │ ├── api/ │ │ └── crm.py — CRM 所有 API 路由(注册到 main.py) │ └── services/ │ └── crm/ │ ├── customer_pool.py — 公海池逻辑(定时回收等) │ └── biz_no_generator.py — 业务编号生成(客户编号、合同编号等) ``` ### 5.2 API 路由设计 ``` /api/crm/ — CRM 模块统一前缀 # 产品分类 GET /api/crm/product-categories — 列表(树形) POST /api/crm/product-categories — 新增 PUT /api/crm/product-categories/{id} — 修改 DELETE /api/crm/product-categories/{id} — 删除 # 产品管理 GET /api/crm/products — 列表(分页) GET /api/crm/products/{id} — 详情 POST /api/crm/products — 新增 PUT /api/crm/products/{id} — 修改 DELETE /api/crm/products/{id} — 删除 GET /api/crm/products/select-options — 下拉选项 # 客户管理 GET /api/crm/customers — 列表(分页) GET /api/crm/customers/{id} — 详情 POST /api/crm/customers — 新增 PUT /api/crm/customers/{id} — 修改 DELETE /api/crm/customers/{id} — 删除 POST /api/crm/customers/{id}/follow — 添加跟进 GET /api/crm/customers/{id}/follows — 跟进列表 # 公海池 GET /api/crm/customer-pool — 公海池列表 POST /api/crm/customer-pool/{id}/claim — 领取 POST /api/crm/customer-pool/assign — 分配 GET /api/crm/customer-pool/rules — 规则列表 PUT /api/crm/customer-pool/rules/{id} — 修改规则 # 联系人 GET /api/crm/contacts — 列表 POST /api/crm/contacts — 新增 PUT /api/crm/contacts/{id} — 修改 DELETE /api/crm/contacts/{id} — 删除 # 线索管理 GET /api/crm/clues — 列表(分页) GET /api/crm/clues/{id} — 详情 POST /api/crm/clues — 新增 PUT /api/crm/clues/{id} — 修改 DELETE /api/crm/clues/{id} — 删除 POST /api/crm/clues/{id}/follow — 添加跟进 POST /api/crm/clues/{id}/convert — 转化为客户 POST /api/crm/clues/{id}/invalid — 标记无效 POST /api/crm/clues/{id}/assign — 分配 # 商机管理 GET /api/crm/opportunities — 列表(分页) GET /api/crm/opportunities/{id} — 详情 POST /api/crm/opportunities — 新增 PUT /api/crm/opportunities/{id} — 修改 DELETE /api/crm/opportunities/{id} — 删除 POST /api/crm/opportunities/{id}/follow — 添加跟进 POST /api/crm/opportunities/{id}/stage — 推进阶段(赢单/输单) # 报价管理 GET /api/crm/quotes — 列表(分页) GET /api/crm/quotes/{id} — 详情 POST /api/crm/quotes — 新增 PUT /api/crm/quotes/{id} — 修改 DELETE /api/crm/quotes/{id} — 删除 POST /api/crm/quotes/{id}/submit — 提交审批 POST /api/crm/quotes/{id}/to-contract — 转合同 # 合同管理 GET /api/crm/contracts — 列表(分页) GET /api/crm/contracts/{id} — 详情 POST /api/crm/contracts — 新增 PUT /api/crm/contracts/{id} — 修改 DELETE /api/crm/contracts/{id} — 删除 POST /api/crm/contracts/{id}/submit — 提交审批 POST /api/crm/contracts/{id}/invalid — 作废 POST /api/crm/contracts/{id}/change — 变更 GET /api/crm/contracts/templates — 模板列表 GET /api/crm/contracts/templates/{id} — 模板详情 ``` ### 5.3 编码约定 - **CRUD**:继承 `CRUDBase`,遵循驼峰/蛇形自动映射 - **模型**:所有模型继承 `Base`,公共字段与一体化一致 - **路由注册**:CRM 路由注册在 `app/api/__init__.py` 和 `app/main.py` - **权限守卫**:使用 `require_admin_or_super_admin` + `require_menu_code("crm:xxx:list")` - **租户隔离**:所有查询过滤 `tenant_no == current_user.tenant_no` - **数据权限**:使用 `apply_data_scope()` 叠加角色数据权限 - **附件**:通过 `sys_oss`(统一附件表,基于 CRM `sys_oss` 结构),`biz_type` 命名规则 `crm_{entity}` - **工作流**:审批通过 `wf_instance_id` 关联 `wf_process_instance` --- ## 6. 前端架构设计 ### 6.1 目录结构 ``` web-admin/src/ ├── api/ │ └── crm/ │ ├── product.ts — 产品/分类 API │ ├── customer.ts — 客户 API │ ├── contact.ts — 联系人 API │ ├── clue.ts — 线索 API │ ├── opportunity.ts — 商机 API │ ├── quote.ts — 报价 API │ └── contract.ts — 合同 API ├── views/ │ └── crm/ │ ├── product/ │ │ ├── index.vue — 产品列表(参考 product/index.vue 模板) │ │ ├── ProductFormDialog.vue │ │ ├── ProductViewDialog.vue │ │ └── PriceDialog.vue │ ├── product-category/ │ │ └── index.vue — 产品分类(树形,参考 category/index.vue) │ ├── customer/ │ │ ├── index.vue — 客户列表 │ │ ├── CustomerFormDialog.vue │ │ ├── CustomerViewDialog.vue │ │ ├── FollowDialog.vue │ │ └── PoolPanel.vue │ ├── contact/ │ │ ├── index.vue │ │ └── ContactFormDialog.vue │ ├── clue/ │ │ ├── index.vue │ │ ├── ClueFormDialog.vue │ │ ├── ConvertDialog.vue │ │ └── FollowDialog.vue │ ├── opportunity/ │ │ ├── index.vue │ │ ├── OpportunityFormDialog.vue │ │ ├── OpportunityViewDialog.vue │ │ └── StageDialog.vue │ ├── quote/ │ │ ├── index.vue │ │ ├── QuoteFormDialog.vue │ │ └── QuoteViewDialog.vue │ └── contract/ │ ├── index.vue │ ├── ContractFormDialog.vue │ ├── ContractViewDialog.vue │ └── TemplateDialog.vue ``` ### 6.2 UI 规范 - **色彩**:Fresh Mint (`--primary #10b981`),不使用 CRM 的色板 - **表单弹窗**:`label-position="top"`,`.dialog-form-layout` + `.form-grid-2` - **表格**:`el-table-column` 用 `min-width`(不用 `width`),操作列 `fixed="right"` min-width ≥ 260px - **状态/类型字段**:使用 `` + 语义色 - **按钮图标**:所有 `el-button` 带 `` - **附件上传**:使用 `sys_oss` 统一附件表(基于 CRM `sys_oss` 接口模式),卡片化布局 - **模板页参考**: - 树形:`category/index.vue` - 标准列表:`unit/index.vue` - 复杂列表:`order/index.vue` - 产品+查看弹窗:`product/index.vue` ### 6.3 菜单注册 在 `sqxp.ts` 和 `menu.py` 中新增「CRM 管理」一级菜单: ``` CRM 管理 ├── 产品分类 ├── 产品管理 ├── 客户管理 │ (公海池作为客户列表的 tab 或筛选条件) ├── 联系人 ├── 线索管理 ├── 商机管理 ├── 报价管理 └── 合同管理 ``` --- ## 7. 数据迁移注意事项 > 本节记录数据迁移时需要特别注意的映射关系和风险点。 > 数据迁移方案将在后续单独编写。 ### 7.1 主键映射 > **修订(2026-07-12)**:生产数据同步以 `docs/data-migration/05-id-preservation-policy.md` 为准——**业务主键原样保留**(`bigint` → 同值 `VARCHAR` 字符串),不再统一生成 UUID。用户外键仍经 `user_mapping` 转换。 | CRM (bigint) | 一体化 (VARCHAR) | 说明 | |---------------|------------------|------| | `id` (AUTO_INCREMENT) | `id` (`str(id)`) | 恒等映射;`crm_id_mapping` 用于审计 | | `owner_user_id` (bigint) | `owner_user_id` (VARCHAR) | **例外**:映射到 `sys_user.id`(门户 UUID) | | `customer_id` (bigint) | `customer_id` (VARCHAR) | `str(customer_id)`;先迁客户再迁子表 | | `create_by` (bigint) | `create_by` (VARCHAR) | **例外**:映射到 `sys_user.id` | ### 7.2 租户字段 ```sql -- CRM: tenant_id (VARCHAR(20), DEFAULT '000000') -- 一体化: tenant_no (VARCHAR(64), DEFAULT 'zkxw') -- 迁移时: UPDATE SET tenant_no = 'zkxw' (或对应租户编号) ``` ### 7.3 附件迁移 ``` CRM 附件: sys_oss 表 oss_id (bigint) → 主键 url → 完整文件 URL file_name / original_name / file_suffix → 文件信息 create_by (bigint) → 上传人 service → 存储服务商(minio) 目标: sys_oss 统一附件表(与 CRM 源表同名同结构) id (VARCHAR) ← str(oss_id),原样保留 tenant_no ← tenant_id 改名 biz_type / biz_id ← 业务关联字段(需根据 CRM 中的附件关联逻辑补充) file_name / original_name / file_suffix / url ← 字段名完全一致,直接复制 create_by (VARCHAR) ← create_by (bigint) 经 user_mapping create_dept_id (VARCHAR) ← create_dept (bigint) 经 dept_mapping(若有) service ← 字段完全一致,直接复制 迁移优势: 1. 字段名完全一致(file_name/original_name/file_suffix/url/service),直接 INSERT 2. 只需 oss_id→str(oss_id)、tenant_id→tenant_no、create_by/create_dept 的用户 UUID 映射 3. 未来报销系统(bx_*)、地磅系统的附件同样写入此表,用 biz_type 区分 4. 报销迁移时 bx_attachment 的数据也可映射到此表 ``` ### 7.4 字典数据迁移 ``` CRM 字典来源: sys_dict_data (sx 库) 目标: sys_dict_data (shanxia2.0 库) 需迁移的字典类型: - crm_customer_industry (行业) - crm_customer_source (客户来源) - crm_customer_level (客户级别) - crm_clue_source (线索来源) - crm_clue_level (线索等级) - crm_opportunity_stage (商机阶段) - crm_contract_type (合同类型) - crm_contract_nature (合同性质) - crm_follow_type (跟进方式) - crm_budget_range (预算范围) - crm_payment_terms (付款条件) ... (实现时从 CRM 数据库中导出完整列表) ``` ### 7.5 部门映射 ``` CRM: create_dept (bigint) → CRM 的 sys_dept 一体化: create_dept_id (VARCHAR(64)) → sys_dept 需先确认: 1. CRM 中的部门是否与一体化 sys_dept 一致 2. 如不一致,需导入部门数据并建立映射 ``` ### 7.6 迁移顺序(依赖关系) ``` 1. 字典数据 (sys_dict_data) 2. 部门数据 (sys_dept) — 如需导入 3. 用户数据 (sys_user) — 如需导入 4. 产品分类 (crm_product_category) 5. 产品 (crm_product) 6. 产品附件 (→ biz_attachment) 7. 客户标签 (crm_customer_tag) 8. 客户 (crm_customer) 9. 联系人 (crm_contact) 10. 客户附件 (→ biz_attachment) 11. 客户跟进 (crm_customer_follow) 12. 公海池记录 (crm_customer_pool) 13. 线索 (crm_clue) 14. 线索跟进 (crm_clue_follow) 15. 商机 (crm_opportunity) 16. 商机产品/跟进/阶段日志 17. 报价单 + 产品 18. 合同 + 产品 + 审批记录 ``` --- ## 8. 定时任务 ### 8.1 公海池自动回收 在 `app/tasks/` 中实现: ``` 规则: - 未跟进超过 N 天的客户 → 自动进入公海池 - 未成交超过 N 天的客户 → 自动进入公海池 - 领取后保护 M 天内不回收 实现: - 使用 APScheduler (一体化已有依赖) - 每日定时扫描 crm_customer + crm_customer_pool_rule - 符合条件的客户: status → 'pool',写入 crm_customer_pool 记录 ``` --- ## 9. 附录 ### A. CRM 原始表 → 新表对照清单 | CRM 原始表 | 新表 | 变更说明 | |------------|------|----------| | crm_product_category | crm_product_category | 主键原样保留 str(id),公共字段统一 | | crm_product | crm_product | 主键原样保留 str(id),category_id 改 VARCHAR | | crm_product_price | crm_product_price | 主键原样保留 str(id),product_id 改 VARCHAR | | crm_product_price_history | crm_product_price_history | 主键原样保留 str(id) | | crm_product_stock_log | crm_product_stock_log | 主键原样保留 str(id) | | crm_product_tag | crm_product_tag | 主键原样保留 str(id) | | crm_product_tag_relation | crm_product_tag_relation | 主键原样保留 str(id),关联 ID 改 VARCHAR | | crm_product_attachment | **删除** → 复用 sys_oss | biz_type='crm_product' | | crm_customer | crm_customer | 主键原样保留 str(id),owner/create 用户外键经 mapping | | crm_customer_follow | crm_customer_follow | 主键原样保留 str(id) | | crm_customer_pool | crm_customer_pool | 主键原样保留 str(id) | | crm_customer_pool_rule | crm_customer_pool_rule | 主键原样保留 str(id) | | crm_customer_tag | crm_customer_tag | 主键原样保留 str(id) | | crm_customer_tag_relation | crm_customer_tag_relation | 主键原样保留 str(id) | | crm_contact | crm_contact | 主键原样保留 str(id) | | crm_clue | crm_clue | 主键原样保留 str(id) | | crm_clue_follow | crm_clue_follow | 主键原样保留 str(id) | | crm_opportunity | crm_opportunity | 主键原样保留 str(id) | | crm_opportunity_follow | crm_opportunity_follow | 主键原样保留 str(id) | | crm_opportunity_product | crm_opportunity_product | 主键原样保留 str(id) | | crm_opportunity_stage_log | crm_opportunity_stage_log | 主键原样保留 str(id) | | crm_quote | crm_quote | 主键原样保留 str(id) | | crm_quote_product | crm_quote_product | 主键原样保留 str(id) | | crm_quote_approval | crm_quote_approval | 主键原样保留 str(id) | | crm_quote_share_log | crm_quote_share_log | 主键原样保留 str(id) | | crm_contract | crm_contract | 主键原样保留 str(id) | | crm_contract_product | crm_contract_product | 主键原样保留 str(id) | | crm_contract_product_price_tier | crm_contract_product_price_tier | 主键原样保留 str(id) | | crm_contract_approval | crm_contract_approval | 主键原样保留 str(id) | | crm_contract_change | crm_contract_change | 主键原样保留 str(id) | | crm_contract_template | crm_contract_template | 主键原样保留 str(id) | ### B. 参考文件清单 | 用途 | 路径 | |------|------| | CRM DDL | `docs/sql/sx.sql` | | 一体化 DDL | `docs/sql/shanxia2.0.sql` | | CRM 后端 (Java) | `/Users/zlwu/work/00code/shanxia/crm/backend/` | | CRM 前端 (Vue) | `/Users/zlwu/work/00code/shanxia/crm/web/` | | 一体化后端模型 | `backend/app/models/models.py` | | 一体化 CRUD 基类 | `backend/app/crud/base.py` | | 一体化 API 示例 | `backend/app/api/admin.py` | | 前端模板页-标准列表 | `web-admin/src/views/system/unit/index.vue` | | 前端模板页-复杂列表 | `web-admin/src/views/system/order/index.vue` | | 前端模板页-树形 | `web-admin/src/views/system/category/index.vue` | | 前端模板页-产品 | `web-admin/src/views/system/product/index.vue` | | 工程规范 | `openspec/changes/zkxw-engineering-standards/specs/` | | UI 规范 | `docs/web-admin-ui-spec-fresh-mint.md` |