tangweijie/fujian_water_biz_doc
1
0
Fork 0
Code Issues Pull Requests 12 Actions Packages Projects Releases 1 Wiki Activity
fujian_water_biz_doc/specs/011-frontend-speckit-alignment/plan.md

8.4 KiB
Raw Permalink Blame History

Implementation Plan: 前端 Speckit 协作对齐

Branch: [011-frontend-speckit-alignment] | Date: 2026-03-24 | Spec: spec.md Input: Feature specification from /specs/011-frontend-speckit-alignment/spec.md

Note: This template is filled in by the /speckit.plan command. For this project, planning is document-first and multi-repo aware.

Summary

本 feature 的目标是在保持 water-docs 为正式 Speckit 单一真源的前提下，补齐 water-frontend 侧的协作入口、独立模板规范与实际样例索引，使代理和实现人员可以：

  • 从前端仓稳定回指 water-docs/specs/<feature>/spec.md、plan.md、tasks.md
  • 基于统一模板规范判断页面语义、目录结构与权限接入边界
  • 基于真实页面样例索引快速选择可复用的母板页
  • 对权限来源、数据权限、列可见配置、BPM 字段权限与普通业务表单字段权限边界形成可追溯结论

本轮计划以文档与证据闭环为主，不新增业务代码生成器，不改造后端权限模型。

Repository Scope

  • Formal workflow home: water-docs
  • Target repos in scope:
    • water-docs: Yes
    • water-backend: No
    • water-frontend: Yes
  • Primary delivery mode: Mixed

Code Baseline

  • Backend baseline: N/A
  • Frontend baseline: ae6593904544 / develop
  • Baseline capture plan: 所有页面样例分类、权限来源与字段权限边界结论，统一锚定到 water-frontend 基线 ae6593904544；正式 evidence 则固定到 baseline.md、docs-validation.md、final-verdict.md。

Technical Context

Primary Work Product: Markdown 协作入口文件、页面模板规范文件、页面样例索引文件、feature evidence 文件 Source of Truth Documents:

  • specs/011-frontend-speckit-alignment/spec.md
  • CLAUDE.md
  • docs/design/00_Management/01_Project_Progress.md
  • docs/design/00_Management/03_Task_Checklist.md
  • ../water-frontend/AGENTS.md Reference Sources:
  • ../water-frontend/CLAUDE.md
  • ../water-frontend/FRONTEND_PAGE_TEMPLATE_GUIDE.md
  • ../water-frontend/FRONTEND_PAGE_TEMPLATE_INDEX.md
  • ../water-frontend/src/views/system/user/index.vue
  • ../water-frontend/src/views/system/user/UserForm.vue
  • ../water-frontend/src/views/custData/custCreate/components/ImportForm.vue
  • ../water-frontend/src/store/modules/user.ts
  • ../water-frontend/src/store/modules/permission.ts
  • ../water-frontend/src/permission.ts
  • ../water-frontend/src/directives/permission/hasPermi.ts
  • ../water-frontend/src/directives/permission/hasRole.ts
  • ../water-frontend/src/api/system/permission/index.ts
  • ../water-frontend/src/views/system/role/RoleDataPermissionForm.vue
  • ../water-frontend/src/views/system/menu/MenuForm.vue
  • ../water-frontend/src/api/system/userFormConfig.ts
  • ../water-frontend/src/components/ColumnSetting/hooks/useColumnSettingStorage.ts
  • ../water-frontend/src/views/bpm/processInstance/create/ProcessDefinitionDetail.vue Validation Commands:
  • 文档读取与差异核对
  • git -C ../water-frontend status --short -- AGENTS.md CLAUDE.md FRONTEND_PAGE_TEMPLATE_GUIDE.md FRONTEND_PAGE_TEMPLATE_INDEX.md
  • 如后续仅文档改动：以 evidence 校验为主，不强制执行 frontend build/lint Target Scope:
  • specs/011-frontend-speckit-alignment/spec.md
  • specs/011-frontend-speckit-alignment/plan.md
  • specs/011-frontend-speckit-alignment/research.md
  • specs/011-frontend-speckit-alignment/data-model.md
  • specs/011-frontend-speckit-alignment/quickstart.md
  • specs/011-frontend-speckit-alignment/baseline.md
  • specs/011-frontend-speckit-alignment/docs-validation.md
  • specs/011-frontend-speckit-alignment/final-verdict.md
  • ../water-frontend/AGENTS.md
  • ../water-frontend/CLAUDE.md
  • ../water-frontend/FRONTEND_PAGE_TEMPLATE_GUIDE.md
  • ../water-frontend/FRONTEND_PAGE_TEMPLATE_INDEX.md Project Type: 文档治理仓库 + 多仓实现协作 Constraints:
  • 不在 water-frontend 新建第二套 .specify/
  • 正式 spec / plan / tasks / evidence 统一回到 water-docs
  • 不臆造新的权限能力或业务规则
  • 相对路径引用必须稳定可读
  • 普通业务表单字段权限不得误写为已具备能力
  • 本轮不改造后端权限模型，不开发前端页面生成器 Scale/Scope: 多仓但以前端文档整理为主，验证偏重 evidence 闭环

