refactor: rewrite user manual with 8-module structure

- Reorganize docs into 8 user-journey modules: Platform Management,
  Project Space, SQL Development, SQL Deployment, SQL Governance,
  Data Security, SQL Optimization, Knowledge & Rules
- Rewrite all 60+ pages with improved content, corrected field names,
  and standardized edition tags (Community/Enterprise/DMS)
- Add new pages: data-security/intro, platform/intro, knowledge/intro,
  sql-dev/intro, sql-deploy/intro, sql-management/intro,
  sql-optimization/intro, data_masking, datasource, expiring_password
- Add Edition MDX component for three-tier version tagging
- Update SUMMARY.md and sidebars.js to match new structure
- Enhance pdf_adapter.py to strip frontmatter/imports/MDX components
- Add word_export.py and export-manual.sh for docx/md export
- Update Makefile with build/pdf/word targets
- Add docusaurus-export-pdf dependency

Made-with: Cursor

Author: Gygkimo95

Makefile

@@ -1,5 +1,14 @@
-pdf:
+build:
 	rm -rf ./build
 	cp -r ./docs ./build
-	docker run --rm -it -v "${PWD}":/usr/src/myapp -w /usr/src/myapp python:3 python pdf_adapter.py
-	docker run --rm -it -v "${PWD}/build":/gitbook -p 4000:4000 billryan/gitbook:zh-hans /bin/bash -c "gitbook install &&  gitbook pdf ./ ./sqle-manual.pdf"
+	docker run --rm -v "${PWD}":/usr/src/myapp -w /usr/src/myapp python:3 python pdf_adapter.py
+
+pdf: build
+	docker run --rm -v "${PWD}/build":/gitbook billryan/gitbook:zh-hans /bin/bash -c "gitbook install && gitbook pdf ./ ./sqle-manual.pdf"
+	cp ./build/sqle-manual.pdf ./DMS用户手册.pdf
+	@echo "PDF 导出完成: DMS用户手册.pdf"
+
+word: build
+	cd build && python3 ../word_export.py
+	cp ./build/DMS用户手册.docx ./DMS用户手册.docx
+	@echo "Word 导出完成: DMS用户手册.docx"

docs/SUMMARY.md

@@ -2,8 +2,7 @@
 
 * [产品介绍](intro.md)
 * [在线体验](online-demo.md)
-* [用户指南](guide.md)
-* [产品支持](intro.md)
+* [产品支持](support/compare.md)
   * [企业版社区版功能对比](support/compare.md)
   * [社区支持](support/community-support.md)
   * [商业支持](support/commercial-support.md)
@@ -16,78 +15,88 @@
   * [Docker-Compose部署](deploy-manual/DockerCompose.md)
   * [升级说明](deploy-manual/upgrade.md)
 * [用户手册](user-manual/intro.md)
-  * [全局数据源管理](user-manual/allinstance.md)
-  * [项目](user-manual/project/intro.md)
-    * [创建项目【企业版】](user-manual/project/project_create.md)
-    * [数据源管理](user-manual/project/instance-manager.md)
-    * [外部数据源同步【企业版】](user-manual/project/instance_syn.md)
-    * [成员/成员组管理](user-manual/project/group_member.md)
+  * [平台管理](user-manual/platform/intro.md)
+    * [全局 Dashboard](user-manual/Dashboard.md)
+    * [资源全景视图](user-manual/resource-overview.md)
+    * [全局数据源](user-manual/allinstance.md)
+    * [用户与权限](user-manual/user-manager/user.md)
+      * [用户管理](user-manual/user-manager/user.md)
+      * [角色管理](user-manual/user-manager/role.md)
+      * [个人中心](user-manual/user-manager/account.md)
+    * [系统设置](user-manual/sys-configuration/login_syn.md)
+      * [登录对接](user-manual/sys-configuration/login_syn.md)
+      * [消息推送](user-manual/sys-configuration/message_syn.md)
+      * [流程对接](user-manual/sys-configuration/process_syn.md)
+      * [Webhook配置](user-manual/sys-configuration/webhook.md)
+      * [双因素认证(2FA)](user-manual/sys-configuration/MFA.md)
+      * [全局配置](user-manual/sys-configuration/configuration.md)
+      * [个性化配置](user-manual/sys-configuration/customize.md)
+      * [可用区管理](user-manual/sys-configuration/zone.md)
+  * [项目空间](user-manual/project/intro.md)
+    * [创建项目](user-manual/project/project_create.md)
+    * [数据源管理](user-manual/project/datasource.md)
+    * [成员管理](user-manual/project/group_member.md)
     * [审核规则模板](user-manual/project/rule-template-manager.md)
     * [审核流程模板](user-manual/project/workflow-template-manager.md)
