Neo
70324d8542
- .kiro/specs/ → docs/specs/（41 个历史需求 spec 迁移，移除 .config.kiro） - CLAUDE.md 三层拆分：根文件精简 + apps/backend/CLAUDE.md + .claude/commands/ - 新增 /spec-close、/pre-change 两个工作流命令 - DDL 基线刷新（从测试库重新导出 11 个文件，dws 35→38 表，biz 18→21 表） - BD_Manual → BD_manual 命名统一（48 个文件） - 修复 3 处文档与数据库不一致（auth.users.status 默认值、scheduled_tasks 字段、RLS 视图数） - 新增 BD_manual_public_rbac_tables.md（public schema 8 张 RBAC/工作流表） - 合并 biz.trigger_jobs 文档（10→12 字段，归档独立文档） - docs/database/README.md 索引更新 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.6 KiB
1.6 KiB
BD 手册：auth.users.avatar_url 字段
概述
auth.users 表新增 avatar_url 字段，存储用户头像的相对路径。
字段定义
| 字段 | 类型 | 约束 | 说明 |
|---|---|---|---|
avatar_url |
VARCHAR(500) |
NULL |
头像相对路径，格式 avatars/{user_id}.jpg |
数据流
- 小程序端通过
<button open-type="chooseAvatar">获取微信头像临时路径 - 通过
wx.uploadFile上传到POST /api/xcx/avatar/upload - 后端保存文件到
AVATAR_EXPORT_PATH/{user_id}.jpg（覆盖式，幂等） - 数据库
avatar_url更新为avatars/{user_id}.jpg（相对路径） - 小程序通过
GET /api/xcx/avatar/{user_id}获取头像文件
关联接口
| 接口 | 方法 | 说明 |
|---|---|---|
/api/xcx/avatar/upload |
POST | 上传头像，更新 avatar_url |
/api/xcx/avatar/{user_id} |
GET | 获取头像文件（FileResponse） |
/api/xcx/me |
GET | 返回 avatar_url 字段 |
设计决策
- 审核表
auth.user_applications不冗余avatar_url，通过 JOINauth.users获取（头像可能更新） - 文件命名按
user_id，覆盖式保存（幂等，无历史版本） - 文件大小限制 2MB，空文件拒绝
迁移脚本
db/zqyy_app/migrations/20260324_add_avatar_url_to_users.sql
环境变量
AVATAR_EXPORT_PATH — 头像文件存储目录，缺失时后端报 500 错误
回滚
ALTER TABLE auth.users DROP COLUMN IF EXISTS avatar_url;
验证
SELECT id, avatar_url FROM auth.users WHERE avatar_url IS NOT NULL LIMIT 5;