# ROADMAP 未完成项明细

最后整理时间：`2026-03-18 19:06:30`

## 说明

本文件记录两类内容：

1. `ROADMAP.md` 里还没有真正落地的功能。
2. 当前项目虽然已有首版，但距离路线图目标还差很远的模块。

如果某项已经有稳定可用实现，会移动到 [ROADMAP_COMPLETED.md](./ROADMAP_COMPLETED.md)。

---

## 一、首页模块仍未完成的部分

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 首页轮播运营位 | 部分完成 | 现已支持后台配置轮播数据、优先级、生效时间、PC / 移动端双图、终端显示和自动播放；但还没有更细的可视化增删改、登录态可见性、点击统计和过渡动画配置。 |
| 公告已读 / 强制弹窗 | 部分完成 | 现已支持前台本地已读记忆、全部标记已读、版本化公告弹窗和强制确认关闭；但还没有登录用户维度同步、公告点击统计、强制确认审计和更细的公告分组 / 触达规则。 |
| 首页内容聚合模块自由编排 | 部分完成 | 现在首页已支持模块开关、统一网格承接和后台排序，但还不能新增自定义模块、配置内容来源规则、终端权限、周期策略和更细的模块样式。 |
| 创作者推荐 / 站点动态 | 部分完成 | 首页现已新增创作者推荐与站点动态首版，后台也可维护标题、简介、手动创作者名单、动态条数和评论纳入规则；但还没有作者主页、关注能力、点击统计、合集联动和更细的规则化运营。 |
| 合集中心 | 部分完成 | 现已新增首页精选合集模块，并把 `collections.php` 升级为数据化合集列表页、`collection-detail.php` 升级为合集详情页、`admin/collections.php` 落地后台 CRUD 首版；本轮也已补上基础订阅 / 收藏、审核状态、回收站、条目点击热度、初审 / 内容复审 / 终审多阶段审核基础版、审核历史留痕、批量审核 / 批量状态操作基础版、独立统计面板基础版、更细来源拆分、章节结构洞察、批量运营增强基础版、来源漏斗 / 页面域名归因基础版、批量分类 / 批量类型基础版、批量章节模板 / 章节排序联动基础版，以及项目 / 资源联动运营基础版，但合集分享、批量导出和更多前台行为统计还没有完成。 |
| 页脚全量可配置 | 部分完成 | 已有基础页脚，但还没有友情链接、备案、RSS、页脚导航的后台管理。 |

### 首页建议下一步

1. 继续补“公告已读 / 弹窗规则 / 模块权限 / 终端可见性”的更细运营规则。
2. 继续把创作者推荐和站点动态从首版承接，深化到“作者主页 / 关注能力 / 点击统计 / 更细排序规则”。
3. 继续把精选合集从“已具备基础订阅收藏 + 多阶段审核基础版 + 审核历史留痕 + 批量审核基础版 + 独立统计面板基础版 + 基础点击热度 + 章节结构洞察基础版 + 批量运营增强基础版 + 来源漏斗 / 页面域名归因基础版 + 批量分类 / 批量类型基础版 + 批量章节模板 / 章节排序联动基础版 + 项目 / 资源联动运营基础版”深化到“合集分享 / 批量导出 / 更多前台行为统计”的成熟形态。
4. 最后把首页模块编排继续升级到“内容来源规则 + 可视化配置 + 更强统计”的成熟形态。

---

