计划清单（路线图）— navgcn_roadmap

单次投票金币上限

100

用户每次投票最大金币数

每日投币次数上限

0（不限制）

每个用户每天最多投币次数

显示已完成项

关

主列表是否显示已完成项

广播通知

关

新计划发布时全站通知

缓存时间

5 分钟

列表缓存有效期

侧栏显示入口

关

个人中心侧边栏显示链接

顶栏显示入口

关

首页顶栏显示链接

发现页集成

关

在发现页展示入口

conf.json 必填字段完整，无 id/installed/enable

✅

含 name/brief/version/bbs_version/type/author/license/hooks_rank

install.php 用 IF NOT EXISTS 幂等

✅

两张表均使用 CREATE TABLE IF NOT EXISTS

uninstall.php 标准拼写，删表 + 删配置 + 清缓存

✅

DROP TABLE IF EXISTS + setting_delete + CacheHelper::pluginDeletePrefix

数据库结构变更走 upgrade.php 幂等迁移

✅

已创建 upgrade.php，含 SHOW COLUMNS + ALTER TABLE 示例模板

PHP hook 以 <?php exit; 开头

✅

路由分发类 hook 正确使用 exit;；编译型 hook（model_inc_file、route_table、lang）无需 exit;

.htm hook 以 <?php 开头

✅

3 个 .htm hook 均以 <?php 开头，无 exit;

hook 文件名与源标记完全匹配

✅

10 个 hook 文件名与 hooks_rank 及实际使用一致

hook 文件无 return;

✅

hook/ 目录下 grep 无结果

所有 POST 表单含 CsrfService::input() + CsrfService::check()

✅

后台 6 个写操作 + 前台投票操作均完整校验，前端 fetch 携带 token

所有输出用 esc_html()/esc_attr()/esc_js()

✅

HTML 上下文用 esc_html()/esc_attr()，JS 字符串上下文用 esc_js()

无 jQuery / Alpine.js / idiomorph

✅

grep 扫描无匹配

无 htmx 2.x 旧事件名

✅

未使用 htmx:configRequest 等旧事件

命名全带前缀

✅

表名前缀 navgcn_roadmap_、变量前缀 $_navgcn_roadmap_/$_rm_、语言键前缀 navgcn_roadmap_

JS/CSS 放 static/ 目录

✅

CSS 已拆分到 static/css/navgcn_roadmap.css，模板通过 <link> 引用

static/*.js 中无 <?php 代码

✅

无静态 JS 文件

数据库表用 utf8mb4

✅

两张表均 DEFAULT CHARSET=utf8mb4

db_* 函数传表名不含前缀

✅

使用 $db->tablepre . 'navgcn_roadmap_item' 模式

用户信息显示用 user_find_by_uids/user_read

✅

插件不涉及用户信息展示

URL 用 url() 函数

✅

39 处 URL 生成均使用 url()，无硬编码 .htm 后缀

缓存用 CacheHelper

✅

列表/统计/金币查询均使用 CacheHelper::remember + pluginDeletePrefix

Service 调用核心类前 include_once 守卫

✅

CreditsService、NotificationService、DiscoverService 均有守卫

改核心文件后清 tmp/

✅

install.php/uninstall.php/upgrade.php 均清理编译缓存

后台模板 include ADMIN_PATH 的 header/footer

✅

后台路由正确使用 ADMIN_PATH . 'view/htm/header.inc.htm'

Card 组件加 x-card class

✅

主列表、详情页、归档页均已统一使用 x-card

头像用 avatar_component_from_data()

✅

插件不涉及头像渲染

PC/移动端双模板 id 加 -mobile 后缀

✅

my_sidebar_nav_threads_before.htm + *_mobile.htm 成对

插件目录名含 _ 分隔

✅

navgcn_roadmap 符合命名规范

后台 setting.php 权限检查

✅

重定向到 admin_navgcn_roadmap，后台路由有 $gid != 1 检查

hook 内局部变量加前缀

✅

hook 模板中使用 $_rm_top_settings/$_rm_nav_settings 前缀，前台模板统一用 $_navgcn_roadmap_ 前缀

esc_textarea

通过

全局无匹配

jQuery 使用 ($()、$.ajax、$.fn)

通过

0 处匹配

Alpine.js 使用 (x-data、x-show、x-bind、x-model)

通过

0 处匹配

return; in hook/

通过

0 处匹配

<?php in static/

通过

无文件

htmx 2.x 旧事件名

通过

0 处匹配

window.__*Data 全局状态

通过

0 处匹配

esc_html / esc_attr / esc_js 转义

通过

18 处正确使用

url() 生成方式

通过

39 处均使用 url()

CSRF 防护

通过

22 处匹配，所有写操作均校验

数据库查询

通过

复杂 SQL 用 $db->sqlFind/sqlFindOne 已标注 // 保留 db_sql_find，简单查询用 db_count()

$db->quote 参数绑定

通过

7 处筛选参数均使用 $db->quote() 防注入

include / include_once / _include

通过

模板加载用 _include()，Service 守卫用 include_once，无裸 include

conf.json 无废弃字段

通过

无 id/installed/enable 字段

install.php 幂等

通过

含 IF NOT EXISTS + 默认配置完整（7 项）

uninstall.php 标准拼写

通过

标准 uninstall.php，删表 + 删配置 + 清缓存

navgcn_roadmap_item

id, title, description, category, status, expected_date, heat, is_pinned, is_deleted, create_date, update_date

idx_status_deleted, idx_heat, idx_create_date

navgcn_roadmap_vote

id, uid, item_id, golds, create_date

idx_uid_item, idx_item_id