Files
jinzuanwork/backend/回执模板.md
T
Suda c6034e9acd backend: 补《他应该知道的》与《回执模板》,并指路
- 他应该知道的.md:生意背景/机器约束/数据边界/术语表/我们的纪律
- 回执模板.md:照着填即可(问题分析+改正意见+你改了什么+我方问题+运维个人想问的)
- 两份交接说明里指向回执模板;仓库根 README 标出两批交付
2026-10-05 18:55:16 +08:00

127 lines
4.9 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 回执模板 · 直接照着填就行
> 你**不用另起格式**,把下面每节填掉、删掉提示语即可。
> 文件名建议 `回执-<你的名字>.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 样例(脱敏)>
---
*(感谢。你写的每一条我们都会看,也会回你"采纳 / 不采纳 + 为什么"。)*