wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 重构并删除docs11目录，更新项目文档结构

Browse Source 
删除旧的docs11目录及其所有内容，包括：
- 业务蓝图文档(business-blueprint.md)
- 数据API规范(data-api-specs.md)
- 系统架构文档(system-architecture.md)
- 模块蓝图文档(module-blueprints.md)
- 治理标准文档(governance-standards.md)
- 质量标准文档(quality-optimization.md)
- 任务总览文档(Crawlful_Hub_Task_Overview_Full_v1.md)
- README.md等文件

同时更新了docs目录下的现有文档：
- 更新SERVICE_MAP.md强化服务层职责和调用规范
- 更新Service_Design.md明确服务层设计规范和边界
- 更新项目规则文档加入逻辑集中化原则
- 统一调整了文档表格格式和结构
This commit is contained in:
wurenzhi
2026-03-18 21:51:52 +08:00
parent 96373deb2f
commit cd55097dbf
19 changed files with 450 additions and 2050 deletions
Download Patch File Download Diff File Expand all files Collapse all files

310
docs/00_Business/Business_ClosedLoops.md
View File

@@ -1663,230 +1663,230 @@ export default function(initialState: InitialState) {
#### 数据采集与清洗闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 采集覆盖率 | 目标平台商品覆盖率 | TOC + TOB |
| 数据准确率 | 清洗后数据的准确性 | TOC + TOB |
| 套利分析准确率 | 前置套利计算的准确性 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ----------- | -------------------- | ----------- |
| 采集覆盖率 | 目标平台商品覆盖率 | TOC + TOB |
| 数据准确率 | 清洗后数据的准确性 | TOC + TOB |
| 套利分析准确率 | 前置套利计算的准确性 | TOC + TOB |
#### 商品刊登闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ----------- | --------- |
| 刊登成功率 | 成功刊登的商品比例 | TOC + TOB |
| 刊登时效 | 从准备到刊登完成的时间 | TOC + TOB |
| 平台审核通过率 | 平台审核通过的商品比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ----------- | -------------------- | ----------- |
| 刊登成功率 | 成功刊登的商品比例 | TOC + TOB |
| 刊登时效 | 从准备到刊登完成的时间 | TOC + TOB |
| 平台审核通过率 | 平台审核通过的商品比例 | TOC + TOB |
#### 素材管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 素材处理时效 | 从上传到可用的平均时间 | TOC + TOB |
| 素材审核通过率 | 通过审核的素材比例 | TOC + TOB |
| 素材转化率 | 使用素材带来的订单转化率 | TOC + TOB |
| 素材复用率 | 被多次使用的素材比例 | TOC + TOB |
| 版权合规率 | 无版权风险的素材比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ----------- | -------------------- | ----------- |
| 素材处理时效 | 从上传到可用的平均时间 | TOC + TOB |
| 素材审核通过率 | 通过审核的素材比例 | TOC + TOB |
| 素材转化率 | 使用素材带来的订单转化率 | TOC + TOB |
| 素材复用率 | 被多次使用的素材比例 | TOC + TOB |
| 版权合规率 | 无版权风险的素材比例 | TOC + TOB |
#### 广告计划与营销闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | -------------- | ------ |
| 广告 ROI | 广告投入产出比 | TOC |
| 点击率（CTR） | 广告点击次数与展示次数的比率 | TOC |
| 转化率（CVR） | 点击广告后产生订单的比例 | TOC |
| 企业营销效果 | 企业营销活动的转化率 | TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| -------------- | ------------------------ | ----------- |
| 广告 ROI | 广告投入产出比 | TOC |
| 点击率（CTR） | 广告点击次数与展示次数的比率 | TOC |
| 转化率（CVR） | 点击广告后产生订单的比例 | TOC |
| 企业营销效果 | 企业营销活动的转化率 | TOB |
#### 订单履约闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ----------- | --------- |
| 订单处理时效 | 从订单生成到发货的时间 | TOC + TOB |
| 发货准确率 | 正确发货的订单比例 | TOC + TOB |
| 妥投率 | 成功送达的订单比例 | TOC + TOB |
| 分批处理率 | 大额订单分批处理的比例 | TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| 订单处理时效 | 从订单生成到发货的时间 | TOC + TOB |
| 发货准确率 | 正确发货的订单比例 | TOC + TOB |
| 妥投率 | 成功送达的订单比例 | TOC + TOB |
| 分批处理率 | 大额订单分批处理的比例 | TOB |
#### 售后逆向闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------- | --------- |
| 售后处理时效 | 从售后请求到处理完成的时间 | TOC + TOB |
| 退款成功率 | 成功退款的比例 | TOC + TOB |
| 退货率 | 退货订单占总订单的比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| 售后处理时效 | 从售后请求到处理完成的时间 | TOC + TOB |
| 退款成功率 | 成功退款的比例 | TOC + TOB |
| 退货率 | 退货订单占总订单的比例 | TOC + TOB |
#### 资金对账闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------- | --------- |
| 对账准确率 | 对账差异率 | TOC + TOB |
| 对账时效 | 从数据汇总到对账完成的时间 | TOC + TOB |
| 异常处理率 | 需要人工处理的异常比例 | TOC + TOB |
| 账期遵守率 | 按合同约定账期结算的比例 | TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| 对账准确率 | 对账差异率 | TOC + TOB |
| 对账时效 | 从数据汇总到对账完成的时间 | TOC + TOB |
| 异常处理率 | 需要人工处理的异常比例 | TOC + TOB |
| 账期遵守率 | 按合同约定账期结算的比例 | TOB |
#### 库存与仓储管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------- | --------- |
| 库存准确率 | 系统库存与实际库存的差异率 | TOC + TOB |
| 库存周转率 | 库存周转次数 | TOC + TOB |
| 仓储操作效率 | 每单处理时间 | TOC + TOB |
| 跨仓调拨时效 | 调拨完成时间 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| 库存准确率 | 系统库存与实际库存的差异率 | TOC + TOB |
| 库存周转率 | 库存周转次数 | TOC + TOB |
| 仓储操作效率 | 每单处理时间 | TOC + TOB |
| 跨仓调拨时效 | 调拨完成时间 | TOC + TOB |
#### 供应链与供应商管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | --------- | --------- |
| 供应商准时交付率 | 按时交付的订单比例 | TOC + TOB |
| 采购成本降低率 | 采购成本下降百分比 | TOC + TOB |
| 供应商评分 | 供应商综合评估分数 | TOC + TOB |
| 补货准确率 | 补货计划的准确性 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| -------------- | -------------------- | ----------- |
| 供应商准时交付率 | 按时交付的订单比例 | TOC + TOB |
| 采购成本降低率 | 采购成本下降百分比 | TOC + TOB |
| 供应商评分 | 供应商综合评估分数 | TOC + TOB |
| 补货准确率 | 补货计划的准确性 | TOC + TOB |
#### B2B / TOB 贸易管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | ------ |
| B2B 利润率 | B2B 业务的利润率 | TOB |
| 报价通过率 | 报价被客户接受的比例 | TOB |
| 信用违约率 | 客户信用违约的比例 | TOB |
| 询盘转化率 | 询盘转化为订单的比例 | TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| B2B 利润率 | B2B 业务的利润率 | TOB |
| 报价通过率 | 报价被客户接受的比例 | TOB |
| 信用违约率 | 客户信用违约的比例 | TOB |
| 询盘转化率 | 询盘转化为订单的比例 | TOB |
#### 治理与审批中心闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ----------- | --------- |
| 审批时效 | 从申请到审批完成的时间 | TOC + TOB |
| 审批准确率 | 审批结果的准确性 | TOC + TOB |
| 待办处理率 | 待办事项的处理比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| 审批时效 | 从申请到审批完成的时间 | TOC + TOB |
| 审批准确率 | 审批结果的准确性 | TOC + TOB |
| 待办处理率 | 待办事项的处理比例 | TOC + TOB |
#### 合规与证书管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | --------- | --------- |
| 证书生成及时率 | 按时生成证书的比例 | TOC + TOB |
| 合规检查通过率 | 通过合规检查的比例 | TOC + TOB |
| 信用评级准确率 | 信用评级的准确性 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ------------- | -------------------- | ----------- |
| 证书生成及时率 | 按时生成证书的比例 | TOC + TOB |
| 合规检查通过率 | 通过合规检查的比例 | TOC + TOB |
| 信用评级准确率 | 信用评级的准确性 | TOC + TOB |
#### 合规与风控闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 风险识别准确率 | 风险识别的准确性 | TOC + TOB |
| 风控处理时效 | 风险处理的时间 | TOC + TOB |
| 合规违规率 | 违规事件的比例 | TOC + TOB |
| 误报率 | 误判为风险的事件比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| 风险识别准确率 | 风险识别的准确性 | TOC + TOB |
| 风控处理时效 | 风险处理的时间 | TOC + TOB |
| 合规违规率 | 违规事件的比例 | TOC + TOB |
| 误报率 | 误判为风险的事件比例 | TOC + TOB |
#### 报表与分析闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | --------------- | --------- |
| 报表生成及时率 | 按时生成报表的比例 | TOC + TOB |
| 数据准确率 | 报表数据的准确性 | TOC + TOB |
| 分析洞察价值 | 分析结果对业务决策的价值 | TOC + TOB |
| 异常预警准确率 | 异常预警的准确性 | TOC + TOB |
| 报表生成时效 | 从数据汇总到报表完成的时间 | TOC + TOB |
| 数据完整率 | 报表覆盖业务闭环输出数据的比例 | TOC + TOB |
| KPI 准确率 | 计算指标与实际数据偏差率 | TOC + TOB |
| 异常响应率 | 异常报表触发优化措施的比例 | TOC + TOB |
| 大屏实时性 | 数据大屏数据更新延迟时间 | TOC + TOB |
| 决策支持率 | 报表建议被采纳并执行的比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ------------- | -------------------------- | ----------- |
| 报表生成及时率 | 按时生成报表的比例 | TOC + TOB |
| 数据准确率 | 报表数据的准确性 | TOC + TOB |
| 分析洞察价值 | 分析结果对业务决策的价值 | TOC + TOB |
| 异常预警准确率 | 异常预警的准确性 | TOC + TOB |
| 报表生成时效 | 从数据汇总到报表完成的时间 | TOC + TOB |
| 数据完整率 | 报表覆盖业务闭环输出数据的比例 | TOC + TOB |
| KPI 准确率 | 计算指标与实际数据偏差率 | TOC + TOB |
| 异常响应率 | 异常报表触发优化措施的比例 | TOC + TOB |
| 大屏实时性 | 数据大屏数据更新延迟时间 | TOC + TOB |
| 决策支持率 | 报表建议被采纳并执行的比例 | TOC + TOB |
#### 定价与利润决策闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------- | --------- |
| 定价准确率 | 建议售价与最优价格的偏差率 | TOC + TOB |
| 利润率达标率 | 达到目标利润率的商品比例 | TOC + TOB |
| 定价决策时效 | 从成本数据到定价决策的时间 | TOC + TOB |
| 价格竞争力 | 与市场平均价格的对比 | TOC + TOB |
| 利润预测准确率 | 预测利润与实际利润的偏差率 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ------------- | ------------------------ | ----------- |
| 定价准确率 | 建议售价与最优价格的偏差率 | TOC + TOB |
| 利润率达标率 | 达到目标利润率的商品比例 | TOC + TOB |
| 定价决策时效 | 从成本数据到定价决策的时间 | TOC + TOB |
| 价格竞争力 | 与市场平均价格的对比 | TOC + TOB |
| 利润预测准确率 | 预测利润与实际利润的偏差率 | TOC + TOB |
#### 账号/店铺健康度闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 店铺健康评分 | 店铺整体健康状态评分 | TOC + TOB |
| 风险预警准确率 | 风险预警的准确性 | TOC + TOB |
| 干预措施有效性 | 干预后店铺健康度改善程度 | TOC + TOB |
| 违规率 | 违规事件发生频率 | TOC + TOB |
| 账号稳定性 | 账号正常运行时间比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ------------- | ---------------------- | ----------- |
| 店铺健康评分 | 店铺整体健康状态评分 | TOC + TOB |
| 风险预警准确率 | 风险预警的准确性 | TOC + TOB |
| 干预措施有效性 | 干预后店铺健康度改善程度 | TOC + TOB |
| 违规率 | 违规事件发生频率 | TOC + TOB |
| 账号稳定性 | 账号正常运行时间比例 | TOC + TOB |
#### 店铺隔离与自动化闭环
| KPI 指标 | 描述 | 适用业务类型 |
| --------- | ------------- | --------- |
| 店铺隔离成功率 | 成功隔离的店铺比例 | TOC + TOB |
| 自动化操作成功率 | 成功执行的自动化操作比例 | TOC + TOB |
| 异常恢复时长 | 异常从发生到恢复的时间 | TOC + TOB |
| 脚本异常率 | 脚本执行异常的比例 | TOC + TOB |
| 功能覆盖率 | 自动化覆盖的业务功能比例 | TOC + TOB |
| 镜像可用性 | 镜像正常运行时间比例 | TOC + TOB |
| 云API调用成功率 | 云服务商API调用成功率 | TOC + TOB |
| 资源利用率 | 镜像资源使用效率 | TOC + TOB |
| 自动登录成功率 | 镜像自动登录成功率 | TOC + TOB |
| 多云切换成功率 | 云服务商切换成功率 | TOC + TOB |
| 成本优化率 | 多云部署带来的成本优化比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| --------------- | ---------------------- | ----------- |
| 店铺隔离成功率 | 成功隔离的店铺比例 | TOC + TOB |
| 自动化操作成功率 | 成功执行的自动化操作比例 | TOC + TOB |
| 异常恢复时长 | 异常从发生到恢复的时间 | TOC + TOB |
| 脚本异常率 | 脚本执行异常的比例 | TOC + TOB |
| 功能覆盖率 | 自动化覆盖的业务功能比例 | TOC + TOB |
| 镜像可用性 | 镜像正常运行时间比例 | TOC + TOB |
| 云API调用成功率 | 云服务商API调用成功率 | TOC + TOB |
| 资源利用率 | 镜像资源使用效率 | TOC + TOB |
| 自动登录成功率 | 镜像自动登录成功率 | TOC + TOB |
| 多云切换成功率 | 云服务商切换成功率 | TOC + TOB |
| 成本优化率 | 多云部署带来的成本优化比例 | TOC + TOB |
#### 商品主数据闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------ | --------- |
| 数据标准化率 | 标准化处理的商品数据比例 | TOC + TOB |
| 数据一致性 | 多平台数据一致性程度 | TOC + TOB |
| 主数据准确率 | 商品主数据的准确性 | TOC + TOB |
| 数据同步时效 | 数据从采集到同步的时间 | TOC + TOB |
| 数据质量评分 | 商品数据质量综合评分 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| 数据标准化率 | 标准化处理的商品数据比例 | TOC + TOB |
| 数据一致性 | 多平台数据一致性程度 | TOC + TOB |
| 主数据准确率 | 商品主数据的准确性 | TOC + TOB |
| 数据同步时效 | 数据从采集到同步的时间 | TOC + TOB |
| 数据质量评分 | 商品数据质量综合评分 | TOC + TOB |
#### SKU变体与结构闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | ------------ | --------- |
| SKU映射准确率 | 多平台SKU映射的准确性 | TOC + TOB |
| SKU生成时效 | SKU生成的平均时间 | TOC + TOB |
| 变体管理效率 | 变体属性管理的效率 | TOC + TOB |
| 库存同步准确率 | 多SKU库存同步的准确性 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| -------------- | ---------------------- | ----------- |
| SKU映射准确率 | 多平台SKU映射的准确性 | TOC + TOB |
| SKU生成时效 | SKU生成的平均时间 | TOC + TOB |
| 变体管理效率 | 变体属性管理的效率 | TOC + TOB |
| 库存同步准确率 | 多SKU库存同步的准确性 | TOC + TOB |
#### 订单拆分与合并闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | -------------- | --------- |
| 拆分/合并准确率 | 订单拆分/合并的准确性 | TOC + TOB |
| 拆分/合并时效 | 订单拆分/合并的处理时间 | TOC + TOB |
| 物流成本优化率 | 拆分/合并带来的物流成本节约 | TOC + TOB |
| 客户满意度 | 拆分/合并订单的客户满意度 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| -------------- | ---------------------- | ----------- |
| 拆分/合并准确率 | 订单拆分/合并的准确性 | TOC + TOB |
| 拆分/合并时效 | 订单拆分/合并的处理时间 | TOC + TOB |
| 物流成本优化率 | 拆分/合并带来的物流成本节约 | TOC + TOB |
| 客户满意度 | 拆分/合并订单的客户满意度 | TOC + TOB |
#### 异常订单处理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------ | --------- |
| 异常处理率 | 成功处理的异常订单比例 | TOC + TOB |
| 异常处理时效 | 异常订单处理的平均时间 | TOC + TOB |
| 异常解决率 | 成功解决的异常订单比例 | TOC + TOB |
| 客户满意度 | 异常订单处理的客户满意度 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ---------- | -------------------- | ----------- |
| 异常处理率 | 成功处理的异常订单比例 | TOC + TOB |
| 异常处理时效 | 异常订单处理的平均时间 | TOC + TOB |
| 异常解决率 | 成功解决的异常订单比例 | TOC + TOB |
| 客户满意度 | 异常订单处理的客户满意度 | TOC + TOB |
#### 物流策略与渠道选择闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 物流成本节约率 | 物流成本节约的比例 | TOC + TOB |
| 物流时效达标率 | 按时送达的订单比例 | TOC + TOB |
| 渠道选择准确率 | 物流渠道选择的准确性 | TOC + TOB |
| 物流跟踪覆盖率 | 可跟踪的物流订单比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ----------- | -------------------- | ----------- |
| 物流成本节约率 | 物流成本节约的比例 | TOC + TOB |
| 物流时效达标率 | 按时送达的订单比例 | TOC + TOB |
| 渠道选择准确率 | 物流渠道选择的准确性 | TOC + TOB |
| 物流跟踪覆盖率 | 可跟踪的物流订单比例 | TOC + TOB |
#### 利润核算闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 利润计算准确率 | 利润计算的准确性 | TOC + TOB |
| 利润核算时效 | 利润核算的平均时间 | TOC + TOB |
| 成本分摊准确性 | 成本分摊的准确性 | TOC + TOB |
| 利润率达标率 | 达到目标利润率的订单比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ----------- | -------------------- | ----------- |
| 利润计算准确率 | 利润计算的准确性 | TOC + TOB |
| 利润核算时效 | 利润核算的平均时间 | TOC + TOB |
| 成本分摊准确性 | 成本分摊的准确性 | TOC + TOB |
| 利润率达标率 | 达到目标利润率的订单比例 | TOC + TOB |
#### 用户/客户资产闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------- | --------- |
| 用户画像准确率 | 用户画像与实际行为的匹配度 | TOC + TOB |
| 客户价值提升率 | 客户平均价值增长比例 | TOC + TOB |
| 复购率 | 客户重复购买比例 | TOC + TOB |
| KPI 指标 | 描述 | 适用业务类型 |
| ----------- | ---------------------- | ----------- |
| 用户画像准确率 | 用户画像与实际行为的匹配度 | TOC + TOB |
| 客户价值提升率 | 客户平均价值增长比例 | TOC + TOB |
| 复购率 | 客户重复购买比例 | TOC + TOB |
| 客户留存率 | 客户持续活跃的比例 | TOC + TOB |
| 营销转化率 | 营销活动的转化效果 | TOC + TOB |

8
docs/00_Business/Task_Overview.md
View File

@@ -12,8 +12,8 @@
| -------------- | ----------- | -------------------------------------- | --------------------------------------------------------------------------------------- | ---------------- | ------ |
| AI-Frontend-5 | 售后逆向闭环 | FE-SR001, FE-SR002, FE-SR003 | ReturnApply.tsx, RefundProcess.tsx, CustomerService.tsx | 2026-03-18 10:00 | ✅ 已完成 |
| AI-Frontend-6 | B2B贸易管理闭环 | FE-TOB001, FE-TOB002, FE-TOB003 | EnterpriseQuote.tsx, BatchOrder.tsx, ContractManage.tsx | 2026-03-18 11:00 | ✅ 已完成 |
| AI-Backend-8 | 合规与证书管理闭环 | FE-COM001, FE-COM002, FE-COM003 | CertificateManage.tsx, ComplianceCheck.tsx | 2025-03-18 17:00 | ✅ 已完成 |
| AI-Analysis-3 | 广告计划与营销闭环 | AI-AD001, AI-AD002, AI-AD003 | AdOptimizationService.ts, BiddingStrategyService.ts, AdPredictionService.ts | 2025-03-18 21:00 | ✅ 已完成 |
| AI-Backend-8 | 合规与证书管理闭环 | FE-COM001, FE-COM002, FE-COM003 | CertificateManage.tsx, ComplianceCheck.tsx | 2026-03-18 17:00 | ✅ 已完成 |
| AI-Analysis-3 | 广告计划与营销闭环 | AI-AD001, AI-AD002, AI-AD003 | AdOptimizationService.ts, BiddingStrategyService.ts, AdPredictionService.ts | 2026-03-18 21:00 | ✅ 已完成 |
| AI-Frontend-8 | 物流策略闭环 | FE-LOG001, FE-LOG002, FE-LOG003 | LogisticsSelect.tsx, LogisticsTrack.tsx, FreightCalc.tsx | 2026-03-18 12:00 | ✅ 已完成 |
| AI-Frontend-9 | 订单履约闭环 | FE-O001, FE-O002, FE-O003, FE-O004 | OrderList.tsx, OrderDetail.tsx, OrderAggregation.tsx, ExceptionOrder.tsx | 2026-03-18 12:30 | ✅ 已完成 |
| AI-Backend-9 | 商品刊登闭环 | FE-P002, FE-P003, FE-P004 | ProductDetail.tsx, ProductPublishForm.tsx, MaterialUpload.tsx | 2026-03-18 22:00 | ✅ 已完成 |
@@ -28,8 +28,8 @@
| AI-Test-10 | 测试用例与质量保证 | OP-IT001, OP-IT002, OP-IT003, OP-IT004 | api.integration.test.ts, plugin.integration.test.ts, e2e.test.ts, tuple-tracing.test.ts | 2026-03-18 14:00 | ✅ 已完成 |
| AI-Test-11 | 压力测试与安全测试 | OP-ST001, OP-ST003 | stress.test.ts, rbac.test.ts | 2026-03-18 15:00 | ✅ 已完成 |
| AI-Plugin-12 | 广告计划与营销闭环插件 | PL-AD001, PL-AD002 | AdOperation.plugin.ts | 2026-03-18 23:30 | ✅ 已完成 |
| AI-Plugin-13 | 数据采集与自动化闭环 | PL-C002, PL-A001, PL-A002 | DOMParser.ts, FingerprintManager.ts, AutoShipService.ts | 2025-03-18 22:00 | ✅ 已完成 |
| AI-Plugin-13 | 物流策略与渠道选择闭环 | PL-A003 | LogisticsSyncService.ts | 2025-03-19 10:00 | ✅ 已完成 |
| AI-Plugin-13 | 数据采集与自动化闭环 | PL-C002, PL-A001, PL-A002 | DOMParser.ts, FingerprintManager.ts, AutoShipService.ts | 2026-03-18 22:00 | ✅ 已完成 |
| AI-Plugin-13 | 物流策略与渠道选择闭环 | PL-A003 | LogisticsSyncService.ts | 2026-03-19 10:00 | ✅ 已完成 |
| AI-Plugin-4 | 物流策略闭环插件 | PL-LOG001, PL-LOG002 | LogisticsSync.plugin.ts | 2026-03-18 20:40 | ✅ 已完成 |
| AI-Decision-1 | 定价与利润决策闭环 | AI-D001, AI-D002 | PricingDecisionService.ts, ExceptionAutoFixService.ts | 2026-03-18 23:30 | ✅ 已完成 |

41
docs/01_Architecture/SERVICE_MAP.md
View File

@@ -1,12 +1,41 @@
# SERVICE_MAP（服务编排总图）
## 设计原则
- 所有业务必须通过 Service 层
- Controller 不允许直接操作数据库
- 一个业务 = 一条 Service Flow
- 服务调用必须遵循 STATE_MACHINE 定义的状态流转
- 涉及收费的业务必须接入 BILLING 系统
- 所有接口必须经过权限校验
### 核心原则（逻辑集中化）
> **所有业务逻辑必须集中在 Service 层，禁止分散在 Controller、前端或数据库操作中。**
### 强制约束
- ✅ **所有业务必须通过 Service 层**：禁止 Controller 直接操作数据库
- ✅ **Controller 职责明确**：只负责请求/响应和权限校验
- ✅ **一个业务 = 一条 Service Flow**：每个业务操作对应一个完整的服务流程
- ✅ **服务调用必须遵循 STATE_MACHINE**：状态流转必须符合状态机定义
- ✅ **涉及收费的业务必须接入 BILLING 系统**：支付、权限、账单必须闭环
- ✅ **所有接口必须经过权限校验**：使用 `authorize()` 中间件
### 禁止行为
- ❌ **Controller 中写业务逻辑**：业务决策、状态变化、数据校验必须在 Service 层
- ❌ **前端直接写业务规则**：复杂计算、权限判断、状态流转禁止在 React 组件中实现
- ❌ **数据库操作分散**：不同模块禁止直接调用数据库，必须通过 Service 层
- ❌ **脚本或工具处理逻辑**：AI 任务或异步脚本必须通过 Service 层统一调用
### 服务层职责边界
#### Controller 层职责
- 接收 HTTP 请求和参数验证
- 调用 Service 层处理业务逻辑
- 返回响应给前端
- 权限校验（通过 `authorize()` 中间件）
#### Service 层职责（核心）
- 业务逻辑编排和状态流转
- 多模块协同和数据一致性保证
- 事务管理和异常处理
- 调用 Repository 层或外部 API
#### Repository 层职责
- 数据库 CRUD 操作
- 数据模型映射
- 查询优化
---

42
docs/02_Backend/Service_Design.md
View File

@@ -8,13 +8,23 @@
## 1. 服务层架构
### 1.1 核心原则
### 1.1 核心原则（逻辑集中化）
- **每个业务操作对应一个 Service**：前端的每个用户操作都必须有对应的后端 Service 处理
- **服务编排**：通过 Service 层串联多个模块，实现业务流程的完整执行
- **单一职责**：每个 Service 只负责一个核心业务领域
- **依赖注入**：通过依赖注入实现服务间的解耦
- **事务管理**：重要操作必须在事务中执行，确保数据一致性
> **逻辑集中化 → 服务驱动**：所有业务逻辑必须集中在 Service 层，禁止分散在 Controller、前端或数据库操作中。
#### 强制约束
- ✅ **每个业务操作对应一个 Service**：前端的每个用户操作都必须有对应的后端 Service 处理
- ✅ **服务编排**：通过 Service 层串联多个模块，实现业务流程的完整执行
- ✅ **单一职责**：每个 Service 只负责一个核心业务领域
- ✅ **依赖注入**：通过依赖注入实现服务间的解耦
- ✅ **事务管理**：重要操作必须在事务中执行，确保数据一致性
- ✅ **状态管理统一**：所有状态更新必须通过 Service 层，禁止在 Controller 或前端直接修改
#### 禁止行为
- ❌ **Controller 中写业务逻辑**：Controller 只负责请求/响应和权限校验，业务决策、状态变化、数据校验必须在 Service 层
- ❌ **前端直接写业务规则**：复杂计算、权限判断、状态流转禁止在 React 组件中实现
- ❌ **数据库操作分散**：不同模块禁止直接调用数据库，必须通过 Service 层
- ❌ **脚本或工具处理逻辑**：AI 任务或异步脚本必须通过 Service 层统一调用
### 1.2 服务层级结构
@@ -22,6 +32,26 @@
Controller → Service (核心编排) → Repository / External API → 数据库/外部系统
```
#### Controller 层职责（强制执行）
- 接收 HTTP 请求和参数验证
- 调用 Service 层处理业务逻辑
- 返回响应给前端
- 权限校验（通过 `authorize()` 中间件）
- **禁止**：业务决策、状态变化、数据校验
#### Service 层职责（核心）
- 业务逻辑编排和状态流转
- 多模块协同和数据一致性保证
- 事务管理和异常处理
- 调用 Repository 层或外部 API
- **必须**：所有业务逻辑必须在此层实现
#### Repository 层职责
- 数据库 CRUD 操作
- 数据模型映射
- 查询优化
- **禁止**：业务逻辑处理
---
## 2. 核心服务列表

75
docs/Development_Progress.md
View File

@@ -19,18 +19,18 @@
### 关键里程碑
| 里程碑 | 状态 | 预计完成时间 | 实际完成时间 |
| ------ | ---- | ------------ | ------------ |
| 多商户业务闭环文档完善 | ✅ 已完成 | 2024-12-15 | 2024-12-15 |
| 服务编排地图（SERVICE_MAP） | ✅ 已完成 | 2024-12-16 | 2026-03-18 |
| 领域模型（DOMAIN_MODEL） | ✅ 已完成 | 2024-12-17 | 2026-03-18 |
| 状态机定义（STATE_MACHINE） | ✅ 已完成 | 2024-12-18 | 2026-03-18 |
| 功能开通服务实现 | ✅ 已完成 | 2024-12-19 | 2026-03-18 |
| 服务层代码实现与修复 | ✅ 已完成 | 2024-12-20 | 2026-03-18 |
| 前端服务启动 | ✅ 已完成 | 2024-12-21 | 2026-03-18 |
| 后端服务启动 | ✅ 已完成 | 2024-12-22 | 2026-03-18 |
| 前端优化 | ✅ 已完成 | 2024-12-23 | 2026-03-18 |
| 前端页面骨架创建 | ✅ 已完成 | 2024-12-24 | 2026-03-18 |
| 前端文档补充 | ✅ 已完成 | 2024-12-25 | 2026-03-18 |
| 系统集成测试 | ⏳ 待开始 | 2024-12-26 | - |
| 多商户业务闭环文档完善 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 服务编排地图（SERVICE_MAP） | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 领域模型（DOMAIN_MODEL） | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 状态机定义（STATE_MACHINE） | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 功能开通服务实现 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 服务层代码实现与修复 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 前端服务启动 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 后端服务启动 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 前端优化 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 前端页面骨架创建 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 前端文档补充 | ✅ 已完成 | 2026-03-18 | 2026-03-18 |
| 系统集成测试 | 🔄 进行中 | 2026-03-19 | - |
## 📋 任务状态跟踪
@@ -86,14 +86,17 @@
49. ✅ 补充Business_ClosedLoops.md附录C：前端组件规范（组件分类、状态管理、API交互、路由权限）
50. ✅ 补充Task_Overview.md附录A：前端交互任务补充（商品、订单、执行、数据、合规、设置交互任务）
51. ✅ 补充Task_Overview.md附录B：前端开发规范（技术栈、项目结构、组件、状态、API、路由权限）
52. ✅ 更新项目规则文档（project-specific-rules.md），加入逻辑集中化原则
53. ✅ 更新SERVICE_MAP.md，强化服务层职责和调用规范
54. ✅ 更新Service_Design.md，明确服务层设计规范和边界
### 进行中任务
1. 🔄 系统集成测试
2. 🔄 前端交互任务开发
### 待开始任务
1. ⏳ 性能测试和优化
2. ⏳ 安全测试
3. ⏳ 领取并完成前端交互任务（附录A中的FE-INT系列任务）
## 🏗️ 架构演进
@@ -123,6 +126,22 @@
/repository （数据层）
```
### 逻辑集中化原则
> **所有业务逻辑必须集中在 Service 层，禁止分散在 Controller、前端或数据库操作中。**
#### 逻辑分散的表现（禁止行为）
- ❌ **Controller 中写业务逻辑**：Controller 只负责请求/响应和权限校验
- ❌ **前端直接写业务规则**：复杂计算、权限判断、状态流转禁止在 React 组件中实现
- ❌ **数据库操作分散**：不同模块禁止直接调用数据库，必须通过 Service 层
- ❌ **脚本或工具处理逻辑**：AI 任务或异步脚本必须通过 Service 层统一调用
#### 逻辑分散的后果
1. **维护成本高**：AI 或开发者需要理解多个模块才能做一件改动
2. **修改容易出错**：改动一处可能引起其他模块逻辑不一致
3. **难以快速迭代**：新功能闭环难以接入，因为逻辑散落在各处
4. **收费闭环风险**：分散逻辑导致支付、权限、账单、状态不一致，直接影响收益
5. **AI 维护困难**：AI 无法一次性理解完整闭环，状态不一致，修改风险高
#### 服务层职责
一个服务 = 一个闭环
@@ -274,12 +293,20 @@
- **2026-03-18**：补充Business_ClosedLoops.md附录A、B、C，完善前端交互设计规范、页面映射和组件规范
- **2026-03-18**：补充Task_Overview.md附录A、B，完善前端交互任务和前端开发规范
- **2026-03-18**：确认50个业务闭环保持不变，仅在文档末尾添加附录，不改变原有结构
- **2026-03-18**：完成docs目录下所有文档的重新排版，统一表格格式和文档结构
- **2026-03-18**：更新开发进度互通文档，调整任务状态和下一步计划
- **2026-03-18**：分析逻辑分散问题，确认其对AI维护的影响和解决方案
- **2026-03-18**：更新项目规则文档（project-specific-rules.md），加入逻辑集中化原则
- **2026-03-18**：更新SERVICE_MAP.md，强化服务层职责和调用规范
- **2026-03-18**：更新Service_Design.md，明确服务层设计规范和边界
### 关键洞察
1. **服务闭环与收费的关系**：服务闭环跟收费没有必然关系，收费只是把问题放大了。只要存在"状态流转 + 多模块协同"，就必须有服务闭环。
2. **不收费场景也需要服务闭环**：订单闭环、库存闭环、多商户分单等都需要服务层保证数据一致性。
3. **收费场景更容易暴露问题**：因为多了一条链（功能 → 支付 → 权限 → 使用 → 计费 → 结算），任何一个点错了都会直接损失钱。
4. **前端优化的重要性**：前端是用户直接接触的界面，其流畅性和功能完整性直接影响用户体验和系统的商业价值。
5. **逻辑集中化的必要性**：逻辑分散导致AI难以维护，状态不一致，修改风险高。集中化逻辑到服务层 + 统一状态管理，AI才能高效维护和迭代。
6. **服务层职责边界**：Controller只负责请求/响应和权限校验，Service层负责业务逻辑编排和状态流转，Repository层负责数据库操作。明确职责边界是逻辑集中化的基础。
### AI开发建议
1. 优先进行系统集成测试，确保各服务之间的正确交互
@@ -289,19 +316,24 @@
5. 严格执行"业务闭环优先"原则，避免碎片化开发
6. 按照前端优化策略，逐步实现组件化、状态管理和性能优化
7. 确保前端与后端的良好集成，实现数据的实时同步和交互的流畅性
8. **严格执行逻辑集中化原则**：所有业务逻辑必须集中在 Service 层，禁止分散在 Controller、前端或数据库操作中
9. **明确服务层职责边界**：Controller 只负责请求/响应和权限校验，Service 层负责业务逻辑编排和状态流转，Repository 层负责数据库操作
10. **统一状态管理**：前端使用全局 Model 或状态管理库，后端统一使用 STATE_MACHINE 定义的状态机，所有状态更新必须通过 Service 层
## 📝 下一步计划
### 短期计划（1-3天）
### 短期计划（2026-03-19 至 2026-03-21）
1. 完成系统集成测试，验证服务层功能
2. 优化数据库查询和缓存策略
3. 实现完整的错误处理和日志记录
4. 进行性能测试和优化
5. 实现安全测试，确保系统安全性
6. 领取并完成前端交互任务（Task_Overview.md附录A中的FE-INT系列任务）
7. 实现前端交互功能，包括筛选、排序、新增、编辑、定价、上架、同步等
6. 完成前端交互任务开发，包括筛选、排序、新增、编辑、定价、上架、同步等
7. **代码审查**：检查所有Controller、Service、Repository代码，确保符合逻辑集中化原则
8. **重构优化**：将分散的业务逻辑迁移到Service层，确保职责边界清晰
9. **测试验证**：验证逻辑集中化后的代码，确保功能正确性和数据一致性
### 中期计划（4-7天）
### 中期计划（2026-03-22 至 2026-03-28）
1. 完善前端与后端的集成，实现数据实时同步
2. 补充二级闭环（功能收费闭环、权限控制闭环、商户账单闭环）
3. 部署系统到测试环境
@@ -309,7 +341,7 @@
5. 完善前端组件库，实现组件复用
6. 实现前端状态管理，优化数据流
### 长期计划（8-14天）
### 长期计划（2026-03-29 至 2026-04-11）
1. 部署系统到生产环境
2. 监控系统运行状态
3. 持续优化和迭代系统功能
@@ -334,9 +366,10 @@
5. 避免逻辑分散，确保业务逻辑集中在服务层
### 架构风险
1. **逻辑分散风险**：如果在 Controller 中写业务逻辑，会导致逻辑分散，AI 无法维护
2. **收费必炸风险**：没有完整的服务闭环，后期收费功能必定出现问题
3. **数据一致性风险**：多商户场景下，没有服务层会导致商户归属混乱、结算错误
1. **逻辑分散风险**：如果在 Controller 中写业务逻辑，会导致逻辑分散，AI 无法维护。逻辑分散导致AI难以追踪业务流程、状态流转不统一、重复逻辑、难以保证一致性、代码依赖复杂。
2. **收费必炸风险**：没有完整的服务闭环，后期收费功能必定出现问题。分散逻辑导致支付、权限、账单、状态不一致，直接影响收益。
3. **数据一致性风险**：多商户场景下，没有服务层会导致商户归属混乱、结算错误。
4. **AI维护困难风险**：逻辑分散让 AI 无法一次性理解完整闭环，状态不一致，修改风险高。集中化逻辑到服务层 + 统一状态管理，AI 才能高效维护和迭代。
## 📞 联系方式

100
docs/临时修改建议 copy.MD
View File

@@ -0,0 +1,100 @@
我把“逻辑分散 → AI难维护”这个问题拆开，详细分析下原因、表现和影响，以及可行的解决思路。
---
## 1️⃣ 问题本质
**逻辑分散**指的是业务逻辑没有集中在服务层，而散布在不同模块中，例如：
* **Controller 中写逻辑**：Controller 除了接收请求和返回响应，还处理业务决策、状态变化、数据校验。
* **前端直接写逻辑**：复杂计算、权限判断、状态流转直接在 React 组件或页面中实现。
* **数据库操作分散**：不同模块直接调用数据库，导致状态更新不统一。
* **脚本或工具处理逻辑**：AI 任务或异步脚本单独处理业务逻辑，没有统一调用入口。
---
## 2️⃣ AI 维护难的原因
AI 的核心优势是**理解和处理规则化逻辑**，逻辑分散导致 AI 难维护主要有以下几个原因：
1. **难以追踪业务流程**
* 业务步骤可能跨多个文件或模块，AI 无法一次性获取完整流程。
* 例如，订单闭环：支付、库存锁定、订单创建、账单生成分别在不同文件处理，AI 需要先分析依赖关系，再理解流程。
2. **状态流转不统一**
* 状态可能在多个地方更新，缺乏中心化状态管理。
* AI 很难判断状态真实值和变化条件，导致任务调度或逻辑判断出错。
3. **重复逻辑**
* 不同模块可能重复实现相同逻辑（如权限判断、价格计算）。
* AI 难以判断哪个逻辑是“权威版本”，容易修改错地方。
4. **难以保证一致性**
* 分散逻辑容易导致边缘情况处理不统一（例如异常、支付失败、库存不足）。
* AI 在优化或修复逻辑时，可能漏掉某些分散的处理点。
5. **代码依赖复杂**
* 分散逻辑意味着调用链不清晰，AI 在修改或推理时必须解析跨文件依赖。
* 对于大型多商户系统，这种复杂度呈指数级增长。
---
## 3️⃣ 典型表现
* Controller 内部有大量 `if/else` + 异步调用
* 前端页面直接处理业务规则（如价格、折扣、库存判断）
* 数据库更新在多个 Service/Repository 之外被调用
* AI 执行任务时，需要在不同模块中查找状态和规则
---
## 4️⃣ 后果
1. **维护成本高**
* AI 或开发者需要理解多个模块才能做一件改动。
2. **修改容易出错**
* 改动一处可能引起其他模块逻辑不一致。
3. **难以快速迭代**
* 新功能闭环难以接入，因为逻辑散落在各处。
4. **收费闭环风险**
* 分散逻辑导致支付、权限、账单、状态不一致，直接影响收益。
---
## 5️⃣ 解决策略
**核心原则：逻辑集中化 → 服务驱动**
1. **服务层集中业务逻辑**
* Controller 只负责请求/响应和权限校验。
* Service 层负责业务闭环、状态流转和多模块协同。
2. **状态管理统一**
* 前端使用全局 Model 或状态管理库（Umi Model、Redux 等）。
* 后端统一使用状态机或闭环处理状态。
3. **复用核心逻辑**
* 公共函数或工具库统一处理权限、价格、库存、账单等逻辑。
* AI 只需调用 Service 接口，不直接处理业务逻辑。
4. **可视化业务流程**
* 使用流程图或状态机图记录完整闭环，让 AI 可快速理解流程。
* 前端交互和后端服务逻辑保持一致。
---
💡 **总结一句话**：
逻辑分散让 AI 无法一次性理解完整闭环，状态不一致，修改风险高；集中化逻辑到服务层 + 统一状态管理，AI 才能高效维护和迭代。