zkxw/openspec/changes/zkxw-engineering-standards/specs/architecture-conventions/spec.md at V2.0

cykj/zkxw

0 Fork 0

Files

T

zlwu b220298f89 chore: 清理历史资料并规范工程目录与开发规则

为减少仓库噪声和重复规则，整理当前开发入口并移除已废弃资料。

- 精简根 AGENTS，补充四个应用规则与 README，统一规范入口
- 归整部署文件、SOP 原稿和参考资源，修正迁移后的脚本路径
- 取消虚拟环境、工具状态、业务导出及备份的跟踪，本机所需原件保留
- 移除停用的 graphify 配置、脚本与产物
- 删除历史业务文档、执行计划、OpenSpec 业务变更和移动 UI 原型
- 清理失效引用，历史细胞产品导入改为必须显式指定 --file

验证：git diff --cached --check、OpenSpec 严格校验、导入参数隔离检查 3/3 通过；
迁移文件完整性和现行链接已核对。未执行部署、业务数据导入或服务启停。

2026-10-29 23:08:29 +08:00

2.3 KiB

Raw Permalink Blame History

ADDED Requirements

来源说明：文中《中科兴皖需求 V0.3》及其章节引用为历史出处，原文已清理；以下既有 SHALL 要求继续有效，当前入口见根 AGENTS.md 与本工程标准。

Requirement: 仓库采用前后端分离的一体化门户形态

中科兴皖一体化门户 SHALL 以「Python 后端 + Web 管理端 + 小程序端」的形态组织代码与部署单元；业务域（细胞存储、中试、系统管理等）共享同一后端与租户模型，除非需求文档明确声明独立子系统。

Scenario: 新人识别工程边界

WHEN 阅读仓库根目录说明或 OpenSpec architecture-conventions
THEN 文档 SHALL 指明后端入口、管理端入口、小程序工程目录及 API 前缀约定（与 AGENTS.md 一致）

Requirement: 技术栈与需求文档 §3 对齐

系统 SHALL 使用 MySQL 5.7 作为关系型数据库；后端 SHALL 使用 Python 实现；Web 管理端 SHALL 基于 Vue 技术栈在精简后的管理端模板工程上扩展；小程序 SHALL 基于 uni-app、Vue 3 与 Vant 体系实现业务界面（与《中科兴皖需求 V0.3》§3 及当前 miniprogram 工程一致或可文档化迁移）。

Scenario: 技术选型评审

WHEN 新增服务或子工程选型
THEN 选型说明 SHALL 论证与上述栈的兼容性，或作为独立变更更新本 spec 与 proposal.md

Requirement: 附件与对象存储

业务附件 SHALL 通过对象存储（如 MinIO）保存可访问 URL；多附件在同一字段内存储时 SHALL 使用英文逗号分隔多个 URL（与需求 §3 一致）。

Scenario: 上传列表回显

WHEN 业务实体包含多个附件
THEN 持久化字段 SHALL 为逗号分隔的 URL 字符串，且接口契约与前端解析逻辑一致

Requirement: 权威文档索引

实现类变更 SHALL 将根 AGENTS.md、openspec/changes/zkxw-engineering-standards/specs/、docs/web-admin-ui-spec-fresh-mint.md、docs/web-admin-ui-pattern-index.md 及 docs/miniprogram-ui-spec-sanqiang.md 视为架构与规范的索引入口；OpenSpec 变更 SHALL 在 proposal.md / design.md 中保持对上述路径的引用。

Scenario: UI 相关 PR 描述

WHEN 提交涉及 Web 或小程序界面的 PR
THEN PR 或关联 OpenSpec SHALL 声明遵循的 UI 规范文档路径

2.3 KiB Raw Permalink Blame History