portal: 金钻宇宙换成星系图(three.js 懒加载)+ 推送前审查 + 总交接文档
- 门户「金钻宇宙」:删掉启动仪式 / 宇宙首屏晶体 / 盘符机架 / 读盘舱及其 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>
This commit is contained in:
@@ -9,6 +9,8 @@
|
|||||||
|
|
||||||
## 怎么读这份包(建议顺序)
|
## 怎么读这份包(建议顺序)
|
||||||
|
|
||||||
|
> 2026-10 这一轮(数据库、开单后台 / 本机开单重写、前端星系图)的总说明在仓库根目录 **`交接文档-2026-10.md`**。
|
||||||
|
|
||||||
| 顺序 | 读什么 | 为什么先读它 |
|
| 顺序 | 读什么 | 为什么先读它 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| 1 | **`他应该知道的.md`** | 生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— **不读这个,代码里很多东西推不出来** |
|
| 1 | **`他应该知道的.md`** | 生意怎么转、机器什么条件、哪些数据碰不得、术语表 —— **不读这个,代码里很多东西推不出来** |
|
||||||
|
|||||||
@@ -736,7 +736,11 @@ def add_call(rec):
|
|||||||
数据库 calls 表是正本(后台和限频都查它);**同时照旧追加一行到 calls.jsonl** ——
|
数据库 calls 表是正本(后台和限频都查它);**同时照旧追加一行到 calls.jsonl** ——
|
||||||
手机通知那边是盯着这个文件的(那段不在这份代码里),不能让它断。
|
手机通知那边是盯着这个文件的(那段不在这份代码里),不能让它断。
|
||||||
"""
|
"""
|
||||||
|
# ⚠️ 这条也会在渲染机回传(finish_upload)里调:库写失败只记日志,绝不能让异常把回传打断
|
||||||
|
try:
|
||||||
STORE.call_add(rec)
|
STORE.call_add(rec)
|
||||||
|
except Exception as e: # noqa: BLE001
|
||||||
|
log("⚠️ 呼叫记录写库失败(只写了 calls.jsonl):%r" % (e,))
|
||||||
try:
|
try:
|
||||||
with open(CALLS_FILE, "a", encoding="utf-8") as f:
|
with open(CALLS_FILE, "a", encoding="utf-8") as f:
|
||||||
f.write(json.dumps(rec, ensure_ascii=False) + "\n")
|
f.write(json.dumps(rec, ensure_ascii=False) + "\n")
|
||||||
@@ -3433,8 +3437,9 @@ class H(BaseHTTPRequestHandler):
|
|||||||
cid = int(d.get("id"))
|
cid = int(d.get("id"))
|
||||||
except (TypeError, ValueError):
|
except (TypeError, ValueError):
|
||||||
return self.err("没有这条记录", 404)
|
return self.err("没有这条记录", 404)
|
||||||
if not STORE.call_mark(cid, handled=not d.get("undo"),
|
undo = bool(d.get("undo"))
|
||||||
handled_at=now().isoformat(timespec="seconds")):
|
if not STORE.call_mark(cid, handled=not undo,
|
||||||
|
handled_at=None if undo else now().isoformat(timespec="seconds")):
|
||||||
return self.err("没有这条记录", 404)
|
return self.err("没有这条记录", 404)
|
||||||
return self.js({"ok": True, "id": cid})
|
return self.js({"ok": True, "id": cid})
|
||||||
|
|
||||||
|
|||||||
@@ -318,6 +318,10 @@ class Store(object):
|
|||||||
return default
|
return default
|
||||||
now = time.time()
|
now = time.time()
|
||||||
with self.tx() as c:
|
with self.tx() as c:
|
||||||
|
# 服务器和 admin.py 同时第一次启动时,两边都会走到这里:BEGIN IMMEDIATE 让它们排队,
|
||||||
|
# 后进来的那个在事务里再看一眼,导过了就不再导(不然呼叫记录会导两份)
|
||||||
|
if c.execute("SELECT 1 FROM schema_info WHERE k='imported'").fetchone():
|
||||||
|
return None
|
||||||
for k, rec in (jl(os.path.join(R, "codes.json"), {}) or {}).items():
|
for k, rec in (jl(os.path.join(R, "codes.json"), {}) or {}).items():
|
||||||
if isinstance(rec, dict):
|
if isinstance(rec, dict):
|
||||||
c.execute("INSERT OR IGNORE INTO codes (code, state, order_id, batch, platform, gift, data, updated)"
|
c.execute("INSERT OR IGNORE INTO codes (code, state, order_id, batch, platform, gift, data, updated)"
|
||||||
|
|||||||
@@ -14,7 +14,7 @@
|
|||||||
7. 导出旧版 JSON → 再导入新库,数据一模一样(回退路径能用)
|
7. 导出旧版 JSON → 再导入新库,数据一模一样(回退路径能用)
|
||||||
8. 热备份能打开、行数一致;完整性检查 ok
|
8. 热备份能打开、行数一致;完整性检查 ok
|
||||||
9. 服务器直接在「迁移过来的老数据」上跑:老订单能查、老卡密能认、admin.py db / calls / ls 能用
|
9. 服务器直接在「迁移过来的老数据」上跑:老订单能查、老卡密能认、admin.py db / calls / ls 能用
|
||||||
10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢
|
10. 并发:8 个线程同时记呼叫、两个进程同时写卡密,一条不丢;三个进程同时第一次启动只导一次
|
||||||
11. 规模:5000 张码 + 2000 单,按状态列订单的耗时
|
11. 规模:5000 张码 + 2000 单,按状态列订单的耗时
|
||||||
"""
|
"""
|
||||||
import json, os, random, shutil, sqlite3, subprocess, sys, tempfile, threading, time
|
import json, os, random, shutil, sqlite3, subprocess, sys, tempfile, threading, time
|
||||||
@@ -255,6 +255,15 @@ for i in range(300):
|
|||||||
ps = [subprocess.Popen([sys.executable, "-c", writer, x]) for x in ("A", "B")]
|
ps = [subprocess.Popen([sys.executable, "-c", writer, x]) for x in ("A", "B")]
|
||||||
[p.wait(timeout=120) for p in ps]
|
[p.wait(timeout=120) for p in ps]
|
||||||
check("并发:两个进程同时各写 300 张码,600 张一张不少", len(st5.codes_all()) == 600, "%d 张" % len(st5.codes_all()))
|
check("并发:两个进程同时各写 300 张码,600 张一张不少", len(st5.codes_all()) == 600, "%d 张" % len(st5.codes_all()))
|
||||||
|
R7 = tempfile.mkdtemp(prefix="ys-db-race-")
|
||||||
|
make_legacy(R7, n_codes=20, n_orders=6)
|
||||||
|
opener = "import sys; sys.path.insert(0, %r); import store; store.Store(%r)" % (SRC, R7)
|
||||||
|
ps = [subprocess.Popen([sys.executable, "-c", opener]) for _ in range(3)]
|
||||||
|
[p.wait(timeout=120) for p in ps]
|
||||||
|
st7 = store.Store(R7)
|
||||||
|
check("并发:三个进程同时第一次启动,旧数据只导一次(呼叫记录不翻倍)",
|
||||||
|
len(st7.calls()) == 6 and len(st7.codes_all()) == 21, "呼叫 %d 条 · 卡密 %d 张" % (len(st7.calls()), len(st7.codes_all())))
|
||||||
|
shutil.rmtree(R7, ignore_errors=True)
|
||||||
|
|
||||||
# ================================================================== 11. 规模
|
# ================================================================== 11. 规模
|
||||||
R6 = tempfile.mkdtemp(prefix="ys-db-scale-")
|
R6 = tempfile.mkdtemp(prefix="ys-db-scale-")
|
||||||
|
|||||||
@@ -53,7 +53,7 @@
|
|||||||
| `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG |
|
| `pngcheck.py` | ~130 | PNG **结构**核验(不解码像素):防「夹带私货」——尾部塞字节、未知关键块、APNG |
|
||||||
| `store.py` | ~400 | **数据层**(2026-10-05 新增):SQLite 建库 / 第一次启动自动导入旧 JSON / 存取 / 导出回旧格式 / 体检 / 热备份 |
|
| `store.py` | ~400 | **数据层**(2026-10-05 新增):SQLite 建库 / 第一次启动自动导入旧 JSON / 存取 / 导出回旧格式 / 体检 / 热备份 |
|
||||||
| `tests/回执复现测试.py` | ~280 | 回归 + 漏洞复现(27 条,HTTP 层打接口) |
|
| `tests/回执复现测试.py` | ~280 | 回归 + 漏洞复现(27 条,HTTP 层打接口) |
|
||||||
| `tests/数据库测试.py` | ~290 | 数据库专项(37 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 |
|
| `tests/数据库测试.py` | ~290 | 数据库专项(38 条:全新安装、迁移、回退、事务、并发、规模),数据全是现编的 |
|
||||||
|
|
||||||
> 这几个文件是**自足**的:没有 import 本项目之外的模块。**部署时 `store.py` 必须和 `server.py` 放在同一个目录**(`server.py` 直接 `import store`)。
|
> 这几个文件是**自足**的:没有 import 本项目之外的模块。**部署时 `store.py` 必须和 `server.py` 放在同一个目录**(`server.py` 直接 `import store`)。
|
||||||
|
|
||||||
@@ -179,13 +179,13 @@
|
|||||||
### 5.6 测试
|
### 5.6 测试
|
||||||
|
|
||||||
```
|
```
|
||||||
python3 tests/数据库测试.py <server.py 所在目录> # 37 条:数据库专项
|
python3 tests/数据库测试.py <server.py 所在目录> # 38 条:数据库专项
|
||||||
python3 tests/回执复现测试.py <server.py 所在目录> # 27 条:回归 + 漏洞复现(现在跑在数据库上)
|
python3 tests/回执复现测试.py <server.py 所在目录> # 27 条:回归 + 漏洞复现(现在跑在数据库上)
|
||||||
```
|
```
|
||||||
|
|
||||||
- 数据全是测试脚本**现编的**(假卡密、假订单、假呼叫,包括一行写坏的 `calls.jsonl`),建在系统临时目录,不碰 `<DATA_DIR>`。
|
- 数据全是测试脚本**现编的**(假卡密、假订单、假呼叫,包括一行写坏的 `calls.jsonl`),建在系统临时目录,不碰 `<DATA_DIR>`。
|
||||||
- 交付副本里三个 URL 格式串被脱敏弄坏了(`http<WIN-PATH>`),要起服务器的那几节跑之前先换成能格式化的占位;线上原版直接跑。
|
- 交付副本里三个 URL 格式串被脱敏弄坏了(`http<WIN-PATH>`),要起服务器的那几节跑之前先换成能格式化的占位;线上原版直接跑。
|
||||||
- 2026-10-05 结果:**64 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。
|
- 2026-10-05 结果:**65 条全过**。另外用假数据把服务器 + 后台面板 + 浏览器整条链路点了一遍(见 `backend-tools/交接说明.md`)。
|
||||||
|
|
||||||
### 5.7 文件 / 目录(库以外的)
|
### 5.7 文件 / 目录(库以外的)
|
||||||
|
|
||||||
|
|||||||
@@ -355,7 +355,7 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
|
|||||||
接口路径、请求 / 响应字段:没动。
|
接口路径、请求 / 响应字段:没动。
|
||||||
数据格式:**动了**(存储从 JSON 文件换成 SQLite)。第一次启动自动导入、旧文件不动,
|
数据格式:**动了**(存储从 JSON 文件换成 SQLite)。第一次启动自动导入、旧文件不动,
|
||||||
`admin.py db export` 能原样导回旧格式。calls.jsonl 照旧追加(手机通知要读)。渲染机不用动。
|
`admin.py db export` 能原样导回旧格式。calls.jsonl 照旧追加(手机通知要读)。渲染机不用动。
|
||||||
你怎么验证的:tests/数据库测试.py 37 条(全新安装 / 迁移 / 重启不重导 / 只改变化的行 / 清理 / 回滚 /
|
你怎么验证的:tests/数据库测试.py 38 条(全新安装 / 迁移 / 重启不重导 / 多进程同时首启只导一次 / 只改变化的行 / 清理 / 回滚 /
|
||||||
导出再导入一致 / 热备份 / 服务器跑在迁移来的数据上 / 8 线程 + 2 进程并发 / 5000 码 2000 单规模);
|
导出再导入一致 / 热备份 / 服务器跑在迁移来的数据上 / 8 线程 + 2 进程并发 / 5000 码 2000 单规模);
|
||||||
tests/回执复现测试.py 27 条照旧全过(现在跑在库上)
|
tests/回执复现测试.py 27 条照旧全过(现在跑在库上)
|
||||||
```
|
```
|
||||||
@@ -376,3 +376,9 @@ Windows 那边:用 NSSM / WinSW 把渲染机装成**服务**,「重启」的
|
|||||||
|
|
||||||
- 没在你们的真机器(1.6G 内存 + systemd MemoryMax)上跑过;库很小(几千行级别),按测试的内存占用不会有压力,但请部署后跑一次 `admin.py db check`。
|
- 没在你们的真机器(1.6G 内存 + systemd MemoryMax)上跑过;库很小(几千行级别),按测试的内存占用不会有压力,但请部署后跑一次 `admin.py db check`。
|
||||||
- `admin.py` 用别的账号跑时的目录权限(WAL 要在 `<DATA_DIR>` 里建两个小文件),见交接说明 5.1。
|
- `admin.py` 用别的账号跑时的目录权限(WAL 要在 `<DATA_DIR>` 里建两个小文件),见交接说明 5.1。
|
||||||
|
|
||||||
|
### 第二轮自查修掉的三处(推送前审查)
|
||||||
|
|
||||||
|
- `add_call`:渲染机回传(`finish_upload`)的「部分失败」也调它;写库出错原来会把异常抛到回传接口 → 改成只记日志、`calls.jsonl` 照写。
|
||||||
|
- `store.import_legacy`:服务器和 `admin.py` 同时第一次启动会各导一遍(呼叫记录翻倍)→ 在写事务里再判一次「导过没有」。测试加了一条(三个进程同时首启)。
|
||||||
|
- `admin_call_done`:撤销「处理过了」时 `handled_at` 没清 → 一起清掉。
|
||||||
|
|||||||
+7
-7
@@ -1,18 +1,18 @@
|
|||||||
# 交付清单(自查用)
|
# 交付清单(自查用)
|
||||||
|
|
||||||
> 生成:2026-10-05 16:31 共 36 个文件 合计 44.9 MB(2026-10-05 第二轮:加了数据库 store.py、两份测试、回执;后台面板和本机开单页面重写)
|
> 生成:2026-10-05 17:30 共 36 个文件 合计 44.9 MB(2026-10-05 第二轮:数据库 store.py、两份测试、回执;后台面板和本机开单页面重写;推送前审查修复)
|
||||||
|
|
||||||
| 文件 | 字节 | SHA-256 |
|
| 文件 | 字节 | SHA-256 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| `README.md` | 8,543 | `ea8e0339caf30b69754f1c6ff28027c9615c43072c596406bc791b5801285eb3` |
|
| `README.md` | 8,696 | `5cef368dbf5916def012dbfcf7fdfb35d1f435faf5a7b42b65f6ad683343b1c2` |
|
||||||
| `backend-site/admin.py` | 26,020 | `d7f86dcf0b07962ceb55a7714b43c876628118d19159dc3a9215535db1bc47f7` |
|
| `backend-site/admin.py` | 26,020 | `d7f86dcf0b07962ceb55a7714b43c876628118d19159dc3a9215535db1bc47f7` |
|
||||||
| `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` |
|
| `backend-site/pngcheck.py` | 4,945 | `ccec7ab21b0399da651029ffa5781bad498e0905b31a1102f6ba3e3f01e8594d` |
|
||||||
| `backend-site/server.py` | 181,030 | `24f052fdab2fbc5eba345cc305810b33c05b44d01b7e749cd8804d28473f401e` |
|
| `backend-site/server.py` | 181,352 | `438fcd98d57043ee503222b6decc83e873dda2d62c66a8d36f521c7d21e6afed` |
|
||||||
| `backend-site/store.py` | 18,948 | `283029b92e0bba8934c7075a4f3467784d7fde46104bd098eda23742f99a0158` |
|
| `backend-site/store.py` | 19,303 | `9d22007b43188225d4254f8c9710c310d9d55635d0d67496ec99e91fe47bcd2d` |
|
||||||
| `backend-site/tests/回执复现测试.py` | 15,355 | `4529f6076abdfce89bf4406c7fbd0789482deaa595383749580bdc3e08ddc327` |
|
| `backend-site/tests/回执复现测试.py` | 15,355 | `4529f6076abdfce89bf4406c7fbd0789482deaa595383749580bdc3e08ddc327` |
|
||||||
| `backend-site/tests/数据库测试.py` | 15,416 | `b9f420a353927da9e5c1bfaa9a130e5d50cae28dffd42712d9f9c42d2816f5f8` |
|
| `backend-site/tests/数据库测试.py` | 16,045 | `9838f32bf213cd3c727625a50b5e0cbff7da98ded8b7452cacd187c448bde04f` |
|
||||||
| `backend-site/交接说明.md` | 21,795 | `80911c91d0623497c057de8374d41337ff75f4a937571b57486a7d2a319e9c70` |
|
| `backend-site/交接说明.md` | 21,795 | `03b9cb73b27a265c32fc5a36120da0d6d61c2e1d612308cba0221818493cb3f0` |
|
||||||
| `backend-site/回执-Claude.md` | 37,110 | `2f7fc60f48e99e7f07affcac16fe3d0ce2e8660738fbf954b89f2c00e638262f` |
|
| `backend-site/回执-Claude.md` | 37,690 | `de1648832fe8bcd004c32ed538d4a90c6c29a0d72b8c70f448fdbe5332d8b5d9` |
|
||||||
| `backend-tools/chk_worker.ps1` | 486 | `939a42cafa0954347f28d69e75b8af407ed1dab870cc3956fa8b7c5eb55e372f` |
|
| `backend-tools/chk_worker.ps1` | 486 | `939a42cafa0954347f28d69e75b8af407ed1dab870cc3956fa8b7c5eb55e372f` |
|
||||||
| `backend-tools/deploy.py` | 5,694 | `bf2cf47e715a3663faba5f1125ca9dee57596fd59664e2898515985924a0cc8c` |
|
| `backend-tools/deploy.py` | 5,694 | `bf2cf47e715a3663faba5f1125ca9dee57596fd59664e2898515985924a0cc8c` |
|
||||||
| `backend-tools/install_worker.ps1` | 8,902 | `95c339f2a69359fd1c980fb649217bb18371d9ba0b06eadce049b58537c11c1e` |
|
| `backend-tools/install_worker.ps1` | 8,902 | `95c339f2a69359fd1c980fb649217bb18371d9ba0b06eadce049b58537c11c1e` |
|
||||||
|
|||||||
Reference in New Issue
Block a user