nepiedg
1eab1b99c1
- 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
公共说明
本目录存放所有小程序共用的接口约定与调用方式，避免每个子系统重复描述。
基础信息
- 接口前缀：
/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（编码风格、模块分层、命名约定、接口规范、新增模块流程等）