docs(plan): 回写 A3 标准完成状态（WBS 状态列 + 最终验收）

按 A1 的完成状态格式补齐 A3 §6.4：新增执行状态说明、WBS 表状态列并逐项标 ✅；完成日期更新为 2026-11-04 最终验收。仅文档变更。
docs(ci): 明确 CI 仅本地执行，远端 Gitea 不启用 CI
2026-11-04 09:37:24 +08:00 · 2026-11-04 08:15:06 +08:00
7 changed files with 39 additions and 31 deletions
@@ -1,8 +1,8 @@
 # 远端 Gitea 未部署 Actions runner：本工作流不随 push 触发，仅供本地参考 / 手动触发。
 # 本地等价命令：pnpm ci:local（推送前必须全绿）。
 name: ci
 on:
  push:
    branches: [main]
  workflow_dispatch:
 concurrency:
@@ -114,7 +114,7 @@ docs/           PRD / 技术架构 / 立项建议 / 工程规范
 | 开发 | `pnpm dev` |
 | 构建 | `pnpm build` |
 | 质量 | `pnpm lint` · `pnpm lint:fix` · `pnpm format` · `pnpm format:check` · `pnpm typecheck` |
-| 测试 | `pnpm test` · `pnpm test:int` · `pnpm test:e2e` · `pnpm ci:local` |
+| 测试 | `pnpm test` · `pnpm test:int` · `pnpm test:e2e` · `pnpm ci:local`（CI 只本地执行，远端无 runner） |
 | 数据库 | `pnpm db:init`（迁移 + 幂等种子，不重置数据）· `pnpm db:migrate` · `pnpm db:reset`（清库重建；默认被拦截，必须 `ALLOW_DB_RESET=1` 显式确认；禁止手工删库 / 删数据卷） |
 | 契约 | `pnpm openapi:diff` |
@@ -127,7 +127,7 @@ docs/           PRD / 技术架构 / 立项建议 / 工程规范
 1. 基于最新 `main` 直接提交，小步 commit（**Conventional Commits，提交信息一律用中文**，`type` / `scope` 保留英文）。
 2. 本地门禁：`pnpm format:check && pnpm lint && pnpm typecheck && pnpm test`。
 3. 提交说明必含：**背景 / 改动 / 影响面 / 回滚方式 / 验证证据**；迁移、权限、AI、导出类变更须在推送前完成双人走查。
-4. 直接 `git push origin main`；禁止 force push `main`，禁止 Merge commit；推送后立即确认 CI，失败按前向修复处理。
+4. 直接 `git push origin main`；禁止 force push `main`，禁止 Merge commit。**远端 Gitea 未部署 Actions runner，线上 CI 不可用，禁止等待/依赖远端 CI**；CI 一律在推送前本地执行（`pnpm ci:local`），本地门禁全绿才能推送。
 5. 发布：staging 验证 → 生产灰度；**迁移先行、代码后行**。
 细则：[Git 规范](docs/工程规范/01-Git规范.md) · [Code Review](docs/工程规范/07-CodeReview与PR规范.md) · [测试与 CI](docs/工程规范/06-测试与CI规范.md)
@@ -154,7 +154,7 @@ docs/           PRD / 技术架构 / 立项建议 / 工程规范
 | API 与路由 | [04-API与路由规范](docs/工程规范/04-API与路由规范.md) | REST /api/v1、错误码、鉴权链、任务协议 |
 | 数据库 | [05-数据库规范](docs/工程规范/05-数据库规范.md) | ULID、customer_id、游标分页、expand/contract |
 | 测试与 CI | [06-测试与CI规范](docs/工程规范/06-测试与CI规范.md) | 分层测试、权限三态、覆盖率只升不降 |
