backend: 补《他应该知道的》与《回执模板》,并指路

Browse Source
- 他应该知道的.md:生意背景/机器约束/数据边界/术语表/我们的纪律
- 回执模板.md:照着填即可(问题分析+改正意见+你改了什么+我方问题+运维个人想问的)
- 两份交接说明里指向回执模板;仓库根 README 标出两批交付
This commit is contained in:
Suda
2026-10-05 18:55:16 +08:00
parent 1d67fda9d5
commit c6034e9acd
7 changed files with 280 additions and 2 deletions
+126
View File
@@ -0,0 +1,126 @@
# 回执模板 · 直接照着填就行
> 你**不用另起格式**,把下面每节填掉、删掉提示语即可。
> 文件名建议 `回执-<你的名字>.md`,放在仓库根目录。
> **填不满不要紧,写"没看/没测/没意见"比空着好** —— 空着我们不知道是漏了还是没问题。
---
# 回执 · <你的名字> · <日期>
## 0. 一句话总结
<这套代码整体你怎么看?哪里最值得先修?>
---
## 1. 问题分析
> 请**分轻重**:会丢钱 / 丢数据 / 能被别人利用的排前面,风格问题排后面。
> 尽量**指到具体位置**,并说清**什么条件下会踩到**(什么输入、什么并发时序、什么状态组合)。
| # | 严重度 | 位置(文件 : 函数 : 行) | 问题是什么 | 触发条件 | 影响 |
|---|---|---|---|---|---|
| 1 | 🔴高 / 🟡中 / 🟢低 | | | | |
| 2 | | | | | |
| 3 | | | | | |
<如果某条你自己也拿不准,就写"我怀疑但没验证" —— 那也很有用。>
---
## 2. 改正意见
> 每条说清**怎么改** + **代价**(改起来多大、会不会动到别处、要不要停机)。
> 如果某处你觉得**整体就该换个做法**,直接说,不用迁就现在的结构。
| 对应 # | 建议改法 | 代价 / 风险 | 优先级 |
|---|---|---|---|
| 1 | | | |
| 2 | | | |
---
## 3. 你改了什么(**改了就必须填**)
> 每条抄一份下面这个小块。**接口路径 / 请求响应字段 / 数据格式**这三样
> **动了必须单独标出来** —— 这套系统是两台机器上各跑一份代码,不同步会**静默出不来图**。
### 改动 1
```
文件 / 函数:
为什么改:
改成什么(一句话):
⚠️ 有没有动:接口路径 [ 是 / 否 ] 请求响应字段 [ 是 / 否 ] 数据格式 [ 是 / 否 ]
若"是",具体动了什么:
怎么验证的(跑了什么、看到什么):
有没有引入新的依赖:
```
### 改动 2
```
(同上)
```
---
## 4. 我们这边拿不准的,请你表态(逐条答,哪怕一句"现在这样够用"也行)
**Q1. 支付回调"不验签、改成拿开放接口反查"这个取舍,你认同吗?**
 我们手头没有对方的公钥,与其猜算法不如收到回调后反查这笔单是否真实存在且已付款。
 你怎么看?有没有更好的做法?
**Q2. 订单状态机在"部分失败"时怎么收口?**
 比如一单要出 3 张,第 2 张渲染失败。我们现在靠渲染机**显式发一个"收尾"信号**才判完成,
 否则订单会永远停在"渲染中"、被反复重渲。你觉得这个收口方式够不够?
**Q3. "改完不生效"这类问题,除了"先杀旧进程再起新的",有没有更稳的机制?**
**Q4. 单机多单:现在渲染是严格串行。** 如果要在同一台机器上支持多单同时渲染,
 你会怎么设计才**不会把机器顶满**?(先说方案,不用实现)
**Q5. 技术栈:我们现在是"单文件、纯标准库、零依赖"**(路由/校验/序列化全自己写)。
 好处是小机器跑得动、零安装;代价是自己写的这些一定有漏。
 **换你,你会不会上框架?** 请直说。
**Q6. 前后端共用一个质检脚本**(前端负责"拦"给用户看原因,后端负责"剥"元数据块)。
 这个设计省了逻辑漂移,但**两边判定必须一致**,不一致就会"网页说能传、后端说不行"。
 你觉得值不值?还是应该只留一边?
---
## 5. 苏达(运维)另外想知道的
> 这几条是我个人拿不准的,不属于"必须答",但你要是顺手能指一句,我少走很多弯路。
- **3100 行的单文件该不该拆、怎么拆?** 拆的话你最想先拆出哪一块?
- **卡密和订单用 JSON 文件存,而不是数据库**:并发写和"写到一半崩了"这两点,
在你看来风险有多大?有没有低成本的加固办法?
- **限流现在放在两个地方**(反向代理一层、应用自己一层)。这是重复还是互补?
有没有可能一边松一边紧、互相打架?
- **内存受限制的前提下**,你扫一眼觉得**还有哪些地方可能爆**?
- **日志与审计**:现在留痕比较散(几个 jsonl + 文件),你觉得够不够追责?
真要出事(比如买家投诉"我的图被别人下了"),现在这套记录能不能自证?
- **有没有你觉得"我们完全没想到"的角度?** 什么方向都行。
---
## 6. 你没验证的部分(说明原因就行)
> 比如"需要真机 / 需要凭据 / 需要买家皮肤 / 时间不够"。**写出来比假装测过好。**
- <例:渲染链路的真实耗时我没法复现,因为没有渲染机环境>
---
## 7. 你还需要什么材料
> 如果你觉得"要是有 XX 我就能判断得更准",列出来,我们补。
- <例:一份真实的订单 meta.json 样例(脱敏)>
---
*(感谢。你写的每一条我们都会看,也会回你"采纳 / 不采纳 + 为什么"。)*