-    * [白名单管理【企业版】](user-manual/project/whitelist-manager.md)
-    * [管控SQL例外管理【企业版】](user-manual/project/blacklist-manager.md)
+    * [白名单管理](user-manual/project/whitelist-manager.md)
+    * [管控SQL例外管理](user-manual/project/blacklist-manager.md)
     * [推送规则配置](user-manual/project/push-rule.md)
-    * [SQL管控【企业版】](user-manual/project/audit_task/sqlmanage.md)
-    * [数据导出【企业版】](user-manual/project/dataexport.md)
+    * [操作记录](user-manual/project/operation_records.md)
+  * [SQL 开发](user-manual/sql-dev/intro.md)
     * [SQL审核](user-manual/project/quick_audit.md)
-    * [SQL分析](user-manual/project/analysis.md)
+    * [数据导出](user-manual/project/dataexport.md)
+    * [SQL 工作台](user-manual/sql-workbench/introduction.md)
+      * [CloudBeaver](user-manual/sql-workbench/cloudbeaver/intro.md)
+      * [定制包使用](user-manual/sql-workbench/cloudbeaver/customize.md)
+      * [新版工作台](user-manual/sql-workbench/odc/deploy.md)
+    * [结构对比](user-manual/project/Structure-Comparison.md)
     * [IDE审核](user-manual/project/IDEaudit.md)
     * [CI/CD集成](user-manual/project/CICDintegration.md)
-    * [结构对比](user-manual/project/Structure-Comparison.md)
-    * [操作记录](user-manual/project/operation_records.md)
-    * [工单](user-manual/project/workflow/intro.md)
-      * [创建工单](user-manual/project/workflow/create-workflow.md)
-      * [审核工单](user-manual/project/workflow/audit-workflow.md)
-      * [上线工单](user-manual/project/workflow/exec-workflow.md)
-      * [回滚工单](user-manual/project/workflow/rollback.md)
-      * [版本管理](user-manual/project/workflow/version-management.md)
-    * [扫描任务](user-manual/project/audit_task/intro.md)
-      * [性能洞察](user-manual/project/audit_task/performance-insight.md)
+  * [SQL 上线](user-manual/sql-deploy/intro.md)
+    * [工单概述](user-manual/project/workflow/intro.md)
+    * [创建工单](user-manual/project/workflow/create-workflow.md)
+    * [审核工单](user-manual/project/workflow/audit-workflow.md)
+    * [上线工单](user-manual/project/workflow/exec-workflow.md)
+    * [回滚工单](user-manual/project/workflow/rollback.md)
+    * [版本管理](user-manual/project/workflow/version-management.md)
+  * [SQL 管控](user-manual/sql-management/intro.md)
+    * [扫描任务概述](user-manual/project/audit_task/intro.md)
+    * [SQL管控](user-manual/project/audit_task/sqlmanage.md)
+    * [性能洞察](user-manual/project/audit_task/performance-insight.md)
+    * [SQL下钻分析](user-manual/project/audit_task/SQLdrilldown.md)
+    * [智能扫描任务](user-manual/project/audit_task/metadata_audit.md)
       * [库表元数据](user-manual/project/audit_task/metadata_audit.md)
       * [慢日志](user-manual/project/audit_task/slowlog_audit.md)
       * [会话SQL扫描任务](user-manual/project/audit_task/processlist_audit.md)
