内容后台上线:网页里改网站内容(账号密码 + 首次强制改密 + 草稿/预览/发布/回滚 + 画展传图);新世界线自动排位;星球预设 18 种
- backend-site/cms.py(新):账号(scrypt 加盐哈希)、服务端会话(只存哈希,30 天滑动,可撤销)、 admin/admin 首次登录强制改密(改密前其它接口一律 403)、CSRF / 来源 / https / 登录冷却、 内容校验、发布写 content/ 与 prices.json / payinfo.json、版本与回滚、传图核验 + 去元数据 + ffmpeg 缩略图 - server.py 把 /api/cms/* 交给 cms.py;admin.py 加 user list/add/passwd/reset/disable/enable/sessions - portal/admin/(新):内容后台页面;门户顶栏加不带字的淡色铅笔入口 - 门户 / 下单页读 content/site.js、order/content/order.js(代码里的数据降级为兜底);?preview=1 预览草稿 - portal/assets/universe/layout.js(新):新点亮的世界线自动排到中圈不挤的位置、补给线接附近的星、已有的都不动 - planets.js:加 10 种卡通预设(类地 / 海洋 / 丛林 / 荒漠 / 冻原 / 熔岩 / 毒雾 / 荒芜岩球 / 冰巨星 / 带环巨星) - galaxy.js:名牌 / 档案卡文字一律转义 - tests/内容后台测试.py(75 条);回归 27 + 数据库 38 照旧全过;端到端浏览器 36 条 - 文档:交接文档-2026-10.md(变更 / 接口 / 部署 7.1b / 测试 / 第 10 节)、内容后台设计.md(实现对照)、星系图交接说明、nginx 片段 ④ Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
+62
-12
@@ -19,7 +19,7 @@
|
||||
7. [部署与运维](#7-部署与运维)
|
||||
8. [测试与验证](#8-测试与验证)
|
||||
9. [已知未验证 / 待确认](#9-已知未验证--待确认)
|
||||
10. [下一步:内容后台(设计已定,未实现)](#10-下一步内容后台设计已定未实现)
|
||||
10. [内容后台(2026-10-05 晚实现)](#10-内容后台2026-10-05-晚实现)
|
||||
|
||||
---
|
||||
|
||||
@@ -86,7 +86,7 @@
|
||||
|
||||
`backend-tools/local.html` 换成跟网站 / 后台同一套样子;补上原来没写样式的分辨率选择、没绑事件的「清空」;整页接收拖拽;按勾选顺序标号;预计耗时。`ys_local.py` 没动。
|
||||
|
||||
### 2.5 本次提交 · 金钻宇宙换成星系图 + 推送前审查
|
||||
### 2.5 `09b229d` · 金钻宇宙换成星系图 + 推送前审查
|
||||
|
||||
- 门户「金钻宇宙」板块:**删掉**启动仪式、宇宙首屏晶体、盘符机架、读盘舱;**换成**星系图(three.js,懒加载)+ 窗下世界线卡片。
|
||||
- 世界线数据只剩一份:`portal/assets/universe/config.js`(主脚本也读它)。
|
||||
@@ -94,6 +94,17 @@
|
||||
- 审查修掉的后端问题:`add_call` 写库失败会打断渲染机回传;多进程同时首启会重复导入呼叫记录;撤销「处理过了」没清时间。数据库测试加一条,共 38 条。
|
||||
- 本文档。
|
||||
|
||||
### 2.6 内容后台 + 新世界线自动排位 + 星球预设
|
||||
|
||||
- **内容后台**(第 10 节):网站上所有展示内容在网页后台里改 —— 账号密码登录(首次 `admin/admin` 强制改密)、草稿自动保存、预览、发布、回滚、画展传图。
|
||||
后端 `backend-site/cms.py`(挂在 `server.py` 的 `/api/cms/*`),页面 `portal/admin/`,命令行 `admin.py user …`。
|
||||
- **门户 / 下单页改成读内容文件**:`portal/content/site.js`(`window.JZ_CONTENT`)、`order/content/order.js`(`window.JZ_ORDER`),后台发布时生成;代码里写死的数据降级为兜底。
|
||||
- 门户顶栏最右边加内容后台入口:一个不带字的淡色铅笔图标(无边框,hover 稍亮)。
|
||||
- **星系图排布** `layout.js`:新点亮的世界线自动排到中圈不挤的位置,补给线接到附近更靠里的星(不穿星);空槽按编号固定在外圈;**新加一条,已有的星和线都不动**。
|
||||
- **星球预设**从 7 种加到 18 种:类地(卡通地球)/ 海洋 / 丛林 / 荒漠 / 冻原 / 熔岩 / 毒雾 / 荒芜岩球 / 冰巨星 / 带环巨星(光环只有这个预设才有)。
|
||||
- 星图名牌 / 档案卡的文字一律转义(内容来自后台,不能当 HTML 拼)。
|
||||
- 新增 `tests/内容后台测试.py`(75 条);端到端浏览器流程 36 条(第 8 节)。
|
||||
|
||||
---
|
||||
|
||||
## 3. 功能增加 / 删除一览
|
||||
@@ -109,6 +120,9 @@
|
||||
| 后端 · 管理接口 | 呼叫记录列表、标「处理过了」、失败单退回重渲、卡密搜索 |
|
||||
| 开单后台 | 待处理首页(要动手的事集中在一页)、订单搜索、卡密搜索 / 停用 / 启用 / 改张数、订单备注、呼叫·反馈页、失败单「退回重渲」按钮 |
|
||||
| 本机开单 | 分辨率选择样式、清空、整页拖拽、出图顺序标号、预计耗时、复制买家说明 |
|
||||
| **内容后台**(新) | 账号密码登录、首次强制改密、草稿 / 预览 / 发布 / 回滚、发布记录、操作日志、登录设备管理;可改:首页文案与公告、板块说明、画展(含传图)、工具与开源、金钻宇宙(档案 + 外观)、平台入口、关于、下单页模板上下架 / 名字 / 说明、页头与公告、价格档位、付款方式 |
|
||||
| 门户 / 下单页 | 读后台发布的内容;首页公告条(可设起止日期);`?preview=1` 预览草稿(只有登录的人看得到) |
|
||||
| 金钻宇宙 | 新世界线自动排位与连线;星球预设 18 种 |
|
||||
|
||||
### 删除
|
||||
|
||||
@@ -135,6 +149,10 @@
|
||||
| 新增字段 | `/api/claim` 回的订单里多一个 `terms_v`(只增不减) | 渲染机可以不理 |
|
||||
| 开单后台本机接口 | 新增 `/api/codes` `/api/calls` `/api/retry` `/api/note` `/api/code-edit` `/api/call-done`(都要 PIN,原样转服务器) | 只有面板页面自己用 |
|
||||
| 前端 | 门户的 `#rack` / `#bay` DOM 与 `window.__icd.open/close/flip/tray` 调试钩子删了;新增 `window.__jzUniverse.show()/fly(no)` | 只有页面自己和自动化脚本 |
|
||||
| **新增接口** | `/api/cms/*`(登录 / 内容 / 草稿 / 发布 / 回滚 / 传图 / 预览),见 `cms.py` 开头;nginx 要加一节(`deploy/nginx-片段.md` ④) | 只有内容后台页面 |
|
||||
| **数据格式** | 库里新增 `cms_users` / `cms_sessions` / `cms_draft` / `cms_versions` / `cms_audit` 五张表(启动时自动建);新增内容文件 `portal/content/site.{json,js}`、`order/content/order.{json,js}`;画展上传的图在 `portal/uploads/` | 服务器、门户、下单页 |
|
||||
| 文件被谁写 | `prices.json` / `payinfo.json` 现在由内容后台发布时写(**格式不变**,别的字段原样保留) | 服务器 |
|
||||
| 前端 | 门户读 `window.JZ_CONTENT`、下单页读 `window.JZ_ORDER`(读不到用内置兜底);下单页 `TEMPLATES` 拆成 `TEMPLATES_ALL`(全部,用于显示老订单)和 `TEMPLATES`(上架的) | 页面自己 |
|
||||
|
||||
**没变**:所有买家接口、渲染机接口的路径和字段;本机开单的本机接口。
|
||||
|
||||
@@ -301,10 +319,33 @@ inactive(停用:网页单等付款 / 手动停用)
|
||||
| `order/**` | 网站 `/order/` | |
|
||||
| `server.py` + **`store.py`** + `admin.py` + `pngcheck.py` | `<APP_DIR>`(同一目录) | `server.py` 直接 `import store`,**少了 `store.py` 服务起不来** |
|
||||
| `backend-tools/*` | 店主电脑 `<WORKER_DIR>` | `deploy.py` 推送;面板新按钮依赖服务器新接口,**先升服务器** |
|
||||
| **`cms.py`** | `<APP_DIR>`(和 `server.py` 同一目录) | `server.py` 直接 `import cms` |
|
||||
| `portal/admin/` | 网站 `/admin/` | 内容后台页面(静态) |
|
||||
| `portal/content/`、`order/content/` | 随页面一起 | 后台发布时**由服务器进程覆盖写**:这两个目录和 `portal/uploads/` 要给服务进程写权限 |
|
||||
|
||||
**环境变量**(systemd 单元里加):`YS_PORTAL_DIR=<门户网站根目录>`、`YS_ORDER_DIR=<下单页目录>`(内容后台写内容文件和上传图用;`YS_ROOT` 照旧)。
|
||||
|
||||
### 7.1b 内容后台首次部署(⚠️ 照顺序做)
|
||||
|
||||
1. nginx 按 `deploy/nginx-片段.md` 第 ④ 节加配置(**必须带 `X-Forwarded-Proto`**,整站 http → https)。**没配好证书之前不要开放**:后端会拒绝所有非 https 请求。
|
||||
2. 放好 `cms.py`、设好两个环境变量、给 `content/` `uploads/` 写权限,重启服务。第一次启动会自动建初始账号 `admin / admin`,日志里有一句提示。
|
||||
3. **马上**打开 `https://<站点>/admin/`,用 `admin / admin` 登录 → 强制改密(至少 8 位、不能是 admin / 常见密码)→ 用新密码重新登录。
|
||||
在改密之前,服务端只放行改密码和退出,其它接口一律 403;但这段空档里谁先登进去谁就能改密 —— 所以越快越好。
|
||||
4. 第一次打开内容页时,后台把网站现有的 `content/` 文件当成第 1 版。
|
||||
5. 账号管理(服务器上):
|
||||
```
|
||||
python3 admin.py user list # 有哪些账号、最近登录
|
||||
python3 admin.py user add <用户名> [--email 邮箱] [--temp] # 建账号(--temp 发一次性临时密码,首次登录必须改)
|
||||
python3 admin.py user passwd <账号> # 设新密码(所有会话作废)
|
||||
python3 admin.py user reset <账号> [--to-admin] # 忘了密码:会话全作废 → 临时密码(只打印在终端)→ 下次登录必须改
|
||||
python3 admin.py user disable|enable <账号>
|
||||
python3 admin.py user sessions <账号> [--revoke-all]
|
||||
```
|
||||
|
||||
### 7.2 缓存与版本号
|
||||
|
||||
- 门户星系图:改了 JS / CSS 要换版本号,**四处一起换**:`portal/index.html` 里 `universe.css?v=`、`config.js?v=`、底部模块脚本里 `galaxy.js?v=`,以及 `galaxy.js` 里 `import './planets.js?v='`。踩过:坏文件被缓存住,修好了打开还是「加载不出来」。
|
||||
- 门户星系图:改了 JS / CSS 要换版本号,**一起换**:`portal/index.html` 里 `universe.css?v=`、`config.js?v=`、底部模块脚本里 `galaxy.js?v=`,`galaxy.js` 里 `import './planets.js?v='` 和 `'./layout.js?v='`,以及 `portal/admin/index.html` 里 `planets.js?v=`。踩过:坏文件被缓存住,修好了打开还是「加载不出来」。
|
||||
- 内容文件 `content/site.js` / `order.js` 文件名不变、内容会变:nginx 给 `/content/` `/order/content/` 加 `Cache-Control: no-cache`(片段里有)。
|
||||
- 检查 ES 模块语法要拷成 `.mjs` 再 `node --check`(按普通脚本查会漏「重复声明」)。
|
||||
- three.js 只在第一次打开「金钻宇宙」时下载(约 690KB,gzip 后约 170KB)。
|
||||
|
||||
@@ -340,6 +381,8 @@ python3 admin.py sweep # 清过期成品 + 核销(建议每天
|
||||
| 本机开单 | 假本机服务(模拟渲染)+ headless 浏览器走完整流程 | 无报错、无横滚 |
|
||||
| 门户 | headless 浏览器 1366 / 390:六个板块都切一遍;宇宙:星图就绪、点卡片飞过去出档案、`#0002` 深链、全屏开关、手机上拖星图页面不滚;首页不下载 three.js | 全过;除星系图板块外,其余板块和改动前**逐像素一致** |
|
||||
| 下单页 | 打开截图 | 正常(本轮没改) |
|
||||
| **内容后台(后端)** | `python3 backend/backend-site/tests/内容后台测试.py <server.py 所在目录> <仓库根目录>` | 75 / 75:初始账号与强制改密(改密前 11 个接口全 403)、库里无明文、Cookie 属性、https / CSRF / 跨站来源 / 爆破冷却(按 IP 5 次、按账号合计 20 次)、内容校验、XSS 转义、发布写文件、冲突 409、回滚一致、预览要登录、传图核验与去元数据、会话撤销与过期、命令行、三进程同时首启只建一个账号 |
|
||||
| **内容后台(端到端)** | 迷你反代模拟 nginx + 真服务器 + headless 浏览器 1366 / 390 | 36 / 36:门户入口 → 登录 → 强制改密 → 改文案 / 传图 / 点亮新地球 / 加入口 / 下架模板 / 加档位 → 预览(未登录看不到草稿)→ 发布 → 门户 / 星系图 / 下单页都变了 → 回滚复原 → 退出;无新增报错(只有交付副本本来就缺的 `view_stats.json` 和模板缩略图 404) |
|
||||
|
||||
后端测试数据全是测试脚本现编的,建在系统临时目录。⚠️ 交付副本里三个 URL 格式串被脱敏成 `http<WIN-PATH>`,要起服务器的测试得先在**测试副本**里换成能格式化的占位(这三处分别吃 1 / 2 / 0 个参数);线上原版直接跑。
|
||||
|
||||
@@ -355,15 +398,22 @@ python3 admin.py sweep # 清过期成品 + 核销(建议每天
|
||||
|
||||
---
|
||||
|
||||
## 10. 下一步:内容后台(设计已定,未实现)
|
||||
## 10. 内容后台(2026-10-05 晚实现)
|
||||
|
||||
网站前端所有展示内容(门户各板块、下单页的模板与文字、价格与付款)以后要能在网页后台里改,不用再改代码。
|
||||
完整设计见仓库根目录 **`内容后台设计.md`**,要点:
|
||||
网站前端所有展示内容在网页后台里改,不用再改代码。设计和每条安全规则的来由见根目录 **`内容后台设计.md`**;实现在:
|
||||
|
||||
- 跟开单后台分开:内容后台跑在服务器上、公网能打开登录页,入口是门户顶栏最右边一个不带字的铅笔图标;内容账号碰不到卡密和订单。
|
||||
- 登录用**用户名或邮箱 + 密码**,密码用 `hashlib.scrypt`(或 `pbkdf2_hmac`)加盐存哈希,不存明文;会话是服务端令牌(库里只存哈希)+ 过期,Cookie 始终 HttpOnly + SameSite=Strict、https 下加 Secure,「记住我」30 天,服务端能主动撤销。
|
||||
- 首次部署自动建 `admin / admin`,**首次登录强制改密**:改密前服务端只放行改密码和退出,其它接口一律 403。⚠️ 部署完要**马上**登录改密。
|
||||
- 密码至少 8 位;服务器命令行能建账号、改密、重置(作废旧会话 + 临时密码 + 下次必须改)、停用、查设备。
|
||||
- 登录页和后台接口只走 https;草稿 → 预览 → 发布,每次发布留版本可一键回滚;画展能直接传图(服务器核验 + 去元数据 + 生成缩略图)。
|
||||
- 分四步做,估时约 6–8 天。
|
||||
| 部分 | 文件 |
|
||||
|---|---|
|
||||
| 服务端(账号 / 会话 / 草稿 / 发布 / 传图) | `backend/backend-site/cms.py`(`server.py` 把 `/api/cms/*` 交给它) |
|
||||
| 后台页面 | `portal/admin/index.html`(入口:门户顶栏最右边的淡色铅笔) |
|
||||
| 内容文件 | `portal/content/site.{json,js}`、`order/content/order.{json,js}`(发布时生成;`.json` 是正本,`.js` 给页面读) |
|
||||
| 命令行 | `admin.py user …`(见 7.1b) |
|
||||
| 测试 | `tests/内容后台测试.py`(75 条) |
|
||||
|
||||
要点(店主定的安全底线,别放松):
|
||||
- 初始账号 `admin / admin`,**首次登录强制改密**;改密前服务端只放行改密码 / 退出,其它接口一律 403。
|
||||
- 密码 `hashlib.scrypt`(没有就 `pbkdf2_hmac`)加盐存哈希,任何地方都不存明文;至少 8 位。
|
||||
- 会话是服务端令牌(库里只存哈希),「记住我」30 天滑动过期;退出 / 改密 / 命令行重置 / 停用都会当场作废。
|
||||
- Cookie:HttpOnly + SameSite=Strict,https 下 Secure;修改类请求要带 CSRF 头;跨站来源拒绝。
|
||||
- 只走 https(反代没说 https 就拒);登录冷却:同一 IP 错 5 次 / 同一账号合计错 20 次开始冷却(账号那档放宽,免得别人故意输错把店主锁在门外)。
|
||||
- 内容后台碰不到卡密 / 订单。
|
||||
|
||||
Reference in New Issue
Block a user