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

3.7 KiB

Raw Blame History

中科兴皖一体化门户（zkxw）

面向细胞存储、科研捐赠、生产质检、中试服务及 OA 审批的多租户业务系统。四个应用共享后端与权限模型；sanqiang、sqxp、陇耘鲜达等名称是历史标识，不代表独立服务。

应用与入口

应用	技术与用途	开发说明
`backend/`	Python 3.9 / FastAPI，业务 API、认证、权限、工作流及 OA	后端 README
`web-admin/`	Vue 3 / TypeScript / Element Plus，Web 管理端	Web README
`mobile-h5/`	HBuilderX uni-app Vue 3，移动工作台及 WebView 宿主	uni-app README
`mobile-oa-h5/`	Vue 3 / Vant，OA 与市场业务 H5	H5 README

Web 与移动端访问同一后端；移动宿主通过 WebView 打开 H5 表单和详情。Web 使用 Hash 路由，H5 使用 /oa-h5/ 下的 History 路由。Docker 的 Web 镜像包含 Web 管理端和移动 H5，小程序由 HBuilderX 独立编译。

后端入口为 backend/app/main.py。默认 API 总前缀 /api，业务模块主要位于 /web/... 与 /mini/...；以对应路由定义为准。数据服务使用 MySQL 5.7、Redis 与 MinIO。

开发导航

开发约束：根 AGENTS及各应用的 AGENTS。
UI、模式、SQL、SOP 与开发指南：文档导航。
工程规范：OpenSpec 工程标准。当前仍在变更目录，尚未完成长期基线归档。

首次开发按各应用 README 准备依赖与环境配置，不复用 Git 中的虚拟环境。启动、停止、重启服务由用户执行，Agent 仅告知需要的操作。

目录职责

路径	内容
四个应用目录	业务源码、各端测试、各端专用工具
`docs/`	当前规范、开发指南、SQL 与 SOP 模板
`openspec/`	保留工程标准，历史业务变更记录已清理
`deploy/docker/`	Docker 构建、Compose、Nginx 与交付说明
`scripts/`	跨项目工具；发布脚本有外部影响，不能当作普通检查运行
`deploy/test/`、`deploy/production/`	测试部署与生产操作资料；凭据和证书在忽略的 `.local/deploy/`
`resources/`	SOP 原稿、图片和导入规则，见资源导航
`.local/`	本机证书、环境配置、业务表格与备份，不进入 Git 或 Docker 上下文

部署入口与已知限制

Docker 交付说明、测试环境说明。
.drone.yml 由 tag 触发生产交付包构建，调用 scripts/package-docker-deploy.sh，不是日常检查流水线。
当前 docs/sql/zkxw.sql 只包含 3 张表的建表语句，但打包和 Compose 仍引用它作为初始化文件。尚未验证空库完整部署，请勿把它视为完整可用的全库基线。既有部署文档中的相关说法待专项修正。
部分测试引用的迁移 SQL 已缺失；字段检查器的覆盖限制见字段一致性指南，移动色板差异见移动端 AGENTS。不能通过删除测试、覆盖现网数据或改变 UI 来规避这些问题。

版本管理

提交源码、必要模板和脱敏配置示例；依赖、构建产物、日志、本地工具状态及真实业务备份不新增入库。真实数据存放在本机 .local/，导入操作显式指定输入。graphify 已停用，不再生成或提交知识图谱，也不安装或运行其 hook。

本机凭据位于 .local/deploy/，表格与 TSV 位于 .local/data/，备份位于 .local/backups/。业务历史文档及整理报告已删除；后续优先维护现有规范和 README。

3.7 KiB Raw Blame History Unescape Escape