72 lines
3.3 KiB
Markdown
72 lines
3.3 KiB
Markdown
# Phase 5b：/terminal 彩蛋 + /books 书评画廊 + Sveltia 管理台试水 - 项目范围
|
||
|
||
<!-- spec-format: 2 -->
|
||
|
||
## 1. 问题定义
|
||
- **项目目标**：三个预研方案落地——终端彩蛋（极客人格记忆点）、书评索引画廊（阅读轨策展面）、Sveltia 管理台（照片上传/编辑体验升级试水）
|
||
- **目标用户**：站长（写作/管理体验）与读者（浏览乐趣）
|
||
- **核心价值**：二期池前三项交付；Sveltia 试水失败可全身而退
|
||
|
||
## 2. 假设与待确认
|
||
|
||
### 2.1 已确认事实
|
||
- 三方案预研完成（op-artalk A+B / op-gitea Sveltia，含坑清单与工作量）
|
||
- Sveltia 机制全对上：整文件 JSON=sidecar 同构、media_folder '' 裸文件名、token 登录、保存即 commit→webhook 自动构建
|
||
- gitea CORS 未配是唯一硬前置
|
||
|
||
### 2.2 关键假设
|
||
- Sveltia 内建图片优化保持关闭（开了会抹 EXIF 断构建期提取管线）
|
||
- 书评 description 由正文首段精炼可接受（用户后续可自行策展润色）
|
||
|
||
### 2.3 待确认问题
|
||
- [ ] Sveltia 试水体验是否合手 → 冒烟后用户/团队评估定去留
|
||
|
||
### 2.4 可选解释与取舍
|
||
- /books 不进主导航（书评列表行内入口）> 导航加第五项 -> 防膨胀
|
||
- 色脊排版卡 > 满色书封卡（mood 深浅不一跨亮暗风险）-> 色脊
|
||
|
||
### 2.5 已证伪路径
|
||
- 无
|
||
|
||
## 3. 功能范围
|
||
|
||
### 3.1 核心功能（MVP）
|
||
- [ ] T1 /terminal 彩蛋页
|
||
- [ ] T2 /books 书评画廊（zh/en）
|
||
- [ ] T3 Sveltia 管理台试水（含 gitea CORS）
|
||
- [ ] T4 验证收官
|
||
|
||
### 3.2 扩展功能
|
||
- /books 进导航（若用户要求）
|
||
|
||
### 3.3 不在范围内
|
||
- moments PWA 上传端点、/stack·/colophon 页（后续池）
|
||
|
||
## 4. 最小实现路径
|
||
- 最简单可行方案：三车道并行按预研方案实施；Sveltia 试水不改现有任何流（只加不改）
|
||
- 暂不引入：终端插件化命令系统、书封真实图片扫描
|
||
- 不做的抽象/配置化：多管理后端适配
|
||
|
||
## 5. 技术决策
|
||
- 技术栈：预研方案原样（vanilla TS 终端 / 色脊卡静态页 / Sveltia 官方集成）
|
||
- 证据协议：evidence: runs
|
||
- 本轮允许改动：src/pages/、src/content.config.ts、content/posts/（五篇补字段）、public/admin/、infra/gitea/README、gitea 运行时 [cors]
|
||
- 本轮不应触碰：content/photos 既有 sidecar 结构、发布链、生产 nginx
|
||
- Git integration branch：`spec/2026-10-25_add-terminal-books-admin`
|
||
|
||
### 5.1 验证策略
|
||
- 范围级别：package
|
||
- 变更对象：两个新页面、posts schema 扩展、admin 静态目录、gitea 运行时
|
||
- 快速检查：`pnpm astro build`
|
||
- 集成检查：terminal/books 产物断言 + Sveltia 双冒烟走通 commit→webhook→build
|
||
- 全项目检查：E2E 30 项 + 新页视觉复核；仅在 gitea 运行时或发布链变更时升级范围
|
||
- 升级触发：只有 Sveltia 冒烟引发 gitea 行为异常时，才升级验证范围并记录理由
|
||
|
||
## 6. 成功标准与验证方式
|
||
- [ ] /terminal 可交互（help/ls/theme/sudo 彩蛋实跑） -> verify: task_0004
|
||
- [ ] /books zh/en 五书呈现（色脊+mood） -> verify: task_0002
|
||
- [ ] Sveltia 冒烟双通过（改+建全链） -> verify: task_0003
|
||
|
||
## 7. 风险与约束
|
||
- gitea restart 窗口（秒级，公告无需）；Sveltia 保存直连 main——已有 webhook 管线为安全网
|