帮助中心使用说明与目录总纲

帮助中心重组方案与目录总纲

文档性质：网站更新修复说明 · 方案与实施记录

版本：2026-07-11

状态：Phase 1 已落地目录框架 + 招聘/求职/招标/人才逐步手册；其余章节分批补全

一、重组目标

操作说明与更新修复说明分离，互不混杂。
操作版再分两块：

- 全部操作说明（catalog=ops）：面向使用者，逐步点击，每步标注 URL。

- 操作流程及逻辑（catalog=ops-flow）：业务流、数据表、权限、关键代码路径。

左侧采用 树型目录（已实现 <details> 折叠树，数据源为 manifest PHP 文件）。
所有方案与改造过程写入 网站更新修复说明（catalog=updates）。

二、技术方案：HTML 还是数据库？

方案	优点	缺点	结论
Markdown + PHP manifest + 静态 HTML（现行）	与 git/docs 同步；`build_help_pages.php` 一键生成；无需改库	大批量编辑需改 md	✅ 继续采用
数据库 CMS	后台在线改	与 docs 双份维护；迁移成本高	暂不采用
纯手写 HTML	简单	难维护、难检索	不采用

数据流：

docs/*.md  ──►  help_*_manifest.php（目录/register slug）
                    │
                    ▼
         tools/build_help_pages.php
                    │
                    ▼
    themes/default/Home/help/pages/{slug}.html
                    │
                    ▼
         /help/article/slug/{slug}.html  （HelpAction 读取）

树型目录数据源：

主树：Banyan/Lib/Service/Help/help_ops_manifest.php（操作说明）
逻辑树：Banyan/Lib/Service/Help/help_ops_flow_manifest.php（流程逻辑）
总纲索引：Banyan/Lib/Service/Help/help_catalog_tree.data.php（规划对照，含 planned 占位）
更新树：help_updates_manifest.php
入口树：help_site_nav.data.php

三、操作说明目录总纲（9 大章）

0. 前言 · 系统信息与环境

站点定位（法律站 baoan / 保安站 ba）
多端入口：PC 前台、WAP、/backstage/、/merchant/、/distributors/、/members/、/user/、/worker/
帮助中心自身：/help/index.html

1. 系统后台操作说明（按 /backstage/ 菜单顺序）

待按 by_menu 一级 Tab 逐项补全；已有：权限、部门、公司等级、招聘 life 审核、人才库等。

2. 个人中心（分 PC / WAP）

端	入口	已有文档
PC	`/members/`	帮助中心-PC个人中心操作说明
WAP	`/user/member/index.html`	帮助中心-WAP个人中心菜单总览

3. 商家后台（分 PC / WAP）

端	入口
PC	`/merchant/`
WAP	`/distributors/`

4. 公司项目操作说明

/merchant/project/、/worker/project/

5. 公司员工操作说明

/worker/、员工权限、项目参与

6. 员工验证中心操作说明

待编写（实名/资质验证中心，若独立模块上线后补）

7. 公司部门操作说明

组织权限、部门 CRUD、员工归属

8. 前端展示（分子版块）

子版块	数据模块	逐步操作手册 slug
商家	shop/company	待补
资讯	article	news-frontend-flow
招聘	life 频道「XX招聘」	ops-recruit-publish-steps
求职	life 频道「XX求职」	ops-jobseek-publish-steps
招标采购	tender	ops-tender-publish-steps
人才展	user_career	ops-talent-showcase-steps
评价	dianping	待补
活动	activity/coupon	待补
产品/服务包	goods/法律包	待补
信息服务（规划）	未来独立模块	待规划

招聘 ≠ 招标 ≠ 求职：详见招标采购与招聘求职区别说明

9. 功能说明（不分前后端）

会员注册 → 公司入驻 → 项目 → 员工 → 权限链
微信分享 / 支付
定位 / 分站 / 地图
推送（短信 / 微信 / 站内）
AI / 采集 / 黄页 / 积分

四、操作流程及逻辑（ops-flow）

与第九章对应，但侧重：

数据表字段
biz_type 留言路由
审核/支付/可见性条件
控制器 → 服务类调用链

已有：recruit-life-full-flow、news-flow、wap-location-flow、wechat-share-flow-detail 等。

五、网站更新修复说明（updates）

记录：方案、修复报告、SQL 迁移、UI 修复、测试回归。

本文档即 updates 条目之一（slug: help-center-reorg-plan）。

六、网站入口说明（entry）

见帮助左侧「网站入口说明」面板（help_site_nav.data.php），含前台、后台、会员、员工快捷链。

七、Phase 1 已完成（2026-07-11）

[x] 目录总纲 data 文件 help_catalog_tree.data.php
[x] manifest 重组为 9 大章结构
[x] 新增 ops-flow 第二棵树（操作流程及逻辑）
[x] 四份逐步手册：招聘 / 求职 / 招标 / 人才展
[x] HelpAction / 左侧树支持 type=ops-flow
[x] 本方案写入 updates

八、Phase 2 计划

[ ] 系统后台按 by_menu 导出菜单顺序，逐菜单一篇操作说明
[ ] 商家 PC 侧栏逐 slot 一篇（index/money/company/tender/life…）
[ ] 前端：评价、活动、产品子版块逐步手册
[ ] 员工验证中心
[ ] 信息服务新模块规划文档

九、维护规范

新增/改功能：先写 updates（方案或修复说明），再写 ops 逐步操作，必要时补 ops-flow 逻辑文。
每篇操作文必须含：前置条件、逐步 URL、预期结果、常见错误。
改 md 后执行：php tools/build_help_pages.php
slug 全局唯一；旧 slug 保留 redirect 或 manifest 内兼容条目。

帮助中心