README.md
文档目录说明（doc/）
本仓库主文档根目录为 doc/。请勿在仓库根目录再新建并列的 docs/ 存放本仓库文档（历史 docs/ 已并入此处）。
与子目录 ai-dop-platform/docs/ 的区别
| 路径 | 归属 | 用途 |
|---|---|---|
doc/（本文件所在） |
Ai-DOP 主库（含 Web/、server/） |
主库业务方案、审批流说明、会议记录、数据库导出脚本等 |
ai-dop-platform/docs/ |
子目录 ai-dop-platform |
平台侧架构、上手、SQL、SmartOps 数据模型等，不随本次合并迁移 |
在 Cursor 中引用平台文档时，仍使用 @ai-dop-platform/docs/...。
目录约定
| 子目录 / 位置 | 放置内容 |
|---|---|
doc/plan/ |
各模块/专题的实施方案、设计说明（如 plan/S1/） |
doc/plan/系统集成/ |
第三方系统对接指南与业务/技术详表（含 Word） |
doc/plan/系统部署/ |
首次部署与新租户初始化指南、初始化脚本（含 Word） |
doc/meeting/ |
会议纪要、评审记录、过程性附件 |
doc/db/ |
与主库相关的表结构导出、生成脚本（如 Excel、Python） |
doc/ 根下 |
跨模块的功能说明等独立 Markdown；第三方对接资料已归入 plan/系统集成/ |
doc/img/、doc/shop/ 等 |
文档用图片、截图等资源（保持现有结构即可） |
命名与格式
- 语言：面向团队的说明以中文为主；需对外或开源时再提供英文版可复制路径。
- 文件名：使用可读中文或
模块-主题.md，避免无意义缩写；审批流相关已约定：审批流功能说明.md— 用户/产品视角功能清单审批流集成开发指南.md— 开发接入步骤与 API
- 新增文档：优先放入上表对应子目录；若无合适子目录，放在
doc/根并在本 README「文档索引」中补一行（或后续集中整理到子目录）。 - 大附件：二进制、Excel、SQL 体积较大时，可放在
doc/db/或专题子目录，不要把生成物硬编码为机器绝对路径；脚本输出宜相对脚本目录（参见doc/db/gen_table_excel.py）。
文档索引（维护中）
| 文档 | 说明 |
|---|---|
| plan/项目验收/README.md | 现行项目验收入口：L1 客户最低线（2026-08-07 修订 Word + 113 项技术规范/72 条合同 FUNC-AC）与 L2 产品全量线（167 条 FUNC-AC），以及三套 UAT 数据覆盖矩阵 |
| 项目交付验收方案.md | 历史 Markdown V0.6 / 兼容入口；现行 L1 以 plan/项目验收/ 中 2026-08-07 修订 Word 为准 |
| plan/移动端APP建设方案.md | 移动端 APP 总体方案（评审稿）：uni-app(Vue3) 单代码库 Android 先行、后续同码扩 iOS；复用现有后端 API/JWT/SignalR 零侵入；含技术选型对比、鉴权、后端最小改动清单（B1/B2/B3/B7）、四大功能域页面→API 映射、推送链路、打包分发、M1~M5 里程碑与风险清单 |
| plan/移动端APP-UI页面设计方案.md | 移动端 APP UI 设计方案（评审稿）：设计 Tokens（品牌色 #0F59A4、字号/间距规范）、Element Plus→wot-design-uni 组件映射、4 Tab 信息架构与页面树、14 组页面详细设计（布局/交互/数据来源/状态设计）、通用交互模式、与 M1~M5 里程碑对应关系及设计验收方式 |
| 移动端APP界面截图手册.md | 移动端界面速览手册（面向业务同事）：按功能目录层级组织 15 个核心页面真实截图（截图于 2026-09-30 本地 UAT 环境），含页面结构树、总览表、逐页说明与已知显示问题记录；截图资源在 img/mobile-app/ |
| 移动端APP界面导览.html | 可点击的界面模拟导览（单文件 HTML，双击即开）：15 张截图串热区，点 Tab/九宫格/列表行/返回键按真实操作路径跳转；由 _gen_mobile_tour.py 生成，截图更新后重跑即可 |
| 审批流功能说明.md | 审批流菜单、审批中心、设计器、通知与权限 |
| 审批流集成开发指南.md | IFlowBizHandler、ApprovalPanel、配置与 API |
| plan/系统部署/README.md | 部署与初始化入口：首次云端部署 + 新租户工厂从零开通 |
| plan/推送凭据与租户基线修复执行任务书.md | 可派发任务书（纯后端，无 DDL）：编写初始化指南时取证发现的两个缺陷。包 A（P0） 发放推送授权只写 mdp_inbound_grant 不写 sys_open_access，界面发出的 accessKey 必然验签失败（InboundSignatureHandler.cs:74-90 取的是 SysOpenAccess.AccessSecret），方式丙在生产路径上不可用；含 BindTenantId 决定入站数据租户归属这一关键点与跨租户串数防线。包 B（P1） 租户基线反射解析失败时完全静默（SysTenantService.cs:311-325 的 null 分支无日志）且无重跑入口，方法本身已幂等故加入口安全 |
| plan/系统部署/Ai-DOP系统初始化配置指南.md | 按环境部署、新增租户工厂、运营建模主数据、数据服务层对接、启用运行五阶段编写，每阶段附验证项，末尾含 30 项检查表与问题排查表；配套初始化脚本 init_new_tenant.py |
| plan/系统集成/README.md | 第三方系统对接资料入口：集成指南 + 业务/技术详表（Markdown 与 Word） |
| plan/系统集成/Ai-DOP第三方系统集成指南.md | 给第三方系统看的对接指南：入站对象、DB 同步与 API 约定、回写与联调验收 |
| plan/系统集成/Ai-DOP第三方对接业务数据详表-业务页.md | 对接详表（业务）：九宫格/详情看板/诊断/ChatBI 需要哪些业务数据，不含库表名 |
| plan/系统集成/Ai-DOP第三方对接业务数据详表-技术页.md | 对接详表（技术）：源字段落到中台哪张表、哪个栏位 |
| plan/Ai-DOP本体驱动制造业数据智能运营平台产品方案.md | 本体驱动产品顶层方案（待评审）：在“独立工业数据中台 + S0–S9 + 智能体运营平台”基础上增加业务语义控制面，定义通用制造本体、行业扩展、工厂原型和客户覆盖分层，说明数据中台、S0–S9、智能体、知识体系及行业化价值演示平台的调整，包含新旧方案变动对照、P0–P5 路线图和治理红线 |
| plan/Ai-DOP本体驱动智能体建设方案.docx | 智能体建设方案（评审稿 Word，V1.7）：第一章含 Palantir Foundry Ontology 本体背景、DOP 背景与四层架构（S0~S9 十大模块功能定位与技术亮点、S8/S9 核心能力）与四大建设目标（L0~L4 五级自动化等级统一口径：L2 为主、L3 白名单例外）；含 S1~S9 九大模块级智能体画像（S4~S7 已按代码资产补写详细需求）与「画像—现有代码承载」对应表、需求覆盖矩阵 A（S1~S9 × 四类能力主/辅/—、业务 Owner/审批角色、责任边界三硬规则与跨域衔接实例）、6.3 需求就绪度判定（六维判定 + 矩阵 B，判定经主库代码三层取证修订：仅 S2 验收评测与 S7 KPI 为缺失，其余六维均部分以上）与 C0~C13 一页需求卡模板（含三个易错点、证据规范，S4 采购执行 AGT-S4-001 完整卡见配套文档）；本体四表设计含属性口径/状态字典与自动化等级/幂等键/回滚方式字段；5.2 归因分析附节点—箭头链路图（症状定位→根因证据→处置建议）；零旁路增量建设四类职能智能体 × 九模块智能体矩阵；P0~P4 分阶段计划（P0 含矩阵起步值基线校准，P4 含业务域补齐顺序）与治理红线；5.5 齐套四量问答试点，5.6~5.9 四个场景示例（生成脚本 _gen_agent_plan_docx.py） |
| plan/AI-DOP_S1-S9智能体需求覆盖矩阵与需求卡模板_v0.1.docx | 智能体方案配套文档（评审稿 v0.1）：S1–S9 需求覆盖矩阵 A/B、L0~L4 自动化等级口径、责任边界三硬规则、C0~C13 一页需求卡模板与 S4 采购执行智能体完整需求卡示例（AGT-S4-001），作为《Ai-DOP 本体驱动智能体建设方案》第三章与 6.3 节的补充，是各域需求卡的填写标准与开发排期输入 |
| plan/Ai-DOP智能体建设任务计划.docx | 智能体建设任务计划（V1.0）：基于《Ai-DOP 本体驱动智能体建设方案》(7)(1) 的落地执行分解——阶段里程碑总表（P0~P4 共约 11 周 + 持续扩展）、按阶段 WBS 任务清单（T0.1~T4.3 共 24 项任务，含工作内容/交付物/前置依赖/工期/角色/验收口径）、九域需求卡补齐任务（对照 6.3 首要补齐项）、里程碑 M0~M4 与甘特时间线、关键路径与并行依赖、需求卡三硬闸门与证据规范、代码评审红线、风险任务化应对与跟踪汇报机制（生成脚本 _gen_agent_task_plan_docx.py） |
| plan/Ai-DOP本体驱动智能体建设方案_理解与解读.docx | 方案理解与解读（V1.0）：对 (7)(1) 方案文档的阅后理解——一句话理解与三层定位（战略/方案/任务）、四核心主张、十章逻辑主线表、关键概念地图（本体四要素/四类职能智能体/L0~L4/证据链/工具闸门/改善闭环，含与代码的对应）、核心设计逐点解读（零旁路增量选型、登记制本体、「四大目标—三大能力」对应、5.5~5.9 场景数据来源表）、就绪度与分阶段计划理解（瓶颈在规格文档不在代码）、总体评价四亮点与评审前四项注意点（长期记忆载体、S2/S7 缺失、术语表 S0~S10 笔误）（生成脚本 _gen_agent_plan_reading_docx.py） |
| Windows后端WinSW守护重启方案.md | Windows 服务器上使用 WinSW 守护后端服务、自动重启与日志落盘 |
| plan/S1/S1-订单管理-审批流程实施方案.md | S1 订单审批实施方案 |
| plan/S1-S3业务逻辑测试与数据准备方案.md | S1-S3 完整业务逻辑测试 case 与测试数据准备方案 |
| plan/S1-S4全局UAT场景测试数据生成方案.md | S1-S4 全局 UAT 场景测试数据主线，要求订单、工单、物料、采购、交货跨模块串联 |
| plan/S1/S1产销协同UAT测试数据抽取与导入方案.md | S1 UAT 场景化测试数据抽取范围、AIDOP 租户归属、导入顺序与验收 SQL |
| plan/S1/S1产销协同UAT候选数据清单与导入映射.md | S1 UAT 首批候选单号、场景化造数原则、目标表映射、批次标记与 SQL 草案 |
| plan/S1/S1产销协同UAT数据生成执行任务书.md | 给其它大模型或协作者执行 S1 UAT 数据生成的阶段任务、约束、确认点与验收标准 |
| plan/S2/S2制造协同UAT测试数据生成方案.md | S2 制造协同 UAT 测试数据包、工单排程、产线日历、日计划、看板与验收方向 |
| plan/S2/S2制造协同UAT数据生成执行任务书.md | 给其它大模型或协作者执行 S2 UAT 数据生成的阶段任务、约束、确认点与验收标准 |
| plan/S3/S3供应协同UAT测试数据生成方案.md | S3 供应协同 UAT 测试数据包、物料需求、交货计划、采购、委外外协与看板验收方向 |
| plan/S3/S3供应协同UAT数据生成执行任务书.md | 给其它大模型或协作者执行 S3 UAT 数据生成的阶段任务、约束、确认点与验收标准 |
| plan/S4/S4采购执行UAT测试数据生成方案.md | S4 采购执行 UAT 测试数据包，当前以测试报告驱动，覆盖交货、发货、退货、IQC 与欠料看板 |
| plan/S4/S4采购执行UAT数据生成执行任务书.md | 给其它大模型或协作者执行 S4 UAT 数据生成的阶段任务、约束、确认点与验收标准 |
| plan/S0-CodeFirst启动异常与BOM历史数据治理方案.md | S0 legacy BOM 表 CodeFirst 启动异常、根因与彻底治理步骤 |
| plan/当前系统针对标准和非标BOM的适用情况分析.md | 待讨论：标准 / MTO / 轻非标 / 真 ETO 对现有三轨 BOM 的适配结论；内部 UAT 见 UAT-INT-005 |
| plan/S0未走数据中台的问题.md | 待讨论：S0 与中台双向断（写出不进中台、入站不回灌、BOM 双轨）；内部 UAT 见 UAT-INT-006 |
| plan/AIDOP标准与非标双模BOM升级方案.md | 目标方案（最佳完整路径）：统一修订权威、标准/非标双模、三轨迁入摘除、中台闭环与 165 出站反向 |
| plan/第三方标准API推数入站方案.md | 方式丙终态：POST /api/mdp/inbound/{entityCode}（不带 /v1/）；五层（身份/契约/摄取/规范/发布）；UAT-INT-004 |
| plan/S8/S8数据库处理优化方案.md | S8 调度、检测日志、通知扫描与数据库写入压力优化方案 |
| plan/aidopdev_165库容量与增量写入分析_20260716.md | 165/aidopdev 库容量快照、Top 表、调度增量写入与治理建议（2026-07-16） |
| plan/165-aidopdev连接耗尽根治执行任务书.md | 可派发：2026-09-24/25 aidopdev 1040 根治（定时全量改跳过窗口+夜间串行、贴源批量、MySQL 护栏），含执行机数据库化指派与超管跨租户 ETL 管理页（包 B/G）。禁止把抬 max_connections 当交付 |
| plan/新系统数据库简明介绍与S1数据流.md | 新系统数据库简明说明，并以 S1 为例说明数据中台流转 |
| plan/Ai-DOP项目待办清单.md | 项目级待办统一入口（专题子文档见 §2 注册表） |
| plan/Ai-DOP剩余待办统一执行任务书_20260814.md | 可派发总任务书：基于 server 1.0.340 / Web 2.4.293 核对 P-001～P-037，将 29 个未完成项整理为 16 个代码包、8 个验收包、5 个决策/文档包；含依赖顺序、代码入口、步骤、验收、跨模块影响及新会话复制提示词 |
| plan/S1-S4业务功能测试结果汇总_20260712.md | S1–S4 API/E2E 测试结果（含样例单号、失败根因线索、原始 JSON 路径） |
| plan/数据中台方案复盘与未实现清单.md | 数据中台总体方案、S1-S3 当前进度、未实现事项和后续优先级复盘 |
| plan/租户隔离彻底修正执行任务书.md | 主执行任务书（进行中）：租户隔离问题的完整修正方案，分 4 批（公共解析器 / 止血 / 贴源根因 / 兜底值 / 种子脚本），含白名单、回归矩阵、数据清理与自检检索式。批次 0/1/2/4 主体已随 0da9ce11b（server 1.0.327）落地；剩余工作请执行下方收口任务书，勿重头再跑本书 |
| plan/租户隔离全量审计报告-20260810.md | 审计依据：租户号硬编码与缺过滤问题清单（写入侧写死 0 / 读取侧跨租户泄露 / 种子脚本硬编码三类），含实测污染数据 |
| plan/租户隔离收口与造数前置任务书.md | 可派发任务书（纯后端，含逐行 diff、16 个调用点清单与验收 SQL）：主任务书批次 0/1/2/4 随 0da9ce11b（server 1.0.327）落地后剩余的三项收口，是多租户造数的放行条件——WP-1 齐套刷新「先删后建、失败即空」+ 存储过程 30 秒超时（实测已致 dwd_material_readiness 丢失 20872 行；根因是 Step 1 全表删除多余，Step 2/3 已幂等）、WP-2 写入侧租户零兜底（MdpJsonSql 三方法 , 0) + 7 处内联，tenant_id=0 的唯一剩余产生源）、WP-3 派生层零值残渣清理（含 ado_s8_exception 42 行 tenant_id=1 待定归属）。含「已落地勿重做」「已核实非缺陷勿改」两份白名单——初版的「A 项：补齐跨租户 DELETE 租户条件」经核查不成立已撤销（那三处 DWD 构建本就是一次重建全部租户，删除与重建范围自洽），由此派生出 P6「DWD/KPI 必须全局刷新一次」的使用约束 |
| plan/MDP贴源层租户映射缺失修复任务书.md | |
| plan/旧DOP-MES-WMS/README.md | 旧 DOP·MES·WMS 梳理专题目录（含新 Ai-DOP 对接现状对照） |
| plan/旧DOP-MES-WMS/对接任务书/README.md | 新 Ai-DOP 对接 165 SQL Server（MES/WMS）总方案与任务书（执行须知 + WP1–WP8 + 手册操作覆盖矩阵；WP1/2/3/8 与 WP7 部分可派发执行） |
| plan/S2排产日计划回写165执行任务书.md | 可派发任务书：排产日计划经 Outbox 回写 165 PeriodSequenceDet，补齐 WP4 缺口，使 MES APP 在正常路径下可投产（含存过硬约束对照、payload 契约、验收 SQL） |
| plan/S2生产排程性能优化方案.md | 生产排程耗时 127 秒的根因实证（全库缺二级索引导致全表扫描，EXPLAIN ANALYZE 佐证）与最终目标架构（L1 索引体系 / L2 集合化 / L3 主键与并发正确性 / L4 异步任务化，含跨模块影响与验收口径） |
| plan/S2排程性能-L1索引体系执行任务书.md | 可派发任务书：上述方案 L1 层落地，补齐齐套检查/BOM 展开热点表的二级索引（含完整幂等 DDL 1.0.321.sql、执行计划与耗时验收口径、回滚 SQL）。纯 DDL，不改业务代码。已执行（server 1.0.321） |
| plan/S2排程正确性重构执行任务书.md | 可派发任务书：实证「当前生产排程并未在排产能」——工作日历全周 IsWorkDay=0 致产能分支从未执行，实际只按 OrdDate→DueDate 线性插值摊派工序日期。据此论证排产范围不应收敛到页面勾选（物料是全局竞争资源），给出冻结期 / 运行版本化 run_id / 占用可归属 / 异步任务化 / 真产能排期五根支柱与 A–G 九阶段执行细则。含产能主数据实证（ProdLineDetail 81 产线 5817 行 Rate 齐全，排程却读 WorkCtr 维度；同步把 Rate 错写进成本列 MachBdnRate）、G1 日历播种的完整幂等 DDL、「G1 不得先于 B 执行」的顺序硬约束、S1 交期产能计算同样因日历缺行而空转、休眠雷区（occupiedSlots 陈旧后漂、空值退化为全厂单槽）与验收 SQL |
| plan/S2排程算法正确性修复执行任务书.md | 可派发任务书：上一任务书 A–F 落地（server 1.0.322）后，真产能排期已生效并经公式复算验证（ZJ01 日产能 ⌈(10.5×60−80)/60×0.39⌉=4 件/天 → 965 件占 242 个工作日 → 后一张工单顺延至 2027-07-13）。据此审出 8 处算法缺陷：产能按日扣减却只写一行致占用无法回放（冻结期保护失效）、单工单重排与自身抢产能、工序先后用开工首日而非完工日、冻结工序不推进游标、366 天视界静默截断、产线无日历静默、超交期无信号、日产能向上取整偏乐观。给出 H1–H6 六阶段细则（含产能占用表 aidop_s2_line_capacity_occupy 完整 DDL、冻结占用结转、验收 SQL）与「迁移脚本必须 LF 行尾」的启动阻断实证 |
| plan/S2日计划回写165一致性修复执行任务书.md | 可派发任务书：上一任务书 H1–H6 落地后真人验收派生。排程算法本身无误，漏在「作废旧计划」的回写段——165 残留本库已作废的 IsActive=1 旧行，且后续重排永远修不回来（本库生效 41 行 vs 165 生效 44 行，僵尸行与 outbox 死信一一对应）。含三层取证：S2_PSD_UPSERT 101 条全成功而 S2_PSD_DEACTIVATE 失败 5 条（故漏的只是「作废」不是「写入」）、错误文案 未配置 API 与当前 TryResolve 路由代码相互矛盾（该源 source_type=DB，全仓仅一处调用 PushAsync，当前代码产生不出该文案）、失败行字段处于任何单一写入方都写不出的「不可能状态」（指向 TryEnqueueOrRefreshAsync 与 MarkAsync 并发整列覆盖；一旦落成 status=2 而 dispatcher 只扫 status=0，换了计划日即换 idem_key，死信永无人认领）。给出 I1–I5 五阶段（I1 只读取证优先、MarkAsync 乐观锁、按工单与 165 对账兜底补发、对账指标进 detail_json 并前端告警、存量清理）、V1–V7 验收与 A1–A6 可复制 SQL、改前基线快照、回滚表、「已核实事实速查表」；mdp_outbox 为 S1/领料/WMS 公用，含跨模块回归要求 |
| plan/S2优先级调整误写交期与计划作废修复执行任务书.md | 可派发任务书：P-028 §6.5 真人验收派生的两个 P0。① 「工单优先级调整」弹窗把只读的「订单日期」当交期提交，后端解析成 DueDate 落库 → 打开弹窗按一次保存就把交期无声改成订单日期，并连带触发单工单重排与 crm_seorderentry 同步（实证：交期 2026-09-05 → 2026-08-10）；② 纯改优先级走「只作废不重排」分支，本库置 IsActive=0 并向 165 入队作废，两库同时失去日计划、MES 当天取不到计划，恢复须全量重排（实证：生效行 3 → 0，全租户 41 → 38）。给出 A1/B1 方案取舍（预览补返 DueDate + 弹窗字段归位；纯改优先级改为不作废不重排、以 pendingReorder warning 提示）、J1–J4 改动清单（不改 DeactivateExistingScheduleAsync 本体，无 DDL）、V1–V6 验收与 A1–A5 可复制 SQL、存量污染排查口径（DueDate=OrdDate + 日志 detail_json.before.DueDate 可还原）、「先恢复数据再改代码」的顺序约束 |
| plan/Ai-DOP生产排程方案-对照优化.md | 对照 Asprova APS 排程方法论（KnowHow 001/002/004/012/015/019/020 等）与 DEMOMySql ProductionScheduleAppService.cs（瓶颈推断/设备数/换型插队/报工折算/自动下达），输出 AIDOP 排程增量优化 4.1–4.8（换型代价最小插队、准备时间实记录抵扣、报工折算剩余量、工序重叠时间、节假日日历、班制加班、模具维修约束、自动下达与 KPI 闭环），列出 DEMO 6 项确定性缺陷（B1–B6）与 7 项工程性问题（E1–E7）作为负面清单，并做反向影响推演与 P0–P3 优先级。纯文档方案，待评审。 |
| plan/旧系统MongoDB替代-待办清单.md | Mongo 替代专题待办明细（T-MONGO；入口见项目待办清单） |
| plan/动态运营详情看板与指标改善闭环方案.md | 动态运营详情看板、智慧诊断与改善闭环总体方案 |
| plan/ChatBI改善方案.md | ChatBI（FUNC-S9-007）改善方案：与看板/智慧诊断/改善计划分工、操作指引（how_to）、硬边界、P0–P2 分期与验收口径（2026-09-04） |
| plan/看板查询条件现状分析.md | 看板查询条件为何不影响 KPI、前后端数据流与改造方向 |
| plan/数据中台模块扩展指南-S1至S3经验版.md | 基于 S1-S3 经验的 S4-S8 数据中台、KPI 报表与看板扩展指南，含 Cursor 小步闭环任务模板 |
| plan/数据库迁移/S1/S1-任务交接记忆.md | S1 数据中台迁移跨会话交接（当前进度、阻塞、验收 SQL） |
| plan/数据库迁移/S1/S1数据中台迁移实施计划.md | S1 数据中台迁移主方案与分块步骤 |
| plan/数据库迁移/S2/S2数据中台与KPI扩展验收.md | S2 生产排程数据中台链路、KPI 写入与验收 SQL |
| plan/数据库迁移/S3/S3数据中台与看板动态化验收.md | S3 供应协同数据中台链路、看板动态化与验收 SQL |
| plan/数据中台模块扩展开发指南-S3范式.md | 数据中台扩展（仿 S3）：四库逻辑、作业与 Cursor 协作 |
| plan/UAT缺陷整治任务书/README.md | 可派发任务书集：2026-08-09 起真人 UAT 暴露缺陷的整治，拆为 4 个可独立交付的工作包——WP-A 死信告警任务修复（SqlSugar 私有字段）+ D-W01 归档、WP-B 库存新鲜度打通（齐套算料改读 165 实时库存）、WP-C 齐套两入口口径统一与结论不互相覆盖、WP-D 计划实绩合并（MES 影子计划行实绩回读与聚合）。含各包决策项、事实复核 SQL、验收判据与"明确不做"边界；D-W01 / D-M01 根因均在 165 存储过程内，受"不改 165"硬约束，只做我方侧适配与归档 |
| plan/UAT测试数据准备/README.md | 现行入口（2026-08-15）：三套最终交付目标——UATTEST_CHL 首批 5 组客户全链路 UAT、UATTEST_CHLB 从新租户初始态逐步点通、UATDEMO 稳定展示九宫格/智慧诊断/S8/ChartBI。实施中所有阻断缺陷和交付范围内缺失功能必须修复并回归 |
| plan/UAT测试数据准备/10-阻断问题修复与闭环机制.md | 三套准备过程的 P0–P3 分级、修复工作包门禁、禁止绕库、缺失功能判定与最终完成条件 |
| plan/UAT多租户数据方案/README.md | 2026-08-11 分析原稿（已由上方现行入口接续）：当时含 C 套；三套盘库、D1–D13、P0 阻断。勿在此目录继续追加执行内容 |
| plan/UAT多租户数据方案/逐表清单.md | 2026-08-11 三套逐表原稿（含 C 套对照） |
| db/mdp/README.md | S4/S8 相关 mdp、dwd 等建表脚本说明与执行顺序 |
| db/Ai-DOP智能体本体登记表结构设计.xlsx | 智能体方案配套表结构 Excel：《Ai-DOP 本体驱动智能体建设方案》第三章 4 张新建配置表（实体/关联/动作链/工具注册）的字段明细、公共审计字段与建议索引；含「试点种子数据」Sheet（5.5 节工单物料齐套四量问答用例的实体/关联/工具种子与落地三条件）与「场景示例库」Sheet（5.6~5.9 四场景清单、6 个新增工具注册种子、8 个实体/关联登记种子）（生成脚本 db/gen_agent_tables_excel.py） |
| 指标模型动态配置方案.md | 指标模型动态配置总体方案 |
| meeting/20260408/vue-tsc-既存类型错误说明.md | 前端类型问题说明 |
| feishu/MCP集成说明.md | 飞书云盘/在线文档 MCP 配置，供 Cursor Agent 读写飞书文档 |
| plan/S0-S2-报价与交付文档对比表.xlsx | S0–S2 报价单 vs 需求/蓝图 Excel 对比（含算法清单） |
| plan/S1/S1-报价与交付文档串联对比表.md | S1 单模块 Markdown 对比（与上表 S1 sheet 一致） |
| 交付文档综合要求.md | S0–S4 交付 Word（需求/蓝图）命名、版式、版本、REQ/FUNC 与工具链统一要求 |
指标模型（SmartOps）主设计仍在：ai-dop-platform/docs/db/smart_ops_data_model/README.txt。
变更记录
- 2026-10-23：新增 plan/Ai-DOP生产排程方案-对照优化.md：对照 Asprova APS 排程方法论（「了解 Asprova」KnowHow 系列 001/002/004/012/015/019/020）与 DEMOMySql
ProductionScheduleAppService.cs（DoProductSchedule/LineSchedule 瓶颈推断与设备数公式/换型插队/报工折算/自动下达）三层取证 AIDOP 排程现状，输出 4.1–4.8 八项增量优化建议与反向影响推演，列出 DEMO 6 项确定性缺陷与 7 项工程性问题作为实现负面清单，优化建议与现有 S2 执行任务书（正确性重构/算法正确性修复）衔接不重复。纯文档方案，待评审。 - 2026-10-23：新增 plan/Ai-DOP补货计划方案.md：提炼 Asprova APS 培训手册（基础篇/APS 篇）与行业解决方案（3/6）中的「自动补充生产」补货逻辑，形成适合 AIDOP 的补货计划方案（库存 MIN/目标库存 MIN/安全库存三层水位 + 批量参数 + 期间收集 + 需求优先级四级模型 + 补货预测表，推式 MRP 与拉式补货双引擎单出口复用 srm_pr_main/ic_demandschedule）。纯文档方案，待评审。
- 2026-10-23：新增 plan/Ai-DOP补货计划方案-对照优化.md：对照 DEMOMySql
ReplenishmentAppService.cs（SaveAnnualProductionOutline/CalcROP）解剖其正态分布 ROP 模型（SS=Φ⁻¹(服务水平)×σ、EOP、周转率上限、FMR/ABC 分类、回退链、滚动库存），输出 AIDOP 方案增量优化（动态 ROP 公式、σ 口径修正、ABC×FMR 服务水平闭环、月度滚动库存）并列出 DEMO 8 项确定性 bug 作为实现负面清单。纯文档方案，待评审。 - 2026-10-23：新增 plan/Ai-DOP补货计划方案-优化整合版.md：将对照优化建议逐条并入原方案的终态整合版（参数表一次性纳入 rop_mode/service_level/history_months/stock_turnover/target_mode 等列、动态 ROP 公式与补货量 max(EOP, ROP−库存) 修正、ABC×FMR 服务水平闭环、月度滚动库存与实绩回写、多级回退链），可直接作为实施基线阅读。纯文档方案，待评审。
- 2026-09-28：新增 plan/系统部署/ 目录，含《Ai-DOP 系统初始化配置指南》与新租户初始化脚本
init_new_tenant.py；同日新增 plan/推送凭据与租户基线修复执行任务书.md，记录编写指南期间取证发现的两个缺陷。 - 2026-09-25：新增 plan/165-aidopdev连接耗尽根治执行任务书.md，供其他模型按包 A–G 执行 1040 根治。同日修订：更正根因权重（多实例为次要因素，定时全量设计量级才是主因）；包 B 扩写为执行机注册/人工指派/领取过滤；新增包 G 超管跨租户 ETL 管理。
- 2026-09-06：重写 plan/第三方标准API推数入站方案.md 为五层终态（否定只贴源/另案回灌）；UAT-INT-004 待确认立项。
- 2026-09-06：新增 plan/AIDOP标准与非标双模BOM升级方案.md（标准/非标双模 + 三轨收口，非最小改动）。
- 2026-09-06：新增 plan/S0未走数据中台的问题.md；内部 UAT 待办增补
UAT-INT-006，并在UAT-INT-003/UAT-INT-005加交叉提示。 - 2026-09-06：新增 plan/当前系统针对标准和非标BOM的适用情况分析.md；内部 UAT 待办增补
UAT-INT-005。 - 2026-09-04：新增 plan/ChatBI改善方案.md；第三方对接指南与业务/技术详表（含 Word）归入
plan/系统集成/。 - 2026-04-16：根目录
docs/已合并至doc/（含doc/db/与根下方案文档），并增加本规范文件。