Files
nepiedg 1eab1b99c1 feat: rename qiniu to oss, add admin upload proxy with thumbnail, add dev-login
- Rename all QINIU_* config/code/docs to OSS_* to match actual Alibaba Cloud OSS
- Refactor upload module from internal/common/qiniu to internal/common/upload
- Add backend proxy upload endpoint (POST /api/admin/marketing/upload) to avoid CORS
- Auto-generate compressed thumbnail (800px, JPEG 80%) on admin image upload
- Add dev-login endpoint (POST /api/v1/auth/dev-login) for H5 debugging
- Add imageutil package for server-side image resizing

Made-with: Cursor
2026-04-04 02:52:16 +08:00

912 B
Raw Permalink Blame History

公共说明

本目录存放所有小程序共用的接口约定与调用方式,避免每个子系统重复描述。

基础信息

  • 接口前缀:/api/v1
  • 健康检查:GET /healthz{"status":"ok"}

通用响应结构

本项目所有接口使用统一 JSON 结构(见:docs/common/response.md):

{
  "code": 200,
  "message": "success",
  "data": {}
}

认证方式

除登录接口外,其他接口都需要携带登录后返回的 session_key(见:docs/common/auth.md)。

上传(阿里云 OSS 直传)

  • docs/common/upload_qiniu.md

微信公众号

  • docs/common/wechat_official.md

Redis

  • docs/common/redis.md

自动化部署(非 Docker

  • docs/common/deploy_ci.md

后端开发规范

  • docs/common/backend_convention.md(编码风格、模块分层、命名约定、接口规范、新增模块流程等)