## 二、项目体系仍未完成的部分

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 项目列表页高级筛选 | 部分完成 | 现在已有分类 / 标签 / 搜索 / 排序，但还没有状态、协议、时间范围、评分、权限筛选。 |
| 视图切换与记忆 | 未开始 | 还没有“卡片 / 列表”双视图切换，也没有记忆上次浏览视图。 |
| 项目详情 Tab 化主体区 | 部分完成 | 已有“项目介绍 / 项目文档 / 版本记录 / FAQ / 评论区”首版 Tab 切换、hash 定位、上次查看记忆和键盘切换，但还没有后台自定义排序、更多内容类型、移动端吸附切换条和更强的阅读联动。 |
| 项目版本归档与更新日志 | 部分完成 | 已有 `project_versions` 表、后台版本记录维护和详情页版本时间轴，但还没有版本对比、版本通知、历史附件管理和更细的发布状态。 |
| 项目文档体系 | 部分完成 | 已有 `project_docs` 表、后台章节维护、前台目录锚点跳转和代码块复制按钮，但还没有章节树、文档层级、多页文档、代码块高亮和更完整的目录管理。 |
| 环境适配矩阵 / 依赖清单 / 贡献者 | 未开始 | 详情页侧边信息仍是基础字段，没有扩展矩阵。 |
| FAQ 区 | 部分完成 | 已有 `project_faqs` 表、后台 FAQ 维护和详情页折叠问答区，但还没有 FAQ 分组、搜索、反馈统计和更强的内容运营能力。 |
| 评分与评价标签 | 未开始 | 没有评分表、评分接口、评分统计和后台审核。 |
| 分享 / 收藏 / 举报 | 部分完成 | 点赞有了，但收藏、分享海报、举报流程还没有打通。 |

### 项目体系建议下一步

1. 继续把项目文档章节从首版目录页深化到“章节树 / 文档层级 / 更强的阅读工具”，再推进版本记录 / FAQ 的对比、分组和运营能力。
2. 再做“评分 / 收藏 / 举报”互动能力。
3. 最后补环境矩阵、贡献者、版权说明等增强信息。

---

## 三、资源体系仍未完成的部分

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 资源详情页高级版 | 部分完成 | 现在已有详情正文、文档 / 镜像链接和状态展示，但还没有截图画廊、版本历史、附件、评分和更多运营字段。 |
| 多级分类导航 | 部分完成 | 现在已支持 `categories.parent_id`、后台树形分类管理、前台项目 / 资源一级二级筛选与详情页分类路径，但还没有三级及以上导航、独立分类介绍页、分类 SEO 字段和更深入的跨模块联动。 |
| 有效性检测 | 未开始 | 还没有自动巡检资源外链是否失效，也没有失效标记和后台修正队列。 |
| 资源推荐 / 评分 / 收藏 | 未开始 | 没有资源评分、资源收藏、相关推荐、官方推荐位的完整链路。 |
| 资源更新历史 | 未开始 | 没有版本记录、更新时间轴和附件下载。 |

### 资源体系建议下一步

1. 先把资源详情页从基础版升级成“多区块内容沉淀页”。
2. 再把现有首版树形分类扩展成更完整的三级导航、分类介绍页和 SEO 能力。
3. 最后做失效检测和资源更新历史。

---

## 四、合集 / 专题中心

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 合集列表页 | 部分完成 | `collections.php` 现已支持真实数据表读取、关键词 / 分类 / 精选筛选、更新时间 / 浏览 / 点击 / 互动排序、作者信息、条目数量、浏览统计，以及订阅量 / 收藏量 / 条目点击量展示，并且只会展示审核通过且未删除的公开合集；但更细的运营位和高级筛选组合还没有完成。 |
| 合集详情页 | 部分完成 | `collection-detail.php` 现已支持合集说明、分组条目、相关合集、设备级订阅 / 收藏切换、统一跳转追踪和条目点击热度，以及项目 / 资源 / 帮助文档 / 页面 / 外链 / 说明卡片混排；但章节折叠、分享能力、更多行为统计和更完整的内容运营能力还没有完成。 |
| 合集后台管理 | 部分完成 | `admin/collections.php` 已支持合集创建、编辑、审核状态 / 审核阶段 / 审核备注、审核历史时间线、批量通过 / 驳回 / 阶段流转 / 发布草稿 / 精选 / 可见性 / 分类 / 类型 / 章节模板 / 顺序重排 / 作者归属 / 回收恢复、独立统计面板、更细来源拆分、来源漏斗、页面 / 详情归因、外部域名归因、项目 / 资源联动看板、联动观察池、可扩散候选、章节结构洞察、结构观察池、热度榜、软删除回收站、恢复 / 彻底删除、公开 / 私密与发布状态控制、首页精选标记、条目分组配置，以及基础订阅 / 收藏 / 点击统计展示；但合集分享、批量导出和更多前台行为统计还没有完成。 |

