Blizzard
aefb1bc103
## pages/petform 三步向导
① 名字 + 传头像
② 猫还是狗 → 选品种
③ 性别 / 生日 / 到家日期 / 体重 / 毛色 / 阶段
**编辑时不分步**，一屏全放开：用户是来改某一项的，不该被按顺序走一遍。
同一个页面两种形态，靠 ?id= 区分。
每一步只校验这一步的东西。三步全填完才校验的话，用户在第三步才被告知
第一步没填名字，还得翻回去。
进度条没用 seg-tabs：那是「可以随意切」的语义，这里有顺序，
点第三步跳过前两步会拿到一份没名字的档案。
## 生日和到家日期分开
原来是一个「生日 / 到家时间」字段。领养的成年猫狗生日常常是不知道的，
而「一起生活了多少天」要按到家日算——合成一个字段两件事都说不准。
验过：到家 4 个月前 → 第 121 天；按生日算会是 801 天。
模型里 Birthday 和 ArrivedAt 本来就是两个字段，只是表单没露出来。
## 品种：自由文本 → 后台可配的选择器
原来品种是个输入框，用户手打「柯基」「柯基犬」「威尔士柯基」算三个品种，
以后想按品种做体重基准、常见病提示这类事就没法做。
新增 breeds 表，预置 34 种猫 + 45 种狗，按首字母分组、右侧 A-Z 索引跳转、
首字母吸顶。留了「不确定」——领养的串串确实说不出品种，逼着选一个只会
得到假数据。换物种会清掉已选品种（原来那个一定不对了）。
**首字母存字段不运行时算**：Go 没有标准拼音库，而多音字自动转常出错——
「藏獒」按 cang 还是 zang 分组、「柴犬」的柴，人来定比库来猜靠谱。
后台新增品种时手填这一位，服务端校验必须是单个 A-Z。
已有档案在用的品种不许删（删了那些档案的品种就变成查不到的字符串），
想隐藏用 enabled=false。同物种下不许重名——品种是统计口径，重名会把
同一种猫劈成两半。
预置数据自己填错了两条，实跑时看出来的：「苏格兰柯利犬」我按「柯利」
填了 K，应该按「苏格兰」算 S；「双血统边牧」根本不是品种，是血统描述。
seed 源和库里都改了。
## 弹层继续瘦
addPet/editPet 两支删掉，连带 10 个方法、ageFromBirthday/GENDERS/STAGES
和 5 个 add* 字段。累计（从记录表单搬走那次算起）：
js 1110 → 734 行
wxml 485 → 307 行
多宠管理里「点某只去编辑」原来是 setType('editPet')，那支没了会开一个
空白弹层——改成关弹层再跳页。8 个页面的入口全换完，grep 无残留。
## 验证（预生产库实跑）
品种接口 猫 34 种 16 个首字母、狗 45 种 17 个首字母；非法 species 返回 []
建档 生日 / 到家日期 分别落库，品种毛色阶段都对
编辑 只改名字，到家日期没被冲掉
修正 柯利犬 K→S、双血统边牧已删
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
毛孩子计划 · 后端 (pets-be)
Gin + GORM + MySQL + MinIO 的宠物小程序后端，内嵌 React(Vite + Tailwind + shadcn/ui) 后台管理。
技术栈与约定
- 模块路径
github.com/sundynix/pets-be，标准 Go 布局（cmd/ internal/ pkg/ configs/ deployments/ web/） - 所有数据库表带前缀
sundynix_ - 统一响应
{code, message, data}（pkg/response），列表接口统一分页参数page/page_size（response.PageQuery+PageResult） - MySQL
root/root库pets；MinIOsundynix/sundynix桶pets - 服务端口
:8080；后台在http://localhost:8080/admin（seed 管理员sundynix/sundynix）
快速开始
# 1. 起依赖（MySQL + MinIO）
make env-up # 或 cd deployments && docker compose up -d
# 2. 构建后台前端 + 后端单二进制
make build # 产物 bin/pets-be（已 embed 后台）
./bin/pets-be
# 或开发期直接运行（使用现有 internal/admin/dist）
make run
后台前端开发（热更新）
make admin-dev # vite dev server :5173，已代理 /api → :8080
# 改完执行 make admin-build 让产物落到 internal/admin/dist，再 go build 即 embed
目录
cmd/server入口：载配置→连库→迁移→seed→建桶→路由→启动internal/config配置(viper，支持PETS_环境变量覆盖)internal/modelGORM 模型（sundynix_前缀）internal/database连接/迁移/seedinternal/storageMinIO 封装（自动建桶 + 上传）internal/service业务逻辑；internal/handlerHTTP 处理器；internal/router路由internal/middlewareCORS / 用户鉴权 / 管理员鉴权internal/admingo:embed内嵌后台产物 + SPA fallbackpkg/response统一响应与分页；pkg/jwt令牌；pkg/errcode错误码web/admin后台前端源码
接口
- 小程序
/api/*（用户 JWT）：auth / user / pets / onboarding / records / tasks / plan / reminders / report / bill / community / articles / pro / ai / upload - 后台
/api/admin/*（管理员 JWT）：login / stats / users / pets / posts / comments / articles / memberships
登录鉴权
默认 auth.dev_login: true，POST /api/auth/login {"nickname":"xxx"} 即发用户 JWT。
接真微信：在 configs/config.yaml 填 wechat.app_secret 并把 dev_login 置 false，实现 /api/auth/wechat(code2session)。
access token + refresh token
登录接口返回 token(access) 与 refresh_token 两个令牌：
- access token：JWT，默认 2 小时（
jwt.expire_hours），放Authorization: Bearer，服务端无状态校验。 - refresh token：随机串，落库
sundynix_refresh_tokens（只存 sha256）。小程序 30 天、后台 7 天。 - 续期：
POST /api/auth/refresh/POST /api/admin/refresh，入参{"refresh_token":"..."}，返回新的一对令牌。 - 退出：
POST /api/auth/logout/POST /api/admin/logout作废该刷新令牌。
安全约定：
- 每次续期都轮换刷新令牌，旧的立即作废；作废后 60 秒内再到达算并发重试（放行），超过则判定泄露，吊销该账号全部会话。
- 主动退出、被连坐吊销的令牌不享受宽限期。
- 禁用用户时一并吊销其刷新令牌，最多 2 小时后彻底失去访问。
前端两端都做了单飞续期：并发请求同时 401 只会发一次 refresh（否则刷新令牌会被并发轮换掉）。小程序续期失败会回退到 wx.login 重新登录。