Files
sundynix-pets/pets-be
Blizzard 3ea50efb7d feat: 添加记录独立成页,表单字段由后端配置驱动
## 弹层里塞 24 个表单是走不通的
弹层高度受 .sheet-scroll 的 78vh 限制,字段一多就变成内滚;24 项的选择器
挤在弹层里更难看(用户原话「很丑」)。整体搬成页面。

## pages/addrecord —— 一个页面吃掉全部 24 种
形态:记录宠物 / 记录时间 / 类型专属字段 / 描述 + 照片 / 底部固定保存键。

关键在「类型专属字段」整段是后端驱动的:前端不认识「体重」「金额」这些业务词,
只认识 number / options / text 三种渲染方式,以及每个字段的值该落到哪儿。

record_types 加了 fields 列,后台用紧凑写法配(一行一个):

  number:体重:kg                    数值 → num_value
  options:状态:正常|软便|拉稀          单选 → category
  options:症状:呕吐|拉稀|精神差:-      末尾 - 表示不落 category,只进标题
  text:吃了什么                      文本 → 只进标题
  (空)                            只要 时间+描述+照片

解析放服务端不放前端:配错了要在后台保存时就报出来(第几行、错在哪),
不能等用户点开表单才发现渲染不出东西。读取时解析失败只让这一种事项没有额外
字段并打 warn,不让一条烂配置把整个记录页打空。

## 那个 - 开关不是过度设计
异常观察有两个单选(症状 + 严重程度),而 category 只有一个坑,
周报的高风险数按 category='高' 统计(report.go:46)——必须能指定谁占这个坑。
同理账单按 cost 的 category 分组聚合(report.go:134),
食便相关性排除 poop 的 category='正常'。这三处口径都得严丝合缝对上。

## 记录页瘦成纯列表
只留分组宫格。健康洞察 / 体重趋势 / 健康时间轴整页搬到 pages/history,
从报告页「记录与趋势」进——报告页才是看数据的地方,而一个「我要记一笔」的
页面上摆三块只读图表,用户每次都得先滚过去才能找到要点的东西。

**没有直接删掉那三块**:时间轴是唯一能看和删历史记录的地方,报告页只有
周报/账单这些聚合。删了用户就再也看不到自己记过什么。搬页面用的是 git 里
改动前的完整版复制,比往 report.js 里合并代码安全。

## 弹层瘦了一圈
9 个记录分支删掉,连带 17 个方法、SIMPLE_HINT、buildRecord 的 7 个 case
和一批只有它们在用的 data 字段。
  js   1089 → 857 行
  wxml  480 → 335 行
弹层现在只管「不是记一笔」的事:提醒、海报、档案、发帖、评论、导出、反馈。
buildRecord 只剩 vetSummary 一个分支(它写一条 note 留痕,不是用户填的表单)。

## 验证(预生产库实跑)
24 种的字段配置逐个核对解析结果,然后照 addrecord 的 buildBody 组装落库:
  体重  title='体重:4.6kg'        num=4.6            → 宠物档案回写成 4.6kg ✓
  记账  title='记账:128元 医疗'     num=128 cat=医疗    → 账单 total=128 分类[(医疗,128)] ✓
  异常  title='异常:呕吐 高'        cat=高             → 周报 high_risk_count=1 ✓
  排便  cat=软便                                    食便相关性口径保住
  饮食  title='饮食:幼猫粮 45g 偏少' cat=偏少
  喝水  num=180(新类型带数值,老代码没有它的分支也不影响)
  洗澡  title='洗澡'(无额外字段)
  看病  num=320(两个字段:文本+数值)
体重趋势 1 个点、值 4.6,没被其他 7 条污染。

回填踩过一次坑:fields 列是服务启动时 AutoMigrate 才建的,我在启动前就跑了
回填,Update 报错被忽略、13 行静默没写进去。第二版加了 HasColumn 前置检查
和逐行错误统计才发现。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-30 10:25:42 +08:00
..

毛孩子计划 · 后端 (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_sizeresponse.PageQuery + PageResult
  • MySQL root/rootpetsMinIO sundynix/sundynixpets
  • 服务端口 :8080;后台在 http://localhost:8080/adminseed 管理员 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/model GORM 模型(sundynix_ 前缀)
  • internal/database 连接/迁移/seed
  • internal/storage MinIO 封装(自动建桶 + 上传)
  • internal/service 业务逻辑;internal/handler HTTP 处理器;internal/router 路由
  • internal/middleware CORS / 用户鉴权 / 管理员鉴权
  • internal/admin go:embed 内嵌后台产物 + SPA fallback
  • pkg/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: truePOST /api/auth/login {"nickname":"xxx"} 即发用户 JWT。 接真微信:在 configs/config.yamlwechat.app_secret 并把 dev_login 置 false,实现 /api/auth/wechat(code2session)。

access token + refresh token

登录接口返回 token(access) 与 refresh_token 两个令牌:

  • access tokenJWT,默认 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 重新登录。