- 门户「金钻宇宙」:删掉启动仪式 / 宇宙首屏晶体 / 盘符机架 / 读盘舱及其 CSS、图标; 换成星系图(portal/assets/universe/,three.js r170 自托管于 assets/vendor/,第一次打开板块才下载) + 窗下世界线卡片;#0001 深链飞到对应世界线;世界线数据只留 config.js 一份 - 像素字子集重做(旧字全保留 + 新字);其余板块与改动前逐像素一致 - 后端审查:add_call 写库失败不再打断渲染机回传;多进程同时首启只导入一次(+1 条测试,共 38); 撤销「处理过了」清掉 handled_at - 交接文档-2026-10.md:变更清单 / 功能增删 / 接口与数据格式变更 / 设计规范 / 业务逻辑 / 部署运维 - 交付清单哈希重算;README、旧交接说明指路 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
142 lines
8.5 KiB
Markdown
142 lines
8.5 KiB
Markdown
# 交付包 · 卡密 / 自助渲染下单(后端 + 工具)
|
||
|
||
> **交付方**:苏达(网站运维与技术提供)
|
||
> **收件方**:外部协作者
|
||
> **日期**:2026-10-05
|
||
> **本次交付由店主拍板,范围就是他圈定的**:网站后端 + 工具后端,全部脱敏,各配交接文档。
|
||
|
||
---
|
||
|
||
## 怎么读这份包(建议顺序)
|
||
|
||
> 2026-10 这一轮(数据库、开单后台 / 本机开单重写、前端星系图)的总说明在仓库根目录 **`交接文档-2026-10.md`**。
|
||
|
||
| 顺序 | 读什么 | 为什么先读它 |
|
||
|---|---|---|
|
||
| 1 | **`他应该知道的.md`** | 生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— **不读这个,代码里很多东西推不出来** |
|
||
| 2 | 本文件 | 包里有什么、三条纪律、我们要你回什么 |
|
||
| 3 | `backend-site/交接说明.md` 或 `backend-tools/交接说明.md` | 各含一节**《我们的思路与方法》**(比代码更值得看:坑都是"不报错但坏掉"那一类) |
|
||
| 4 | 代码 | 到这儿再进代码 |
|
||
| 5 | **`回执模板.md`** | 写回执时照它填,**不用另起格式** |
|
||
|
||
---
|
||
|
||
## 包里有什么(按店主划的交付范围)
|
||
|
||
| 店主说的 | 落在哪 | 里面是什么 | 交接文档 |
|
||
|---|---|---|---|
|
||
| **网页后端 / 自助后端** | `backend-site/` | 网站服务端全部逻辑:下单、卡密生命周期、队列、支付回调、打包下载、小票 + 管理 CLI + PNG 结构核验 | `backend-site/交接说明.md` |
|
||
| **本地的自助管理后台** | `backend-tools/` | 局域网开单后台(带 PIN 锁)+ 纯本机开单工具 + 渲染机 + Blender 出图脚本 + 部署/启动脚本 | `backend-tools/交接说明.md` |
|
||
| **用于测试的工程** | `模板/` | 三个 Blender 模板工程(已脱敏,可直接打开渲染) | `模板/说明.md` |
|
||
| **其他需要的** | `deploy/` | 反向代理的路由与限流片段(部署层)+ 这一层的取舍说明 | `deploy/nginx-片段.md` |
|
||
| **背景须知** | `他应该知道的.md` | 生意背景 / 机器约束 / 数据边界 / 术语表 / 我们这边的纪律 | — |
|
||
| **回执模板** | `回执模板.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` / `store.py`(数据库,2026-10-05 加),已脱敏
|
||
- [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 命中。
|
||
- [ ] **故意没带的**(不是漏):运行期的数据文件(卡密池、订单、皮肤、成品、心跳、
|
||
价格表、凭据文件等)—— 那些是**真实经营数据**,不在交付范围里。
|