skygu 863b935b1c docs(kpi): 指标模型动态配置方案补档 Phase 5/6/7 + 扩充后续待办 + bump 2.4.89/1.0.56		1 月之前
..
db	379511be62 chore: consolidate docs into doc, add doc/README conventions (Web 2.4.77 / API 1.0.44)	1 月之前
img	701f395cf8 docs(S1): add approval flow plan v2.0 + KPI doc (Web 2.4.47 / API 1.0.11)	1 月之前
meeting	db93958d60 B3前后端开发&单元测试	1 月之前
migrations	3fb1a08cdd chore: add s8 verification fields migration	1 月之前
plan	e39e28df9d docs(approval): 登记 P5-18 APP 端对接占位 + bump 2.4.86 / 1.0.53	1 月之前
plans	81ebc0efa6 feat: complete s8 configurable monitoring setup	1 月之前
shop	c62c03c96d chore: checkpoint backup 2026-04-06 — version 2.4.35 / 1.0.2, rules, smart_ops docs, sync tracked tree	1 月之前
README.md	379511be62 chore: consolidate docs into doc, add doc/README conventions (Web 2.4.77 / API 1.0.44)	1 月之前
S8异常协同-审批流集成功能说明.md	82bcfd9616 feat(approvalFlow): P4-17 Handler 回调扩展 + P4-16 多通道通知推送首版	1 月之前
审批流功能说明.md	ec2bf8fabf feat(approval): P2-12 核心三页移动端适配 + P4-16 延伸（通知模板化/渠道管理页）	1 月之前
审批流集成开发指南.md	ec2bf8fabf feat(approval): P2-12 核心三页移动端适配 + P4-16 延伸（通知模板化/渠道管理页）	1 月之前
指标模型动态配置方案.md	863b935b1c docs(kpi): 指标模型动态配置方案补档 Phase 5/6/7 + 扩充后续待办 + bump 2.4.89/1.0.56	1 月之前

文档目录说明（`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/meeting/`	会议纪要、评审记录、过程性附件
`doc/db/`	与主库相关的表结构导出、生成脚本（如 Excel、Python）
`doc/` 根下	跨模块的功能说明、集成指南等独立 Markdown（命名建议见下）
`doc/img/`、`doc/shop/` 等	文档用图片、截图等资源（保持现有结构即可）

命名与格式

语言：面向团队的说明以中文为主；需对外或开源时再提供英文版可复制路径。
文件名：使用可读中文或 模块-主题.md，避免无意义缩写；审批流相关已约定：
- 审批流功能说明.md — 用户/产品视角功能清单
- 审批流集成开发指南.md — 开发接入步骤与 API
新增文档：优先放入上表对应子目录；若无合适子目录，放在 doc/ 根并在本 README「文档索引」中补一行（或后续集中整理到子目录）。
大附件：二进制、Excel、SQL 体积较大时，可放在 doc/db/ 或专题子目录，不要把生成物硬编码为机器绝对路径；脚本输出宜相对脚本目录（参见 doc/db/gen_table_excel.py）。

文档索引（维护中）

文档	说明
审批流功能说明.md	审批流菜单、审批中心、设计器、通知与权限
审批流集成开发指南.md	`IFlowBizHandler`、`ApprovalPanel`、配置与 API
plan/S1/S1-订单管理-审批流程实施方案.md	S1 订单审批实施方案
指标模型动态配置方案.md	指标模型动态配置总体方案
meeting/20260408/vue-tsc-既存类型错误说明.md	前端类型问题说明

指标模型（SmartOps）主设计仍在：ai-dop-platform/docs/db/smart_ops_data_model/README.txt。

变更记录

2026-04-16：根目录 docs/ 已合并至 doc/（含 doc/db/ 与根下方案文档），并增加本规范文件。