- 他应该知道的.md:生意背景/机器约束/数据边界/术语表/我们的纪律 - 回执模板.md:照着填即可(问题分析+改正意见+你改了什么+我方问题+运维个人想问的) - 两份交接说明里指向回执模板;仓库根 README 标出两批交付
127 lines
4.9 KiB
Markdown
127 lines
4.9 KiB
Markdown
# 回执模板 · 直接照着填就行
|
||
|
||
> 你**不用另起格式**,把下面每节填掉、删掉提示语即可。
|
||
> 文件名建议 `回执-<你的名字>.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 样例(脱敏)>
|
||
|
||
---
|
||
|
||
*(感谢。你写的每一条我们都会看,也会回你"采纳 / 不采纳 + 为什么"。)*
|