-| Code Review | [07-CodeReview与PR规范](docs/工程规范/07-CodeReview与PR规范.md) | 提交说明、双人场景、DoD、推送后观察 |
+| Code Review | [07-CodeReview与PR规范](docs/工程规范/07-CodeReview与PR规范.md) | 提交说明、双人场景、DoD、本地 CI 后推送 |
 | 日志与可观测 | [08-日志与可观测性规范](docs/工程规范/08-日志与可观测性规范.md) | Pino 字段、trace_id、审计与日志分离、告警 |
 | 环境变量与密钥 | [09-环境变量与密钥规范](docs/工程规范/09-环境变量与密钥规范.md) | `.env.example` 入库、启动校验、轮换与泄露处置 |
 | 资产命名与图层 | [10-资产命名与PSD图层规范](docs/工程规范/10-资产命名与PSD图层规范.md) | 命名占位符、PSD 图层前缀、规格矩阵、低质量标记 |
@@ -119,7 +119,7 @@ pnpm openapi:export && pnpm openapi:diff   # 契约快照与破坏性变更检
 pnpm ci:local                              # 本地跑完整 CI 门禁（已内置 e2e 所需 env）
 ```
-> Gitea 暂未部署 Actions runner，推送后远程 CI 会停留在 queued；当前以 `pnpm ci:local` 为准，runner 就绪后 `.gitea/workflows/ci.yml` 会自动接管。
+> **远端 Gitea 未部署 Actions runner，线上 CI 不可用**。所有 CI 一律在本地执行：推送前跑 `pnpm ci:local`（或至少 `format:check + lint + typecheck + test`）。`.gitea/workflows/ci.yml` 仅作本地流水线参考 / 手动触发，**不随 push 自动运行**。
 命令与门禁见 [AGENTS.md §6](AGENTS.md) 与 [06-测试与CI规范](docs/工程规范/06-测试与CI规范.md)。当前 UI 采用「顶部模块菜单 + 左侧功能菜单」布局，视觉方向为 **A · 云白蓝（传统企业后台 + 现代浅色质感）**。
@@ -21,7 +21,7 @@
 - `GIT-01` 所有提交直接基于最新 `main`；提交前先 `git pull --ff-only`，避免落后。
 - `GIT-02` 禁止创建并推送任何非 `main` 分支；确需本地验证时可临时创建，但不得推送，完成后立即删除。
- `GIT-03` 允许直接 push `main`；推送前必须通过本地门禁（`format:check`、`lint`、`typecheck`、`test`），推送后立即确认 CI。
+- `GIT-03` 允许直接 push `main`；推送前必须通过本地门禁（`format:check`、`lint`、`typecheck`、`test`，完整链路用 `pnpm ci:local`）。**远端 Gitea 未部署 runner，线上 CI 不可用，推送后不等待远端 CI**。
 - `GIT-04` 禁止 force push `main`；禁止 Merge commit；`main` 必须保持线性。
 ## 2　提交信息（Conventional Commits 1.0）
@@ -134,4 +134,4 @@ export default {
 - [ ] 提交粒度单一，无无关文件
 - [ ] 无 `.env` / 密钥 / 大文件
 - [ ] 提交说明含背景 / 影响面 / 回滚方式 / 验证证据
- [ ] 本地门禁全绿，已 push `main` 并确认 CI
+- [ ] 本地门禁全绿（必要时 `pnpm ci:local`），已 push `main`；远端无 CI，无需等待
@@ -2,10 +2,11 @@
 | 项 | 内容 |
 | --- | --- |
-| 文档版本 | V1.0（2026-11-02） |
+| 文档版本 | V1.1（2026-11-04） |
 | 依据 | 技术架构 §10.4（测试策略）、§4.6（CI/CD）、§4.1.1（本地环境） |
 | 适用范围 | 全仓库 |
 | 强制级别 | 强制 |
 | 远端 CI | **不启用**：Gitea 无 runner，CI 只本地执行 |
 ---
@@ -14,15 +15,15 @@
 | 层级 | 工具 | 范围 | 运行时机 |
 | --- | --- | --- | --- |
 | 单元 | Vitest | Service、工具函数、状态机、命名 / 表单引擎 | 每次提交（CI + 本地） |
-| 集成 | Vitest + Testcontainers（PG 18 / Redis 7.4 / MinIO） | Repository、队列、迁移、事务 | 每次 push `main`（CI） |
+| 集成 | Vitest + Testcontainers（PG 18 / Redis 7.4 / MinIO） | Repository、队列、迁移、事务 | 每次推送前本地 `pnpm ci:local` |
-| 契约 | OpenAPI + `oasdiff` | 接口兼容性 | 每次 push `main` |
+| 契约 | OpenAPI + `oasdiff` | 接口兼容性 | 每次推送前本地 `pnpm ci:local` |
 | E2E | Playwright | 主链路（登录 → 生成 → 预览 → 勾选 → 导出） | 主干 + 发布前 |
 | 性能 | k6 | 列表 / 任务提交 / SSE | 发布前（仅 staging） |
 | 视觉回归 | 图片像素比对 | PSD 合成产物 | 改动 `packages/render` 时 |
 - `TST-01` 单测与源码同目录，命名 `<name>.spec.ts`；集成 `*.int.spec.ts`；E2E 放 `e2e/`。
 - `TST-02` 关键包（`shared` / `form-engine` / `render` / `ai-sdk`）行覆盖率 **≥ 70%**；整体基线只升不降。
- `TST-03` 禁止提交 `.skip` / `.only`；CI 检测到即失败。
+- `TST-03` 禁止提交 `.skip` / `.only`；本地 `pnpm ci:local` 检测到即失败。
 - `TST-04` 禁止依赖执行顺序；每个测试自建数据、自清理（用独立 `customer_id` 前缀）。
 ---
@@ -46,7 +47,7 @@
 ## 3　测试数据与环境
- `TST-15` 禁止连接生产库 / 生产对象存储；CI 用 Testcontainers 起同版本依赖。
+- `TST-15` 禁止连接生产库 / 生产对象存储；本地 CI 用 Testcontainers / 本地容器起同版本依赖。
 - `TST-16` 测试数据用 factory 构造，禁止依赖线上导出数据。
 - `TST-17` 测试内置时钟可注入（`clock` 包），禁止 `new Date()` 直接断言时间。
 - `TST-18` AI 调用在测试中一律 mock Provider，**禁止**真实外网调用（防止费用与不稳定）。
@@ -54,7 +55,7 @@
 ---
-## 4　CI 流水线
+## 4　本地 CI 流水线（远端不跑 CI）
 ```
 install --frozen-lockfile
