归档过时文档,立仓库根 CLAUDE.md 记最新状态

**归档四份**(docs/archive/,每份头部带归档说明与现行去向,另配 archive/README.md 索引):
  · MVP规格包-README.md(原 docs/README.md)—— 从零实现的启动包,MVP 已建成,
    启动提示词与里程碑纪律不再是现行指引;代码注释「README《归一化对照表》」等引用
    的各节原文保留,查历史语境仍来这里;
  · PROGRESS.md —— M0-M6 全部完成后停止维护,「下一步」多数已做完或被后续决策取代;
  · plan-2026-07-27-{mvp-foundation,three-surfaces}.md —— 两份已执行完毕的实施计划
    (三面形态此后又有演进:运营撤数据区、触发器与大模型独立成区)。
  语义源三份 html(操作系统/活动模型/MVP示例)不归档 —— 仍是 OS/AM 条款的出处,
  只是 flow 相关章节读作历史记述。

**新立 CLAUDE.md**(仓库根,每会话装载):现状快照(三面一体 · 编排层测死 · 范式退役
一律案例模型 · 无模型密钥时三套 e2e 跳过 · 下一件大事 = 按活动开发规范第 12 章销账)、
文档权威地图(活文档/语义源/前端权威/归档)、八条铁规矩(五闸以退出码验 · 契约四步 ·
§12.5 禁止清单 · mock 只在外界 · 密钥只从环境 · 试跑用 AI 账号测完清数据 ·
安装恒新增改必升版 · 界面不撒谎)、常用命令与结构速查。

五闸绿。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m

CLAUDE.md

@@ -0,0 +1,72 @@
+# JCAI-WOS —— 企业级 AI Native 任务操作系统
+
+> 一句话:组织的工作定义为可编排的工作流,工作流由**活动**编排而成;活动是完成一项任务的
+> Agent 机制,系统外开发、安装即用。人只在责任点与放行点出现 —— 确定交系统,临场交 AI,落地交人。
+
+## 现状快照(2026-07-30)
+
+- **三面一体**:设计中心 `/design`(九区:蓝图/触发器/流程包/活动库/工具箱/数据域/知识库/
+  大模型/测试台)· 运营中心 `/ops`(六区:驾驶舱/工作流/任务/员工/台账/系统)· 工作台 `/`。
+  `/gov` 302 → `/ops`。
+- **编排层与流程引擎已跑通并测死**:起单宽进(门口不拒缺项)、数据按字段名流动(无强制
+  类型)、边只表达顺序与条件(对齐 Mastra)、闭合校验只查结构闭合 + 活动装载、一条流恰一个
+  生效版本、在途按启动版本跑完、版本号与名归设计人员自己定。
+- **活动一律案例模型**(2026-07-29 范式退役):flow-engine 已删,业务模型只有
+  CMMN + 说明书 + DMN 一形;`turn-runner` 每拍要 `agent.decide` —— **环境无模型密钥时
+  案例活动一步走不动**,三套端到端(unified-quote-flow / new-package-flow / testbed-trace)
+  整套跳过,恢复条件写在各文件头。
+- **模型实例**:只留 `deepseek-v4-flash` / `deepseek-v4-pro` 两条;种子读不到
+  `JCAI_DEEPSEEK_API_KEY` 就**不绑密钥**(卡上如实显示不可用),去治理台大模型区补。
+- **下一件大事:实现活动与工具调用逻辑** —— 规范已写死在 `docs/活动开发规范.md`,
+  按其**第 12 章待实现清单**顺序销账(第一优先级:写类动作意向落地断链、工具未命中转人)。
+- 后端 19 模块 + 6 活动包 + 前端 features;五道门禁全绿(2026-07-30)。
+
+## 文档权威地图
+
+| 层 | 文件 | 说明 |
+|---|---|---|
+| **活文档**(冲突时以代码现状为准) | `docs/编码规范.md` | 工程结构权威:模块层级 L1-L8、依赖门禁、AI 协作协议 §12 |
+| | `docs/产品设计.md` | 三面一体的产品形态与决策记录 |
+| | `docs/活动开发规范.md` | **开发活动照这份**:基座六件、清单六区、工具声明式调用、验收放行、工作台视图逻辑;第 12 章 = 待实现清单 |
+| | `docs/debt.md` | 欠账台账(只增,销账划线) |
+| | `docs/adr/` · 各模块 `CONTRACT.md` | 架构决策与模块级不变量 |
+| 语义源(历史语境) | `docs/操作系统.html` `docs/活动模型.html` `docs/MVP示例工作流.html` | 两卷规范 + 业务样例;flow 相关章节为历史记述 |
+| 前端语义权威 | `~/coding/JCAI_PRD/workbench` `~/coding/JCAI_PRD/governance` | 原型 1:1 平移(只平移不 import);工作台视图逻辑以 `workbench/.../\_data/model.ts` 统一建模为准 |
+| 归档 | `docs/archive/` | 已完成使命的文档(旧 README 规格包、PROGRESS、旧计划),只读 |
+
+## 铁规矩(违者返工)
+
+1. **五道门禁以退出码验**,不许以 echo 验:`pnpm -s typecheck && pnpm -s lint &&
+   pnpm -s depcruise && pnpm -s api:check && pnpm -s test`(或 `pnpm gates`)。
+2. **契约变更四步**(§12.4):depcruise 反查下游 → 同步 CONTRACT.md →
+   `pnpm api:check --update && git add api-report` → 破坏性走三步弃用。
+3. **§12.5 禁止清单**:no `any` / `as unknown as` / `@ts-ignore`;domain 零 IO;
+   不删测试;不动门禁配置;不绕写三分/两缝。
+4. **mock 只许出现在外界**(邮件通道、外部系统的录制回放替身);系统内部机制不得 mock。
+5. **密钥只从环境读**:`JCAI_DEEPSEEK_API_KEY`(模型)、`JCAI_SEED_PASSWORD`(种子口令)、
+   `JCAI_SECRET_KEY`(凭证密封);不入源码、不入包、不入留痕;E2E 永不回退开发库。
+6. **试跑一律用 AI 账号**(密码 `jcai-dev-2026`),绝不派到用户工作台;测完
+   `pnpm --filter @app/api reset-runs` 清运行数据(清跑出来的,留配置好的)。
+7. **安装恒新增**:活动/工具改了内容必须升版本号,同版重装是 no-op(静默丢失,踩过)。
+8. **界面不撒谎**:状态如实(未绑就写未绑)、错误带厂商原话、不可用不摆假数字。
+
+## 常用命令
+
+```bash
+pnpm gates            # 五道门禁(gen:tiers → typecheck → lint → depcruise → api:check → test)
+pnpm db:up            # docker compose 起 PG16
+pnpm db:migrate       # 应用迁移(新迁移写 db/migrations/ 并登记 meta/_journal.json)
+pnpm db:seed          # 播种(五员工 + AI 账号;登录者 = 冯兵)
+pnpm dev:api          # :8787        pnpm dev:web   # :5173(/api 反代)
+pnpm --filter @app/api reset-runs   # 清运行数据,留配置
+```
+
+## 结构速查
+
+```
+apps/api/src/modules/<m>/{index,contract,port,CONTRACT.md,internal/{domain,usecase,adapter}}
+apps/api/src/app/          # 唯一组装层:container / wiring/engines / routes / workers / seed
+apps/web/src/features/     # desk-*(工作台)· gov-*(设计+运营)· auth
+packages/{contracts,activity-sdk,sfeel,ui-kit,testing}
+activities/<id>/src/{index,manifest,case-model,skills,views/}   # 活动包(只准 import @sdk/@contracts)
+```

