# 开发计划：AI 工具/产品导航站

## 1. 目标
依据 `specs/prd.md` 交付完整的页面端与管理端，满足 SEO、运营与统计要求。

## 2. 技术方案概览
- 后端：Laravel 10
- PHP：8.2（D:/phpstudy_pro/Extensions/php/php8.2.9nts/php.exe）
- 数据库：MySQL（utf8mb4_unicode_ci）
- 管理端：Filament
- 渲染：Blade SSR
- 存储：本地 public 存储

## 3. 里程碑与任务

### M1：项目初始化与基础配置
- [ ] 初始化 Laravel 10 项目
- [ ] 配置数据库连接与字符集（utf8mb4_unicode_ci）
- [ ] 配置本地存储与基础环境变量
- [ ] 定义路由结构与全局布局（顶部 + 左侧 + 内容区）

### M2：数据模型与迁移
- [ ] 分类 Category（支持两级）
- [ ] 标签 Tag
- [ ] 产品 Product（含统计字段、热度、推荐位、排序）
- [ ] 文章 Article（含统计字段、SEO）
- [ ] 评论 Comment（含审核、回复、点赞）
- [ ] 敏感词 SensitiveWord
- [ ] 站点设置 SiteSetting
- [ ] 联系表单 ContactMessage
- [ ] 索引与约束（slug 唯一、分类层级）

### M3：管理端（Filament）
- [ ] 分类/标签/产品/文章资源 CRUD
- [ ] 排序能力（拖拽 + 权重）
- [ ] 推荐位与到期时间
- [ ] 热度权重配置页面
- [ ] 评论审核/删除/回复
- [ ] 敏感词管理
- [ ] 站点设置管理（SEO/Logo/统计代码）
- [ ] 联系表单查看

### M4：页面端（Blade SSR）
- [ ] 首页：搜索、热门推荐、新加、分类区块
- [ ] 分类页：卡片网格 + 描述
- [ ] 标签页：标签云 + 搜索
- [ ] 产品列表页：网格/列表切换、过滤、分页、右侧更多
- [ ] 产品详情页：简介/媒体/标签/官网/相关推荐/评论
- [ ] 文章列表页：标签过滤、时间排序
- [ ] 文章详情页：正文/作者/标签/相关推荐/评论
- [ ] 关于页：Markdown 渲染
- [ ] 联系我们：表单提交
- [ ] 暗黑模式（系统+手动）
- [ ] 响应式适配

### M5：SEO 与统计
- [ ] SEO 元信息（title/description）
- [ ] 结构化数据（WebSite/SoftwareApplication/Article）
- [ ] OG 图片
- [ ] sitemap 自动生成
- [ ] robots.txt（屏蔽后台）
- [ ] UV/点击统计与中转页
- [ ] 页面缓存（首页/列表）

### M6：验收与上线准备
- [ ] 功能验收清单执行
- [ ] 数据种子（分类草案 + 示例产品）
- [ ] 迁移与部署说明

## 4. 关键实现细节
- **排序**：分类/标签内手工排序优先，支持拖拽与权重值；热度用于自动补齐。
- **热度计算**：默认权重 = 浏览 1 + 点击 3，支持后台调整与手动覆盖。
- **浏览/点击**：UV/天（IP+UA）计数；官网链接通过中转路由统计。
- **评论**：匿名可评，先审后发；验证码 + 频率限制；敏感词仅评论。
- **SEO**：英文 slug 手工填写；分类/标签/产品/文章均有独立 SEO 字段。

## 5. 测试与验收
- 首页模块数量与排序正确
- 列表分页、筛选、更多入口正确
- 详情页统计与中转点击正确
- 评论审核与敏感词过滤生效
- SEO 元信息、结构化数据、sitemap 可访问
- 移动端布局无溢出

## 6. 风险与对策
- **数据量与排序维护成本**：通过后台拖拽+权重降低维护成本。
- **评论垃圾**：验证码+频率限制+审核。
- **SEO 质量**：统一模板 + 可编辑 SEO 字段。

## 7. 交付物
- `specs/prd.md`
- 页面端与管理端代码
- 数据库迁移与种子
- 部署与运行说明