GOV-009 应用工程脚手架基线开发总结

功能编号：GOV-009
发布版本：v0.0.8
架构确认日期：2026-08-17

原始开发需求

用户要求先搭建可支持 A 股市场概览业务的前后端基础：前端采用 Vue 3 与 Dart Sass，后端以独立 NestJS 工程维护，MySQL 固定 5.7、utf8mb4_general_ci 与东八区，Redis 作为缓存，RocketMQ 负责异步任务，API、Scheduler、Worker 分进程运行。工程需要开发/生产配置隔离、源码部署、OpenAPI 契约、完整治理留痕，并在全部实施后基于真实结构再次向用户论证。

需求与范围变化

消息队列从早期 RabbitMQ 方案调整为 RocketMQ 5.x，业务只依赖 MessageBusAdapter，未验证 Node 客户端前保持明确禁用。
部署从“Docker Compose 与源码并存”逐步收敛为“只支持 Ubuntu 源码部署”，Dockerfile、Compose、镜像门禁和容器兜底全部移除；历史验证事实不改写。
前后端不建立根共享 TypeScript 契约包。Server DTO 生成 OpenAPI，Web 生成自己的类型；RocketMQ 消息契约只属于 Server。
用户体系、会员订阅、市场概览 UI、行情采集和 AI Provider 均不属于本功能范围，后续以独立功能档案实施。

实际完成需求

范围	状态	实际结果
Web 工程	已完成	建立 Vue 3、Vite、Pinia、Vue Router、Element Plus、Dart Sass、Vitest 与 Playwright 基线。
Server 工程	已完成	建立 NestJS API、Scheduler、Worker 三入口及独立配置、生命周期和构建产物。
契约边界	已完成	Server DTO → OpenAPI → Web 类型单向生成；Web/Server 源码越界和契约漂移由自动门禁阻断。
基础设施边界	已完成	固定 MySQL 5.7.42、Redis 只读健康检查、RocketMQ Adapter/消息信封和禁用语义，不自动管理外部服务。
环境与部署	已完成	开发/生产模板按进程最小权限拆分，生产仅支持 Ubuntu、systemd、Nginx 的源码部署。
质量治理	已完成	建立运行时、Schema、契约、边界、部署、测试、构建、视觉与 GitNexus 验证链路。
架构复核	已完成	依据真实目录和运行入口完成论证，用户于 2026-08-17 确认当前架构基线。

修复缺陷

实施与 Review 阶段修复了配置注入和三进程生命周期、未跟踪生成契约绕过、Vue 外部脚本越界、Vite 运行时模板警告、源码门禁 Docker 路径绕过、systemd 单元安装名称错误以及 Redis 测试兜底改变外部服务所有权等问题。所有处置均保留在实施计划、QA 和两份 Review 中；当前无未关闭的 Critical 或 Important 问题。

未完成与延期项

市场概览、短线/中长线模式、行情图表、规则/AI/混合/对照分析尚未实现，归入业务功能开发。
TDX 常驻采集代理与 RocketMQ Node 客户端尚未落地；当前仅保留接口边界、禁用 Adapter、Tailscale 操作文档和 PoC 前置档案。
用户、邀请制、权限、会员和订阅按用户决定后置，不预埋业务实现。
完成市场概览真实业务后，需要依据模块依赖、负载与维护成本再次进行架构复核；当前确认不等于永久冻结。

关键提交

阶段	代表提交	说明
工程与契约基线	`b3d8e29` 至 `95b8611`	Schema、workspace、Web、Server 三进程、OpenAPI、边界与 Review 整改。
仅源码部署	`cfcd7f1` 至 `c756654`	确认设计、移除 Docker、修复发布门禁并完成复审。
GitNexus 封存	`bbda26f`	更新 GOV-009 最终索引统计。

上述提交均使用包含 GOV-009 的中文 Conventional Commit 并已推送项目专用 Gitea。发布封存提交和 v0.0.8 标签在本次收尾中分别推送并核对。

验证证据

qa/test-results.md 保存运行时、治理、MySQL 5.7、环境、Schema、契约、边界、部署、Web、Server、构建、Playwright、安全扫描和格式证据。
qa/visual-qa.md 与 screenshots/iterations/ 保存桌面和移动应用外壳证据；GOV-009 不评价尚未实现的市场概览视觉质量。
gitnexus/before.md、impact-plan.md、detected-changes.md、after.md 和 comparison.md 保存开发前后影响与实际执行流对比。
两份 Review 最终结论均为 passed；当前版本没有业务迁移，不访问生产数据库，不创建 RocketMQ Topic，也不写入 Redis 或 MySQL 业务数据。

4.5 KiB Raw Permalink Blame History Unescape Escape