+      * [TopSQL](user-manual/project/audit_task/topsql.md)
+      * [MyBatis扫描](user-manual/project/audit_task/mybatis.md)
+      * [SQL文件扫描](user-manual/project/audit_task/SQLfile_audit.md)
+      * [应用程序SQL抓取](user-manual/project/audit_task/java_application_audit.md)
+      * [Java探针版应用程序SQL抓取](user-manual/project/audit_task/java_agent_audit.md)
       * [百度云RDS慢日志](user-manual/project/audit_task/baiduyunrds.md)
       * [华为云RDS慢日志](user-manual/project/audit_task/huaweiyunrds.md)
-      * [应用程序SQL抓取【企业版】](user-manual/project/audit_task/java_application_audit.md)
-      * [Java探针版应用程序SQL抓取【企业版】](user-manual/project/audit_task/java_agent_audit.md)
-      * [SQL文件扫描](user-manual/project/audit_task/SQLfile_audit.md)
-      * [MyBatis扫描](user-manual/project/audit_task/mybatis.md)
-      * [TopSQL](user-manual/project/audit_task/topsql.md)
-      * [SQL下钻分析](user-manual/project/audit_task/SQLdrilldown.md)
       * [TDSQL锁监控](user-manual/project/audit_task/lockinfo.md)
-    * [数据权限管控【企业版】](user-manual/project/data_access_control/intro.md)
-      * [权限模板](user-manual/project/data_access_control/permission_template.md)
-      * [授权清单](user-manual/project/data_access_control/authorization_list.md)
-    * [SQL优化](user-manual/project/sql-improve/introduction.md)
-      * [SQL合规重写](user-manual/project/sql-improve/sqlrewrite.md)
-  * [系统设置](user-manual/sys-configuration/intro.md)
-    * [登录对接](user-manual/sys-configuration/login_syn.md)
-    * [双因素认证(2FA)](user-manual/sys-configuration/MFA.md)
-    * [消息推送](user-manual/sys-configuration/message_syn.md)
-    * [流程对接](user-manual/sys-configuration/process_syn.md)
-    * [webhook配置](user-manual/sys-configuration/webhook.md)
-    * [个性化配置](user-manual/sys-configuration/customize.md)
-    * [全局配置](user-manual/sys-configuration/configuration.md)
-    * [可用区管理](user-manual/sys-configuration/zone.md)
-  * [SQL工作台](user-manual/sql-workbench/introduction.md)
-    * [CloudBeaver](user-manual/sql-workbench/cloudbeaver/intro.md)
-      * [定制包使用](user-manual/sql-workbench/cloudbeaver/customize.md)
-    * [新版工作台](user-manual/sql-workbench/odc/deploy.md)
-  * [用户管理](user-manual/user-manager/intro.md)
-    * [用户管理](user-manual/user-manager/user.md)
-    * [角色管理](user-manual/user-manager/role.md)
-    * [个人中心](user-manual/user-manager/account.md)
-  * [自定义审核规则](user-manual/customrule.md)
-  * [规则知识库【企业版】](user-manual/knowledgebase.md)
+  * [数据安全](user-manual/data-security/intro.md)
+    * [数据脱敏](user-manual/project/data_masking.md)
+    * [账号安全](user-manual/project/data_access_control/intro.md)
+      * [角色管理](user-manual/project/data_access_control/permission_template.md)
+      * [账号管理](user-manual/project/data_access_control/authorization_list.md)
+      * [临期密码](user-manual/project/data_access_control/expiring_password.md)
+  * [SQL 优化](user-manual/sql-optimization/intro.md)
+    * [SQL合规重写](user-manual/project/sql-improve/sqlrewrite.md)
+    * [SQL调优](user-manual/project/sql-improve/sqltune.md)
+  * [知识与规则](user-manual/knowledge/intro.md)
+    * [自定义审核规则](user-manual/customrule.md)
+    * [规则知识库](user-manual/knowledgebase.md)
 * [开发者手册](dev-manual/introduction.md)
