Files
jinzuanwork/backend
ywsandClaude Opus 5.5 51212a07c0 backend: 接入 SQLite 数据库 + 开单后台按功能重写
- store.py(新):卡密 / 订单信息 / 爱发电账本 / 呼叫记录 / 小块状态进 <DATA_DIR>/ys.db;
  第一次启动自动建库并导入旧 JSON(旧文件不动),admin.py db check/backup/export
- server.py / admin.py 存取换到库上,路由与接口字段不变;calls.jsonl 照旧追加
- 管理接口新增 calls / call-done / retry,codes 支持 q 搜索
- ys_admin.py 页面重写:待处理 / 订单 / 卡密 / 福利券 / 呼叫·反馈 / 开单工具
- tests/数据库测试.py(37 条,假数据);回归 27 条照旧全过
- 交接说明(数据库一节、面板一节)、回执第二轮、交付清单更新

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 16:20:45 +00:00
..

交付包 · 卡密 / 自助渲染下单(后端 + 工具)

交付方:苏达(网站运维与技术提供) 收件方:外部协作者 日期:2026-10-05 本次交付由店主拍板,范围就是他圈定的:网站后端 + 工具后端,全部脱敏,各配交接文档。


怎么读这份包(建议顺序)

顺序 读什么 为什么先读它
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 在接口层根本测不出来); 部署完要核对"跑的是不是新代码"。
  • 付过学费的坑 —— 例:静默失败最贵(不报错、不崩、就是没效果); 显示层会骗人(订单算对了但界面从另一个来源取数);"改完不生效"是这套系统最高频的坑。

每份最后还有**三个我们拿不准的"做法"**请你表态(要不要换技术栈、单机多单怎么设计、 部署不生效有没有更稳的机制)。

我们更想要的是对做法的批评,不只是对某几行代码的。如果整套思路就是错的,请直说。


交付清单(自查用)

  • 网站后端:server.py / admin.py / pngcheck.py / store.py(数据库,2026-10-05 加),已脱敏
  • 工具后端:19 个文件(含 .bat / .ps1 / .html / 共用的 skincheck.js / Blender 脚本),已脱敏
  • 两份交接文档(含《我们的思路与方法》)
  • 三个模板工程,已脱敏(等长替换,文件字节数未变)
  • 逐文件 SHA-256 清单(交付清单.md)
  • 机器逐类扫描:0 命中(域名含大小写变体 / 端口 / 各类路径 / IP / 邮箱 / 密钥特征 / 分享链里夹的群号与授权参数 / 第三方人名 / 长数字串)
  • 独立第二双眼睛复查(由另一个 agent 独立扫、不采信我们的自述结论) —— 它抓出了 3 处我们漏的(Windows 账户名从路径与 SSH 用户名两处漏出、 一处换过但仍像真路径的 /srv、一处把真端口换成了另一个像真端口的数) 以及 2 处"引用了却没带上"的缺件(共用的质检脚本、打包脚本),全部已修并复扫 0 命中。
  • 故意没带的(不是漏):运行期的数据文件(卡密池、订单、皮肤、成品、心跳、 价格表、凭据文件等)—— 那些是真实经营数据,不在交付范围里。