feat: 首次登录引导与注册修复

ARCHITECTURE.md

@@ -330,3 +330,31 @@ jobs:
           # 构建时跳过 ESLint/TS 检查 (因为已经在 quality-check job 做过了，加速构建)
           NEXT_TELEMETRY_DISABLED: 1
 ```
+
+## 工作记录（2026-01-12）
+
+### 注册与首次登录引导
+- 注册流程调整为“仅创建账户并跳转登录”，首次登录后通过全局弹窗分步骤完成资料配置
+- 全局引导弹窗包含：选择角色 → 通用信息（姓名/电话/住址）→ 角色信息（可跳过，后续在设置中补全）→ 完成
+- 新增/补齐用户扩展字段与迁移：phone、address、gender、age、gradeId、departmentId、onboardedAt
+- 新增引导状态与提交接口：`/api/onboarding/status`、`/api/onboarding/complete`
+
+相关文件：
+- src/shared/components/onboarding-gate.tsx
+- src/app/api/onboarding/status/route.ts
+- src/app/api/onboarding/complete/route.ts
+- src/shared/db/schema.ts
+- drizzle/0008_add_user_profile_fields.sql
+
+### 注册失败排查与错误提示
+- 注册 server action 增强错误信息（可识别重复邮箱、未迁移、权限错误、连接失败等），开发环境可返回更具体的底层错误消息
+- 本地排查曾出现 `ECONNREFUSED`，属于数据库连接不可达问题（需检查 MySQL 服务状态与 DATABASE_URL 配置）
+
+相关文件：
+- src/app/(auth)/register/page.tsx
+
+### 顶部头像信息修复
+- 修复右上角头像/下拉信息写死为 admin 的问题，改为从 NextAuth session 动态读取当前用户 name/email 并生成头像 fallback
+
+相关文件：
+- src/modules/layout/components/site-header.tsx