-  * [IDE审核插件](dev-manual/auditplugins/introduction.md)
+  * [数据源审核插件](dev-manual/plugins/intro.md)
+    * [插件使用指南](dev-manual/plugins/howtouse.md)
+    * [插件开发指南](dev-manual/plugins/howtodev.md)
+  * [开发工具审核插件](dev-manual/auditplugins/jetbrains.md)
     * [IDEA审核插件](dev-manual/auditplugins/jetbrains.md)
     * [Eclipse插件](dev-manual/auditplugins/eclipse.md)
   * [OpenAPI对接](dev-manual/OpenAPI/dmstoken.md)
-  * [审核插件](dev-manual/plugins/intro.md)
-    * [插件使用指南](dev-manual/plugins/howtouse.md)
-    * [插件开发指南](dev-manual/plugins/howtodev.md)
-* [FAQ](FAQ/intro.md)
+* [FAQ](FAQ/whichdatabase.md)
   * [支持的数据库及版本](FAQ/whichdatabase.md)
-  * [镜像仓库推荐](FAQ/mirror.md)
   * [SQL回滚支持程度](FAQ/rollback.md)
+  * [镜像仓库推荐](FAQ/mirror.md)

docs/book.json

@@ -14,5 +14,5 @@
       "website": "website.css"
     },
     "author": "ActionTech",
-    "title": "SQLE manual"
+    "title": "DMS 用户手册"
 }

docs/user-manual/Dashboard.md

@@ -1,32 +1,44 @@
 ---
-title: 全局待关注清单
+title: 全局 Dashboard
 ---
 
-全局待关注清单功能旨在帮助业务操作人员和项目管理人集中管理多个项目的审批和SQL问题，提高工作效率和响应速度。
+全局 Dashboard 是登录后的默认首页，帮助用户集中查看跨项目的待处理事项，无需在不同项目间切换。
 
-### 功能亮点
+## 功能入口
 
-* 审批效率提升： 一站式查看所有项目的待处理工单，无需在不同项目间切换。
-* SQL问题追踪： 快速识别并优化各项目中的SQL问题，确保问题不被遗漏。
+点击页面左上角的 **全局 Dashboard** 按钮，或登录后自动进入。
 
+## Dashboard 内容
 
-### 操作步骤
-点击页面左上角的全局dashboard按钮，查看当前待处理的内容
-* 待处理的工单，可以点击跳转
-* 待处理的SQL，可以点击查看
+### 待处理工单
 
-**1. 访问全局Dashboard：**
+| 标签 | 说明 | 适用角色 |
+|------|------|---------|
+| 需我审核 | 当前用户作为审核人的待审核工单 | DBA / 审核人 |
+| 需我上线 | 当前用户作为上线人的待上线工单 | DBA / 上线人 |
+| 我创建的 | 当前用户创建的所有工单及其状态 | 开发人员 |
 
-* 点击页面左上角的全局Dashboard按钮，即可查看当前所有待处理的内容。
+点击工单名称可直接跳转至工单详情页，快速执行审批或上线操作。
 
-**2. 查看待处理工单：**
+### 待解决 SQL 问题
 
-* 在待处理工单面板中，用户可以一目了然地查看所有项目的待处理工单，包括待审批、待上线的工单。
-* 点击任意工单，即可直接跳转至详细审批页面，进行快速审批操作。
+展示各项目中待处理的 SQL 管控问题（来自智能扫描和 SQL 审核）。点击具体 SQL 可查看详细信息并进行针对性优化。
 
-**3. 查看待解决SQL问题：**
+### 统计概览
 
-* 在待解决SQL面板中，用户可以跟踪和排查各项目中存在的SQL问题，这些问题SQL来源于SQL管控中超过预定标准的SQL。
-* 点击具体的SQL问题，即可查看详细信息，并进行针对性的优化。
+Dashboard 顶部展示关键统计指标：
 