### 建议

合集模块已经进入首版可用阶段，下一步最值得补的是：

1. 合集分享、批量导出和更多前台行为统计。
2. 更细的高级筛选、运营位和前台行为分析。
3. 前台详情页的分享能力、章节折叠和更多行为转化统计。

---

## 五、用户体系与个人中心

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 用户注册 / 登录前台化 | 未开始 | 目前后台登录存在，但普通用户前台登录、注册、找回密码还没有完整实现。 |
| 个人中心 | 未开始 | 还没有“我的创作、草稿箱、收藏、关注、反馈、偏好设置”等页面。 |
| 用户公共主页 | 未开始 | 还没有作者主页、公开资料页、作品列表、粉丝关注区。 |
| 私信系统 | 未开始 | 没有会话表、消息接口、拉黑 / 已读 / 限流等能力。 |
| 等级 / 徽章 | 未开始 | 后台和前台都还没有等级规则、徽章展示、成长体系。 |

### 建议

如果近期优先服务“内容站”而不是“社区站”，用户体系可以放在项目 / 资源 / 合集能力之后再做。

---

## 六、互动与反馈体系

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 评论 Markdown / 楼中楼 / @用户 | 未开始 | 当前评论还是基础文本评论，没有 Markdown、回复树、@提醒。 |
| 收藏系统 | 未开始 | 没有收藏夹、收藏统计、收藏通知。 |
| 分享系统 | 未开始 | 没有平台分享、二维码、海报、分享次数统计。 |
| 内容反馈 / 纠错 | 未开始 | 没有用户反馈表单、进度跟踪、处理结果通知。 |
| 举报体系 | 未开始 | 没有违规内容举报、审核流和处罚记录。 |

### 建议

互动链路下一步最值得先做的是：

1. 收藏系统。
2. 评论回复树。
3. 反馈 / 举报后台处理。

---

## 七、静态页面与辅助页面

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 帮助中心 | 部分完成 | 已新增 `help.php` 前台帮助中心，并补上 `admin/help-center.php` 后台维护、帮助分类独立管理、帮助文档 / FAQ 数据化、分类表现配置、前台展示规则配置、阅读工具首版（文档内搜索 / 阅读进度记忆 / 章节书签）、已登录账号跨端阅读进度同步基础版、普通访客阅读身份 / 同步码基础版、沉浸式阅读模式、当前章节高亮、字号 / 行高 / 阅读宽度调节、白天 / 夜间 / 护眼阅读主题切换、章节命中结果列表、章节搜索排序策略、命中类型标签、帮助章节三引号代码块渲染、代码复制、代码块主题切换、阅读行为分析首版、`7 / 30 / 90` 天阅读趋势与时间范围切换、CSV 报表导出、上一周期报表对比、异常告警、内容运营建议、模板化运营 / 任务化编排、任务派发通知 / 状态回写 / 审批闭环、文档内搜索关键词与搜索跳转转化统计、文档内搜索零命中分析、章节级阅读漏斗、搜索同义词 / 自动纠偏建议、停留时长 / 阅读质量分析、互动率 / 阅读参与度分析、阅读质量综合评分、阅读完成度 / 进度分布统计、发布状态、帮助文章版本历史、搜索关键词、FAQ 联搜、关联阅读、目录式阅读布局、帮助文档访问量、搜索热词统计、文档附件管理、搜索结果高亮和章节化内容编辑；但按 `ROADMAP.md` 继续对齐后，仍缺真正的前台用户注册 / 登录 / 收藏 / 偏好 / 历史统一账号体系。 |
| 用户协议 / 隐私政策 | 部分完成 | 已新增 `terms.php` / `privacy.php` 前台页，并补上后台 `admin/site-pages.php` 的可视化维护、版本号 / 更新时间管理和 `static_page_versions` 历史留痕；但还没有协议更新后的强制重新确认、Cookie 说明、用户数据权利申请流程和更完整的合规设置。 |
| 站点地图 | 部分完成 | 已新增 `sitemap.php` HTML 版站点地图和 `sitemap.xml.php` 动态 XML 输出，并补上页脚入口、`robots.txt` 联动、后台生成规则配置、自动分片、`robots.txt` 在线编辑、搜索引擎推送配置 / 手动验证，以及项目 / 资源发布后的自动推送；但还没有多语言 / 多域名适配和更完整的 SEO 收录统计。 |
| 404 页面 | 部分完成 | 已新增 `404.php` 友好落地页，并补上 `not_found_logs` 失效链接统计和后台高频路径查看，但还没有服务器层统一接管和自动修复建议。 |
| 维护模式页 | 部分完成 | 已新增 `maintenance.php` 维护页，并补齐白名单 IP、维护范围切换、恢复倒计时和公开写入 / 读取拦截，但还没有维护原因分类、黑白名单后台、服务健康面板和更细的应急编排。 |