@@ -64,6 +65,11 @@ install --frozen-lockfile
  → e2e（main）→ 镜像构建 + 漏洞扫描
 ```
 > **强制规则（2026-11-04 确认）**：远端自建 Gitea **未部署 Actions runner，线上 CI 不可用**。所有 CI 一律在本地执行：
 > - 推送前运行 `pnpm ci:local`（完整链路）或至少 `pnpm format:check && pnpm lint && pnpm typecheck && pnpm test`；
 > - `.gitea/workflows/ci.yml` 仅供本地参考 / 手动触发，**不随 push 自动运行**；
 > - 禁止在推送后等待远端 CI、禁止以「远端 CI 会在后续跑」为由跳过本地门禁。
 | 阶段 | 阻断条件 |
 | --- | --- |
 | 安装 | lock 文件与 `package.json` 不一致 |
@@ -114,7 +120,7 @@ staging 部署 → 冒烟（登录 / 生成 / 预览 / 导出）
 - [ ] 端点有权限三态用例，客户隔离用例存在
 - [ ] 状态机非法迁移、幂等、成本前置已覆盖
 - [ ] 集成测试用 Testcontainers，无外网依赖
- [ ] CI 全绿且未使用豁免
+- [ ] 本地 `pnpm ci:local` 全绿且未使用豁免（远端无 runner）
 - [ ] 迁移可回滚，staging 已演练
 - [ ] 未完成功能藏开关，开关有清理期限
 - [ ] 发布记录与回滚预案已写
@@ -101,7 +101,7 @@
 同时满足才可推送：
-1. 本地门禁全绿；推送后 CI 全绿（含契约与集成），无豁免。
+1. 本地门禁全绿（含契约与集成，必要时 `pnpm ci:local`）；远端 Gitea 无 runner，不等待线上 CI，无豁免。
 2. Review 通过，blocking 意见全部解决。
 3. 文档同步：PRD 规则编号、技术架构、OpenAPI、本目录细则（如涉及）。
 4. 迁移可回滚，或在描述说明为何不可回滚与前向修复方案。
@@ -113,7 +113,7 @@
 ## 5　推送与推送后
 - `CR-08` 推送前完成本地门禁（`format:check` / `lint` / `typecheck` / `test`）；推送即进入主干，不再有 Squash 合并环节。
- `CR-09` 直接 `git push origin main`；禁止 force push、禁止 Merge commit；推送后 15 分钟内确认 CI 与错误率。
+- `CR-09` 直接 `git push origin main`；禁止 force push、禁止 Merge commit；推送前确认 `pnpm ci:local` 全绿，推送后不等待远端 CI（远端无 runner）。
 - `CR-10` 推送后发现缺陷：优先以新提交前向修复；影响面大时按回滚预案执行（回滚也用新提交，不回写历史），并补一次复盘（写 `docs/releases/` 或 issue）。
 - `CR-11` 禁止「先推后补测试 / 补文档」作为常态；紧急修复须 24 小时内以新提交补齐，并在提交说明记录。
@@ -10,7 +10,7 @@
 | 文档名称 | 灵犀 · 信息流素材生产平台 项目开发计划 |
 | 版本 | V0.1（初稿，待评审） |
 | 日期 | 2026-11-02 |
-| 状态 | **执行中**：A0 工程骨架与契约基线已完成（2026-11-02）；A1 身份认证与用户管理已完成（2026-11-03）；A2 角色权限与数据范围已完成（2026-11-03）；A3 客户与行业目录已完成（2026-11-03）；下一步 A4 |
+| 状态 | **执行中**：A0 工程骨架与契约基线已完成（2026-11-02）；A1 身份认证与用户管理已完成（2026-11-03）；A2 角色权限与数据范围已完成（2026-11-03）；A3 客户与行业目录已完成（2026-11-04 最终验收）；下一步 A4 |
 | 需求基线 | PRD V1.6（[灵犀-信息流广告素材一站式生产平台PRD.md](../PRD/灵犀-信息流广告素材一站式生产平台PRD.md)） |
 | 技术基线 | 技术架构 V0.4（[灵犀_信息流素材生产平台_技术架构_V0.1.md](../技术架构/灵犀_信息流素材生产平台_技术架构_V0.1.md)）+ `AGENTS.md` V1.0 + `docs/工程规范/` V1.0 |
 | 覆盖范围 | **M0 任务级；M1–M4 迭代级 + 任务组级；M5 预研边界（不排期）** |
@@ -572,24 +572,26 @@ PRD §7 把 **M-27（素材元素级拆解）** 与「自动字幕 → TTS 配
 ### 6.4　A3 客户与行业目录
 > **执行状态：✅ 已完成（2026-11-03 开发完成，2026-11-04 UI 对齐 / 本地 CI 最终验收）**。以下 9 项 WBS 全部交付并实测；实现记录、验收证据与遗留见 [A3 实施报告](./灵犀_A3客户与行业目录_实施报告_V0.1.md)。
 **目标**：行业 / 客户 / 客户组 / 客户字段四件事立住，作为全部资产的根节点。**对应**：P-04 / P-05 / P-17、PRD §5.4.2 / §5.4.9；`R-20` / `R-04`；架构 §6.3.2。
-| 编号 | 任务 | 端 | 内容与产出 | 依赖 | 验收要点 | EPD |
+| 编号 | 任务 | 端 | 内容与产出 | 依赖 | 验收要点 | EPD | 状态 |
-| --- | --- | --- | --- | --- | --- | --- |
+| --- | --- | --- | --- | --- | --- | --- | --- |
-| A3-BE-01 | 行业目录（两级） | BE | `industries`；一级 → 二级最多两级；一级名称全局唯一、二级同父唯一；客户只挂末级行业；删除前校验无子行业 / 客户 / 资产，否则只能停用；有启用子行业时禁止停用 | A2-BE-04 | 重名 40902；有子行业 / 客户时删除被拒；有启用子行业停用被拒；停用后新建客户不可选 | 0.5 |
+| A3-BE-01 | 行业目录（两级） | BE | `industries`；一级 → 二级最多两级；一级名称全局唯一、二级同父唯一；客户只挂末级行业；删除前校验无子行业 / 客户 / 资产，否则只能停用；有启用子行业时禁止停用 | A2-BE-04 | 重名 40902；有子行业 / 客户时删除被拒；有启用子行业停用被拒；停用后新建客户不可选 | 0.5 | ✅ |
-| A3-BE-02 | 客户档案与状态机 | BE | `customers`；简称必填、`(industry_id, name)` 唯一；服务状态（在服务 / 暂停 / 结束）；负责人 / 对接人；交付偏好；套用行业资产包入口 | A3-BE-01 | 简称缺失 42201；暂停只读、不能发起新任务；结束全只读 | 1.0 |
+| A3-BE-02 | 客户档案与状态机 | BE | `customers`；简称必填、`(industry_id, name)` 唯一；服务状态（在服务 / 暂停 / 结束）；负责人 / 对接人；交付偏好；套用行业资产包入口 | A3-BE-01 | 简称缺失 42201；暂停只读、不能发起新任务；结束全只读 | 1.0 | ✅ |
-| A3-BE-03 | 客户组 | BE | `customer_groups` + `customer_group_members`；客户组作为授权与数据范围最小单位 | A3-BE-02 | 成员增删幂等；数据范围引用客户组后可见集合正确 | 0.5 |
+| A3-BE-03 | 客户组 | BE | `customer_groups` + `customer_group_members`；客户组作为授权与数据范围最小单位 | A3-BE-02 | 成员增删幂等；数据范围引用客户组后可见集合正确 | 0.5 | ✅ |
-| A3-BE-04 | 客户级字段申请与审批 | BE | `customer_fields`；申请（定义 + 用途 + 是否进入生成）→ 审批 → 生效；每客户 ≤ 5 个进入生成字段、基础字段 ≤ 10 | A3-BE-02 | 超限 40001（字段校验失败）；未审批字段不进入生成；审批与变更进审计 | 1.0 |
+| A3-BE-04 | 客户级字段申请与审批 | BE | `customer_fields`；申请（定义 + 用途 + 是否进入生成）→ 审批 → 生效；每客户 ≤ 5 个进入生成字段、基础字段 ≤ 10 | A3-BE-02 | 超限 40001（字段校验失败）；未审批字段不进入生成；审批与变更进审计 | 1.0 | ✅ |
-| A3-BE-05 | 客户上下文与归属校验 | BE | 客户上下文中间件；资产 / 任务归属校验函数；跨客户访问统一 404（不暴露存在性） | A2-BE-04、A3-BE-02 | 跨客户访问返回 40401；所有查询带 `customer_id` | 0.5 |
+| A3-BE-05 | 客户上下文与归属校验 | BE | 客户上下文中间件；资产 / 任务归属校验函数；跨客户访问统一 404（不暴露存在性） | A2-BE-04、A3-BE-02 | 跨客户访问返回 40401；所有查询带 `customer_id` | 0.5 | ✅ |
-| A3-FE-01 | 行业管理页 | FE | 行业列表 / 新建 / 编辑 / 停用；删除前引用提示 | A0-FE-02 | 重名与有客户时的错误可读；停用状态清晰 | 0.5 |
+| A3-FE-01 | 行业管理页 | FE | 行业列表 / 新建 / 编辑 / 停用；删除前引用提示 | A0-FE-02 | 重名与有客户时的错误可读；停用状态清晰 | 0.5 | ✅ |
-| A3-FE-02 | 客户列表与档案 | FE | 列表（行业 / 状态 / 负责人筛选）、详情、分步新建（行业 → 基础信息 → 交付偏好 → 资产包）、简称必填校验 | A3-FE-01 | 分步表单可回退；暂停 / 结束状态只读并提示 | 1.5 |
+| A3-FE-02 | 客户列表与档案 | FE | 列表（行业 / 状态 / 负责人筛选）、详情、分步新建（行业 → 基础信息 → 交付偏好 → 资产包）、简称必填校验 | A3-FE-01 | 分步表单可回退；暂停 / 结束状态只读并提示 | 1.5 | ✅ |
-| A3-FE-03 | 客户组管理 | FE | 客户组列表、成员批量添加 / 移除、按客户组授权提示 | A3-FE-02 | 批量操作有确认与结果反馈 | 0.5 |
+| A3-FE-03 | 客户组管理 | FE | 客户组列表、成员批量添加 / 移除、按客户组授权提示 | A3-FE-02 | 批量操作有确认与结果反馈 | 0.5 | ✅ |
-| A3-FE-04 | 字段申请与审批 | FE | 字段定义表单、用途说明、是否进入生成、审批列表、超限提示 | A3-FE-02 | 申请 / 审批状态可追踪；超限给出明确文案 | 0.5 |
+| A3-FE-04 | 字段申请与审批 | FE | 字段定义表单、用途说明、是否进入生成、审批列表、超限提示 | A3-FE-02 | 申请 / 审批状态可追踪；超限给出明确文案 | 0.5 | ✅ |
-| A3-QA-01 | 唯一性 / 状态 / 范围用例 | QA | 行业与客户唯一性、状态只读、跨客户越权、字段上限 | A3-BE-05 | 用例全绿；越权访问有审计 | 0.5 |
+| A3-QA-01 | 唯一性 / 状态 / 范围用例 | QA | 行业与客户唯一性、状态只读、跨客户越权、字段上限 | A3-BE-05 | 用例全绿；越权访问有审计 | 0.5 | ✅ |
 **本批门禁**：可建行业 → 客户 → 客户组；唯一性与状态机生效；客户字段审批可用；所有查询带客户维度。
-> **A3 完成情况（2026-11-03）**：9/9 项 WBS 通过。两级行业树（ADR-002）、客户档案与状态机、客户组、客户级字段双层与审批、客户转交、真实 `CustomerDirectory`、客户上下文与跨客户 404 全部落地；前端按用户选定混搭实现（行业 B / 客户列表 A / 客户详情 A / 新建 B / 客户组 B / 字段 A），侧栏更名「客户管理」「行业管理」并新增「客户组」。门禁：`format:check / lint / typecheck / test` 全绿（shared 131 / api 90 / web 125，共 346），`test:int` 39 项（5 文件，含 A3 client 6 条），A3 浏览器 e2e 1/1（11.6s），`build` 8/8；实现记录、截图与遗留见 [A3 实施报告](./灵犀_A3客户与行业目录_实施报告_V0.1.md)。已知遗留：B0 行业资产包套用、A5 审计落库、A4 字段上限配置、客户详情面包屑末级名称。
+> **A3 完成情况（2026-11-03 开发完成 / 2026-11-04 最终验收）**：9/9 项 WBS 全部 ✅。两级行业树（ADR-002）、客户档案与状态机、客户组、客户级字段双层与审批、客户转交、真实 `CustomerDirectory`、客户上下文与跨客户 404 全部落地；前端按用户选定混搭实现（行业 B / 客户列表 A / 客户详情 A / 新建 B / 客户组 B / 字段 A），侧栏更名「客户管理」「行业管理」并新增「客户组」。门禁：`format:check / lint / typecheck / test` 全绿（shared 131 / api 90 / web 125，共 346），`test:int` 39 项（5 文件，含 A3 client 6 条），A3 浏览器 e2e 1/1（11.6s），`build` 8/8；实现记录、截图与遗留见 [A3 实施报告](./灵犀_A3客户与行业目录_实施报告_V0.1.md)。已知遗留：B0 行业资产包套用、A5 审计落库、A4 字段上限配置、客户详情面包屑末级名称。
 ### 6.5　A4 数据字典与系统配置