-![dashboard](img/dashboard.png)
+- 待审核工单数
+- 待上线工单数
+- 待处理 SQL 数
+- 近期工单趋势
+
+![Dashboard](img/dashboard.png)
+
+## 不同角色的使用建议
+
+| 角色 | 关注重点 |
+|------|---------|
+| 开发人员 | 查看「我创建的」工单状态，关注审核结果和驳回原因 |
+| DBA | 查看「需我审核」和「需我上线」标签，及时处理待办 |
+| 平台管理员 | 关注统计概览，了解平台整体运行状态 |

docs/user-manual/allinstance.md

@@ -1,15 +1,24 @@
 ---
 title: 全局数据源管理
 ---
-# 全局数据源管理
 
-* 当需要对多个项目中的数据源进行统一修改或查看时，此功能可以帮助迅速定位并进行操作。
-* 当需要进行跨项目管理工作时，可以使用该功能，确保对数据源的分布和配置情况一目了然，实现更高效的数据源管理和项目协调。
+全局数据源管理提供跨项目的数据源统一视图，方便管理员快速定位和管理分布在不同项目中的数据源。
 
+## 适用场景
 
-## 使用步骤
+- 需要跨项目统一查看和管理数据源
+- 需要了解数据源在各项目中的分布情况
 
-* 导航至全局设置，选择数据源管理页面，以访问平台管理的所有数据源列表。
-* 利用提供的筛选工具，根据项目需求或特定条件，精确筛选出您关注的数据源。
+## 功能入口
 
-![instancelist](img/instancelist.png)
+导航至全局设置，选择 **数据源管理** 页面。
+
+## 操作说明
+
+| 功能 | 说明 |
+|------|------|
+| 查看数据源列表 | 展示平台所有项目中的数据源 |
+| 筛选数据源 | 按项目、数据源类型等条件筛选 |
+| 跳转至数据源 | 点击数据源名称可跳转至对应项目的数据源详情 |
+
+![全局数据源管理](img/instancelist.png)

docs/user-manual/customrule.md

@@ -2,32 +2,35 @@
 title: 自定义审核规则
 ---
 
-## 使用场景
-自定义审核规则是平台提供的功能，用于根据业务需求创建新的审核规则。用户可以利用平台的自定义规则功能，通过正则表达式定义SQL审核的规范，并将新建的审核规则作为全局资源使用。
+自定义审核规则允许平台管理员通过正则表达式创建企业私有的审核规则，作为全局资源在所有规则模板中使用。
 
-## 使用步骤
+## 前置条件
 
-### 新建自定义规则
+- 当前用户为平台管理员
 
-1.以平台管理员身份登入，点击`设置`，选择`规则管理`后，选择`自定义规则`标签；
+## 创建自定义规则
 
-2.点击`新建`,填写规则基本信息，并输入正则表达式，确认无误后，点击提交，即可完成自定义规则创建；
-![customrule-regex](img/customrule-regex.png)
+1. 点击顶部导航栏 **设置 → 规则管理**，选择 **自定义规则** 标签
+2. 点击 **新建**，填写规则基本信息并输入正则表达式
+3. 点击 **提交** 完成创建
+
+![自定义规则](img/customrule-regex.png)
 
 :::tip
-当前支持golang正则语法。
+当前支持 Go 语言正则语法。
 :::
 
-### 应用自定义规则
-1.编辑数据源应用的规则模板，启用新建的自定义规则；
-2.创建工单，新建表`customers123`，从工单审核结果中可以看到自定义规则已生效；
-![customrule-result](img/customrule-result.png)
+## 应用自定义规则
+
+1. 编辑数据源绑定的规则模板，启用新建的自定义规则
+2. 创建工单时，自定义规则将参与 SQL 审核
 
+![自定义规则效果](img/customrule-result.png)
 
 :::tip
