Blizzard
cbfcaada55
竞品那张「居民身份卡」，完整做了。 ## 后端 service/wxacode.go —— 小程序码。两步：先拿 access_token（2h 有效，进程内缓存、 提前 5 分钟过期），再调 getwxacodeunlimit 换一张 PNG 存到 MinIO 返回 URL。 同一只宠物的码 object 名按 pet id 定死，存在就直接返回不重新生成 —— 微信侧有日调用配额，不能每次点都烧一次。 ⚠️ getwxacodeunlimit 要求 page 在**已发布**的小程序版本里。开发/未发布时返回 errcode 41030，实测确认。这时身份卡照常出、只是没码（qr_ready=false）， 发布后自动就有，不用改代码。best-effort，取不到不算错。 service/idcard.go —— 组装卡片内容。身份 ID 用「宠物雪花 id 的数字 + 生日」 拼成 18 位、每 4 位空一下，纯装饰不入库不校验，同一只每次都一样。 介绍按物种给默认（汪星人/喵星人来地球啦~）。有效期用生日起算。 GET /api/pets/:id/id-card storage 加了 Exists（StatObject），生成前先查。 ## 前端 pages/idcard 离屏 canvas 2d 画卡，导出成图展示 + 存相册 + 分享（open-type=share， imageUrl 用画好的卡当封面）。 两张远程图（头像 + 小程序码）都用 node.createImage() 异步加载， **Promise.all 等两张都就绪再开画** —— 否则小程序码会画不上或画一半 （规划里专门点过名的坑）。任一张加载失败 resolve(null)，缺图也照画： 头像缺→画物种 emoji，码缺→画「小程序码 待发布」占位框。 存相册的权限被拒过一次后 wx.authorize 不再弹，走 openSetting 引导（同海报那套）。 绘制复用了 bottom-sheet 里 poster 的 canvas 模式（dpr 放大、roundRect、 canvasToTempFilePath），但 poster 只画文字不画远程图，这里的双图加载是新写的。 入口：「我的」→ 身份卡，用当前选中的宠物。 ## 验证（预生产库实跑） id-card 接口返回：姓名/性别/品种/生日/介绍/身份ID/有效期 全对 身份 ID = 3410 4333 1420 2503 17（宠物id数字+生日，稳定） qr_ready = false，日志确认 41030 invalid page（小程序未发布，预期） canvas 版式用 HTML 复刻确认过：未发布=占位、发布后=真码 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 重新登录。