Constitution Check

GATE: Must pass before Phase 0 research. Re-check after Phase 1 design.

  • 主文档归属已确认：正式 spec / plan / evidence 统一落在 water-docs/specs/011-frontend-speckit-alignment/，不新增平行正式稿。
  • 多仓范围已确认：water-docs 与 water-frontend 在范围内；water-backend 仅作为历史研究证据，不要求代码改动。
  • 代码基线已确认：frontend 基线已记录为 ae6593904544 / develop，docs 当前分支为 011-frontend-speckit-alignment。
  • Archive 使用方式合规：本 feature 未直接以 Archive 替代正式口径，仅以现有 spec 与代码证据为准。
  • 一致性影响已列出：已识别 Speckit 单一来源、模板规范入口、页面样例映射、权限边界术语等一致性影响项。
  • 校验与台账动作已规划：已明确采用 baseline.md、docs-validation.md、final-verdict.md 做 evidence 闭环；根据 spec，本轮不要求更新 01_Project_Progress.md / 03_Task_Checklist.md。

Project Structure

Feature Artifacts

specs/011-frontend-speckit-alignment/
├── spec.md
├── plan.md
├── research.md
├── data-model.md
├── quickstart.md
├── contracts/
├── tasks.md
├── baseline.md
├── docs-validation.md
└── final-verdict.md

Repository Touchpoints

water-docs/
└── specs/011-frontend-speckit-alignment/

water-frontend/
├── AGENTS.md
├── CLAUDE.md
├── FRONTEND_PAGE_TEMPLATE_GUIDE.md
└── FRONTEND_PAGE_TEMPLATE_INDEX.md

Structure Decision:

  • water-docs/specs/011-frontend-speckit-alignment/*：承接正式 spec、plan、research、data-model、quickstart 与验证 evidence。
  • water-frontend/AGENTS.md：承接前端通用代理入口与 Speckit 回指规则。
  • water-frontend/CLAUDE.md：承接 Claude Code 在前端仓的入口与执行边界。
  • water-frontend/FRONTEND_PAGE_TEMPLATE_GUIDE.md：承接模板规则层定义。
  • water-frontend/FRONTEND_PAGE_TEMPLATE_INDEX.md：承接实际页面样例索引层定义。

Phase 0: Research & Alignment

Research Inputs

  • 前端仓与 docs 仓的单一事实来源边界如何保持一致
  • 模板规则层与样例索引层如何分工
  • 页面分类按交互结构还是业务域组织更合理
  • 普通业务字段权限、列可见配置、BPM 字段权限如何避免混写
  • 本轮是否需要额外 contract 文件或技术接口描述

Deliverables

  • research.md
  • 已有 evidence 工件的范围说明

Phase 1: Design & Contracts

Planned Artifacts

  • data-model.md
  • contracts/（保留目录，本 feature 无新增外部接口契约文件）
  • quickstart.md
  • final-verdict.md（verification-heavy feature，已纳入正式产物）

Design Decisions

  • 采用“water-docs 单一正式真源 + water-frontend 实施入口”的多仓协作结构。
  • 采用“规则文件（guide） + 样例索引（index）”双层前端模板化设计。
  • 页面分类按交互结构划分，而不是按业务域划分。
  • 权限结论保持证据优先，不对普通业务字段权限做超范围推断。
  • plan 阶段不新增技术接口 contract，只保留 Speckit 标准目录结构。

Validation Plan

  • Document validation:
    • 核对 spec.md、plan.md、research.md、data-model.md、quickstart.md 之间的口径一致性
    • 核对 AGENTS.md / CLAUDE.md / FRONTEND_PAGE_TEMPLATE_GUIDE.md / FRONTEND_PAGE_TEMPLATE_INDEX.md 的引用链是否闭环
  • Backend validation: N/A
  • Frontend validation: N/A（当前仅文档协作文件改动，不触发业务代码构建验证）
  • Evidence output:
    • baseline.md
    • docs-validation.md
    • final-verdict.md

Ledger Sync Plan

  • Project progress update required: No
  • Task checklist update required: No
  • Evidence or verification summary update required: Yes

Complexity Tracking

Fill ONLY if Constitution Check has violations that must be justified

当前无需要豁免的 Constitution 违规项。