## Why 中科兴皖一体化门户的技术与体验约束分散在《中科兴皖需求 V0.3》、Web 管理端与小程序 UI 规范及仓库 `AGENTS.md` / `.cursorrules` 中,缺少一份可被评审、版本化且与实现检查对齐的**单一事实来源(OpenSpec)**。本变更将上述材料提炼为可测试的 SHALL 级需求与架构/设计说明,便于研发、测试与评审统一口径。 ## What Changes - 新增 OpenSpec 变更 `zkxw-engineering-standards`,包含提案、设计说明、**七项能力规范**及落地任务清单。 - **不修改**业务代码;规范正文以需求 V0.3 第 3 节「技术要求」为硬约束,UI 细节以两份 UI 规范文档为权威展开(本变更中的 UI 条目为**跨端统一原则与引用约束**,像素级 Token 仍以原文档为准)。 - 工作流/审批与权限条目直接对齐需求文档 **§2.1.11 流程管理** 与 **§2.1.5 角色管理** 等章节。 ## Capabilities ### New Capabilities - `architecture-conventions`:仓库分层、技术栈选型(Python 后端、Web 管理端、小程序端)及与需求文档的对应关系。 - `api-conventions`:租户隔离、数据权限过滤、列表默认排序、附件存储形态等接口与数据层统一约定。 - `ui-conventions`:Web(Fresh Mint)与小程序(三墙体系)的权威文档、Token/骨架级统一要求及**禁止跨端混色**等约束。 - `coding-conventions`:前后端工程化与编码风格(与 `AGENTS.md`、`.cursorrules` 一致的最小必要集合)。 - `database-conventions`:MySQL 5.7、公共字段、软删除、字段顺序等数据库层规范。 - `workflow-conventions`:自研工作流的目标能力、配置、运行时与待办/已办中心(对齐需求 §2.1.11)。 - `permission-conventions`:角色-菜单-数据权限模型及多角色权限合并规则(对齐需求 §2.1.5 等)。 ### Modified Capabilities - (无)当前仓库 `openspec/specs/` 下尚无已归档基线能力。 ## Impact - **文档**:新增 `openspec/changes/zkxw-engineering-standards/` 下全部制品;可选后续将 `openspec/config.yaml` 的 `context` 指向本变更摘要以降低 AI/新人上下文漂移。 - **代码**:无直接代码变更;后续功能开发应以本变更中的 `specs/*/spec.md` 为评审依据之一。 - **系统**:不涉及部署与运行时行为变更。