feat: 宠物身份卡（canvas 绘制 + 小程序码 + 存相册/分享）

竞品那张「居民身份卡」，完整做了。 ## 后端 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>
2026-07-30 16:47:47 +08:00
parent 048408b0e9
commit cbfcaada55
13 changed files with 563 additions and 0 deletions
@@ -0,0 +1,89 @@
+package service
+
+import (
+	"log"
+	"strings"
+
+	"github.com/sundynix/pets-be/internal/model"
+)
+
+// IDCard 宠物身份卡的全部内容，前端拿去 canvas 上画
+type IDCard struct {
+	Name      string `json:"name"`
+	Species   string `json:"species"` // 猫猫 / 狗狗
+	Gender    string `json:"gender"`
+	Breed     string `json:"breed"`
+	Birthday  string `json:"birthday"` // "2023 年 12 月 15 日"
+	Intro     string `json:"intro"`
+	AvatarURL string `json:"avatar_url"`
+	IDNo      string `json:"id_no"`    // 玩具身份号，不入库
+	Validity  string `json:"validity"` // "2023.12.15 - 永远"
+	QRURL     string `json:"qr_url"`   // 小程序码，未发布时为空
+	QRReady   bool   `json:"qr_ready"` // 码有没有生成出来
+}
+
+// petIDNo 造一个稳定的「身份号」。纯装饰，不入库、不做校验。
+// 规律照竞品那种：一串数字，扫不出真实含义但看着像证件号。
+// 用 宠物雪花 id 的数字 + 生日 拼，同一只宠物每次都一样
+func petIDNo(pet *model.Pet) string {
+	digits := make([]byte, 0, 18)
+	for i := 0; i < len(pet.ID) && len(digits) < 10; i++ {
+		if pet.ID[i] >= '0' && pet.ID[i] <= '9' {
+			digits = append(digits, pet.ID[i])
+		}
+	}
+	for len(digits) < 10 {
+		digits = append(digits, '0')
+	}
+	bd := "00000000"
+	if pet.Birthday != nil && !pet.Birthday.IsZero() {
+		bd = pet.Birthday.Format("20060102")
+	}
+	raw := string(digits[:10]) + bd // 18 位
+	// 每 4 位空一下，像证件号
+	var b strings.Builder
+	for i, c := range raw {
+		if i > 0 && i%4 == 0 {
+			b.WriteByte(' ')
+		}
+		b.WriteRune(c)
+	}
+	return b.String()
+}
+
+// GetIDCard 组装身份卡。小程序码是 best-effort：拿不到（未发布/配额）也照出卡
+func (s *Service) GetIDCard(userID, petID string) (*IDCard, error) {
+	pet, err := s.GetPet(userID, petID)
+	if err != nil {
+		return nil, err
+	}
+
+	intro := "地球来了个新居民~"
+	switch pet.Type {
+	case "狗狗":
+		intro = "汪星人来地球啦~"
+	case "猫猫":
+		intro = "喵星人来地球啦~"
+	}
+
+	bd, validity := "未知", "永久有效"
+	if pet.Birthday != nil && !pet.Birthday.IsZero() {
+		bd = pet.Birthday.Format("2006 年 1 月 2 日")
+		validity = pet.Birthday.Format("2006.01.02") + " - 永远"
+	}
+
+	card := &IDCard{
+		Name: pet.Name, Species: pet.Type, Gender: pet.Gender, Breed: pet.Breed,
+		Birthday: bd, Intro: intro, AvatarURL: pet.AvatarURL,
+		IDNo: petIDNo(pet), Validity: validity,
+	}
+
+	// 小程序码取不到不算错——未发布/配额用尽时卡照样出，只是没码
+	if url, e := s.PetQRCode(petID); e == nil {
+		card.QRURL = url
+		card.QRReady = true
+	} else {
+		log.Printf("[info] 宠物 %s 的小程序码暂不可用（多为小程序未发布）：%v", petID, e)
+	}
+	return card, nil
+}