Files
sundynix-pets/pets-be
Blizzard 8507d5060b
deploy / deploy (push) Has been cancelled
fix(storage): 共用 MinIO 实例下不再覆盖已存在桶的访问策略
MinIO 是多服务共用实例(sundynix-agent / sundynix-plant 等)。原先
ensureBucket 每次启动都无条件 SetBucketPolicy 设为公开只读,一旦
MINIO_BUCKET 配错成别的服务的桶,启动一次就会把人家的桶悄悄改成
全网可读且无任何报错。

改为:桶已存在则只连接、绝不修改策略并打日志说明;仅对本服务新建的
桶设公开只读(小程序需要图片直链)。.env.example 补充共用实例注意事项,
并建议改用仅授权 sundynix-pet 的独立账号替代 root 凭据。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-25 16:57:37 +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)。