2026年2月开发记录-文档类实现方案草案
<h1>分类信息排序方案实施计划（方案 1.0 完整版）</h1><h2>一、项目概述</h2>
<h3>1.1 方案目标</h3>
<p>基于 Discuz 分类信息系统实现目录树和版块列表页的统一排序，解决以下问题：</p>
<ol>
<li><strong>排序一致性</strong>：目录树排序和列表页排序保持一致</li>
<li><strong>配置简化</strong>：发帖时直接设置排序值，无需在配置帖中查 tid</li>
<li><strong>教育成本降低</strong>：使用下拉单选 + 置顶判断，无需学习特殊格式</li>
<li><strong>顶级帖子展示</strong>：支持置顶说明帖自动展示在 0 级目录</li>
<li><strong>配置帖可控</strong>：配置帖可通过选项控制是否展示在目录树中</li>
</ol>
<h3>1.2 核心设计</h3>
<table>
<thead>
<tr>
<th>项目</th>
<th>值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>sortid</td>
<td>5</td>
<td>分类名称：文档管理</td>
</tr>
<tr>
<td>optionid=21</td>
<td>sort_order</td>
<td>类型：字串 (text)，用于帖子排序值</td>
</tr>
<tr>
<td>optionid=22</td>
<td>is_config</td>
<td>类型：单选 (radio)，0=普通帖子，1=配置帖子</td>
</tr>
<tr>
<td>optionid=23</td>
<td>show_in_tree</td>
<td>类型：单选 (radio)，0=不展示，1=展示（仅对配置帖有效）</td>
</tr>
</tbody>
</table>
<h3>1.3 判断逻辑</h3>
<pre><code>0 级目录（顶级）：displayorder > 0 AND is_config = 0
→ 自动展示所有置顶说明帖
配置帖展示：displayorder > 0 AND is_config = 1 AND show_in_tree = 1
→ 配置帖可选择是否展示在目录树中
普通帖子：displayorder = 0
→ 按 sort_order 排序归入对应目录
</code></pre>
<hr />
<h2>二、数据库设计</h2>
<h3>2.1 分类信息项目创建</h3>
<h4>2.1.1 创建分类信息（sortid=5）</h4>
<p>在 Discuz 后台 → 分类信息 → 添加分类信息</p>
<table>
<thead>
<tr>
<th>字段</th>
<th>值</th>
</tr>
</thead>
<tbody>
<tr>
<td>分类名称</td>
<td>文档管理</td>
</tr>
<tr>
<td>类型标识</td>
<td>document</td>
</tr>
<tr>
<td>显示顺序</td>
<td>5</td>
</tr>
<tr>
<td>可用</td>
<td>是</td>
</tr>
</tbody>
</table>
<h4>2.1.2 创建选项项目</h4>
<p><strong>optionid=21 - sort_order（排序值）</strong></p>
<table>
<thead>
<tr>
<th>字段</th>
<th>值</th>
</tr>
</thead>
<tbody>
<tr>
<td>所属分类</td>
<td>sortid=5</td>
</tr>
<tr>
<td>选项类型</td>
<td>字串 (text)</td>
</tr>
<tr>
<td>选项标题</td>
<td>排序权重</td>
</tr>
<tr>
<td>变量名</td>
<td>sort_order</td>
</tr>
<tr>
<td>输入提示</td>
<td>数字越小越靠前，如 1、2、3...</td>
</tr>
<tr>
<td>必填</td>
<td>否（默认 99）</td>
</tr>
</tbody>
</table>
<p><strong>optionid=22 - is_config（配置帖标识）</strong></p>
<table>
<thead>
<tr>
<th>字段</th>
<th>值</th>
</tr>
</thead>
<tbody>
<tr>
<td>所属分类</td>
<td>sortid=5</td>
</tr>
<tr>
<td>选项类型</td>
<td>单选 (radio)</td>
</tr>
<tr>
<td>选项标题</td>
<td>是否为配置帖</td>
</tr>
<tr>
<td>变量名</td>
<td>is_config</td>
</tr>
<tr>
<td>选项值</td>
<td>0=否\n1=是</td>
</tr>
<tr>
<td>默认值</td>
<td>0</td>
</tr>
<tr>
<td>必填</td>
<td>是</td>
</tr>
</tbody>
</table>
<p><strong>optionid=23 - show_in_tree（目录树展示控制）</strong></p>
<table>
<thead>
<tr>
<th>字段</th>
<th>值</th>
</tr>
</thead>
<tbody>
<tr>
<td>所属分类</td>
<td>sortid=5</td>
</tr>
<tr>
<td>选项类型</td>
<td>单选 (radio)</td>
</tr>
<tr>
<td>选项标题</td>
<td>是否展示在目录树</td>
</tr>
<tr>
<td>变量名</td>
<td>show_in_tree</td>
</tr>
<tr>
<td>选项值</td>
<td>0=不展示\n1=展示</td>
</tr>
<tr>
<td>默认值</td>
<td>1</td>
</tr>
<tr>
<td>权限设置</td>
<td>仅管理员可设置</td>
</tr>
<tr>
<td>说明</td>
<td>仅对配置帖有效，普通帖子始终展示</td>
</tr>
</tbody>
</table>
<h3>2.2 涉及的数据表</h3>
<pre><code class="language-sql">-- 分类信息选项定义表
pre_forum_typeoption
-- 分类信息选项数据表
pre_forum_typeoptionvar
-- 分类信息单选值表
pre_forum_typeoptionvalue
-- 帖子表（查询用）
pre_forum_thread
-- 标签表（现有功能）
pre_common_tag
pre_common_tagitem
</code></pre>
<h3>2.3 索引优化建议</h3>
<pre><code class="language-sql">-- 为分类信息表添加组合索引
ALTER TABLE `pre_forum_typeoptionvar`
ADD INDEX `idx_sortid_optionid` (`sortid`, `optionid`);
ALTER TABLE `pre_forum_typeoptionvar`
ADD INDEX `idx_tid_optionid` (`tid`, `optionid`);
-- 为帖子表添加索引（如果尚未存在）
ALTER TABLE `pre_forum_thread`
ADD INDEX `idx_fid_displayorder` (`fid`, `displayorder`);
</code></pre>
<hr />
<h2>三、代码实施步骤</h2>
<h3>3.1 文件修改清单</h3>
<table>
<thead>
<tr>
<th>文件</th>
<th>修改类型</th>
<th>优先级</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>template/xmyc_doc/php/directory_tree.php</code></td>
<td>核心重写</td>
<td>P0</td>
</tr>
<tr>
<td><code>template/xmyc_touch_doc/touch/php/directory_tree.php</code></td>
<td>核心重写</td>
<td>P0</td>
</tr>
<tr>
<td><code>template/xmyc_doc/forum/forumdisplay.htm</code></td>
<td>修改</td>
<td>P1</td>
</tr>
<tr>
<td><code>template/xmyc_touch_doc/touch/forum/forumdisplay.htm</code></td>
<td>修改</td>
<td>P1</td>
</tr>
</tbody>
</table>
<h3>3.2 directory_tree.php 核心修改</h3>
<h4>3.2.1 新增辅助函数</h4>
<pre><code class="language-php">/**
* 批量获取帖子的分类信息值
* @param array $tids 帖子 ID 数组
* @param int $optionid 选项 ID
* @return array
*/
function get_typeoption_values($tids, $optionid) {
$values = array();
if(empty($tids)) return $values;
$tids_str = implode(',', $tids);
$query = DB::query("SELECT tid, value FROM ".DB::table('forum_typeoptionvar')."
WHERE tid IN ($tids_str) AND optionid=".intval($optionid));
while($row = DB::fetch($query)) {
$values[$row['tid']] = $row['value'];
}
return $values;
}
/**
* 获取版块下所有相关帖子（优化版）
* @param int $fid 版块 ID
* @return array ['config'=>[], 'top_sticky'=>[], 'normal'=>[]]
*/
function get_directory_threads_optimized($fid) {
$result = array(
'config' => array(), // 配置帖
'top_sticky' => array(), // 置顶说明帖（0 级目录）
'normal' => array() // 普通帖子
);
$fid = intval($fid);
if(empty($fid)) {
global $_G;
$fid = intval($_G['fid']);
}
// 查询所有置顶帖和带目录标签的普通帖
$query = DB::query("SELECT t.tid, t.subject, t.dateline, t.displayorder
FROM ".DB::table('forum_thread')." t
WHERE t.fid=".$fid."
AND t.subject NOT LIKE '%'
AND t.displayorder>=0
ORDER BY t.displayorder DESC, t.dateline DESC");
$threads = array();
while($row = DB::fetch($query)) {
$threads[$row['tid']] = $row;
}
if(empty($threads)) {
return $result;
}
$tids = array_keys($threads);
// 批量获取分类信息
$sort_orders = get_typeoption_values($tids, 21); // sort_order
$is_configs = get_typeoption_values($tids, 22); // is_config
$show_in_trees = get_typeoption_values($tids, 23); // show_in_tree
// 分类帖子
foreach($threads as $tid => $thread) {
$is_config = isset($is_configs[$tid]) ? $is_configs[$tid] : '0';
$show_in_tree = isset($show_in_trees[$tid]) ? $show_in_trees[$tid] : '1';
$sort_order = isset($sort_orders[$tid]) ? $sort_orders[$tid] : '99';
$thread['sort_order'] = $sort_order;
if($thread['displayorder'] > 0 && $is_config == '1') {
// 配置帖：根据 show_in_tree 决定是否加入 0 级目录
if($show_in_tree == '1') {
$result['config'][$tid] = $thread;
}
} elseif($thread['displayorder'] > 0 && $is_config == '0') {
// 置顶说明帖：自动加入 0 级目录
$result['top_sticky'][$tid] = $thread;
} else {
// 普通帖子
$result['normal'][$tid] = $thread;
}
}
return $result;
}
</code></pre>
<h4>3.2.2 主逻辑修改</h4>
<pre><code class="language-php">// === 原代码 ===
// $_tagged_threads = get_directory_threads($_G['fid']);
// === 新代码 ===
// 使用优化版函数获取帖子
$all_threads = get_directory_threads_optimized($_G['fid']);
// 初始化目录树
$flquery = array(
'choices' => array(),
'curkey' => '',
'source' => 'tag',
'sortid' => 0,
'identifier' => 'dir'
);
// 设置当前选中的目录
$dir_param = isset($_GET['dir']) ? $_GET['dir'] : '';
$flquery['curkey'] = str_replace('.', '-', trim($dir_param));
// 1. 首先添加 0 级目录（置顶帖和配置帖）
$level_0_index = 0;
// 添加置顶说明帖（displayorder > 0 AND is_config = 0）
foreach($all_threads['top_sticky'] as $tid => $thread) {
$thread_key = 'tid_' . $tid;
$flquery['choices'][$thread_key] = array(
'key' => $thread_key,
'num' => $tid,
'level' => 0,
'name' => $thread['subject'],
'type' => 'thread',
'href' => generate_thread_link($tid),
'list' => array(),
'sort_order' => $level_0_index++
);
}
// 添加配置帖（displayorder > 0 AND is_config = 1 AND show_in_tree = 1）
foreach($all_threads['config'] as $tid => $thread) {
$thread_key = 'tid_' . $tid;
$flquery['choices'][$thread_key] = array(
'key' => $thread_key,
'num' => $tid,
'level' => 0,
'name' => $thread['subject'],
'type' => 'thread',
'href' => generate_thread_link($tid),
'list' => array(),
'sort_order' => $level_0_index++
);
}
// 2. 处理目录配置帖，构建目录树结构
if(!empty($directory_config)) {
// 检查是否使用新格式
$is_new_format = false;
foreach($directory_config['directories'] as $num_path => $config) {
if(!empty($config['is_new_format'])) {
$is_new_format = true;
break;
}
}
if($is_new_format) {
// 新格式处理：序号 = 标签名 = 目录名
foreach($directory_config['directories'] as $num_path => $config) {
create_directory_node_new($flquery['choices'], $num_path, $config['name']);
}
// 添加普通帖子到对应目录（通过标签名称匹配）
foreach($all_threads['normal'] as $tid => $thread) {
// 获取帖子标签
$tags_str = get_thread_tags($tid);
$tag_names = extract_directory_tags($tags_str);
foreach($tag_names as $tag_name) {
$num_path = find_num_path_by_tag($directory_config, $tag_name);
if($num_path) {
// 使用分类信息中的 sort_order
$sort_order = intval($thread['sort_order']);
add_thread_to_directory_new($flquery['choices'], $num_path, $thread, $sort_order);
}
}
}
} else {
// 旧格式处理（兼容）
// ...（保持原有逻辑）
}
} else {
// 没有配置帖，按标签自动生成单层目录
foreach($all_threads['normal'] as $tid => $thread) {
$tags_str = get_thread_tags($tid);
$dir_names = extract_directory_tags($tags_str);
foreach($dir_names as $dir_name) {
build_directory_tree($flquery['choices'], $dir_name, $thread, intval($thread['sort_order']));
}
}
}
// === 新增辅助函数：获取帖子标签 ===
function get_thread_tags($tid) {
$tags = '';
$query = DB::query("SELECT tag.tagname FROM ".DB::table('common_tagitem')." ti
INNER JOIN ".DB::table('common_tag')." tag ON ti.tagid=tag.tagid
WHERE ti.itemid=".intval($tid)." AND ti.idtype='tid'");
$tag_arr = array();
while($row = DB::fetch($query)) {
$tag_arr[] = $row['tagname'];
}
if(!empty($tag_arr)) {
$tags = implode(' ', $tag_arr);
}
return $tags;
}
</code></pre>
<h3>3.3 版块列表页模板修改</h3>
<h4>3.3.1 <code>forumdisplay.htm</code> 修改要点</h4>
<p>在主题列表循环中，添加 sort_order 排序：</p>
<pre><code class="language-php">// 原代码（按回复时间排序）
// $orderby = 'lastpost';
// 新代码（优先按 sort_order 排序）
// 需要在查询时获取分类信息
$_G['forum']['threads_option_sort'] = 5; // 使用分类信息 sortid=5
$_G['forum']['threads_option_order'] = 21; // 使用 optionid=21 (sort_order)
</code></pre>
<p>在模板循环中：</p>
<pre><code class="language-html"><!-- 在主题列表循环前获取 sort_order -->
<!--{loop $_G['forum_threadlist'] $thread}-->
<!--{if $thread['sortid'] == 5}-->
<!--{eval $sort_order = $thread['option']['21'] ? $thread['option']['21'] : 99;}-->
<!--{/if}-->
<!--{/loop}-->
</code></pre>
<hr />
<h2>四、数据迁移计划</h2>
<h3>4.1 现有帖子数据迁移</h3>
<h4>4.1.1 迁移脚本（SQL 示例）</h4>
<pre><code class="language-sql">-- 1. 为现有配置帖初始化分类信息
-- 查找 开头的置顶帖，设置为配置帖
INSERT INTO `pre_forum_typeoptionvar` (`sortid`, `tid`, `optionid`, `value`)
SELECT 5, tid, 22, '1'
FROM `pre_forum_thread`
WHERE subject LIKE '%' AND displayorder > 0
ON DUPLICATE KEY UPDATE value = '1';
-- 2. 为其他置顶帖设置 is_config = 0
INSERT INTO `pre_forum_typeoptionvar` (`sortid`, `tid`, `optionid`, `value`)
SELECT 5, tid, 22, '0'
FROM `pre_forum_thread`
WHERE displayorder > 0 AND subject NOT LIKE '%'
ON DUPLICATE KEY UPDATE value = '0';
-- 3. 为带目录标签的普通帖子设置 sort_order = 99（默认）
-- 需要先获取这些帖子的 tid（通过标签关联）
-- 这个步骤建议在 PHP 中完成，因为需要查询标签
-- 4. 为所有普通帖子设置默认值
INSERT INTO `pre_forum_typeoptionvar` (`sortid`, `tid`, `optionid`, `value`)
SELECT 5, tid, 21, '99'
FROM `pre_forum_thread`
WHERE displayorder = 0
ON DUPLICATE KEY UPDATE value = '99';
</code></pre>
<h4>4.1.2 PHP 迁移脚本</h4>
<pre><code class="language-php"><?php
/**
* 数据迁移脚本：为现有帖子初始化分类信息
* 使用方法：在 Discuz 根目录执行
*/
define('IN_DISCUZ', true);
require './source/class/class_core.php';
$discuz = C::app();
$discuz->init();
// 获取所有帖子
$query = DB::query("SELECT tid, displayorder FROM ".DB::table('forum_thread')." WHERE displayorder>=0");
$migrated_count = 0;
while($thread = DB::fetch($query)) {
$tid = $thread['tid'];
$displayorder = $thread['displayorder'];
// 判断是否为配置帖
$is_config = (strpos($thread['subject'], '') === 0 && $displayorder > 0) ? '1' : '0';
// 设置 is_config
DB::insert('forum_typeoptionvar', array(
'sortid' => 5,
'tid' => $tid,
'optionid' => 22,
'value' => $is_config
), false, true);
// 设置 sort_order（普通帖子默认 99）
if($displayorder == 0) {
DB::insert('forum_typeoptionvar', array(
'sortid' => 5,
'tid' => $tid,
'optionid' => 21,
'value' => '99'
), false, true);
}
// 设置 show_in_tree（默认展示）
DB::insert('forum_typeoptionvar', array(
'sortid' => 5,
'tid' => $tid,
'optionid' => 23,
'value' => '1'
), false, true);
$migrated_count++;
}
echo "迁移完成！共迁移 {$migrated_count} 个帖子\n";
?>
</code></pre>
<h3>4.2 版主操作指引</h3>
<p>发帖/编辑帖子时的操作流程：</p>
<h4>4.2.1 发布置顶说明帖（0 级目录）</h4>
<ol>
<li>发帖时选择分类信息：<strong>文档管理</strong></li>
<li>设置 <strong>是否为配置帖</strong> = 否</li>
<li>设置 <strong>置顶</strong> = 置顶</li>
<li>发布后自动展示在 0 级目录</li>
</ol>
<h4>4.2.2 发布配置帖</h4>
<ol>
<li>发帖时选择分类信息：<strong>文档管理</strong></li>
<li>设置 <strong>是否为配置帖</strong> = 是</li>
<li>设置 <strong>是否展示在目录树</strong> = 是/否（根据需要）</li>
<li>设置 <strong>置顶</strong> = 置顶</li>
<li>发布后可展示在 0 级目录（如果 show_in_tree=1）</li>
</ol>
<h4>4.2.3 发布普通文档帖</h4>
<ol>
<li>发帖时选择分类信息：<strong>文档管理</strong></li>
<li>设置 <strong>排序权重</strong> = 数字（如 1、2、3...）</li>
<li>设置 <strong>是否为配置帖</strong> = 否</li>
<li>添加标签：<strong>#目录_xxx</strong></li>
<li>发布后按 sort_order 归入对应目录</li>
</ol>
<hr />
<h2>五、测试验证清单</h2>
<h3>5.1 单元测试</h3>
<table>
<thead>
<tr>
<th>测试项</th>
<th>操作步骤</th>
<th>预期结果</th>
<th>状态</th>
</tr>
</thead>
<tbody>
<tr>
<td>0 级目录 - 置顶说明帖</td>
<td>发布 is_config=0 的置顶帖</td>
<td>自动展示在 0 级目录</td>
<td>☐</td>
</tr>
<tr>
<td>0 级目录 - 配置帖展示</td>
<td>发布 is_config=1, show_in_tree=1 的置顶帖</td>
<td>展示在 0 级目录</td>
<td>☐</td>
</tr>
<tr>
<td>0 级目录 - 配置帖隐藏</td>
<td>发布 is_config=1, show_in_tree=0 的置顶帖</td>
<td>不展示在 0 级目录</td>
<td>☐</td>
</tr>
<tr>
<td>目录树 - 新格式</td>
<td>配置新格式，帖子打标签</td>
<td>帖子正确归入目录</td>
<td>☐</td>
</tr>
<tr>
<td>目录树 - 旧格式</td>
<td>配置旧格式，帖子打标签</td>
<td>帖子正确归入目录（兼容）</td>
<td>☐</td>
</tr>
<tr>
<td>排序 - sort_order</td>
<td>设置不同 sort_order 值</td>
<td>按数字从小到大排序</td>
<td>☐</td>
</tr>
<tr>
<td>排序 - 默认值</td>
<td>不设置 sort_order</td>
<td>默认 99，排在最后</td>
<td>☐</td>
</tr>
<tr>
<td>Ajax 请求</td>
<td>getdirectory=true</td>
<td>返回正确 JSON 数据</td>
<td>☐</td>
</tr>
</tbody>
</table>
<h3>5.2 集成测试</h3>
<table>
<thead>
<tr>
<th>测试项</th>
<th>操作步骤</th>
<th>预期结果</th>
<th>状态</th>
</tr>
</thead>
<tbody>
<tr>
<td>目录树与列表页排序一致</td>
<td>设置多个帖子 sort_order</td>
<td>两处排序顺序相同</td>
<td>☐</td>
</tr>
<tr>
<td>配置帖编辑</td>
<td>修改配置帖的 show_in_tree</td>
<td>目录树即时更新</td>
<td>☐</td>
</tr>
<tr>
<td>帖子移动</td>
<td>移动帖子到其他版块</td>
<td>分类信息保持</td>
<td>☐</td>
</tr>
<tr>
<td>帖子删除</td>
<td>删除配置帖</td>
<td>目录树自动移除</td>
<td>☐</td>
</tr>
<tr>
<td>权限控制</td>
<td>普通用户编辑帖子</td>
<td>无法修改 show_in_tree</td>
<td>☐</td>
</tr>
</tbody>
</table>
<h3>5.3 性能测试</h3>
<table>
<thead>
<tr>
<th>测试项</th>
<th>指标</th>
<th>目标值</th>
<th>状态</th>
</tr>
</thead>
<tbody>
<tr>
<td>目录树生成时间</td>
<td>100 个帖子</td>
<td>< 100ms</td>
<td>☐</td>
</tr>
<tr>
<td>分类信息查询</td>
<td>批量查询</td>
<td>< 50ms</td>
<td>☐</td>
</tr>
<tr>
<td>Ajax 响应时间</td>
<td>目录数据请求</td>
<td>< 200ms</td>
<td>☐</td>
</tr>
</tbody>
</table>
<hr />
<h2>六、上线部署计划</h2>
<h3>6.1 部署阶段</h3>
<h4>阶段一：数据库准备（预计 30 分钟）</h4>
<ol>
<li>在 Discuz 后台创建分类信息</li>
<li>创建三个选项项目</li>
<li>执行索引优化 SQL</li>
<li><strong>负责人</strong>：数据库管理员</li>
<li><strong>验收标准</strong>：后台可看到新分类信息</li>
</ol>
<h4>阶段二：代码部署（预计 1 小时）</h4>
<ol>
<li>备份原文件</li>
<li>部署新版 directory_tree.php</li>
<li>部署新版 forumdisplay.htm</li>
<li><strong>负责人</strong>：开发人员</li>
<li><strong>验收标准</strong>：语法检查通过</li>
</ol>
<h4>阶段三：数据迁移（预计 2 小时）</h4>
<ol>
<li>执行数据迁移脚本</li>
<li>验证迁移结果</li>
<li>抽查帖子分类信息</li>
<li><strong>负责人</strong>：开发人员</li>
<li><strong>验收标准</strong>：所有帖子有默认值</li>
</ol>
<h4>阶段四：测试验证（预计 4 小时）</h4>
<ol>
<li>执行单元测试</li>
<li>执行集成测试</li>
<li>执行性能测试</li>
<li><strong>负责人</strong>：测试人员</li>
<li><strong>验收标准</strong>：所有测试项通过</li>
</ol>
<h4>阶段五：上线切换（预计 30 分钟）</h4>
<ol>
<li>选择低峰期（如凌晨 2-4 点）</li>
<li>切换代码到生产环境</li>
<li>验证生产环境功能</li>
<li><strong>负责人</strong>：运维人员</li>
<li><strong>验收标准</strong>：生产环境功能正常</li>
</ol>
<h3>6.2 回滚计划</h3>
<p>如上线后发现问题，按以下步骤回滚：</p>
<ol>
<li><strong>立即回滚代码</strong>：还原 directory_tree.php 到旧版本</li>
<li><strong>数据保留</strong>：分类信息数据保留，不影响现有功能</li>
<li><strong>问题排查</strong>：在测试环境复现并修复问题</li>
<li><strong>重新上线</strong>：问题修复后重新执行上线流程</li>
</ol>
<hr />
<h2>七、时间估算和里程碑</h2>
<h3>7.1 时间估算</h3>
<table>
<thead>
<tr>
<th>阶段</th>
<th>工时</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>数据库准备</td>
<td>0.5 小时</td>
<td>创建分类和选项</td>
</tr>
<tr>
<td>代码开发</td>
<td>4 小时</td>
<td>修改 4 个文件</td>
</tr>
<tr>
<td>数据迁移</td>
<td>2 小时</td>
<td>脚本编写 + 执行</td>
</tr>
<tr>
<td>测试验证</td>
<td>4 小时</td>
<td>完整测试用例</td>
</tr>
<tr>
<td>上线部署</td>
<td>1 小时</td>
<td>含回滚准备</td>
</tr>
<tr>
<td><strong>总计</strong></td>
<td><strong>11.5 小时</strong></td>
<td>约 1.5 个工作日</td>
</tr>
</tbody>
</table>
<h3>7.2 里程碑</h3>
<table>
<thead>
<tr>
<th>里程碑</th>
<th>交付物</th>
<th>验收标准</th>
</tr>
</thead>
<tbody>
<tr>
<td>M1：数据库就绪</td>
<td>分类信息创建完成</td>
<td>后台可见，选项可编辑</td>
</tr>
<tr>
<td>M2：代码完成</td>
<td>directory_tree.php 修改完成</td>
<td>单元测试通过</td>
</tr>
<tr>
<td>M3：数据迁移完成</td>
<td>帖子分类信息初始化</td>
<td>抽查验证通过</td>
</tr>
<tr>
<td>M4：测试通过</td>
<td>测试报告</td>
<td>所有测试项通过</td>
</tr>
<tr>
<td>M5：上线成功</td>
<td>生产环境验证</td>
<td>功能正常，性能达标</td>
</tr>
</tbody>
</table>
<hr />
<h2>八、风险与应对</h2>
<h3>8.1 技术风险</h3>
<table>
<thead>
<tr>
<th>风险</th>
<th>影响</th>
<th>概率</th>
<th>应对措施</th>
</tr>
</thead>
<tbody>
<tr>
<td>分类信息表数据量大</td>
<td>查询性能下降</td>
<td>中</td>
<td>添加索引，分页查询</td>
</tr>
<tr>
<td>迁移脚本执行失败</td>
<td>数据不一致</td>
<td>低</td>
<td>事务处理，回滚机制</td>
</tr>
<tr>
<td>旧格式兼容问题</td>
<td>部分目录失效</td>
<td>中</td>
<td>保留旧代码，单独测试</td>
</tr>
</tbody>
</table>
<h3>8.2 业务风险</h3>
<table>
<thead>
<tr>
<th>风险</th>
<th>影响</th>
<th>概率</th>
<th>应对措施</th>
</tr>
</thead>
<tbody>
<tr>
<td>用户不会设置分类信息</td>
<td>排序混乱</td>
<td>高</td>
<td>发布操作指引，培训版主</td>
</tr>
<tr>
<td>版主权限设置错误</td>
<td>普通用户修改排序</td>
<td>中</td>
<td>严格权限控制，审核机制</td>
</tr>
<tr>
<td>上线后出现 bug</td>
<td>用户体验受损</td>
<td>中</td>
<td>快速回滚，及时修复</td>
</tr>
</tbody>
</table>
<hr />
<h2>九、附录</h2>
<h3>9.1 相关文件路径</h3>
<pre><code>template/xmyc_doc/php/directory_tree.php # PC 版核心
template/xmyc_touch_doc/touch/php/directory_tree.php # 移动版核心
template/xmyc_doc/forum/forumdisplay.htm # PC 版列表页
template/xmyc_touch_doc/touch/forum/forumdisplay.htm # 移动版列表页
</code></pre>
<h3>9.2 数据库表结构</h3>
<pre><code>pre_forum_typeoption # 分类信息选项定义
pre_forum_typeoptionvar # 分类信息选项数据
pre_forum_typeoptionvalue # 分类信息单选值
pre_forum_thread # 帖子表
pre_common_tag # 标签表
pre_common_tagitem # 标签项目关联表
</code></pre>
<h3>9.3 参考资料</h3>
<ul>
<li><a href="./目录树展示方案演进说明.md">目录树展示方案演进说明.md</a></li>
<li><a href="./目录树系统修改记录日志.md">目录树系统修改记录日志.md</a></li>
</ul>
<hr />
<p><strong>文档版本</strong>：1.0<br />
<strong>创建日期</strong>：2026-02-16<br />
<strong>创建人</strong>：蜗牛</p>
页:
[1]