OuYingJun1024
9a2599bc3a
- README.md 翻新: 从 v0.1.0 登录模块版更新到当前(钱包/提现/签到/省钱/看广告/CPS); 目录结构按现状重写(integrations 含 pangle/wxpay、repositories 含全部数据访问、 core 含 ratelimit/rewards);API 改为按组速览 + 链 docs/api;建表步骤改为 alembic upgrade head(原步骤是过时的 autogenerate init);部署补微信支付证书同步 - docs/ad_reward_golive_checklist.md → docs/看广告赚金币上线清单.md(改中文名) - docs/README.md 文档库导航补 integrations/ + 数据库迁移.md + 看广告上线清单 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
26 lines
2.6 KiB
Markdown
26 lines
2.6 KiB
Markdown
# 后端文档库(docs/)
|
|
|
|
`shaguabijia-app-server` 的文档都在这里。各文档作用:
|
|
|
|
| 文档 / 目录 | 作用 |
|
|
|---|---|
|
|
| [后端技术实现.md](./后端技术实现.md) | **后端技术方案**:业务概览、分层架构与目录、登录链路、美团 CPS、领券透传、数据模型、配置与部署、已知问题。想了解"整个后端怎么回事"看这份。 |
|
|
| [api/](./api/) | **API 接口文档**(目录),采用"索引 + 一接口一文件",结构见下。想查"某个接口的协议"看这里。 |
|
|
| [integrations/](./integrations/) | **集成层实现文档**(目录):穿山甲验签 / 微信支付 / 极光 / 短信 / 美团 CPS 等 SDK 集成的签名、加解密、协议细节与踩坑。想知道"接外部服务那块到底怎么实现"看这里。 |
|
|
| [数据库迁移.md](./数据库迁移.md) | **Alembic 迁移指南**:clone 后如何建表、日常升级、新增迁移、迁移文件命名约定。想"把数据库跑起来 / 改表结构"看这份。 |
|
|
| [待办与技术债.md](./待办与技术债.md) | **待办与技术债账本**:记"现在先简化、以后要补"的事 + 跨前后端技术债(P1 鉴权/用户绑定、引擎移植待办等),免遗忘。想知道"还欠什么、以后要补什么"看这份。 |
|
|
| [看广告赚金币上线清单.md](./看广告赚金币上线清单.md) | **看广告发奖上线 checklist**:跨前后端,记上线前必做(GroMore 回调配置、清理调试脚手架、端到端验收)。上线"看广告赚金币"前对照这份。 |
|
|
|
|
## api/ 目录是怎么组织的(传送门式)
|
|
|
|
接口多了之后,单个大文件会臃肿、难维护,所以拆成 **一个索引 + 一个接口一个文件**:
|
|
|
|
- **[api/README.md](./api/README.md) — 入口/传送门**
|
|
一张总览表列出**全部接口**(方法、路径、鉴权),每行链接到该接口的独立文档;另含**通用约定**(错误码、时间格式等)和**复用数据结构**(`TokenPair` / `UserOut` / `CouponCard` 等)。它本身不展开每个接口的细节,只负责"指路"。
|
|
- **api/<模块>-<接口>.md — 单接口文档**
|
|
每个接口一个文件,只写自己的入参 / 出参 / 错误码 / 说明。命名按 `<模块>-<接口>`,如 `auth-jverify-login.md`、`coupon-step.md`、`meituan-feed.md`。
|
|
|
|
**查某个接口的协议**:先打开 [api/README.md](./api/README.md) 的总览表 → 找到接口 → 点链接进对应文档。
|
|
|
|
> **新增接口时**:在 `api/` 下加一个 `<模块>-<接口>.md`,并到 `api/README.md` 总览表里补一行链接。这样索引始终是唯一的"传送门",细节各自独立、互不干扰。
|