-目前仅支持在SQLE平台新建自定义规则，暂不支持导入导出规则模板时携带自定义规则。
+自定义规则目前不支持通过导入/导出规则模板携带。
 :::
 
 ## 后续操作
 
-目前，自定义规则也支持编辑知识库页面，以进一步优化审核规则的使用。可以参考[知识库](./knowledgebase.md)
+- 为自定义规则编辑知识库内容，参见 [知识库](./knowledgebase.md)

docs/user-manual/data-security/intro.md

@@ -0,0 +1,19 @@
+---
+title: 数据安全
+edition: dms
+---
+
+:::caution DMS 专有功能
+数据安全模块仅在 DMS 版本中可用。
+:::
+
+数据安全模块帮助企业对数据库账号、角色权限和敏感数据实施全方位管控，确保数据访问安全可控。
+
+## 本章内容
+
+| 功能 | 说明 | 适用角色 |
+|------|------|---------|
+| [数据脱敏](../project/data_masking.md) | 自动识别敏感字段并配置脱敏规则，保障查询和导出场景中的数据安全 | 安全管理员 / DBA |
+| [角色管理](../project/data_access_control/permission_template.md) | 查看和管理数据源上的数据库角色 | DBA |
+| [账号管理](../project/data_access_control/authorization_list.md) | 发现、创建和管理数据库账号 | DBA |
+| [临期密码](../project/data_access_control/expiring_password.md) | 监控到期密码并及时处理 | DBA |

docs/user-manual/intro.md

@@ -2,4 +2,32 @@
 title: 用户手册
 ---
 
-在程序部署完成后，用户即可通过 SQLE UI （http://127.0.0.1:10000）访问，使用SQLE平台提供的SQL审核功能。
+SQLE 是爱可生自主研发的 SQL 质量管理平台，支持 16+ 种数据库、700+ 条审核规则，覆盖 SQL 开发、审核、变更、扫描、优化全链路。
+
+:::tip 关于 SQLE 与 DMS
+SQLE 区分社区版和企业版，企业版在社区版基础上提供多项目管理、高级扫描、SSO 对接等增强能力。DMS（Data Management Service）是基于 SQLE 企业版的数据管理服务，额外提供账号管理和数据脱敏能力。
+
+本手册以 SQLE 功能为主线，企业版专有功能标注 **企业版** 标签，DMS 专有功能标注 **DMS** 标签。
+:::
+
+## 手册结构
+
+| 章节 | 说明 | 主要角色 |
+|------|------|---------|
+| [平台管理](platform/intro.md) | Dashboard、全局视图、用户与权限、系统设置 | 平台管理员 |
+| [项目空间](project/intro.md) | 数据源、成员、规则模板、流程模板等项目级配置 | 项目管理员 / DBA |
+| [SQL 开发](sql-dev/intro.md) | 快捷审核、数据导出、SQL 工作台、结构对比、IDE 审核、CI/CD | 开发 / DBA |
+| [SQL 上线](sql-deploy/intro.md) | SQL 工单（创建、审核、上线）、回滚、版本管理 | 开发 / DBA |
+| [SQL 管控](sql-management/intro.md) | SQL 管控配置、智能扫描任务、性能洞察、下钻分析 | DBA |
+| [数据安全](data-security/intro.md) | 数据脱敏、权限模板、授权清单（DMS 专有） | 安全管理员 |
+| [SQL 优化](sql-optimization/intro.md) | SQL 改写、SQL 调优 | 开发 / DBA |
+| [知识与规则](knowledge/intro.md) | 知识库、自定义规则 | 所有角色 |
+
+## 快速导航
+
+**首次使用？** 建议按以下顺序操作：
+
+1. 管理员完成 [平台管理](platform/intro.md) 中的用户和角色配置
+2. 创建 [项目](project/intro.md) 并配置数据源、规则模板、流程模板
+3. 开发人员开始 [创建工单](sql-deploy/intro.md) 提交 SQL 变更
+4. DBA 通过 [SQL 管控](sql-management/intro.md) 设置持续扫描任务