# 金钻客栈 · 2026-10 总交接文档(前端 + 后端) > 这一份把 2026-10-05 这一轮**前后端所有改动**、**功能增删**、**设计规范**、**业务逻辑**和**部署运维**写在一处。 > 细节文档还在各自目录里(位置见第 1 节),这份是总目录 + 总说明。 > > 占位值一律保持原样:`example.com` / `shop.example.com`、`123456789`、`备案号(已移除)`、`(本机路径)`、`` / `` / `` / `` 等。 > 署名不动(「苏达 · 大肥鱼」)。本文不含任何密钥、真实地址或截图。 --- ## 目录 1. [仓库里有什么](#1-仓库里有什么) 2. [变更清单(按提交)](#2-变更清单按提交) 3. [功能增加 / 删除一览](#3-功能增加--删除一览) 4. [⚠️ 接口与数据格式变更(单独列)](#4-️-接口与数据格式变更单独列) 5. [设计规范](#5-设计规范) 6. [业务逻辑](#6-业务逻辑) 7. [部署与运维](#7-部署与运维) 8. [测试与验证](#8-测试与验证) 9. [已知未验证 / 待确认](#9-已知未验证--待确认) 10. [内容后台(2026-10-05 晚实现)](#10-内容后台2026-10-05-晚实现) --- ## 1. 仓库里有什么 | 目录 / 文件 | 是什么 | 细节文档 | |---|---|---| | `portal/` | 门户(整个网站):`index.html` 首页、`gallery.html` 画展、`tools.html` 工具与开源、`universe.html` 金钻宇宙、`links.html` 平台入口、`about.html` 关于(**2026-10-06 起是多页,样子以设计预览站为准**)+ `assets/` `fonts/` `content/` `admin/` | 本文第 2.7、5、6 节;`portal/assets/universe/交接说明.md`(星系图) | | `order/` | 自助模板渲染(下单页)`index.html` + `skincheck.js` | 本文第 6.2 节 | | `backend/backend-site/` | 网站后端:`server.py`(全部服务端逻辑)、`store.py`(数据库)、`admin.py`(命令行管理)、`pngcheck.py`(PNG 结构核验)、`tests/` | `backend/backend-site/交接说明.md`、`回执-Claude.md` | | `backend/backend-tools/` | 店主电脑上的一整套:渲染机 `ys_worker.py`、开单后台 `ys_admin.py`、本机开单 `ys_local.py` + `local.html`、Blender 出图脚本 `make_order.py`、各种启动脚本 | `backend/backend-tools/交接说明.md`、`回执-Claude.md` | | `backend/模板/` | 三个 Blender 模板工程(测试用) | `backend/模板/说明.md` | | `backend/deploy/` | 反向代理路由与限流片段 | `backend/deploy/nginx-片段.md` | | `backend/他应该知道的.md` | 生意背景 / 机器约束 / 数据边界 / 术语表 | — | | `交接说明.md`(根目录) | 11eb16c 那一轮视觉改版的说明(**部分已过时**,以本文为准) | — | --- ## 2. 变更清单(按提交) 时间顺序。哈希以 `git log` 为准。 ### 2.1 `11eb16c` · 前端 2026 改版「白光藏色 × MC 方块」 - 删掉上一轮的暗色覆盖块 `redesign-2026`(反馈不好看)。 - 两页 `` 前新增 `…`:手机底栏 HTML + `