backend: 交付网站后端 + 本地自助管理后台 + 测试工程(已脱敏)
范围由店主圈定:网页后端 / 自助后端、本地的自助管理后台、 用于测试的 Blender 工程、以及部署层的反代片段。 出站纪律:所有指向真实环境的值(域名/端口/盘符路径/IP/账户名)已替换为占位; 代码里本来就没有硬编码凭据(令牌走文件与环境变量)。 Blender 工程因内嵌绝对路径,做了等长替换(文件字节数未变,结构完好)。 两份交接文档各含《我们的思路与方法》,并要求对方回: 问题分析 + 改正意见 + 他改了什么(含是否动到接口/字段/数据格式)。
This commit is contained in:
@@ -0,0 +1,125 @@
|
||||
# 交付包 · 卡密 / 自助渲染下单(后端 + 工具)
|
||||
|
||||
> **交付方**:苏达(网站运维与技术提供)
|
||||
> **收件方**:外部协作者
|
||||
> **日期**:2026-10-05
|
||||
> **本次交付由店主拍板,范围就是他圈定的**:网站后端 + 工具后端,全部脱敏,各配交接文档。
|
||||
|
||||
---
|
||||
|
||||
## 包里有什么(按店主划的交付范围)
|
||||
|
||||
| 店主说的 | 落在哪 | 里面是什么 | 交接文档 |
|
||||
|---|---|---|---|
|
||||
| **网页后端 / 自助后端** | `backend-site/` | 网站服务端全部逻辑:下单、卡密生命周期、队列、支付回调、打包下载、小票 + 管理 CLI + PNG 结构核验 | `backend-site/交接说明.md` |
|
||||
| **本地的自助管理后台** | `backend-tools/` | 局域网开单后台(带 PIN 锁)+ 纯本机开单工具 + 渲染机 + Blender 出图脚本 + 部署/启动脚本 | `backend-tools/交接说明.md` |
|
||||
| **用于测试的工程** | `模板/` | 三个 Blender 模板工程(已脱敏,可直接打开渲染) | `模板/说明.md` |
|
||||
| **其他需要的** | `deploy/` | 反向代理的路由与限流片段(部署层)+ 这一层的取舍说明 | `deploy/nginx-片段.md` |
|
||||
|
||||
---
|
||||
|
||||
## ⭐ 我们要你回的东西(这次交付的主要目的)
|
||||
|
||||
请你读完代码后,**各回一份**回执(就放在对应目录下,文件名 `回执-<你的名字>.md`),
|
||||
每份包含三段:
|
||||
|
||||
1. **问题分析** —— 你看到的问题/风险/坏味道,**分轻重**(会丢钱/丢数据/能被人打的排前面),
|
||||
尽量**指到具体函数或行**,并说清**什么条件下会踩到**。
|
||||
2. **改正意见** —— 每条给出你建议的改法,以及**代价**(改起来多大、会不会影响别处)。
|
||||
3. **你改了什么** —— 如果你直接动手改了,逐条列:
|
||||
```
|
||||
文件 / 函数: 为什么改: 改成什么(一句话):
|
||||
⚠️ 有没有动接口路径 / 请求响应字段 / 数据格式: ← 这三样动了我们必须知道
|
||||
你怎么验证的:
|
||||
```
|
||||
|
||||
> 两份交接文档里各有两个**我们自己拿不准的具体问题**,也请顺手回答一下。
|
||||
|
||||
**"你改了什么"为什么单独要一段**:这套系统是**两台机器上各跑一份代码**
|
||||
(服务器一份、店里电脑一份),两边靠接口对齐。你只改了其中一份、
|
||||
或者改了字段名却没标出来,我们这边会**静默出不来图** —— 不报错、就是没图,
|
||||
这种最难查。所以请务必标清楚。
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 三条纪律
|
||||
|
||||
1. **私有交付**:请勿外传、勿公开、勿镜像(含截图和片段)。
|
||||
里面的**占位值**(域名、端口、路径、IP)请**保持原样**,不要替换成任何真实地址。
|
||||
2. **不要为了"跑起来"去补真实凭据**:这份代码**设计上就跑不起来**(见下),
|
||||
我们是给你**读**的,不是给你部署的。要看运行效果用 `模板/` 那三个工程。
|
||||
3. **有看不懂的先问再改**,别猜 —— 猜错的表现是"静默失效",不报错。
|
||||
|
||||
---
|
||||
|
||||
## 关于"跑不起来"这件事(不是疏漏,是刻意的)
|
||||
|
||||
出站纪律要求:**任何离开我们机器的代码,先脱敏**。所以:
|
||||
|
||||
- 站点/支付平台的**域名** → `example.com` 系列(RFC 2606 保留域,永远不会指向真站)
|
||||
- **端口** → 中性数字(不是真端口)
|
||||
- **目录、盘符路径** → `<DATA_DIR>` / `<WORKER_DIR>` / `<WIN-PATH>` 这类占位
|
||||
- **家里出口 IP、局域网 IP** → `<LOCAL-IP>` 这类占位
|
||||
- **密钥 / 令牌的值** → 代码里本来就**没有硬编码**(全走文件与环境变量),所以这一项是干净的
|
||||
|
||||
**保留未换的**(说明一下,免得你以为我们漏了):
|
||||
- `localhost` —— 回环地址,通用值,不指向任何真实主机
|
||||
- `1000 / 1024 / 2048 / 4096` —— 是**出图分辨率**,业务常量,不是端口
|
||||
- **品牌笔名** —— 属公开署名,按我们的署名口径保留
|
||||
|
||||
---
|
||||
|
||||
## 关于 `模板/` 里那三个工程
|
||||
|
||||
渲染是**拿 Blender 模板工程 + 买家的皮肤贴图**渲出来的。要真跑一遍看效果,
|
||||
你需要模板 —— 所以店主选了三个给你:
|
||||
|
||||
| 文件 | 用途 |
|
||||
|---|---|
|
||||
| `1站立正反.blend` | 最基础的一个(站立,正反两面),**先用它把链路跑通** |
|
||||
| `4海边自拍.blend` | 场景类的,带环境(测"场景重"的时候用) |
|
||||
| `5不看爆炸.blend` | **另一个场景**(动感类),用来验证"换一个场景是不是也对" |
|
||||
|
||||
> 三个合起来约 45MB。**名字前面那个数字就是模板编号**,
|
||||
> 代码里 `TEMPLATES` 那张表就是靠编号对应的(一一对应,别改文件名)。
|
||||
|
||||
**渲染环境**:Blender 4.x,命令行后台模式(`-b --factory-startup`),
|
||||
Windows 下用 `pythonw.exe` 起。具体参数看 `backend-tools/make_order.py` 顶部的用法说明。
|
||||
|
||||
---
|
||||
|
||||
## 我们的思路与方法(两份交接文档里各有一节详版)
|
||||
|
||||
代码能看出"做了什么",看不出"为什么这么做、踩过什么坑"。所以两份交接文档里
|
||||
各加了一节**《我们的思路与方法》**,把这几样都摊开了,**请你连做法本身一起评**:
|
||||
|
||||
- **给自己定的硬规矩** —— 例:正常买家一步都不许多加(防探测改动不能误伤付钱的人);
|
||||
收钱的数字一律以服务器为准;状态话术不许骗人;同一件事的逻辑只写一处。
|
||||
- **干活的方法** —— 例:改一处要顺着所有调用点核一遍;同一个东西存两处时,
|
||||
先问"读取方按哪个字段找";前端必须真在浏览器里点一遍(一批 bug 在接口层根本测不出来);
|
||||
部署完要核对"跑的是不是新代码"。
|
||||
- **付过学费的坑** —— 例:静默失败最贵(不报错、不崩、就是没效果);
|
||||
显示层会骗人(订单算对了但界面从另一个来源取数);"改完不生效"是这套系统最高频的坑。
|
||||
|
||||
每份最后还有**三个我们拿不准的"做法"**请你表态(要不要换技术栈、单机多单怎么设计、
|
||||
部署不生效有没有更稳的机制)。
|
||||
|
||||
> 我们更想要的是**对做法的批评**,不只是对某几行代码的。如果整套思路就是错的,请直说。
|
||||
|
||||
---
|
||||
|
||||
## 交付清单(自查用)
|
||||
|
||||
- [x] 网站后端:`server.py` / `admin.py` / `pngcheck.py`,已脱敏
|
||||
- [x] 工具后端:19 个文件(含 `.bat` / `.ps1` / `.html` / 共用的 `skincheck.js` / Blender 脚本),已脱敏
|
||||
- [x] 两份交接文档(含《我们的思路与方法》)
|
||||
- [x] 三个模板工程,已脱敏(等长替换,文件字节数未变)
|
||||
- [x] 逐文件 SHA-256 清单(`交付清单.md`)
|
||||
- [x] 机器逐类扫描:**0 命中**(域名含大小写变体 / 端口 / 各类路径 / IP / 邮箱 / 密钥特征 /
|
||||
分享链里夹的群号与授权参数 / 第三方人名 / 长数字串)
|
||||
- [x] **独立第二双眼睛复查**(由另一个 agent 独立扫、不采信我们的自述结论)
|
||||
—— **它抓出了 3 处我们漏的**(Windows 账户名从路径与 SSH 用户名两处漏出、
|
||||
一处换过但仍像真路径的 `/srv`、一处把真端口换成了另一个像真端口的数)
|
||||
**以及 2 处"引用了却没带上"的缺件**(共用的质检脚本、打包脚本),全部已修并复扫 0 命中。
|
||||
- [ ] **故意没带的**(不是漏):运行期的数据文件(卡密池、订单、皮肤、成品、心跳、
|
||||
价格表、凭据文件等)—— 那些是**真实经营数据**,不在交付范围里。
|
||||
Reference in New Issue
Block a user