57 lines
4.5 KiB
Markdown
57 lines
4.5 KiB
Markdown
# 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 业务数据。
|