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>
This commit is contained in:
Blizzard
@@ -195,3 +195,13 @@ func (h *Handler) PetStageDrift(c *gin.Context) {
|
||||
}
|
||||
response.OK(c, h.svc.CheckStageDrift(pet))
|
||||
}
|
||||
|
||||
// PetIDCard GET /api/pets/:id/id-card 宠物身份卡内容（含小程序码，未发布时无码）
|
||||
func (h *Handler) PetIDCard(c *gin.Context) {
|
||||
card, err := h.svc.GetIDCard(middleware.UserID(c), idParam(c, "id"))
|
||||
if err != nil {
|
||||
respondErr(c, err)
|
||||
return
|
||||
}
|
||||
response.OK(c, card)
|
||||
}
|
||||
|
||||
@@ -75,6 +75,7 @@ func registerUserAPI(api *gin.RouterGroup, h *handler.Handler, jm *appjwt.Manage
|
||||
g.GET("/pets/:id/plan", h.GetPlan)
|
||||
g.GET("/pets/:id/plan/calendar", h.PlanCalendar)
|
||||
g.GET("/pets/:id/stage-drift", h.PetStageDrift)
|
||||
g.GET("/pets/:id/id-card", h.PetIDCard)
|
||||
g.GET("/pets/:id/plan/month-status", h.PlanMonthStatus)
|
||||
// 养护方案：列出可选的、套用一套到某个月
|
||||
g.GET("/care-templates", h.CareTemplateOptions)
|
||||
|
||||
@@ -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
|
||||
}
|
||||
@@ -0,0 +1,125 @@
|
||||
package service
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"context"
|
||||
"encoding/json"
|
||||
"errors"
|
||||
"fmt"
|
||||
"io"
|
||||
"net/http"
|
||||
"net/url"
|
||||
"sync"
|
||||
"time"
|
||||
)
|
||||
|
||||
// 小程序码（wxacode）。身份卡右下角那个码，扫了能进小程序。
|
||||
//
|
||||
// 两步：先拿 access_token（有 2h 有效期，缓存复用），再调 getwxacodeunlimit
|
||||
// 换一张 PNG，存到 MinIO 返回 URL。同一只宠物的码存一次就够——微信侧有
|
||||
// 日调用配额，object 名按宠物 id 定死，存在就直接返回不重新生成。
|
||||
//
|
||||
// ⚠️ getwxacodeunlimit 要求 page 存在于**已发布**的小程序版本里。开发版/未发布
|
||||
// 时会返回 errcode 41030（page 不存在），这时身份卡照常出，只是没有码。
|
||||
// 发布之后自动就有了，不用改代码。
|
||||
|
||||
// accessToken 缓存。进程级，够用——多实例各自缓存不影响正确性
|
||||
var (
|
||||
atMu sync.Mutex
|
||||
atValue string
|
||||
atExpires time.Time
|
||||
)
|
||||
|
||||
// wechatAccessToken 取 access_token，带缓存。提前 5 分钟过期，避免边界上用到失效的
|
||||
func (s *Service) wechatAccessToken() (string, error) {
|
||||
atMu.Lock()
|
||||
defer atMu.Unlock()
|
||||
if atValue != "" && time.Now().Before(atExpires) {
|
||||
return atValue, nil
|
||||
}
|
||||
if s.cfg.WeChat.AppID == "" || s.cfg.WeChat.AppSecret == "" {
|
||||
return "", errors.New("微信 app_id / app_secret 未配置")
|
||||
}
|
||||
q := url.Values{}
|
||||
q.Set("grant_type", "client_credential")
|
||||
q.Set("appid", s.cfg.WeChat.AppID)
|
||||
q.Set("secret", s.cfg.WeChat.AppSecret)
|
||||
|
||||
ctx, cancel := context.WithTimeout(context.Background(), 8*time.Second)
|
||||
defer cancel()
|
||||
req, _ := http.NewRequestWithContext(ctx, http.MethodGet,
|
||||
"https://api.weixin.qq.com/cgi-bin/token?"+q.Encode(), nil)
|
||||
resp, err := http.DefaultClient.Do(req)
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
|
||||
var out struct {
|
||||
AccessToken string `json:"access_token"`
|
||||
ExpiresIn int `json:"expires_in"`
|
||||
ErrCode int `json:"errcode"`
|
||||
ErrMsg string `json:"errmsg"`
|
||||
}
|
||||
if err := json.NewDecoder(resp.Body).Decode(&out); err != nil {
|
||||
return "", err
|
||||
}
|
||||
if out.AccessToken == "" {
|
||||
return "", fmt.Errorf("拿 access_token 失败(%d): %s", out.ErrCode, out.ErrMsg)
|
||||
}
|
||||
atValue = out.AccessToken
|
||||
atExpires = time.Now().Add(time.Duration(out.ExpiresIn-300) * time.Second)
|
||||
return atValue, nil
|
||||
}
|
||||
|
||||
// PetQRCode 取某只宠物的小程序码 URL。存在就直接返回，不存在才向微信换。
|
||||
// scene 里带宠物 id，扫码进来时小程序能拿到（暂时只用来打开小程序）
|
||||
func (s *Service) PetQRCode(petID string) (string, error) {
|
||||
if s.storage == nil {
|
||||
return "", errors.New("对象存储未配置")
|
||||
}
|
||||
obj := "wxacode/" + petID + ".png"
|
||||
if s.storage.Exists(obj) {
|
||||
return s.storage.PublicURL(obj), nil
|
||||
}
|
||||
|
||||
token, err := s.wechatAccessToken()
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
body, _ := json.Marshal(map[string]any{
|
||||
"scene": "pet=" + petID, // 最长 32 字符，够放一个雪花 id
|
||||
"page": "pages/home/home",
|
||||
"check_path": true,
|
||||
"width": 280,
|
||||
})
|
||||
ctx, cancel := context.WithTimeout(context.Background(), 12*time.Second)
|
||||
defer cancel()
|
||||
req, _ := http.NewRequestWithContext(ctx, http.MethodPost,
|
||||
"https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token="+token, bytes.NewReader(body))
|
||||
req.Header.Set("Content-Type", "application/json")
|
||||
resp, err := http.DefaultClient.Do(req)
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
|
||||
data, err := io.ReadAll(resp.Body)
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
// 成功返回图片二进制；失败返回一段 JSON。用 Content-Type 分辨最稳
|
||||
if ct := resp.Header.Get("Content-Type"); len(ct) >= 5 && ct[:5] == "image" {
|
||||
if _, err := s.storage.Upload(obj, bytes.NewReader(data), int64(len(data)), "image/png"); err != nil {
|
||||
return "", err
|
||||
}
|
||||
return s.storage.PublicURL(obj), nil
|
||||
}
|
||||
var e struct {
|
||||
ErrCode int `json:"errcode"`
|
||||
ErrMsg string `json:"errmsg"`
|
||||
}
|
||||
_ = json.Unmarshal(data, &e)
|
||||
// 41030 = page 不在已发布版本里。开发期常见，往上层透传让它降级
|
||||
return "", fmt.Errorf("微信生成小程序码失败(%d): %s", e.ErrCode, e.ErrMsg)
|
||||
}
|
||||
@@ -92,6 +92,15 @@ func (s *Storage) Upload(objectName string, reader io.Reader, size int64, conten
|
||||
return s.PublicURL(objectName), nil
|
||||
}
|
||||
|
||||
// Exists 对象在不在。小程序码有微信侧配额，同一只宠物的码存一次就够，
|
||||
// 生成前先查
|
||||
func (s *Storage) Exists(objectName string) bool {
|
||||
ctx, cancel := context.WithTimeout(context.Background(), 8*time.Second)
|
||||
defer cancel()
|
||||
_, err := s.client.StatObject(ctx, s.bucket, objectName, minio.StatObjectOptions{})
|
||||
return err == nil
|
||||
}
|
||||
|
||||
// PublicURL 由对象名拼出可访问 URL（用当前配置的 public_base_url，避免存旧地址）
|
||||
func (s *Storage) PublicURL(objectName string) string {
|
||||
return fmt.Sprintf("%s/%s/%s", s.publicBaseURL, s.bucket, objectName)
|
||||
|
||||
Reference in New Issue
Block a user