docs: register tpl-a design and Xboard theme survey
This commit is contained in:
hellcat
parent
8b78424a18
commit
89a7a1720d
@ -15,7 +15,9 @@
|
||||
|
||||
| 文件 | 用途 |
|
||||
| --- | --- |
|
||||
| SITE_PROFILES.md | dpl / hn 独立部署参数、EZ 主题、开发与发布隔离 |
|
||||
| SITE_PROFILES.md | dpl / hn 独立部署参数、主题选择、开发与发布隔离 |
|
||||
| THEME_DESIGNS.md | tpl-a 等可复用设计方案、定稿与绑定状态、预览和验证边界 |
|
||||
| XBOARD_THEME_SURVEY.md | Xboard 生态主题一手来源、同名项目区别与本地库存范围 |
|
||||
| ARCHITECTURE.md | 服务入口、前后端边界、配置来源、开发与检查 |
|
||||
| BUSINESS_RULES.md | 邮件、提醒、账号与支付等不可随意改变的约束 |
|
||||
| DEPLOYMENT.md | Git 发布、备份、运行依赖、恢复及故障排查 |
|
||||
|
||||
45
docs/maintenance/THEME_DESIGNS.md
Normal file
45
docs/maintenance/THEME_DESIGNS.md
Normal file
@ -0,0 +1,45 @@
|
||||
# 自有主题设计方案与预览
|
||||
|
||||
## 当前范围与定稿
|
||||
|
||||
2026-10-14，用户确认当前效果可作为定稿方案保留，命名为 `tpl-a`，不限定用于 hn。当前独立源码在 `frontends/tpl-a/`，设计定稿版本 1.0.0；业务接入仍未完成。hn 最终主题尚未选定，吉祥物暂缓。此前接入业务接口的 `frontends/hardnerd/` 功能草稿，以及 EZ / Stellar 独立保留。
|
||||
|
||||
用户最新明确定位为“机房网络运营商”，解除此前 2D 扁平 / SVG 风格限制并要求重新设计。当前首页采用写实机柜通道主视觉、网络接入 / 套餐 / 技术服务入口与运营管理内容；接入方案、控制台、资源、账单、文档、工单和账户页面均重做为统一服务门户。使用深蓝、暖橙、自然空间影像与常规企业排版，不继续沿用卡通机架、格子衫 / 厚眼镜和终端装饰作为主视觉。保留减少无关小字的要求，只在全站一处注明影像和数据为示意。明暗双色保留，初次加载默认暗色。
|
||||
|
||||
所有价格、参数、地区、节点、账户、流量与订单均为演示，年付展示按演示月价 × 12 计算。机房主图通过内置 imagegen 生成，不是 hn 实际机房照片；不据此认定机房资产、实际覆盖或可用性承诺。表单与按钮只切换视觉状态和提示，不提交业务数据、不发邮件、不创建订单或工单。
|
||||
|
||||
设计源文件和素材已以本地 Git 提交 `8b78424` 保存；关联业务草稿与环境未纳入该提交。
|
||||
|
||||
## 开发入口
|
||||
|
||||
在独立工作树启动：
|
||||
|
||||
```bash
|
||||
npm --prefix frontends/tpl-a run dev
|
||||
```
|
||||
|
||||
预览：`http://127.0.0.1:8591/#/home`。该端口当前由 Vite 直接提供静态前端；原先占用该端口的 hn PHP 演示进程已停止。配置 `envDir:false`，没有后端代理，不加载 Laravel 配置或业务数据库。只监听本机回环地址。
|
||||
|
||||
主要源码：
|
||||
|
||||
- `src/NetworkLanding.vue`：写实机房首页、网络接入、套餐与服务入口。
|
||||
- `src/App.vue`：导航、明暗切换，以及七类用户中心页面的模拟交互。
|
||||
- `src/brand.mjs`：可替换的演示品牌；`template.json` 的 site_binding 为 null。
|
||||
- `approved-files.sha256.json`：定稿源码与素材摘要；运行和定稿保护见方案 README。
|
||||
- `src/operator.css`：完整企业官网和服务门户样式、明暗与响应式布局；旧 style.css 已退出使用并移除。
|
||||
- `public/datacenter-hero-v1.png`：已落入项目的写实主视觉，原始生成文件另行保留。生成方式与完整提示词在 `codex/output/hn-datacenter-asset.md`。
|
||||
|
||||
构建验证：在仓库根运行 `npm --prefix frontends/tpl-a run build`，输出仅在 `frontends/tpl-a/dist/`。**该构建不会发布到 `theme/Hardnerd` 或运行中的 dpl；不能使用 hn 正式资源发布脚本将本设计稿误当作功能主题。**
|
||||
|
||||
## 本次验证与限制
|
||||
|
||||
- 首页、用户中心、套餐、节点、订单、说明、工单、账户均能前端跳转；保存偏好只显示模拟提示。
|
||||
- 默认暗色与浅色切换已在浏览器验证。
|
||||
- 当前机房运营商方向已在 1280px 宽屏验证明暗首页、接入方案和控制台；390px 七类门户页面逐页检查无横向溢出，320px 首页、菜单与控制台无溢出。临时浏览器尺寸已恢复。
|
||||
- 月付 / 年付展示切换、方案选择和账户模拟保存已验证，仅作用于前端状态。
|
||||
- 浏览器观察到的首页资源、页面跳转与模拟保存请求全部留在本机 Vite；未出现业务 API 请求。源码无 fetch / Axios / XHR 和后端 proxy。
|
||||
- 构建与差异格式检查通过，浏览器没有运行错误。当前截图为 `codex/output/hn-dc-*.jpg`；`hn-hard-*` / `hn-operator-*` 为此前版本对照，均不作为定稿素材。
|
||||
- 项目维护记录和 CoDocs hn/dpl 入口已同步。CoDocs 全库结构检查仍报告 13 项既有 Obsidian 主题目录/文件权限问题；本任务未改动这些无关配置，不能称全库检查通过。
|
||||
- 设计已由用户批准保存为 tpl-a；未推送、部署，hn 使用方案未定。业务接入、支付、邮件、订阅、节点连通与生产验收没有在本阶段执行。
|
||||
|
||||
后续明确使用实例后，再将 tpl-a 接入功能主题，分别进行业务接入和部署验收。实例隔离和历史功能验证见 [SITE_PROFILES](SITE_PROFILES.md) 与 [STATUS](STATUS.md)。
|
||||
27
docs/maintenance/XBOARD_THEME_SURVEY.md
Normal file
27
docs/maintenance/XBOARD_THEME_SURVEY.md
Normal file
@ -0,0 +1,27 @@
|
||||
# Xboard 主题生态调查
|
||||
|
||||
核对日期：2026-10-14。仅依据本次读取的上游、作者仓库和作者文档；不是官方完整目录、购买建议或本项目适配验收。第三方主题的可购买性、授权和 Xboard 版本支持须在实际采用前核对。
|
||||
|
||||
## 已找到的主要项目
|
||||
|
||||
| 名称 / 作者 | 本次证据与获取状态 | 一手来源 |
|
||||
| --- | --- | --- |
|
||||
| Xboard 默认主题 | 官方 master 的 theme/ 目录内置 Xboard | [官方目录](https://github.com/cedar2025/Xboard/tree/master/theme) |
|
||||
| EZ THEME / EZTHEME | 公开源码，作者声明适配 V2Board / XBoard / wyxBoard；本项目以前适配的是这个仓库 | [作者仓库](https://github.com/EZTHEME/EZ_THEME) |
|
||||
| EZ-Theme / PangHu-Code | 与上一项名称相近的另一项目；Vue 3，README 标注 MIT，明确提供 Xboard API 配置 | [作者仓库](https://github.com/PangHu-Code/EZ-Theme) |
|
||||
| Stellar Theme | 公开源码，README 明确支持 cedar2025/Xboard 与 wyx2685/v2board | [项目仓库](https://github.com/aklibk86-dev/stellar) |
|
||||
| DK Theme | React / Vite / TypeScript，作者声明 XBoard / V2Board 适配，MIT | [作者仓库](https://github.com/Nice-Derrick/DK_Theme) |
|
||||
| Aurora | 作者公开发布包（static、config.json、Blade）；仓库含 Xboard 标签，README 主要面向 V2Board。具体授权与版本支持需确认 | [作者发布仓库](https://github.com/krsunm/Aurora) |
|
||||
| AirRocket / Rocket | 作者 README 明确列 Xboard；仓库目前主要是介绍，提供授权购买入口，不能因仓库摘要写免费就认为当前产品免费开源 | [作者仓库](https://github.com/dc8683/v2board-theme-airrocket) |
|
||||
| Zero Theme | 作者配置文档允许 v2board_version=xboard，含购买授权令牌字段 | [作者文档](https://linkis-organization.gitbook.io/v2boar-zero-theme/shi-yong-jiao-cheng/zhu-ti-pei-zhi) |
|
||||
| Lucid | 作者频道介绍 Bento Grid 与商业域名授权，声明曾在 Xboard 测试；不代表本次已验证当前版本 | [作者频道](https://t.me/s/NEDEFINITA) |
|
||||
| Angela | 作者公开介绍、响应式 / PWA / 扩展点；GitHub 仓库只有 README，含 Xboard 标签，具体交付与适配版本向作者确认 | [作者仓库](https://github.com/Miss-Tea2/Angela) |
|
||||
| Lovesy | 作者介绍 Xboard 前后端分离主题；仓库主要是 README 与截图，未见完整源码 | [作者仓库](https://github.com/devlovesy/xboard-theme-lovesy) |
|
||||
|
||||
同名项目、分支和商业版不自动等价。公开 GitHub 页面可能只是介绍或编译产物，不能一律称为开源。这里只确认项目存在及作者声明；未购买、安装、登录演示后台或测试业务 API。
|
||||
|
||||
## 本地库存与 tpl-a
|
||||
|
||||
本次只读清点：运行中的 dpl 代码目录中，系统主题 Xboard、自定义主题 Stellar 的 config.json 和 dashboard.blade.php 均存在。隔离工作树另有 EZ 与旧 Hardnerd 功能草稿。SYSTEM_THEMES 里的保留名称不代表相应目录已经安装。
|
||||
|
||||
`tpl-a` 是本次用户批准保存的自主设计方案，独立源码 `frontends/tpl-a/`，未绑定 hn，不作为第三方生态项目或已经接入 Xboard 后台的主题计数。其状态与启动入口见 [THEME_DESIGNS](THEME_DESIGNS.md)。
|
||||
Loading…
Reference in New Issue
Block a user