zlwu
b220298f89
为减少仓库噪声和重复规则，整理当前开发入口并移除已废弃资料。 - 精简根 AGENTS，补充四个应用规则与 README，统一规范入口 - 归整部署文件、SOP 原稿和参考资源，修正迁移后的脚本路径 - 取消虚拟环境、工具状态、业务导出及备份的跟踪，本机所需原件保留 - 移除停用的 graphify 配置、脚本与产物 - 删除历史业务文档、执行计划、OpenSpec 业务变更和移动 UI 原型 - 清理失效引用，历史细胞产品导入改为必须显式指定 --file 验证：git diff --cached --check、OpenSpec 严格校验、导入参数隔离检查 3/3 通过； 迁移文件完整性和现行链接已核对。未执行部署、业务数据导入或服务启停。
32 lines
2.7 KiB
Markdown
32 lines
2.7 KiB
Markdown
## Why
|
||
|
||
中科兴皖一体化门户的技术与体验约束分散在《中科兴皖需求 V0.3》、Web 管理端与小程序 UI 规范及仓库 `AGENTS.md` / `.cursorrules` 中，缺少一份可被评审、版本化且与实现检查对齐的**单一事实来源（OpenSpec）**。本变更将上述材料提炼为可测试的 SHALL 级需求与架构/设计说明，便于研发、测试与评审统一口径。历史需求原文现已清理，章节引文仅用于说明来源；当前规范入口为根 `AGENTS.md`、本变更 `specs/*/spec.md`、`docs/web-admin-ui-spec-fresh-mint.md`、`docs/web-admin-ui-pattern-index.md` 与 `docs/miniprogram-ui-spec-sanqiang.md`。
|
||
|
||
## 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` 为评审依据之一。
|
||
- **系统**：不涉及部署与运行时行为变更。
|