---

## 八、后台高级管理能力

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 分类管理中心 | 部分完成 | 已有树形首版 `admin/categories.php`，支持项目 / 资源分类父子级、路径展示和删除校验，但还没有分类图标、封面、SEO 字段、独立分类介绍页和更完整的联动面板。 |
| 标签管理中心 | 部分完成 | 已有首版 `admin/tags.php` 和 `tag.php`，支持标签列表、热度统计、未使用标签删除、重复标签合并、标签说明、推荐标签、独立标签聚合页和首版浏览趋势，但还没有跨内容关联管理、更细的趋势拆分、SEO 字段和更完整的运营面板。 |
| 仪表盘 / 数据统计增强 | 部分完成 | 当前 `admin/index.php` 与 `admin/analytics.php` 已支持实时重算、禁缓存响应头、旧库字段兼容补齐与页面提示；但按 `ROADMAP.md` 继续对齐后，还缺数据卡片自定义、统计周期切换、环比箭头、人工修正、下载量统计和更细的权限可见性规则。 |
| SQL 导入中心 | 部分完成 | `admin/sql-import.php` 已支持业务表白名单、可视化字段映射、来源字段自动识别、目标字段智能补全、文件 / 语句双模式、导入预览、字段类型校验、模板新增 / 更新 / 删除、任务详情、异步分批导入、实时进度、暂停 / 继续 / 终止、单日 / 单批次 / 并发 / 时段管控、失败明细导出、审计日志和 7 天内安全场景回滚，但还没有短信验证码、跨表联动导入和更完整的多表迁移编排。 |
| 合集管理中心 | 部分完成 | 已有增强版 `admin/collections.php`，支持合集 CRUD、审核状态 / 审核阶段 / 审核备注、审核历史时间线、批量通过 / 驳回 / 阶段流转 / 发布草稿 / 精选 / 可见性 / 分类 / 类型 / 章节模板 / 顺序重排 / 作者归属 / 回收恢复、独立统计面板、更细来源拆分、来源漏斗、页面 / 详情归因、外部域名归因、项目 / 资源联动看板、联动观察池、可扩散候选、章节结构洞察、结构观察池、热度榜、软删除回收站、恢复 / 彻底删除、发布状态、首页精选标记、条目混排和基础订阅 / 收藏 / 点击统计展示；但合集分享 / 批量导出和更多前台行为统计还没有完成。 |
| 投稿审核工作流 | 部分完成 | 工具投稿有待审，合集也已有基础多阶段审核和审核历史留痕，但项目 / 资源和更完整的统一审核流还没有。 |
| 用户安全与封禁管理 | 部分完成 | 已补入后台登录成功 / 失败 / 拦截日志、用户安全操作日志、强制下线、密码重置和会话版本失效能力；但还没有设备管理、异常登录告警、处罚等级、申诉流和更完整的黑白名单体系。 |
| 反馈 / 举报处理台 | 未开始 | 还没有专门的反馈和举报管理页。 |
| 缓存与系统维护中心 | 未开始 | 没有缓存开关、缓存清理、系统状态页。 |
| 在线升级中心 | 未开始 | 没有版本检测、备份、升级、回滚、更新源配置。 |

