docs: 更新初始化交接文档

2026-09-02 17:56:42 +08:00
parent 1a2caba2b3
commit 09e5207c83
3 changed files with 31 additions and 19 deletions
@@ -1,6 +1,6 @@
 # 项目结构与运行边界

-> 状态：初始化骨架已创建。本文描述仓库的代码归属、构建关系和本地运行边界；业务规则仍以项目交接、API 契约和数据模型文档为准。
+> 状态：初始化骨架已创建并完成版本基线锁定。本文描述仓库的代码归属、构建关系和本地运行边界；业务规则仍以项目交接、API 契约和数据模型文档为准。

 ## 1. 目录结构

@@ -107,15 +107,19 @@ sequenceDiagram

 ## 5. 本地开发入口

+运行时基线：Node 24.20.0（见 `.nvmrc`）、pnpm 11.25.0、Web `8100`、API `8200`。Worker 是队列消费者，不对浏览器提供 HTTP 服务，因此没有端口号。
+
 ```bash
 cp .env.example .env
 pnpm install
-pnpm infra:up       # PostgreSQL、Redis、MinIO
+pnpm infra:up       # PostgreSQL 18.6、Redis 7.4、MinIO
 pnpm dev            # Web、API、Worker、Extension 并行 watch
 ```

 常用验证命令：`pnpm build`、`pnpm typecheck`、`pnpm format:check`。首次实现数据库迁移执行器时，必须将 `atlas_migrator` 和 `atlas_app_login` 的连接串分开配置，并在集成测试中验证 RLS 隔离。

+本地 Docker 镜像使用明确标签而非 `latest`；完整依赖版本表见 [技术与部署方案](./technology-and-deployment.md)。
+
 ## 6. 接下来的实现顺序

 1. 在 `packages/database` 实现只接受 migrator 连接串的可重复 SQL migration runner，并导入已评审的 `001_foundation.sql`、`002_product-domain.sql`。