D1 业务全景与开发环境 — 课件

用法：每行为一张幻灯片要点，可直接转 PPT/PDF。

1. 封面

• D1 业务全景与开发环境｜第 1 周｜讲师：（主人）
• 培训：《Claude Token 业务工程师基础培训》

2. 目录

• 公司业务模型
• 上下游架构
• sub2api / newapi / oneapi 角色
• 服务清单与域名
• 一次请求全流程
• 环境搭建
• 公司规范与红线

3. 公司业务模型

• 幻灯1：我们卖什么？—— 卖的是"可靠、便宜、可计费的 Claude 调用能力"
• 幻灯2：什么是 token（计费单位）—— 输入 token + 输出 token 都计费
• 幻灯3：一句话链路 —— 上游密钥 → 中游网关 → 下游客户

4. 上下游架构

• 幻灯1：架构图（上游 / 中游 / 下游）
• 幻灯2：中游是什么 —— 鉴权、转发、计费、限流、多上游负载均衡
• 幻灯3：为什么中游是核心资产 —— 上游会变、客户会变、计费能力不变

5. 三个网关角色

• 幻灯1：sub2api = 自研计费系统（主营业务核心，面向客户算钱）
• 幻灯2：newapi / oneapi = 通用 LLM 网关（把上游变成统一 API）
• 幻灯3：记忆法 —— newapi 负责"统一接口"，sub2api 负责"算钱"

6. 服务清单与域名

• 幻灯1：域名体系 *.akria.net，集群 prod k3s（唯一生产）
• 幻灯2：核心服务速览（api/oneapi/db/kuma/monitor.akria.net）
• 幻灯3：部署链路 —— GitHub Actions + git tag → 镜像 → k3s

7. 一次请求全流程（重点，讲师现场走查）

• 幻灯1：7 步流程（key → 鉴权 → 余额 → 选上游 → 转发 → 流式返回 → 计费）
• 幻灯2：哪一步是核心？—— 第 6 步计费
• 幻灯3：让学员轮流复述这条链

8. 环境搭建（现场演示）

• 幻灯1：SSH key 生成与配置
• 幻灯2：工具链清单（git/python3/node/docker/kubectl/VSCode）
• 幻灯3：克隆公司仓库（真实 remote 地址）
• 幻灯4：测试环境 vs 生产环境（prod 只读）

9. 公司规范与红线

• 幻灯1：中文协作 / 中文提交信息
• 幻灯2：Class A（需批准）vs Class B（直接执行）
• 幻灯3：OPS_JOURNAL 记录
• 幻灯4：新人红线 —— 生产只读，写操作先问

10. 作业布置

• 幻灯1：画业务架构图 + 环境验证 + 规范小测
• 幻灯2：截止时间与提交方式（Git PR，中文提交信息）

11. 结尾

• 预告 D2：网络基础 TCP/IP —— 为理解"请求怎么在路上跑"打地基