docs/archive/MVP规格包-README.md

@@ -1,3 +1,10 @@
+> **⚠️ 已归档(2026-07-30)** —— 这是 2026-07-26 交给编码 Agent 的**从零实现启动包**,
+> MVP 已建成,启动提示词与里程碑纪律不再是现行指引;「归一化对照表」里的 flow/loop 两分
+> 已随 2026-07-29 范式退役成为历史记述。代码注释里引用的「README《归一化对照表》
+> 《已裁定的落地决策》《种子数据》《MVP 完成判据》《前端 UI · 原型 1:1 平移》」各节
+> 仍指本文,查历史语境时来这里。现行状态看仓库根 `CLAUDE.md`;现行规范看
+> `docs/编码规范.md` / `docs/产品设计.md` / `docs/活动开发规范.md`。
+
 # JCAI 任务操作系统 · MVP 规格包
 
 这个目录是「企业级 AI Native 任务操作系统」的**完整规格包**：两卷语义规范 + 一份工程结构契约 +

docs/archive/PROGRESS.md

@@ -1,3 +1,7 @@
+> **⚠️ 已归档(2026-07-30)** —— M0–M6 里程碑全部完成后本表停止维护;
+> 「下一步」「已知待办」两节是当时的快照,多数已做完或已被后续决策取代。
+> 现行状态看仓库根 `CLAUDE.md`;在办的账看 `docs/debt.md` 与 `docs/活动开发规范.md` 第 12 章。
+
 # 实施进度(主 Agent 维护)
 
 > 里程碑序见 编码规范 §15。每个里程碑先立骨架(index / contract / port / CONTRACT.md + 空测试)

docs/archive/README.md

@@ -0,0 +1,12 @@
+# docs/archive —— 已归档文档
+
+完成使命或被后续决策取代的文档收在这里,**只读不再维护**;每份文件头部有归档说明与现行去向。
+
+| 文件 | 曾是什么 | 归档原因 |
+|---|---|---|
+| `MVP规格包-README.md` | 从零实现 MVP 的启动包(启动提示词 / 归一化对照表 / 已裁定决策 / 平移规则) | MVP 已建成;flow/loop 两分随范式退役成历史。代码注释「README《…》」引用的各节仍在此文 |
+| `PROGRESS.md` | M0–M6 里程碑进度表 | 全部完成,停止维护 |
+| `plan-2026-07-27-mvp-foundation.md` | MVP 底座实施计划 | 已执行完毕 |
+| `plan-2026-07-27-three-surfaces.md` | 三面拆分实施计划 | 已执行完毕,形态此后又有演进 |
+
+现行文档地图见仓库根 `CLAUDE.md`。

docs/archive/plan-2026-07-27-mvp-foundation.md

@@ -1,3 +1,5 @@
+> **⚠️ 已归档(2026-07-30)** —— MVP 底座计划,已执行完毕。现行状态看仓库根 `CLAUDE.md`。
+
 # MVP 底座(四域数据 · 1:1 流程包 · 三类工具 · 卡片设计台)实施计划
 
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

docs/archive/plan-2026-07-27-three-surfaces.md

@@ -1,3 +1,6 @@
+> **⚠️ 已归档(2026-07-30)** —— 三面拆分计划,已执行完毕(拆分后又有演进:
+> 运营中心撤「数据」区成六区、触发器与大模型独立成区)。现行形态看 `docs/产品设计.md`。
+
 # 三面一体(设计中心 / 运营中心 / 工作台)实施计划
 
 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.