ai-nav/specs/dev_plan.md

开发计划：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
• 页面端与管理端代码
• 数据库迁移与种子
• 部署与运行说明