chore(audit): 补追 96 份未入仓审计孤本 — 覆盖 2026-02-26 ~ 2026-04-08

这些审计记录原本堆积在 docs/audit/changes/changes/ 嵌套误产物目录下(由开发机迁移
79d3c2e 前后的不明批量操作产生)。由于同期 .gitignore 屏蔽了 docs/audit/ 全目录,
它们从未入过 git 任何分支 history。删除即永久丢失。

按 docs/specs/audit-gap-recovery/tasks.md 阶段 1 执行,将全部 96 份 D 类孤本
(主目录无同名、git history 亦无记录)复制到 docs/audit/changes/ 主目录入仓。

涵盖主题: P1-P18 全栈集成 / 多模块累积变更 / ETL bug 修复 / 业务日切 /
   召回与任务引擎改造 / 租户管理与审批 / 董事会财务 / 客户与助教详情 /
   DDL 基线合并 / Kiro 到 Claude Code 迁移

阶段 2(B 类内容漂移 1 份)和阶段 4(嵌套目录删除)独立推进。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Neo
2026-04-20 06:35:42 +08:00
parent 80bda9b991
commit 14a12342b5
96 changed files with 9521 additions and 0 deletions

View File

@@ -0,0 +1,107 @@
# 变更审计记录:小程序登录页头像昵称获取功能(前端实施)
| 字段 | 值 |
|------|-----|
| 日期 | 2026-03-24 21:08:04 |
| Prompt-ID | P20260324-210327 |
| Session-ID | b95fcdcc |
| Session 路径 | docs/audit/session_logs/2026-03/24/70_1f4ab609_204000 |
## 操作摘要
在小程序申请页apply添加 chooseAvatar 头像选择 + nickname input 昵称快捷填入功能。头像通过 `wx.uploadFile` 上传到后端持久化。同时修改个人页my-profile`app.ts` 以支持头像展示。本次为前端实施部分Step 9-16后端接口`/api/xcx/avatar/upload`)已在上一轮实施完成。
## 风险评估
- 低风险:纯前端 UI 变更 + 文档更新
- chooseAvatar 基础库要求 ≥ 2.21.2nickname input ≥ 2.25.3
- 头像上传依赖后端 `/api/xcx/avatar/upload` 接口(已在上一轮实施完成)
## 变更文件清单
### 前端(小程序)
| 文件 | 变更类型 | 说明 |
|------|----------|------|
| `apps/miniprogram/miniprogram/pages/apply/apply.ts` | 修改 | 新增 avatarTempPath/avatarUploaded data、onChooseAvatar、_uploadAvatarwx.uploadFile、onSubmit 先上传头像再提交、_checkAccess 保存 avatarUrl 到 globalData |
| `apps/miniprogram/miniprogram/pages/apply/apply.wxml` | 修改 | 新增头像选择区域button open-type="chooseAvatar")、昵称 input 改为 type="nickname" |
| `apps/miniprogram/miniprogram/pages/apply/apply.wxss` | 修改 | 新增头像选择区域样式avatar-section、avatar-btn、avatar-preview、avatar-img、avatar-camera |
| `apps/miniprogram/miniprogram/pages/my-profile/my-profile.ts` | 修改 | loadUserInfo 从 fetchMe 的 avatarUrl 构建完整头像 URLAPI_BASE + /api/xcx/avatar/{userId} |
| `apps/miniprogram/miniprogram/app.ts` | 修改 | checkAuthStatus 保存 avatarUrl 到 globalData.authUser |
### 文档
| 文件 | 变更类型 | 说明 |
|------|----------|------|
| `docs/database/BD_Manual_auth_users_avatar.md` | 新增 | BD 手册avatar_url 字段定义、数据流、关联接口 |
| `docs/deployment/EXPORT-PATHS.md` | 修改 | 新增 AVATAR_EXPORT_PATH 映射(目录总览、环境变量表、代码适配状态表、服务器配置示例) |
### 环境配置
| 文件 | 变更类型 | 说明 |
|------|----------|------|
| `.env` | 修改 | 新增 AVATAR_EXPORT_PATH 环境变量 |
| `.env.template` | 修改 | 新增 AVATAR_EXPORT_PATH 模板 |
## 改动注解
### `apps/miniprogram/miniprogram/pages/apply/apply.ts`
- 变更类型:修改
- 原始原因:用户要求小程序登录时读取头像和用户名,头像存本地,用户名在申请提交时自动带到租户审核信息
- 思路分析:使用微信 chooseAvatar 组件获取临时头像路径,通过 wx.uploadFile 上传到后端 `/api/xcx/avatar/upload` 接口持久化。在 onSubmit 流程中先上传头像再提交申请,确保头像 URL 已持久化。_checkAccess 中将 avatarUrl 保存到 globalData 供全局使用
- 修改结果:申请页支持头像选择和上传,头像 URL 持久化到服务器,昵称通过 nickname input 快捷填入
### `apps/miniprogram/miniprogram/pages/apply/apply.wxml`
- 变更类型:修改
- 原始原因:需要在申请页 UI 中添加头像选择和昵称输入区域
- 思路分析:使用 `button open-type="chooseAvatar"` 触发微信头像选择,昵称 input 设置 `type="nickname"` 启用微信昵称快捷填入
- 修改结果:申请页新增头像选择区域和昵称快捷输入,符合微信小程序最新 API 规范
### `apps/miniprogram/miniprogram/pages/apply/apply.wxss`
- 变更类型:修改
- 原始原因:头像选择区域需要配套样式
- 思路分析:新增 avatar-section、avatar-btn、avatar-preview、avatar-img、avatar-camera 等样式类
- 修改结果:头像选择区域视觉呈现完整
### `apps/miniprogram/miniprogram/pages/my-profile/my-profile.ts`
- 变更类型:修改
- 原始原因:个人页需要展示用户头像
- 思路分析:从 fetchMe 接口返回的 avatarUrl 字段构建完整头像 URLAPI_BASE + /api/xcx/avatar/{userId}),用于 image 组件展示
- 修改结果:个人页可展示用户上传的头像
### `apps/miniprogram/miniprogram/app.ts`
- 变更类型:修改
- 原始原因:全局需要缓存用户头像 URL 供各页面使用
- 思路分析:在 checkAuthStatus 中将 avatarUrl 保存到 globalData.authUser避免各页面重复请求
- 修改结果:头像 URL 全局可用
### `docs/database/BD_Manual_auth_users_avatar.md`
- 变更类型:新增
- 原始原因avatar_url 字段新增到 auth_users 表,需要配套 BD 手册文档
- 思路分析:记录字段定义、数据流(小程序 → wx.uploadFile → 后端 → 文件系统)、关联接口
- 修改结果:数据库文档与代码同步
### `docs/deployment/EXPORT-PATHS.md`
- 变更类型:修改
- 原始原因:新增 AVATAR_EXPORT_PATH 环境变量,需要在部署文档中记录
- 思路分析:在目录总览、环境变量表、代码适配状态表、服务器配置示例中新增 avatar 相关条目
- 修改结果:部署文档完整覆盖头像存储路径配置
## 本次对话文件变更
### 新增文件
- `docs/audit/prompt_logs/prompt_log_20260324_210327.md`
- `docs/audit/session_logs/2026-03/24/70_1f4ab609_204000/main_01_b95fcdcc.md`
- `docs/audit/session_logs/2026-03/24/70_1f4ab609_204000/sub_01_16c3d9c7.md`
- `docs/audit/session_logs/2026-03/24/71_9dd37e1b_204432/main_01_2dd5a2b8.md`
- `docs/audit/session_logs/2026-03/24/72_4e2c3fe5_205502/main_01_16c3d9c7.md`
### 删除文件
- `docs/audit/session_logs/2026-03/24/70_1f4ab609_204000/main_01_a9795623.md`
## 合规检查
| 检查项 | 状态 |
|--------|------|
| 新增迁移 SQL | 无(迁移在上一轮已完成) |
| DDL 基线 | ⚠️ DDL 基线待合并has_ddl_baseline: false |
| OpenAPI spec | 无需更新api_changed: false |
| BD 手册 | 已新建 `BD_Manual_auth_users_avatar.md` |
| 文档同步 | `.env` / `.env.template` / EXPORT-PATHS.md 已同步 |