c4c0c2b7cd
## 你问的「养了半年会不会自动切换」
原来的答案是「都不会,而且比这更糟」:
age「2个月」 建档时算好存进库,养半年后首页还显示 2个月
stage「幼年期」同上,一年后还是幼年期
养护方案 按 stage 挑的,所以永远给幼猫那套
NormalizeStage 只在建档那一次调用(handler/pet.go:51),之后就是两个死字符串。
现在:
age 改成计算字段(gorm:"-"),读取时现算。它没有手改需求,存下来只会过期。
填在 ownedPet 这个收口里,不是逐个函数补——那样漏一个就返回空年龄。
stage 保留存储(有正当的手改需求:领养的猫生日是估的,主人按体型判断更准),
但加了漂移检测 GET /pets/:id/stage-drift。
**系统负责发现,用户负责决定。** 不自动改的三个理由:
1. 用户可能手改过
2. 已经排好的这个月计划不该被推翻(套用是「往里加」不是「替换」)
3. 偷偷换会让用户莫名发现计划变了,找不到原因
## 猫狗不能共用阈值 —— 这是这次最实质的发现
原来一刀切「<12月幼年,>=7岁老年」,对猫勉强,对狗两头都错:
吉娃娃 8 个月已性成熟、可换成犬粮;大丹犬 8 个月还在长骨头,
这时喂成犬粮(钙磷比和热量密度都不同)会加重关节负担。
吉娃娃 7 岁还在成年期(8 岁才进中年,能活 13-16 年);
大丹犬 7 岁已是老年(平均寿命 7-10 年)。
所以狗的阶段判定要看体型。体型不能靠当前体重(幼犬体重说明不了成年后多大),
只能靠品种 —— breeds 表加 size_class,45 个犬种逐个标了。
实测:同样 10 个月大 → 吉娃娃青年期、柴犬幼年期、金毛幼年期、大丹犬幼年期;
同样 7 岁 → 吉娃娃成年期、大丹犬老年期。
## 阶段 3 段 → 5 段
幼年期 / 青年期 / 成年期 / 中年期 / 老年期。
标签做成物种中立(不分幼猫期/幼犬期)——物种本来是另一个字段,
分开会让 (species,stage) 的组合和方案配置都翻倍。
「刚到家 0-30 天」不进这五段:它和年龄正交(刚接回家的成年猫两套都需要),
代码里本来就是叠加处理的。
猫按 AAFP/AAHA 猫生命阶段指南那套,在成年里细分出中年。
狗五段的阈值按体型走四组,越大的犬种生长期越长、老得越早。
## 划分标准和判定用同一张表
StageRules 那张表既驱动判定,也直接吐给前端当依据展示
(GET /api/life-stages?species=dog&size=giant)。
不是「代码里判定 + 文档里写标准」——后者一定会漂:改了阈值忘了改文档,
用户看到的说明和实际行为对不上,比没有说明更糟。
建档第三步的阶段选择器现在会显示「0-18 月 · 巨型犬生长期最长,18 个月还在长;
这阶段最忌过度补钙」,还会标出「巨型犬(成年 >40kg)——阶段阈值按体型算」。
前端和后台的 STAGES 硬编码列表都删了,改成读后端。
## 10 套方案,内容按各阶段真实重点配
不是把同一份换个名字:
幼年期 疫苗序列 + 驱虫 + 社会化,大型犬还要控制生长速度
青年期 绝育窗口 + 换成年粮
成年期 维持期,把基线数据记下来
中年期 年度血检开始有意义,体重和牙结石重点看
老年期 体检半年一次;猫记饮水量(多饮多尿是慢性肾病最典型的早期表现)、
狗记精神食欲,都设成「重要」
老的 8 套(按 3 段配的)改名停用不删:万一新内容有问题还能翻回去看;
而且已套用出去的计划早就和模板断开了,停用不影响任何用户。
## 验证(预生产库实跑)
体型判定 10 个月 / 7 岁两组对照,四个体型都落在预期阶段
age '13个月' 现算,不入库
漂移检测 手改成幼年期后 drifted=true,连带给出新阶段的依据和重点
划分标准 猫 5 段、狗 4 个体型各 5 段,老年起点 7/8/10/11 岁
全链路 3 个月大丹犬建档 → 幼年期 → 0 任务 + 4 条必要提醒 →
挑「幼犬标准照护」→ 套用下月 104 条节点,
周四那天正确出现每周项(检查爪垫和耳朵)
迁移 45 个犬种体型回填;现有 5 只宠物阶段重算后无变化(原本都对)
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
198 lines
5.3 KiB
Go
198 lines
5.3 KiB
Go
package handler
|
|
|
|
import (
|
|
"time"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
"gorm.io/datatypes"
|
|
|
|
"github.com/sundynix/pets-be/internal/middleware"
|
|
"github.com/sundynix/pets-be/internal/model"
|
|
"github.com/sundynix/pets-be/internal/service"
|
|
"github.com/sundynix/pets-be/pkg/response"
|
|
)
|
|
|
|
type petReq struct {
|
|
Name string `json:"name"`
|
|
Emoji string `json:"emoji"`
|
|
Type string `json:"type"`
|
|
Gender string `json:"gender"`
|
|
Birthday string `json:"birthday"` // YYYY-MM-DD
|
|
ArrivedAt string `json:"arrived_at"` // YYYY-MM-DD,到家日期
|
|
Weight string `json:"weight"`
|
|
Stage string `json:"stage"`
|
|
Age string `json:"age"`
|
|
Color string `json:"color"`
|
|
Breed string `json:"breed"`
|
|
AvatarFileID string `json:"avatar_file_id"`
|
|
Goals []string `json:"goals"`
|
|
}
|
|
|
|
func (r petReq) toInput() service.PetInput {
|
|
in := service.PetInput{
|
|
Name: r.Name, Emoji: r.Emoji, Type: r.Type, Gender: r.Gender,
|
|
Weight: r.Weight, Stage: r.Stage, Age: r.Age, Color: r.Color, Breed: r.Breed,
|
|
AvatarFileID: r.AvatarFileID,
|
|
}
|
|
if r.Birthday != "" {
|
|
if t, err := time.ParseInLocation("2006-01-02", r.Birthday, time.Local); err == nil {
|
|
// 生日不接受未来日期:前端限制过一道,服务端不能只信前端
|
|
if !t.After(time.Now()) {
|
|
in.Birthday = &t
|
|
}
|
|
}
|
|
}
|
|
if r.ArrivedAt != "" {
|
|
if t, err := time.ParseInLocation("2006-01-02", r.ArrivedAt, time.Local); err == nil && !t.After(time.Now()) {
|
|
in.ArrivedAt = &t
|
|
}
|
|
}
|
|
// 阶段归一化不在这里做:狗要按品种查体型才能定阈值,需要访问 DB。
|
|
// 交给 handler 里 h.svc.NormalizeStage 处理。
|
|
if r.Goals != nil {
|
|
if b, err := jsonMarshal(r.Goals); err == nil {
|
|
in.Goals = datatypes.JSON(b)
|
|
}
|
|
}
|
|
return in
|
|
}
|
|
|
|
// ListPets GET /api/pets
|
|
func (h *Handler) ListPets(c *gin.Context) {
|
|
pets, err := h.svc.ListPets(middleware.UserID(c))
|
|
if err != nil {
|
|
response.FailErr(c, err)
|
|
return
|
|
}
|
|
response.OK(c, pets)
|
|
}
|
|
|
|
// CreatePet POST /api/pets
|
|
func (h *Handler) CreatePet(c *gin.Context) {
|
|
var req petReq
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
|
response.FailParams(c, err.Error())
|
|
return
|
|
}
|
|
in := req.toInput()
|
|
in.Stage = h.svc.NormalizeStage(service.SpeciesOf(req.Type), req.Breed, in.Stage, in.Birthday)
|
|
pet, err := h.svc.CreatePet(middleware.UserID(c), in)
|
|
if err != nil {
|
|
response.FailErr(c, err)
|
|
return
|
|
}
|
|
response.OK(c, pet)
|
|
}
|
|
|
|
// GetPet GET /api/pets/:id
|
|
func (h *Handler) GetPet(c *gin.Context) {
|
|
pet, err := h.svc.GetPet(middleware.UserID(c), idParam(c, "id"))
|
|
if err != nil {
|
|
respondErr(c, err)
|
|
return
|
|
}
|
|
response.OK(c, pet)
|
|
}
|
|
|
|
// UpdatePet PUT /api/pets/:id
|
|
func (h *Handler) UpdatePet(c *gin.Context) {
|
|
var req petReq
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
|
response.FailParams(c, err.Error())
|
|
return
|
|
}
|
|
fields := map[string]any{}
|
|
if req.Name != "" {
|
|
fields["name"] = req.Name
|
|
}
|
|
if req.Emoji != "" {
|
|
fields["emoji"] = req.Emoji
|
|
}
|
|
if req.Weight != "" {
|
|
fields["weight"] = req.Weight
|
|
}
|
|
if req.Stage != "" {
|
|
fields["stage"] = req.Stage
|
|
}
|
|
if req.Gender != "" {
|
|
fields["gender"] = req.Gender
|
|
}
|
|
if req.Age != "" {
|
|
fields["age"] = req.Age
|
|
}
|
|
if req.Color != "" {
|
|
fields["color"] = req.Color
|
|
}
|
|
if req.Breed != "" {
|
|
fields["breed"] = req.Breed
|
|
}
|
|
if req.AvatarFileID != "" {
|
|
fields["avatar_file_id"] = req.AvatarFileID
|
|
}
|
|
pet, err := h.svc.UpdatePet(middleware.UserID(c), idParam(c, "id"), fields)
|
|
if err != nil {
|
|
respondErr(c, err)
|
|
return
|
|
}
|
|
response.OK(c, pet)
|
|
}
|
|
|
|
// DeletePet DELETE /api/pets/:id
|
|
func (h *Handler) DeletePet(c *gin.Context) {
|
|
if err := h.svc.DeletePet(middleware.UserID(c), idParam(c, "id")); err != nil {
|
|
respondErr(c, err)
|
|
return
|
|
}
|
|
response.OK(c, gin.H{"deleted": true})
|
|
}
|
|
|
|
// Onboarding POST /api/onboarding
|
|
func (h *Handler) Onboarding(c *gin.Context) {
|
|
var req petReq
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
|
response.FailParams(c, err.Error())
|
|
return
|
|
}
|
|
in := req.toInput()
|
|
in.Stage = h.svc.NormalizeStage(service.SpeciesOf(req.Type), req.Breed, in.Stage, in.Birthday)
|
|
pet, err := h.svc.Onboarding(middleware.UserID(c), in)
|
|
if err != nil {
|
|
response.FailErr(c, err)
|
|
return
|
|
}
|
|
response.OK(c, pet)
|
|
}
|
|
|
|
// Breeds GET /api/breeds?species=cat 品种,按首字母分组。
|
|
// 建档第二步的选择器直接照这个渲染,前端不做分组也不做排序
|
|
func (h *Handler) Breeds(c *gin.Context) {
|
|
response.OK(c, h.svc.ListBreeds(c.Query("species")))
|
|
}
|
|
|
|
// LifeStages GET /api/life-stages?species=dog&size=large
|
|
// 生命阶段的划分标准。建档时选阶段那里、和「该换方案了」的提示里都要展示依据,
|
|
// 所以直接把驱动判定的那张表吐出来 —— 不另写一份说明文案,免得两边漂
|
|
func (h *Handler) LifeStages(c *gin.Context) {
|
|
species := c.Query("species")
|
|
if species == "" {
|
|
species = model.SpeciesCat
|
|
}
|
|
response.OK(c, gin.H{
|
|
"species": species,
|
|
"size": c.Query("size"),
|
|
"stages": service.StageRules(species, c.Query("size")),
|
|
"sizes": service.SizeLabels,
|
|
})
|
|
}
|
|
|
|
// PetStageDrift GET /api/pets/:id/stage-drift
|
|
// 存的阶段和按生日算的对不上时,告诉前端可以提示用户换一套方案
|
|
func (h *Handler) PetStageDrift(c *gin.Context) {
|
|
pet, err := h.svc.GetPet(middleware.UserID(c), idParam(c, "id"))
|
|
if err != nil {
|
|
respondErr(c, err)
|
|
return
|
|
}
|
|
response.OK(c, h.svc.CheckStageDrift(pet))
|
|
}
|