shanxia2.0/openspec/changes/zkxw-engineering-standards/proposal.md

Why

山峡化工的技术与体验约束分散在《shanxia2.0需求 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 角色管理 等章节。
• 增补（2026-07）：ui-conventions / api-conventions / architecture-conventions 明确小程序附件基线为仅拍照凭证（uni.chooseImage + uni.uploadFile + 业务提交 imageUrls），与 web-admin 通用附件卡片化布局分工；参考叁强 sqxp-wx 凭证上传。

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 等）。
• ecosystem-landscape：多系统 SQL 快照索引（dibang.sql / shanxia2.0.sql / sx.sql）及山峡 CRM 独立仓库路径（shanxia/crm/backend、shanxia/crm/web）。

Modified Capabilities

• （无）当前仓库 openspec/specs/ 下尚无已归档基线能力。

Impact

• 文档：新增 openspec/changes/zkxw-engineering-standards/ 下全部制品；可选后续将 openspec/config.yaml 的 context 指向本变更摘要以降低 AI/新人上下文漂移。
• 代码：无直接代码变更；后续功能开发应以本变更中的 specs/*/spec.md 为评审依据之一。
• 系统：不涉及部署与运行时行为变更。