### 后台建议下一步

1. 分类介绍页 / 分类 SEO / 三级以上树结构。
2. 标签跨内容关联分析与更细趋势拆分。
3. 项目 / 资源审核流。
4. 反馈 / 举报处理台。
5. SQL 导入中心继续补短信二次验证、跨表迁移和更完整的多表迁移编排。

---

## 九、数据与运营能力

| 路线图模块 | 当前状态 | 还缺什么 |
| --- | --- | --- |
| 创作者数据看板 | 未开始 | 当前统计偏站点维度，没有用户作品维度的数据面板。 |
| 标签热度分析 | 部分完成 | 已有标签页浏览量、近 7 天趋势和后台排序，但还没有来源分析、时间范围切换、点击转化、跨内容维度和图表化看板。 |
| 内容来源分析 | 部分完成 | 统计页只有基础量，没有来源渠道、来源域名、转化漏斗。 |
| 首页模块规则化运营 | 未开始 | 还没有按周期、热度、人工置顶、终端可见性等规则运营首页模块。 |

---

## 十、建议的后续迭代顺序

### P1：最值得先做

1. 项目文档章节深化 + 版本记录 / FAQ 深化。
2. 资源详情页。
3. 多级分类 + 标签运营后台。
4. 收藏系统。

### P2：增强内容站能力

1. 首页轮播与模块排序。
2. 合集中心。
3. 反馈 / 举报系统。
4. 评论回复树与 Markdown。

### P3：增强社区与运维能力

1. 用户中心与公共主页。
2. 私信、关注、粉丝体系。
3. 缓存与系统维护中心。
4. 在线升级中心。

---

## 十一、本轮之后的真实结论

当前项目已经不是“只有壳子”的状态，首页分发、项目 / 资源 / 工具、后台管理、搜索、评论、留言、通知、日志这些主骨架都已经存在。

但如果严格按 `ROADMAP.md` 的完整目标来看，下面这些仍然是决定项目上限的缺口：

- 内容沉淀深度还不够，虽然项目版本记录、FAQ 和文档章节都已落地首版，合集中心也已进入数据化并补上基础订阅 / 收藏、基础审核 / 回收站、多阶段审核基础版、审核历史留痕、批量审核基础版、独立统计面板基础版、更细来源拆分、章节结构洞察、批量运营增强基础版、来源漏斗 / 跳转归因基础版、批量分类 / 批量类型基础版、批量章节模板 / 章节排序联动基础版和项目 / 资源联动运营基础版能力，但项目文档树结构、资源详情深化和合集高级运营编排能力仍是关键缺口。
- 整体互动体系还偏轻，虽然合集中心已经补上基础订阅 / 收藏，但全站收藏夹、分享、举报和更完整的互动通知体系仍未形成。
- 用户体系还不完整，尚未形成真正的前台用户产品。
- 后台运营配置已经起步，但还没有进入“规则化、可视化、可审计”的成熟阶段。
- 工程目录方面，本轮已先把更新日志和路线图文档收拢到 `docs/`，但前台业务入口页仍保留根目录直出以兼容当前 `*.php` URL；如果后续要继续大幅清理根目录，需要单独推进前台路由 / front controller 改造。