fix: pin scaffold dependencies and handle graceful shutdown

ROADMAP.md

@@ -0,0 +1,27 @@
+# GoOmni 成熟度计划
+
+## 1. 新项目启动与发布流程（v0.1.1）
+
+- 修正脚手架固定版本引用，保留显式本地开发选项。
+- 生成服务处理退出信号，等待请求完成后清理资源。
+- 验收：源码目录外安装远程 CLI → 生成无 replace 的项目 → 编译 → 请求健康接口和业务接口 → SIGINT/SIGTERM 正常退出。
+- 自动验收入口：`python3 scripts/verifyScaffold.py --version v0.1.1`。
+
+## 2. 业务数据接入（待完成）
+
+- 数据库初始化、Repository 和 ServiceContext 组合成完整业务启动流程。
+- Readiness 注册数据库探针，启动失败与服务退出时清理连接池。
+- 验收：真实数据库 CRUD、事务回滚、数据库不可用时 readiness 返回 503。
+
+## 3. 网络适配一致性（待完成）
+
+- Gin 与标准库适配器运行同一套契约测试。
+- 覆盖路由参数、分组、中间件、错误响应和取消传播。
+- 验收：切换适配器后，业务 Handler 和 Service 无需修改，约定的 HTTP 行为一致。
+
+## 4. 实际业务试用（待完成）
+
+- 在一个实际业务模块中使用远程固定版本，验证配置、日志、错误处理和升级流程。
+- 根据真实接入问题收敛公共 API，再评估稳定版范围。
+
+以上阶段以验收结果判断完成。当前仍是基础框架试用阶段，数据库生产验收、自研网络内核与实际业务接入尚未完成。