ilaandClaude Fable 5
678d081124
- 06-tasks: add per-task detail sheets for Phase 0/1 (concrete init commands, BLOCKED preconditions, verification commands with expected results) and a constraint/verification quick table for Phase 2/3; replace subjective acceptance wording with checkable items - 04-architecture: promote 3.4 to an authoritative filter-param contract (names, values, AND combination, invalid-value handling); add required/optional/default field annex with 0-5 validators to 3.3; state AiCodingScore is not a model in MVP; record structure decision (keep wagtail-start home/search apps, business models in new core app, no Dockerfile) - 03-tech-stack: add version-pinning policy row for T-001 - routes/02-requirements: point filter wording back to the 3.4 contract instead of maintaining copies - T-104: human-input boundary - seed projects, scores and verdicts must be user-confirmed; BLOCKED without a confirmed list - current-state snapshot updated; maintenance record appended to progress.md Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
5.3 KiB
5.3 KiB
需求
本文只描述要什么与怎么算达成。技术方案、数据结构、字段定义见 架构设计。
一、业务现状
| 项 | 状态 |
|---|---|
| 用户 | AI coding 使用者和开发者需要快速判断哪个开源骨架适合自己的新项目。 |
| 数据 | 初期人工录入骨架项目、分类、标签、评分、推荐理由和文章。 |
| 现有系统 | 当前仓库为空项目，已建立 harness coding 文档。 |
| 约束 | 第一版使用 Python 3.12 + Wagtail + SQLite；面向 2 核 2G VPS；不做高并发写入。 |
二、用户角色
- 游客 / 未登录用户：浏览首页、分类页、筛选列表、骨架详情页、文章页。
- 站点编辑者：登录 Wagtail 后台，维护骨架项目、场景分类、语言、框架、评分和文章。
- 站点管理员：管理后台账号、发布内容、配置导航和 SEO。
第一版不提供前台注册用户。
三、功能清单
第一版 MVP（最小闭环）
| 功能 | 用户能做什么 | 优先级 |
|---|---|---|
| 首页与场景导航 | 用户能从首页看到主场景分类和推荐骨架入口。 | P0 |
| 骨架项目列表 | 用户能按场景浏览骨架项目列表。 | P0 |
| 筛选与基础搜索 | 用户能按语言、框架、数据库、AI 友好度筛选。 | P0 |
| 骨架详情页 | 用户能查看适合场景、技术栈、成熟度、维护状态、功能清单、AI 友好度评分、推荐理由和不适用场景。 | P0 |
| 后台内容管理 | 编辑者能通过 Wagtail 后台维护项目、分类、标签、评分和文章。 | P0 |
| SEO 基础 | 公开页面具备 title、description、slug、sitemap 基础能力。 | P0 |
后续迭代
| 功能 | 描述 | 阶段 |
|---|---|---|
| 付费收录 / 赞助展示 | 保持 Sponsored 标识，和编辑推荐分离。 | V2 |
| Newsletter | 收集订阅，推送新骨架和评测文章。 | V2 |
| 用户提交项目 | 用户提交骨架项目，后台审核后发布。 | V2 |
| Affiliate 链接管理 | 管理云服务、部署平台、AI 工具等返佣链接。 | V2 |
| 付费数据库 / 会员 | 详细评分、对比表、维护状态提醒。 | V3 |
| GitHub 数据同步 | 同步 stars、最后提交、issues 等维护指标。 | V3 |
| PostgreSQL 迁移 | 当写入增加或 SQLite 锁冲突出现时迁移。 | V3 |
四、核心用户故事（MVP）
- 作为游客，我打开首页后能按 SaaS、管理后台、API 服务、内容站、AI 应用等场景进入列表。
- 我可以在列表中按语言、框架、数据库、AI 友好度筛选，并看到匹配项目。
- 我可以打开骨架详情页，判断它适合什么项目、不适合什么项目、为什么推荐。
- 作为编辑者，我可以登录后台新增或修改骨架项目，并发布到前台。
- 当某个分类没有项目时，系统展示明确空状态，不报错。
五、验收标准（MVP）
- 首页与场景导航：访问
/时能看到场景入口、推荐项目区和最新文章入口。 - 骨架项目列表：访问场景页时能看到该场景下已发布项目；无项目时显示空状态。
- 筛选与基础搜索：选择语言或框架筛选后，列表只展示匹配项目；筛选条件可被 URL 表示（参数契约见
04-architecture.md§3.4）。 - 骨架详情页：详情页展示名称、简介、官网 / GitHub 链接、技术栈、适用场景、不适用场景、AI 友好度评分、维护状态和推荐理由。
- 后台内容管理：管理员能在 Wagtail 后台新增项目、分类、语言、框架和评分，并发布后在前台可见。
- SEO 基础：核心公开页面有稳定 slug、页面标题、meta description，并可生成 sitemap。
六、范围边界与决策
| 问题 | 决策 |
|---|---|
| 第一版平台 | Web 网站 |
| 是否需要账号 | 前台不需要；后台使用 Wagtail 管理员账号 |
| 第一版范围 | 内容目录 + 筛选 + 详情 + 后台维护 + SEO |
| 暂不支持 | 用户注册、收藏、评论、支付、自动抓取、复杂搜索、多语言 |
| 数据库 | 开发和第一版上线使用 SQLite with JSON1 |
| Python | Python 3.12 |
| 站点语言 | 第一版为英文单语言站点，主攻"AI Coding 友好度"角度关键词；中文站作为后续扩展评估（见 ../business/content-strategy.md） |
| Newsletter | MVP 可放外部托管的订阅链接（如 Buttondown，纯外链、无自建后端）；完整 Newsletter 功能仍在 V2 |
七、待确认 / 风险点
- 数据质量风险：骨架评分需要人工标准，先在
04-architecture.md固定评分字段。 - 维护状态风险：MVP 人工录入维护状态，不自动判断 GitHub 活跃度。
- SQLite 并发风险：多个读通常可接受，多个并发写可能触发锁；出现前台用户提交、评论、会员等写入功能时迁移 PostgreSQL。
- SEO 风险：Wagtail 页面结构和 slug 需要从一开始规范，避免上线后频繁改 URL。
- 商业信任风险：赞助展示必须明确标识，不能影响编辑推荐排序。
- 版权风险：引用第三方骨架项目时只写摘要、评分和链接，不复制大段 README 或文档内容。
- 待确认问题：项目正式名称、域名、视觉风格、首批收录项目清单。