feat(be): 记录类型挪进数据库,后台可配 + 15 种新类型
## 为什么 9 种记录类型全是低频医疗和记账(疫苗一年一次、驱虫一季一次、体检更少), 用户今天打开 App 大概率没什么可记,时间轴是空的。竞品 35 种里有 26 种是 高频日常(洗澡/剪指甲/换猫砂/喝水/洗食盆),那才是每天打开的理由。 ## 一个比预想好得多的发现 本来担心加类型会踩到分析逻辑。把那 9 个常量的引用全捞了一遍,结论是不会: weight record.go:83 回写宠物体重;home/insight/report 的体重趋势与基准 food + poop insight.go:130 食便相关性 symptom insight.go:160 症状聚类;report 高风险计数 cost report.go:99 消费统计 vaccine report.go:137 疫苗完成度 deworm/medicine/photo 没有任何特殊分支 这些分支全都是「按某个具体常量过滤」,没有一处是 switch 全枚举、也没有 default 兜底。CreateRecord 更是完全没有 type 白名单校验。所以新增类型 不可能碰到任何现存逻辑——一行分析代码都不用改。 于是分工是: record_types 表 负责「展示什么、能记什么」 那 9 个常量 负责「哪几种参与分析」 两者各管一段,常量一个都没删。 ## 表设计 code / label / icon / group_key / sort / enabled / form / locked。 group_key 而不是 group:group 是 MySQL 保留字,GORM 会加反引号所以能跑, 但手写 SQL 排查时很容易踩。 form 区分 full(弹层里有专用 wx:elif 分支)和 simple(时间+备注+照片)。 15 种新类型全是 simple——下一步在弹层加一个通用分支吃掉它们,不然 28 个 分支再加 15 个会把 bottom-sheet 写到 1800 行。 locked 给那 9 种:有代码分支依赖、且被 care_template_items.sheet_type 引用。 ## 两条硬拦在 service 层的规则 1. locked 的删不掉 2. 已经有记录的删不掉(删了历史记录会变孤儿) 想让它从记录页消失应该用 enabled=false,历史记录仍能正常显示。 都在 service 层拦,不是靠前端隐藏按钮。改 code 同样受 2 的约束—— code 是落库值,改了历史记录会对不上任何类型。 ## bootstrap 的取舍 文章和养护模板当初按你的要求从代码里挪走了,这次 24 种类型仍然放在 seed 里, 因为它不是内容而是结构:表空着记录页一个可记事项都没有,App 直接不能用。 和管理员账号一样,只在表**完全为空**时铺一次,之后一切以数据库为准。 表非空就完全不碰,否则后台删掉的类型会每次重启自己长回来。 ListRecordTypes 在表为空时返回空数组 + 打 warn,不硬编码兜底一份—— 那等于把「可配置」又变回代码常量,下次改配置的人会发现改了没用。 ## 图标 新增 15 个(iconfont.wxss 40 → 55),全部取自本地那份 tabler-icons-3.46.0 真源,不是凭记忆画路径。已解码抽检确认路径非空。 ## 验证(生产库实跑) 建表 + 24 条 bootstrap 一次到位,分组 daily6/health7/care6/clean5 locked 9 个、simple 表单 15 个 规则 1 删 weight → 「有统计和分析逻辑依赖它,不能删」 规则 2 新增 nose 成功 → 重复 code 报错 → 删除成功 规则 3 造 1 条 tmptest 记录 → 删类型被拦;删掉记录后再删 → 成功;残留 0 规则 4 停用「美容」→ 小程序端洗护组只剩 5 项;恢复后回到 6 项 规则 3 一开始没真验到:库里唯一的记录类型是 weight,locked 先拦住了, 「已有记录」那个分支根本没走到。补了个造真记录的测试才算验过。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -29,6 +29,7 @@ func AllModels() []any {
|
||||
&User{},
|
||||
&Pet{},
|
||||
&HealthRecord{},
|
||||
&RecordType{},
|
||||
&DailyTask{},
|
||||
&Plan{},
|
||||
&PlanTask{},
|
||||
|
||||
@@ -0,0 +1,47 @@
|
||||
package model
|
||||
|
||||
// 记录类型。原来这 9 种是写在 health_record.go 里的常量,加一种就得发版;
|
||||
// 挪到表里之后后台可以直接增删改。
|
||||
//
|
||||
// 注意这里**没有**替换掉那 9 个常量:weight / poop / food / symptom / cost /
|
||||
// vaccine 在 record.go、insight.go、report.go、home.go 里有真实的代码分支
|
||||
// (体重回写宠物档案、食便相关性分析、消费统计、疫苗完成度……),那些分支
|
||||
// 按具体常量过滤,不是 switch 全枚举。所以:
|
||||
// - 表负责「展示什么、能记什么」
|
||||
// - 常量负责「哪几种参与分析」
|
||||
// 两者各管一段,新增类型不会碰到任何分析逻辑。
|
||||
|
||||
// 记录类型分组
|
||||
const (
|
||||
RecordGroupDaily = "daily" // 日常
|
||||
RecordGroupHealth = "health" // 健康
|
||||
RecordGroupCare = "care" // 洗护
|
||||
RecordGroupClean = "clean" // 清洁
|
||||
)
|
||||
|
||||
// 弹层形态
|
||||
const (
|
||||
RecordFormFull = "full" // 有专用表单(原来那 9 种,各自一个 wx:elif 分支)
|
||||
RecordFormSimple = "simple" // 通用简易表单:发生时间 + 备注 + 可选照片
|
||||
)
|
||||
|
||||
// RecordType 一种可记录的事项
|
||||
type RecordType struct {
|
||||
Base
|
||||
// Code 就是小程序 bottom-sheet 的 type,也是 health_records.type 落库的值。
|
||||
// 建过记录之后改 Code 会让历史数据对不上,后台不允许改(只能删了重建)。
|
||||
Code string `gorm:"size:32;uniqueIndex" json:"code"`
|
||||
Label string `gorm:"size:32" json:"label"`
|
||||
Icon string `gorm:"size:32" json:"icon"` // pt-icon 名,见 styles/iconfont.wxss
|
||||
|
||||
// GroupKey 存成 group_key 而不是 group:group 是 MySQL 保留字,
|
||||
// GORM 虽然会加反引号,但手写 SQL 排查时很容易踩
|
||||
GroupKey string `gorm:"column:group_key;size:16;index" json:"group"`
|
||||
Sort int `json:"sort"`
|
||||
Enabled bool `gorm:"default:true" json:"enabled"`
|
||||
Form string `gorm:"size:16" json:"form"`
|
||||
|
||||
// Locked 有代码分支或模板引用依赖它,后台不许删。
|
||||
// 硬拦在 service 层,不是靠前端隐藏按钮。
|
||||
Locked bool `json:"locked"`
|
||||
}
|
||||
Reference in New Issue
Block a user