oauth_nest_demo/database-flow.md

NestJS & TypeORM 数据写入流程图

这是一个描述在您的项目中，从 NestJS 应用启动到通过 TypeOrm 将用户数据写入数据库的完整流程图。

graph TD
    subgraph "1. 应用启动 (Application Bootstrap)"
        A[NestJS App Starts] --> B[加载根模块 AppModule];
        B --> C{"配置全局数据库连接"};
        D[.env 文件] --> E[ConfigService];
        E -- 提供配置 --> C;
        C --> F["创建全局数据库连接池<br/>(Global DB Connection Pool)"];
    end

    subgraph "2. 模块和依赖加载 (Module & Dependency Loading)"
        B -- 导入 --> G[加载功能模块 UserModule];
        G --> H{"为 User 实体注册 Repository"};
        F -- 从连接池获取 --> H;
        H --> I["在 UserModule 作用域内<br/>注册 User Repository"];
    end

    subgraph "3. HTTP 请求处理 (HTTP Request Handling)"
        J["HTTP Request<br/>(e.g., POST /users)"] --> K[UserController];
        K -- 调用方法 --> L[UserService];
        I -- 依赖注入 (Inject) --> L["UserService<br/>(constructor receives userRepository)"];
    end

    subgraph "4. 数据库操作 (Database Operation)"
        L -- 1. 调用 --> M["userService.createUser(...)"];
        M -- 2. 执行 --> N["this.userRepository.create(data)<br/>(在内存中创建实体)"];
        N -- 3. 传递实体 --> O["this.userRepository.save(entity)<br/>(生成 INSERT SQL 语句)"];
        O -- 4. 通过连接池发送 SQL --> P[(MySQL 数据库)];
        P -- 5. 成功写入 --> Q[user 表];
    end

    %% Styling
    style F fill:#f9f,stroke:#333,stroke-width:2px
    style I fill:#ccf,stroke:#333,stroke-width:2px
    style P fill:#bbf,stroke:#333,stroke-width:2px
    style Q fill:#9f9,stroke:#333,stroke-width:2px

流程图解读

1. 应用启动:

   • NestJS 应用启动时，首先加载根模块 AppModule。
   • AppModule 中的 TypeOrmModule.forRootAsync 会利用 ConfigService 读取 .env 文件中的数据库配置信息。
   • 基于这些配置，TypeORM 创建一个全局的、可供整个应用使用的数据库连接池。

2. 模块和依赖加载:

   • AppModule 加载 UserModule。
   • UserModule 中的 TypeOrmModule.forFeature([User]) 指令会从全局连接池中为 User 这个实体获取一个 Repository（可以理解为数据表的操作句柄）。
   • 这个 User Repository 被注册在 UserModule 的依赖注入容器中，等待被使用。

3. HTTP 请求处理:

   • 当一个外部 HTTP 请求到达 UserController 的某个路由时，该路由会调用 UserService 中对应的服务方法。
   • NestJS 的依赖注入系统会自动将第 2 步注册的 User Repository 实例注入到 UserService 的构造函数中。

4. 数据库操作:

   • UserService 中的方法（如 createUser）被执行。
   • 代码首先调用 userRepository.create() 在内存中创建一个与数据表结构对应的实体对象。
   • 紧接着，userRepository.save() 方法被调用，TypeORM 将这个内存中的对象转换成一条 SQL INSERT 语句。
   • 这条 SQL 语句通过全局连接池被发送到 MySQL 数据库执行，最终将数据写入 user 表中。