feat: refine login flows and integrate tiangong worship audio

docs/birthday-calendar-and-avatar.md

@@ -0,0 +1,45 @@
+# 出生历法与头像入口验收
+
+## 实现与数据约定
+
+- 编辑个人信息、完善注册资料共用 `BirthdayPicker`，支持阳历与农历、真实闰月、大小月日期联动。范围为阳历 1900-01-01 至北京时间今天，与现有生肖/五行计算的支持范围保持一致。
+- `birthday` 仍为对应阳历 `YYYY-MM-DD`，用于生肖、五行和每日计算；新增 `birthdayCalendar: "solar" | "lunar"` 仅记录输入/显示偏好。切换历法不改变实际生日，保存后重新编辑按接口偏好回显。农历闰月可由阳历日期准确还原，不需再保存第二份农历生日。
+- 生日或偏好变更沿用现有个人资料保存与修改额度规则；不在选择或切换时自动保存、不擅自改动后端生日计算。
+- 首页左上角头像使用主 Tab 导航到“我的”，不再是不可点的展示区域。
+- 微信端直接点击头像即使用 `openType=chooseAvatar`，不再先打开本项目的自定义菜单；回调只预览选中的临时文件，点击保存时仍走后端文件服务，不绕过平台用户确认。H5 不支持该微信能力，仍保留相册/拍照菜单。本次 H5 验收不代表已操作微信原生弹窗。
+
+## 接口清单
+
+没有新增路径或改变部署基址，复用以下接口：
+
+- GET `/api/user/profile`：响应新增 `birthdayCalendar`，生日仍为阳历。
+- PUT `/api/user/profile`：请求、响应新增 `birthdayCalendar`；服务端只允许 `solar`、`lunar`。
+- POST `/api/auth/wx-login`、POST `/api/auth/bind-phone`：登录资料中的 `user` 同样返回偏好。
+- POST `/api/user/avatar`：头像保存仍上传至现有文件存储服务，生日选择不影响头像接口。
+
+## 部署前置条件
+
+后端已补 DTO、实体、联合查询、资料 Mapper 和建表定义。已有目标数据库应先由部署人员执行：
+
+`/Users/zhouzhibo/file/hongzhen/idea/hera/src/main/resources/db/birthday-calendar-update.sql`
+
+随后部署/重启新版后端，再更新小程序。脚本只按列是否存在增加 `user_profile.birthday_calendar`，默认 `solar`，不修改生日、不删除数据；没有自动启动时远程迁移。本次未执行远程 MySQL DDL、未部署后端、未提交或推送。
+
+## 验收步骤
+
+1. 开发者工具重新编译，登录后从首页点击左上角头像：应切换到“我的”；再点头部进入编辑信息。
+2. 点击“农历”：显示同一天的农历及对应阳历，实际生日未变；打开日期选择器可单独选择闰月。
+3. 示例农历 2023 年闰二月初一，应对应阳历 2023-03-22。切换年份到无此闰月的年份时，使用该年的普通二月；切到小月时超出天数自动收敛，不提交无效日期。
+4. 在选择器点取消：实际生日不变。点确定、保存、返回再进入：农历偏好与日期保持；切回阳历保存后同样能回显。
+5. 首次注册完善资料使用同一控件。不能选未来日期；保存后生肖、五行使用换算后的阳历日期。
+6. 微信端直接点头像：应立即出现一次微信官方头像选择器，不先弹自定义菜单；确认后预览、取消不更换当前头像。H5 点击头像仍显示相册/拍照菜单。
+
+本地视觉验收可用 `http://127.0.0.1:4173/?avatarDemo=1#/pages/home/index`，其中资料、头像仅为隔离演示，刷新重置；不能据此认定远程保存已生效。
+
+## 已验证与边界
+
+- 79 项前端测试通过，类型检查、H5/微信构建与 13 个文件的原生 WXSS 检查通过；其中头像入口测试验证微信端直接绑定官方选择器、无自定义菜单，以及 H5 的相册入口保留。
+- 后端 12 项 H2/MockMvc 测试通过，验证资料落库、回显、再次登录、非法历法拒绝、头像不受影响；1 项真实 MySQL 测试未配置专用测试库而跳过，没有写远程库。
+- 浏览器实测首页头像跳转、农历闰月确认、隔离演示保存与再次编辑回显，以及注册场景共用选择器。
+- 截图：`/private/tmp/hera-birthday-lunar-edit.png`。
+- 微信官方选择器的外观、取消/安全审核分支需微信开发者工具与真机验收；H5 不模拟成真实微信授权。