init

specs/dev_plan.md

@@ -0,0 +1,94 @@
+# 开发计划：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`
+- 页面端与管理端代码
+- 数据库迁移与种子
+- 部署与运行说明