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

4.9 KiB
Raw Permalink Blame History

回执模板 · 直接照着填就行

你不用另起格式,把下面每节填掉、删掉提示语即可。 文件名建议 回执-<你的名字>.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 样例(脱敏)>

(感谢。你写的每一条我们都会看,也会回你"采纳 / 不采纳 + 为什么"。)