feat: 维度映射/嵌套配置/地址栏导航/界面分区重构

2026-07-16 09:01:47 +08:00
commit 5bff1a186f
19 changed files with 4186 additions and 0 deletions
@@ -0,0 +1,5 @@
+node_modules/
+data/projects.json
+data/system.json
+data/configs/*.json
+*.log
@@ -0,0 +1,49 @@
+# Registry - 微服务配置管理中心
+
+基于 Web 的注册表风格微服务配置管理系统。以项目为单位管理配置，支持机房、环境、分组三个维度划分，提供规划、编辑、只读三种工作模式。
+
+## 快速开始
+
+```bash
+npm install
+npm start
+```
+
+启动后访问 http://localhost:3000
+
+## 功能概览
+
+- **项目管理**：以项目为单位隔离配置；维度开关（机房/环境/分组）创建时确定，后续不可修改。
+- **注册表风格界面**：左侧树形导航（项目 → 机房 → 环境 → 分组 → 配置），右侧键值详情表格。
+- **配置项**：路径形式的 key，value 支持 string/number/boolean/json 类型，每项必须有说明。
+- **三种模式**：
+  - 规划模式：定义配置结构（类型、说明、用途、值范围）。
+  - 编辑模式：填写/修改配置值，含类型与范围校验。
+  - 只读模式：仅查看，禁止修改。
+- **持久化**：当前实现 JSON 文件方案，支持导出下载与导入合并。持久化层已抽象，后续可扩展 XML / YAML / SQLite / MySQL / Nacos。
+
+## 文档
+
+- 需求文档：`docs/requirements.md`
+- 概要设计文档：`docs/design.md`
+
+## 目录结构
+
+```
+registry/
+├── docs/            需求与设计文档
+├── data/            JSON 持久化数据
+├── src/             后端源码（Express）
+│   ├── server.js
+│   ├── routes/      项目与配置路由
+│   ├── services/    业务逻辑
+│   ├── persistence/ JSON 持久化适配器
+│   └── utils/       配置值校验
+└── public/          前端静态资源
+```
+
+## 后续规划
+
+- 对接 SSO 单点登录（当前版本无认证）。
+- 扩展更多持久化方案（数据库、Nacos、SSH 远程配置文件）。
+- 项目维度转换机制。
@@ -0,0 +1,215 @@
+# 概要设计文档：微服务配置管理中心 (Registry)
+
+## 1. 系统架构
+
+```mermaid
+flowchart TD
+    A[浏览器 Browser] --> B[Express Web Server]
+    B --> C[路由层 Router]
+    C --> D[项目模块 Project Service]
+    C --> E[配置模块 Config Service]
+    D --> F[JSON 持久化层 Persistence]
+    E --> F
+    F --> G[(JSON 文件存储)]
+```
+
+## 2. 技术选型
+
+| 层级 | 技术 | 说明 |
+|------|------|------|
+| 后端框架 | Express 4.x | 轻量级 HTTP 服务 |
+| 前端 | 原生 HTML/CSS/JS | 无框架依赖，降低复杂度 |
+| 持久化 | JSON 文件 | 当前实现，简单可靠 |
+| 模板引擎 | EJS | 服务端渲染基础页面 |
+| 图标 | 内联 SVG | 不依赖第三方图标库 |
+
+## 3. 数据模型
+
+### 3.1 项目 (Project)
+
+```json
+{
+  "id": "proj-001",
+  "name": "用户服务",
+  "description": "用户微服务配置",
+  "enableIdc": true,
+  "enableEnvironment": true,
+  "enableGroup": true,
+  "idcMapping": "path",
+  "environmentMapping": "path",
+  "groupMapping": "label",
+  "createdAt": "2026-07-15T10:00:00Z",
+  "updatedAt": "2026-07-15T10:00:00Z"
+}
+```
+
+字段说明：
+- `enableXxx`：维度是否启用，创建后不可修改。
+- `xxxMapping`：维度映射方式，`path` 表示作为配置存储路径前缀，`label` 表示仅作筛选标签、不进入路径。创建后可通过映射配置接口调整。
+
+### 3.2 配置项 (ConfigItem)
+
+```json
+{
+  "id": "cfg-001",
+  "projectId": "proj-001",
+  "path": "华北/dev/用户模块/db.host",
+  "key": "db.host",
+  "value": "192.168.1.100",
+  "type": "string",
+  "description": "数据库主机地址",
+  "purpose": "指定 MySQL 数据库连接地址",
+  "valueRange": "合法 IPv4 地址",
+  "createdAt": "2026-07-15T10:00:00Z",
+  "updatedAt": "2026-07-15T10:00:00Z"
+}
+```
+
+### 3.3 配置路径构建规则
+
+配置路径由“维度映射方式”与“嵌套键”共同决定：
+
+```
+路径模板 = [映射为 path 的维度前缀...]/嵌套键
+
+- 维度启用且映射为 path  → 该维度值作为路径前缀
+- 维度启用且映射为 label → 该维度不进入路径，仅作维度栏筛选
+- 维度未启用             → 跳过
+- 配置键 key 自身可用 / 嵌套多级（json 类型在展示时按 . 分割）
+```
+
+示例（机房=path、环境=path、分组=label）：
+- 配置键 `db/host`，机房 `华北`，环境 `dev`，分组 `用户模块`
+- 生成路径：`华北/dev/db/host`（分组作为标签筛选，不进入路径）
+
+示例（全部映射为 path）：
+- 配置键 `db.host` → 路径 `华北/dev/用户模块/db.host`
+
+## 4. API 设计
+
+### 4.1 项目接口
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/api/projects` | 获取项目列表 |
+| GET | `/api/projects/:id` | 获取项目详情 |
+| POST | `/api/projects` | 创建项目（含维度开关与映射方式） |
+| PUT | `/api/projects/:id/mappings` | 更新维度映射方式（path/label） |
+| DELETE | `/api/projects/:id` | 删除项目 |
+
+### 4.2 配置接口
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/api/projects/:id/configs` | 获取项目下所有配置 |
+| GET | `/api/projects/:id/configs/:configId` | 获取单个配置详情 |
+| POST | `/api/projects/:id/configs` | 新增配置项 |
+| PUT | `/api/projects/:id/configs/:configId` | 修改配置项 |
+| DELETE | `/api/projects/:id/configs/:configId` | 删除配置项 |
+
+### 4.3 模式接口
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | `/api/mode` | 获取当前模式 |
+| PUT | `/api/mode` | 切换模式（plan/edit/readonly） |
+
+## 5. 前端界面设计
+
+### 5.1 布局结构
+
+```
+--------------------------------------------------+
+|  标题栏：应用名 | 当前项目名                      |
+--------------------------------------------------+
+|  工具栏（分组）：项目 | 模式 | 配置 | 数据        |
+--------------------------------------------------+
+|  维度栏：机房▼ | 环境▼ | 分组▼ | ⚙映射配置       |
+------------+-------------------------------------+
+|  树形导航  |  地址栏：📍 路径 [转到][拷贝]        |
+|  (左侧)    |  +-------------------------------+  |
+|  📦 项目A  |  | 键名 | 值 | 类型 | 说明      |  |
+|   📁 华北  |  |------+----+------+----------|  |
+|    📁 dev  |  | db/host|192.|string|数据库.. |  |
+|     📁 db  |  | db/port|3306|number|数据库.. |  |
+|      🔑host|  +-------------------------------+  |
+------------+-------------------------------------+
+|  状态栏                                            |
+--------------------------------------------------+
+```
+
+界面分区说明：
+- 标题栏：仅展示应用名与当前项目名，与操作区分离。
+- 工具栏：按“项目 / 模式 / 配置 / 数据”分组排列操作按钮。
+- 维度栏：展示已启用维度的筛选下拉与映射方式标记，提供映射配置入口。
+- 地址栏：注册表风格路径框，支持拷贝、粘贴后回车跳转到对应节点。
+- 树形导航：按“path 维度前缀 + 嵌套键”逐级展开，叶子节点（🔑）为真实配置项。
+
+### 5.2 三种模式差异化
+
+| 功能 | 规划模式 | 编辑模式 | 只读模式 |
+|------|---------|---------|---------|
+| 查看配置 | ✓ | ✓ | ✓ |
+| 新增/删除配置 | ✓ | ✓ | ✗ |
+| 修改值 | ✗ | ✓ | ✗ |
+| 修改类型/说明/用途/范围 | ✓ | ✗ | ✗ |
+| 配置值校验 | 仅格式 | 格式+范围 | 不校验 |
+
+## 6. 持久化层设计
+
+### 6.1 存储结构
+
+```
+data/
+├── projects.json          # 项目元数据
+├── configs/
+│   └── {projectId}.json   # 每个项目独立配置文件
+└── system.json            # 系统级配置（当前模式等）
+```
+
+### 6.2 持久化接口（预留扩展）
+
+```javascript
+class PersistenceAdapter {
+  async loadProjects() {}
+  async saveProjects(projects) {}
+  async loadConfigs(projectId) {}
+  async saveConfigs(projectId, configs) {}
+  async loadSystem() {}
+  async saveSystem(system) {}
+}
+```
+
+当前实现 `JsonFileAdapter`，后续可扩展 `SqliteAdapter`、`NacosAdapter` 等。
+
+## 7. 目录结构
+
+```
+registry/
+├── docs/
+│   ├── requirements.md     # 需求文档
+│   └── design.md           # 概要设计文档
+├── data/                   # 持久化数据目录
+├── src/
+│   ├── server.js           # 服务入口
+│   ├── routes/
+│   │   ├── projects.js     # 项目路由
+│   │   └── configs.js      # 配置路由
+│   ├── services/
+│   │   ├── projectService.js
+│   │   └── configService.js
+│   ├── persistence/
+│   │   └── jsonAdapter.js  # JSON 持久化适配器
+│   └── utils/
+│       └── validator.js    # 配置值校验
+├── public/
+│   ├── index.html          # 主页面
+│   ├── css/
+│   │   └── style.css       # 样式
+│   └── js/
+│       ├── app.js          # 主逻辑
+│       ├── tree.js         # 树形组件
+│       └── api.js          # API 调用封装
+├── package.json
+└── README.md
+```
@@ -0,0 +1,74 @@
+# 需求文档：微服务配置管理中心 (Registry)
+
+## 1. 项目背景
+
+在微服务架构中，配置管理是核心基础设施之一。不同项目、不同环境、不同机房的配置散落在各处，缺乏统一的管理界面和规范。本系统旨在提供一个类 Windows 注册表风格的 Web 管理界面，实现配置的集中化、可视化、规范化管理。
+
+## 2. 功能需求
+
+### 2.1 项目管理
+
+- **FR-1-1**：支持创建项目，项目创建时需指定项目名称、描述、以及是否启用机房/环境/分组维度
+- **FR-1-2**：项目创建后，维度开关（机房/环境/分组）不可修改，只能通过项目转换机制处理
+- **FR-1-3**：支持查看项目列表、项目详情
+- **FR-1-4**：支持删除项目（级联删除所有关联配置）
+
+### 2.2 配置维度
+
+- **FR-2-1**：机房维度——用于隔离不同物理/云区域（如华北机房、华南机房）
+- **FR-2-2**：环境维度——用于隔离不同运行阶段（如开发、测试、生产）
+- **FR-2-3**：分组维度——用于项目内业务分组（如用户模块、订单模块）
+- **FR-2-4**：维度启用后可在维度栏直接展示与筛选，不直接硬编码进配置路径
+- **FR-2-5**：每个维度可配置映射方式——`path`（作为配置存储路径前缀）或 `label`（仅作筛选标签，不进入路径），默认 `path`
+- **FR-2-6**：映射方式创建后可通过映射配置入口调整（维度启用开关仍不可改）
+
+### 2.3 配置项管理
+
+- **FR-3-1**：配置以路径形式组织，类似注册表键值结构；路径 = 映射为 path 的维度前缀 + 嵌套键
+- **FR-3-6**：配置键支持嵌套，以 `/` 分割；json 类型在展示时自动按 `.` 分割
+- **FR-3-7**：提供配置导航地址栏，显示当前路径，可拷贝、可粘贴后回车跳转到对应目录（类似 Windows 注册表地址栏）
+- **FR-3-2**：每个配置项支持类型指定：string、number、boolean、json
+- **FR-3-3**：每个配置项必须有说明（description），用于文档化配置用途
+- **FR-3-4**：支持配置项的新增、修改、删除
+- **FR-3-5**：配置值根据类型进行格式校验
+
+### 2.4 三种工作模式
+
+- **FR-4-1**：规划模式——定义配置结构，包括字段名、类型、用途、值范围约束，类似"配置 Schema 设计"
+- **FR-4-2**：编辑模式——在规划好的结构基础上填写实际配置值
+- **FR-4-3**：只读模式——仅可查看配置，不可修改，用于日常查阅和审计
+
+### 2.5 持久化方案
+
+- **FR-5-1**：支持 JSON 文件持久化（当前版本实现）
+- **FR-5-2**：预留扩展接口，后续支持 XML、YAML、SQLite、MySQL、Nacos
+- **FR-5-3**：配置文件支持导出下载
+- **FR-5-4**：配置文件支持导入合并
+
+### 2.6 界面要求
+
+- **FR-6-1**：左侧树形导航，按“path 维度前缀 + 嵌套键”逐级展开，视觉风格参考 Windows 注册表编辑器
+- **FR-6-2**：右侧详情面板，顶部为配置导航地址栏，下方展示选中节点的配置项列表
+- **FR-6-3**：每个配置项展示：键名、值、类型、说明
+- **FR-6-4**：标题栏（应用名+当前项目）与工具栏分离；工具栏按项目/模式/配置/数据分组
+- **FR-6-5**：维度栏独立展示已启用维度的筛选器与映射方式，并提供映射配置入口
+
+## 3. 非功能需求
+
+- **NFR-1**：技术栈：Node.js + Express 后端，原生 HTML/CSS/JS 前端
+- **NFR-2**：后续对接 SSO 单点登录，当前版本暂不实现认证
+- **NFR-3**：界面响应式，支持主流浏览器
+- **NFR-4**：配置数据实时写入持久化存储，保证数据一致性
+
+## 4. 术语定义
+
+| 术语 | 说明 |
+|------|------|
+| 项目 (Project) | 配置管理的顶层隔离单元，对应一个微服务或应用 |
+| 机房 (IDC) | 物理或云区域标识，如华北、华南、华东 |
+| 环境 (Environment) | 运行阶段标识，如 dev、test、prod |
+| 分组 (Group) | 业务模块分组，如 user、order、payment |
+| 配置路径 (Path) | 注册表风格的层级路径，如 `project/idc/env/group/key` |
+| 规划模式 | Schema 设计模式，定义配置结构 |
+| 编辑模式 | 配置值填写模式 |
+| 只读模式 | 查看模式，禁止修改 |
@@ -0,0 +1,829 @@
+{
+  "name": "microservice-registry",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "microservice-registry",
+      "version": "1.0.0",
+      "license": "MIT",
+      "dependencies": {
+        "express": "^4.18.2"
+      }
+    },
+    "node_modules/accepts": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmmirror.com/accepts/-/accepts-1.3.8.tgz",
+      "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-types": "~2.1.34",
+        "negotiator": "0.6.3"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/array-flatten": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmmirror.com/array-flatten/-/array-flatten-1.1.1.tgz",
+      "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
+      "license": "MIT"
+    },
+    "node_modules/body-parser": {
+      "version": "1.20.6",
+      "resolved": "https://registry.npmmirror.com/body-parser/-/body-parser-1.20.6.tgz",
+      "integrity": "sha512-p5tAzS57i5MV9fZFDj9LeIiTZEufbSe2eDozP+ElheSUq1m74CRq1jI4mYNDdVs9vQztXFLuk/Gd6BWTdwRJ5g==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "content-type": "~1.0.5",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "~1.2.0",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "on-finished": "~2.4.1",
+        "qs": "~6.15.1",
+        "raw-body": "~2.5.3",
+        "type-is": "~1.6.18",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8",
+        "npm": "1.2.8000 || >= 1.4.16"
+      }
+    },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmmirror.com/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmmirror.com/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmmirror.com/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/content-disposition": {
+      "version": "0.5.4",
+      "resolved": "https://registry.npmmirror.com/content-disposition/-/content-disposition-0.5.4.tgz",
+      "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "5.2.1"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmmirror.com/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmmirror.com/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie-signature": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmmirror.com/cookie-signature/-/cookie-signature-1.0.7.tgz",
+      "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==",
+      "license": "MIT"
+    },
+    "node_modules/debug": {
+      "version": "2.6.9",
+      "resolved": "https://registry.npmmirror.com/debug/-/debug-2.6.9.tgz",
+      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "2.0.0"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmmirror.com/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/destroy": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmmirror.com/destroy/-/destroy-1.2.0.tgz",
+      "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8",
+        "npm": "1.2.8000 || >= 1.4.16"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmmirror.com/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+      "license": "MIT"
+    },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmmirror.com/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmmirror.com/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmmirror.com/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
+      "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmmirror.com/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmmirror.com/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/express": {
+      "version": "4.22.2",
+      "resolved": "https://registry.npmmirror.com/express/-/express-4.22.2.tgz",
+      "integrity": "sha512-IuL+Elrou2ZvCFHs18/CIzy2Nzvo25nZ1/D2eIZlz7c+QUayAcYoiM2BthCjs+EBHVpjYjcuLDAiCWgeIX3X1Q==",
+      "license": "MIT",
+      "dependencies": {
+        "accepts": "~1.3.8",
+        "array-flatten": "1.1.1",
+        "body-parser": "~1.20.5",
+        "content-disposition": "~0.5.4",
+        "content-type": "~1.0.4",
+        "cookie": "~0.7.1",
+        "cookie-signature": "~1.0.6",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "finalhandler": "~1.3.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.0",
+        "merge-descriptors": "1.0.3",
+        "methods": "~1.1.2",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "path-to-regexp": "~0.1.12",
+        "proxy-addr": "~2.0.7",
+        "qs": "~6.15.1",
+        "range-parser": "~1.2.1",
+        "safe-buffer": "5.2.1",
+        "send": "~0.19.0",
+        "serve-static": "~1.16.2",
+        "setprototypeof": "1.2.0",
+        "statuses": "~2.0.1",
+        "type-is": "~1.6.18",
+        "utils-merge": "1.0.1",
+        "vary": "~1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/finalhandler": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmmirror.com/finalhandler/-/finalhandler-1.3.2.tgz",
+      "integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "2.6.9",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "statuses": "~2.0.2",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmmirror.com/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fresh": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmmirror.com/fresh/-/fresh-0.5.2.tgz",
+      "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmmirror.com/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmmirror.com/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmmirror.com/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmmirror.com/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmmirror.com/hasown/-/hasown-2.0.4.tgz",
+      "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmmirror.com/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.4.24",
+      "resolved": "https://registry.npmmirror.com/iconv-lite/-/iconv-lite-0.4.24.tgz",
+      "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmmirror.com/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmmirror.com/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmmirror.com/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/media-typer": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmmirror.com/media-typer/-/media-typer-0.3.0.tgz",
+      "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/merge-descriptors": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmmirror.com/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
+      "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/methods": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmmirror.com/methods/-/methods-1.1.2.tgz",
+      "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmmirror.com/mime/-/mime-1.6.0.tgz",
+      "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
+      "license": "MIT",
+      "bin": {
+        "mime": "cli.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmmirror.com/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmmirror.com/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmmirror.com/ms/-/ms-2.0.0.tgz",
+      "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+      "license": "MIT"
+    },
+    "node_modules/negotiator": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmmirror.com/negotiator/-/negotiator-0.6.3.tgz",
+      "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmmirror.com/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmmirror.com/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "license": "MIT",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmmirror.com/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/path-to-regexp": {
+      "version": "0.1.13",
+      "resolved": "https://registry.npmmirror.com/path-to-regexp/-/path-to-regexp-0.1.13.tgz",
+      "integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==",
+      "license": "MIT"
+    },
+    "node_modules/proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmmirror.com/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "license": "MIT",
+      "dependencies": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/qs": {
+      "version": "6.15.3",
+      "resolved": "https://registry.npmmirror.com/qs/-/qs-6.15.3.tgz",
+      "integrity": "sha512-O9gl3zCl5h5blw1KGUzQKhA5oUXSl8rwUIM5o0S3nCXMliSvy5Dzx7/DJcI+SwgICv+IneSZwhBh1oSyEHA71A==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "es-define-property": "^1.0.1",
+        "side-channel": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/range-parser": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmmirror.com/range-parser/-/range-parser-1.2.1.tgz",
+      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "2.5.3",
+      "resolved": "https://registry.npmmirror.com/raw-body/-/raw-body-2.5.3.tgz",
+      "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmmirror.com/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmmirror.com/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "license": "MIT"
+    },
+    "node_modules/send": {
+      "version": "0.19.2",
+      "resolved": "https://registry.npmmirror.com/send/-/send-0.19.2.tgz",
+      "integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "1.2.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.1",
+        "mime": "1.6.0",
+        "ms": "2.1.3",
+        "on-finished": "~2.4.1",
+        "range-parser": "~1.2.1",
+        "statuses": "~2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/send/node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmmirror.com/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    },
+    "node_modules/serve-static": {
+      "version": "1.16.3",
+      "resolved": "https://registry.npmmirror.com/serve-static/-/serve-static-1.16.3.tgz",
+      "integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "parseurl": "~1.3.3",
+        "send": "~0.19.1"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmmirror.com/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "license": "ISC"
+    },
+    "node_modules/side-channel": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmmirror.com/side-channel/-/side-channel-1.1.1.tgz",
+      "integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.4",
+        "side-channel-list": "^1.0.1",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/side-channel-list/-/side-channel-list-1.0.1.tgz",
+      "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.4"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmmirror.com/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmmirror.com/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/type-is": {
+      "version": "1.6.18",
+      "resolved": "https://registry.npmmirror.com/type-is/-/type-is-1.6.18.tgz",
+      "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
+      "license": "MIT",
+      "dependencies": {
+        "media-typer": "0.3.0",
+        "mime-types": "~2.1.24"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmmirror.com/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/utils-merge": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/utils-merge/-/utils-merge-1.0.1.tgz",
+      "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4.0"
+      }
+    },
+    "node_modules/vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmmirror.com/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    }
+  }
+}
@@ -0,0 +1,16 @@
+{
+  "name": "microservice-registry",
+  "version": "1.0.0",
+  "description": "微服务配置管理中心 - 基于 Web 的注册表风格配置管理",
+  "main": "src/server.js",
+  "scripts": {
+    "start": "node src/server.js",
+    "dev": "node src/server.js",
+    "test": "node --test"
+  },
+  "keywords": ["config", "registry", "microservice"],
+  "license": "MIT",
+  "dependencies": {
+    "express": "^4.18.2"
+  }
+}
@@ -0,0 +1,695 @@
+/* Registry 配置管理中心样式 - 参考 Windows 注册表编辑器风格 */
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: "Segoe UI", "Microsoft YaHei", sans-serif;
+  font-size: 13px;
+  color: #1e1e1e;
+  background: #f0f0f0;
+  height: 100vh;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+
+/* 顶部工具栏 */
+.toolbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  height: 44px;
+  padding: 0 12px;
+  background: linear-gradient(to bottom, #fdfdfd, #e8e8e8);
+  border-bottom: 1px solid #c0c0c0;
+  flex-shrink: 0;
+}
+
+.toolbar-left,
+.toolbar-center,
+.toolbar-right {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.app-title {
+  font-weight: 600;
+  font-size: 14px;
+  color: #003a70;
+}
+
+.toolbar-select {
+  height: 28px;
+  padding: 0 8px;
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  background: #fff;
+  font-size: 13px;
+  min-width: 180px;
+}
+
+.toolbar-btn {
+  height: 28px;
+  padding: 0 10px;
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  background: linear-gradient(to bottom, #fdfdfd, #e8e8e8);
+  cursor: pointer;
+  font-size: 12px;
+}
+
+.toolbar-btn:hover {
+  background: linear-gradient(to bottom, #eaf3fb, #d6e9f9);
+  border-color: #5b9bd5;
+}
+
+.mode-label {
+  color: #555;
+}
+
+.mode-switcher {
+  display: flex;
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  overflow: hidden;
+}
+
+.mode-btn {
+  height: 28px;
+  padding: 0 12px;
+  border: none;
+  border-right: 1px solid #adadad;
+  background: #fff;
+  cursor: pointer;
+  font-size: 12px;
+}
+
+.mode-btn:last-child {
+  border-right: none;
+}
+
+.mode-btn.active {
+  background: #0078d4;
+  color: #fff;
+  font-weight: 600;
+}
+
+.mode-btn:not(.active):hover {
+  background: #e5f1fb;
+}
+
+/* 主内容区 */
+.main-container {
+  flex: 1;
+  display: flex;
+  overflow: hidden;
+}
+
+/* 左侧树形导航 */
+.tree-panel {
+  width: 320px;
+  min-width: 180px;
+  background: #fff;
+  border-right: 1px solid #c0c0c0;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+
+.tree-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  height: 30px;
+  padding: 0 10px;
+  background: #f5f5f5;
+  border-bottom: 1px solid #e0e0e0;
+  font-weight: 600;
+  color: #555;
+}
+
+.icon-btn {
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  font-size: 14px;
+  color: #666;
+}
+
+.tree-content {
+  flex: 1;
+  overflow: auto;
+  padding: 4px 0;
+}
+
+.tree-empty {
+  padding: 20px;
+  text-align: center;
+  color: #999;
+}
+
+/* 树节点 */
+.tree-node {
+  user-select: none;
+}
+
+.tree-node-label {
+  display: flex;
+  align-items: center;
+  height: 24px;
+  padding: 0 4px;
+  cursor: pointer;
+  white-space: nowrap;
+}
+
+.tree-node-label:hover {
+  background: #e5f1fb;
+}
+
+.tree-node-label.selected {
+  background: #cce8ff;
+}
+
+.tree-toggle {
+  width: 16px;
+  display: inline-block;
+  text-align: center;
+  color: #666;
+  font-size: 10px;
+}
+
+.tree-icon {
+  margin-right: 4px;
+}
+
+.tree-children {
+  padding-left: 16px;
+}
+
+.tree-children.collapsed {
+  display: none;
+}
+
+/* 分隔条 */
+.resizer {
+  width: 4px;
+  background: #e0e0e0;
+  cursor: col-resize;
+  flex-shrink: 0;
+}
+
+.resizer:hover {
+  background: #5b9bd5;
+}
+
+/* 右侧详情面板 */
+.detail-panel {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  background: #fff;
+  overflow: hidden;
+}
+
+.detail-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  min-height: 34px;
+  padding: 4px 12px;
+  background: #f5f5f5;
+  border-bottom: 1px solid #e0e0e0;
+}
+
+#detail-path {
+  font-family: Consolas, monospace;
+  color: #003a70;
+  font-size: 12px;
+}
+
+.detail-actions {
+  display: flex;
+  gap: 6px;
+}
+
+.detail-table-wrapper {
+  flex: 1;
+  overflow: auto;
+}
+
+/* 配置表格 */
+.config-table {
+  width: 100%;
+  border-collapse: collapse;
+}
+
+.config-table th {
+  position: sticky;
+  top: 0;
+  background: #f0f0f0;
+  border-bottom: 1px solid #c0c0c0;
+  border-right: 1px solid #e0e0e0;
+  padding: 6px 10px;
+  text-align: left;
+  font-weight: 600;
+  color: #555;
+}
+
+.config-table td {
+  padding: 6px 10px;
+  border-bottom: 1px solid #f0f0f0;
+  border-right: 1px solid #f5f5f5;
+  vertical-align: top;
+}
+
+.config-table tr:hover td {
+  background: #f8fbff;
+}
+
+.col-key { width: 22%; }
+.col-value { width: 26%; }
+.col-type { width: 10%; }
+.col-desc { width: 30%; }
+.col-actions { width: 12%; }
+
+.config-key-cell {
+  font-family: Consolas, monospace;
+  color: #0451a5;
+}
+
+.config-value-cell {
+  font-family: Consolas, monospace;
+  word-break: break-all;
+}
+
+.type-badge {
+  display: inline-block;
+  padding: 1px 8px;
+  border-radius: 10px;
+  font-size: 11px;
+  background: #e5f1fb;
+  color: #0078d4;
+}
+
+.empty-row td {
+  text-align: center;
+  color: #999;
+  padding: 30px;
+}
+
+.row-btn {
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  background: #fff;
+  cursor: pointer;
+  padding: 2px 8px;
+  font-size: 11px;
+  margin-right: 4px;
+}
+
+.row-btn:hover {
+  background: #e5f1fb;
+}
+
+.row-btn.danger:hover {
+  background: #fde7e9;
+  border-color: #d13438;
+  color: #d13438;
+}
+
+/* 状态栏 */
+.statusbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  height: 24px;
+  padding: 0 12px;
+  background: #f0f0f0;
+  border-top: 1px solid #c0c0c0;
+  font-size: 12px;
+  color: #666;
+  flex-shrink: 0;
+}
+
+/* 模态框 */
+.modal-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.35);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+}
+
+.modal {
+  width: 480px;
+  background: #fff;
+  border-radius: 6px;
+  box-shadow: 0 8px 30px rgba(0, 0, 0, 0.25);
+  overflow: hidden;
+}
+
+.modal-sm {
+  width: 360px;
+}
+
+.modal-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 12px 16px;
+  background: #f5f5f5;
+  border-bottom: 1px solid #e0e0e0;
+}
+
+.modal-header h3 {
+  font-size: 15px;
+  color: #003a70;
+}
+
+.modal-close {
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  font-size: 16px;
+  color: #999;
+}
+
+.modal-close:hover {
+  color: #333;
+}
+
+.modal-body {
+  padding: 16px;
+  max-height: 60vh;
+  overflow: auto;
+}
+
+.modal-footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  padding: 12px 16px;
+  border-top: 1px solid #e0e0e0;
+}
+
+/* 表单 */
+.form-group {
+  margin-bottom: 12px;
+}
+
+.form-row {
+  display: flex;
+  gap: 12px;
+}
+
+.form-half {
+  flex: 1;
+}
+
+.form-group label {
+  display: block;
+  margin-bottom: 4px;
+  font-weight: 600;
+  color: #444;
+  font-size: 12px;
+}
+
+.form-group input,
+.form-group select,
+.form-group textarea {
+  width: 100%;
+  padding: 6px 8px;
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  font-size: 13px;
+  font-family: inherit;
+}
+
+.form-group textarea {
+  resize: vertical;
+}
+
+.required {
+  color: #d13438;
+}
+
+.hint {
+  font-weight: normal;
+  color: #999;
+  font-size: 11px;
+}
+
+.checkbox-group {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.checkbox-label {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-weight: normal !important;
+  cursor: pointer;
+}
+
+.checkbox-label input {
+  width: auto !important;
+}
+
+/* 按钮 */
+.btn {
+  height: 30px;
+  padding: 0 16px;
+  border-radius: 3px;
+  border: 1px solid #adadad;
+  cursor: pointer;
+  font-size: 13px;
+}
+
+.btn-primary {
+  background: #0078d4;
+  color: #fff;
+  border-color: #0078d4;
+}
+
+.btn-primary:hover {
+  background: #106ebe;
+}
+
+.btn-secondary {
+  background: #fff;
+}
+
+.btn-secondary:hover {
+  background: #f0f0f0;
+}
+
+.btn-danger {
+  background: #d13438;
+  color: #fff;
+  border-color: #d13438;
+}
+
+.btn-danger:hover {
+  background: #b52e32;
+}
+
+/* 只读模式下隐藏操作按钮 */
+body.mode-readonly .detail-actions #btn-add-config,
+body.mode-readonly .row-btn:not(.view) {
+  display: none;
+}
+
+/* Toast 提示 */
+.toast {
+  position: fixed;
+  top: 60px;
+  left: 50%;
+  transform: translateX(-50%);
+  padding: 10px 20px;
+  border-radius: 4px;
+  color: #fff;
+  font-size: 13px;
+  z-index: 2000;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
+}
+
+.toast-success { background: #107c10; }
+.toast-error { background: #d13438; }
+.toast-info { background: #0078d4; }
+
+/* ===== 标题栏（与工具栏分离） ===== */
+.titlebar {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  height: 40px;
+  padding: 0 14px;
+  background: linear-gradient(to bottom, #0a4a86, #003a70);
+  color: #fff;
+  flex-shrink: 0;
+}
+
+.titlebar .app-title {
+  font-weight: 600;
+  font-size: 15px;
+  color: #fff;
+}
+
+.titlebar .current-project {
+  font-size: 13px;
+  color: #cfe3f7;
+  padding-left: 14px;
+  border-left: 1px solid rgba(255, 255, 255, 0.3);
+}
+
+/* ===== 工具栏（分组处理） ===== */
+.toolbar {
+  display: flex;
+  align-items: stretch;
+  gap: 4px;
+  min-height: 46px;
+  padding: 4px 8px;
+  background: linear-gradient(to bottom, #fdfdfd, #eaeaea);
+  border-bottom: 1px solid #c0c0c0;
+  flex-shrink: 0;
+  flex-wrap: wrap;
+}
+
+.tool-group {
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: 6px;
+  padding: 2px 10px;
+  border-right: 1px solid #d5d5d5;
+}
+
+.tool-group .group-label {
+  font-size: 11px;
+  color: #888;
+}
+
+/* ===== 维度栏 ===== */
+.dimension-bar {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  min-height: 34px;
+  padding: 4px 14px;
+  background: #eef4fb;
+  border-bottom: 1px solid #d0dced;
+  flex-shrink: 0;
+  flex-wrap: wrap;
+}
+
+.dim-empty {
+  color: #8aa;
+  font-size: 12px;
+}
+
+.dim-item {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+
+.dim-item .dim-name {
+  font-weight: 600;
+  color: #0a4a86;
+  font-size: 12px;
+}
+
+.dim-select {
+  height: 26px;
+  padding: 0 6px;
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  background: #fff;
+  font-size: 12px;
+}
+
+.dim-mapping {
+  font-size: 11px;
+  color: #7a8ba0;
+}
+
+/* ===== 配置导航地址栏 ===== */
+.address-bar {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 12px;
+  background: #f5f5f5;
+  border-bottom: 1px solid #e0e0e0;
+}
+
+.address-icon {
+  font-size: 13px;
+}
+
+.address-input {
+  flex: 1;
+  height: 28px;
+  padding: 0 10px;
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  font-family: Consolas, monospace;
+  font-size: 12px;
+}
+
+.addr-btn {
+  height: 28px;
+  padding: 0 12px;
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  background: linear-gradient(to bottom, #fdfdfd, #e8e8e8);
+  cursor: pointer;
+  font-size: 12px;
+}
+
+.addr-btn:hover {
+  background: linear-gradient(to bottom, #eaf3fb, #d6e9f9);
+  border-color: #5b9bd5;
+}
+
+/* ===== 新建项目维度映射行 ===== */
+.dim-config-row {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin-bottom: 8px;
+}
+
+.dim-config-row .checkbox-label {
+  min-width: 60px;
+}
+
+.dim-config-row .map-name {
+  min-width: 60px;
+  font-weight: 600;
+  color: #444;
+  font-size: 12px;
+}
+
+.mapping-select {
+  height: 28px;
+  padding: 0 8px;
+  border: 1px solid #adadad;
+  border-radius: 3px;
+  background: #fff;
+  font-size: 12px;
+}
+
+/* ===== 树节点：值项与目录项区分 ===== */
+.tree-node-label.is-leaf .tree-icon {
+  opacity: 0.9;
+}
@@ -0,0 +1,292 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Registry - 微服务配置管理中心</title>
+  <link rel="stylesheet" href="/css/style.css">
+</head>
+<body>
+  <!-- 标题栏：仅展示应用名与当前项目 -->
+  <header class="titlebar">
+    <span class="app-title">📋 Registry 配置管理中心</span>
+    <span class="current-project" id="current-project-name">未选择项目</span>
+  </header>
+
+  <!-- 工具栏：分组处理（项目 / 模式 / 配置 / 数据） -->
+  <div class="toolbar">
+    <div class="tool-group" title="项目操作">
+      <span class="group-label">项目</span>
+      <select id="project-selector" class="toolbar-select">
+        <option value="">-- 选择项目 --</option>
+      </select>
+      <button id="btn-new-project" class="toolbar-btn" title="新建项目">📁 新建</button>
+      <button id="btn-delete-project" class="toolbar-btn" title="删除项目">🗑 删除</button>
+    </div>
+
+    <div class="tool-group" title="工作模式">
+      <span class="group-label">模式</span>
+      <div class="mode-switcher">
+        <button class="mode-btn" data-mode="plan" title="规划模式：定义配置结构">📐 规划</button>
+        <button class="mode-btn active" data-mode="edit" title="编辑模式：修改配置值">✏️ 编辑</button>
+        <button class="mode-btn" data-mode="readonly" title="只读模式：仅查看">👁️ 只读</button>
+      </div>
+    </div>
+
+    <div class="tool-group" title="配置操作">
+      <span class="group-label">配置</span>
+      <button id="btn-add-config" class="toolbar-btn" title="新增配置项">➕ 新增</button>
+      <button id="btn-collapse-all" class="toolbar-btn" title="全部折叠">⊟ 折叠</button>
+    </div>
+
+    <div class="tool-group" title="数据操作">
+      <span class="group-label">数据</span>
+      <button id="btn-export-config" class="toolbar-btn" title="导出配置">📥 导出</button>
+      <button id="btn-import-config" class="toolbar-btn" title="导入配置">📤 导入</button>
+      <input type="file" id="import-file-input" accept=".json" style="display:none">
+    </div>
+  </div>
+
+  <!-- 维度栏：展示已启用维度的筛选器与映射配置入口 -->
+  <div class="dimension-bar" id="dimension-bar">
+    <span class="dim-empty" id="dim-empty">选择项目后展示维度筛选</span>
+    <div class="dim-item" id="dim-idc" style="display:none">
+      <span class="dim-name">机房</span>
+      <select class="dim-select" id="dim-idc-select"></select>
+      <span class="dim-mapping" id="dim-idc-mapping"></span>
+    </div>
+    <div class="dim-item" id="dim-env" style="display:none">
+      <span class="dim-name">环境</span>
+      <select class="dim-select" id="dim-env-select"></select>
+      <span class="dim-mapping" id="dim-env-mapping"></span>
+    </div>
+    <div class="dim-item" id="dim-group" style="display:none">
+      <span class="dim-name">分组</span>
+      <select class="dim-select" id="dim-group-select"></select>
+      <span class="dim-mapping" id="dim-group-mapping"></span>
+    </div>
+    <button id="btn-dim-mapping" class="toolbar-btn" style="display:none" title="配置维度映射方式">⚙ 映射配置</button>
+  </div>
+
+  <!-- 主内容区 -->
+  <div class="main-container">
+    <!-- 左侧树形导航 -->
+    <aside class="tree-panel" id="tree-panel">
+      <div class="tree-header">
+        <span>配置树</span>
+      </div>
+      <div class="tree-content" id="tree-content">
+        <div class="tree-empty">请先选择一个项目</div>
+      </div>
+    </aside>
+
+    <!-- 分隔条 -->
+    <div class="resizer" id="resizer"></div>
+
+    <!-- 右侧详情面板 -->
+    <main class="detail-panel" id="detail-panel">
+      <!-- 配置导航地址栏：显示当前路径，可拷贝、可粘贴回车跳转 -->
+      <div class="address-bar">
+        <span class="address-icon">📍</span>
+        <input type="text" id="address-input" class="address-input" placeholder="配置路径，回车跳转（类似注册表地址栏）">
+        <button id="btn-address-go" class="addr-btn" title="跳转到路径">转到</button>
+        <button id="btn-address-copy" class="addr-btn" title="拷贝路径">拷贝</button>
+      </div>
+      <div class="detail-table-wrapper">
+        <table class="config-table" id="config-table">
+          <thead>
+            <tr>
+              <th class="col-key">键名</th>
+              <th class="col-value">值</th>
+              <th class="col-type">类型</th>
+              <th class="col-desc">说明</th>
+              <th class="col-actions">操作</th>
+            </tr>
+          </thead>
+          <tbody id="config-tbody">
+            <tr class="empty-row">
+              <td colspan="5">请在左侧选择节点查看配置</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </main>
+  </div>
+
+  <!-- 状态栏 -->
+  <footer class="statusbar">
+    <span id="status-text">就绪</span>
+    <span id="status-mode">当前模式：编辑</span>
+  </footer>
+
+  <!-- 模态框：新建项目 -->
+  <div class="modal-overlay" id="modal-project" style="display:none">
+    <div class="modal">
+      <div class="modal-header">
+        <h3 id="modal-project-title">新建项目</h3>
+        <button class="modal-close" onclick="closeModal('modal-project')">✕</button>
+      </div>
+      <div class="modal-body">
+        <div class="form-group">
+          <label>项目名称 <span class="required">*</span></label>
+          <input type="text" id="project-name" placeholder="例如：用户服务">
+        </div>
+        <div class="form-group">
+          <label>项目描述</label>
+          <textarea id="project-description" rows="2" placeholder="项目配置说明"></textarea>
+        </div>
+        <div class="form-group">
+          <label>维度配置 <span class="hint">（是否启用创建后不可修改；映射方式后续可调整）</span></label>
+          <div class="dim-config-row">
+            <label class="checkbox-label"><input type="checkbox" id="project-enable-idc" checked> 机房</label>
+            <select id="project-idc-mapping" class="mapping-select">
+              <option value="path">映射为路径</option>
+              <option value="label">仅作标签</option>
+            </select>
+          </div>
+          <div class="dim-config-row">
+            <label class="checkbox-label"><input type="checkbox" id="project-enable-env" checked> 环境</label>
+            <select id="project-env-mapping" class="mapping-select">
+              <option value="path">映射为路径</option>
+              <option value="label">仅作标签</option>
+            </select>
+          </div>
+          <div class="dim-config-row">
+            <label class="checkbox-label"><input type="checkbox" id="project-enable-group" checked> 分组</label>
+            <select id="project-group-mapping" class="mapping-select">
+              <option value="path">映射为路径</option>
+              <option value="label">仅作标签</option>
+            </select>
+          </div>
+        </div>
+      </div>
+      <div class="modal-footer">
+        <button class="btn btn-secondary" onclick="closeModal('modal-project')">取消</button>
+        <button class="btn btn-primary" id="btn-save-project">保存</button>
+      </div>
+    </div>
+  </div>
+
+  <!-- 模态框：维度映射配置 -->
+  <div class="modal-overlay" id="modal-mapping" style="display:none">
+    <div class="modal">
+      <div class="modal-header">
+        <h3>维度映射配置</h3>
+        <button class="modal-close" onclick="closeModal('modal-mapping')">✕</button>
+      </div>
+      <div class="modal-body">
+        <p class="hint" style="margin-bottom:12px">映射为路径：该维度作为配置存储路径前缀；仅作标签：该维度仅用于筛选，不进入路径。</p>
+        <div class="dim-config-row" id="map-idc-row">
+          <span class="map-name">机房</span>
+          <select id="map-idc-mapping" class="mapping-select">
+            <option value="path">映射为路径</option>
+            <option value="label">仅作标签</option>
+          </select>
+        </div>
+        <div class="dim-config-row" id="map-env-row">
+          <span class="map-name">环境</span>
+          <select id="map-env-mapping" class="mapping-select">
+            <option value="path">映射为路径</option>
+            <option value="label">仅作标签</option>
+          </select>
+        </div>
+        <div class="dim-config-row" id="map-group-row">
+          <span class="map-name">分组</span>
+          <select id="map-group-mapping" class="mapping-select">
+            <option value="path">映射为路径</option>
+            <option value="label">仅作标签</option>
+          </select>
+        </div>
+      </div>
+      <div class="modal-footer">
+        <button class="btn btn-secondary" onclick="closeModal('modal-mapping')">取消</button>
+        <button class="btn btn-primary" id="btn-save-mapping">保存</button>
+      </div>
+    </div>
+  </div>
+
+  <!-- 模态框：新增/编辑配置项 -->
+  <div class="modal-overlay" id="modal-config" style="display:none">
+    <div class="modal">
+      <div class="modal-header">
+        <h3 id="modal-config-title">新增配置项</h3>
+        <button class="modal-close" onclick="closeModal('modal-config')">✕</button>
+      </div>
+      <div class="modal-body">
+        <div class="form-group">
+          <label>键名 <span class="required">*</span> <span class="hint">（可用 / 嵌套，如 db/pool/max）</span></label>
+          <input type="text" id="config-key" placeholder="例如：db/host 或 db.host">
+        </div>
+        <div id="config-dimension-fields">
+          <div class="form-row">
+            <div class="form-group form-half" id="dim-idc-group">
+              <label>机房</label>
+              <input type="text" id="config-idc" placeholder="例如：华北">
+            </div>
+            <div class="form-group form-half" id="dim-env-group">
+              <label>环境</label>
+              <input type="text" id="config-environment" placeholder="例如：dev">
+            </div>
+          </div>
+          <div class="form-group" id="dim-group-group">
+            <label>分组</label>
+            <input type="text" id="config-group" placeholder="例如：用户模块">
+          </div>
+        </div>
+        <div class="form-group">
+          <label>值</label>
+          <input type="text" id="config-value" placeholder="配置值">
+        </div>
+        <div class="form-row">
+          <div class="form-group form-half">
+            <label>类型</label>
+            <select id="config-type">
+              <option value="string">string</option>
+              <option value="number">number</option>
+              <option value="boolean">boolean</option>
+              <option value="json">json</option>
+            </select>
+          </div>
+          <div class="form-group form-half">
+            <label>值范围 <span class="hint">（规划模式）</span></label>
+            <input type="text" id="config-value-range" placeholder="例如：1-100 或 枚举: A,B">
+          </div>
+        </div>
+        <div class="form-group">
+          <label>说明 <span class="required">*</span></label>
+          <textarea id="config-description" rows="2" placeholder="配置项用途说明"></textarea>
+        </div>
+        <div class="form-group">
+          <label>用途 <span class="hint">（规划模式）</span></label>
+          <textarea id="config-purpose" rows="2" placeholder="详细用途描述"></textarea>
+        </div>
+      </div>
+      <div class="modal-footer">
+        <button class="btn btn-secondary" onclick="closeModal('modal-config')">取消</button>
+        <button class="btn btn-primary" id="btn-save-config">保存</button>
+      </div>
+    </div>
+  </div>
+
+  <!-- 模态框：确认删除 -->
+  <div class="modal-overlay" id="modal-confirm" style="display:none">
+    <div class="modal modal-sm">
+      <div class="modal-header">
+        <h3>确认操作</h3>
+        <button class="modal-close" onclick="closeModal('modal-confirm')">✕</button>
+      </div>
+      <div class="modal-body">
+        <p id="confirm-message"></p>
+      </div>
+      <div class="modal-footer">
+        <button class="btn btn-secondary" onclick="closeModal('modal-confirm')">取消</button>
+        <button class="btn btn-danger" id="btn-confirm-ok">确认</button>
+      </div>
+    </div>
+  </div>
+
+  <script src="/js/api.js"></script>
+  <script src="/js/tree.js"></script>
+  <script src="/js/app.js"></script>
+</body>
+</html>
@@ -0,0 +1,129 @@
+/**
+ * API 调用封装
+ * 统一处理与后端 REST 接口的交互，返回解析后的数据或抛出错误
+ */
+const API = {
+  /**
+   * 通用请求方法
+   * @param {string} url - 请求路径
+   * @param {Object} options - fetch 选项
+   * @returns {Promise<any>} 响应数据
+   */
+  async request(url, options = {}) {
+    const opts = {
+      headers: { "Content-Type": "application/json" },
+      ...options,
+    };
+    if (opts.body && typeof opts.body !== "string") {
+      opts.body = JSON.stringify(opts.body);
+    }
+    const res = await fetch(url, opts);
+    const json = await res.json();
+    if (!json.success) {
+      throw new Error(json.message || "请求失败");
+    }
+    return json.data;
+  },
+
+  /**
+   * 获取所有项目
+   * @returns {Promise<Array>} 项目列表
+   */
+  getProjects() {
+    return this.request("/api/projects");
+  },
+
+  /**
+   * 获取单个项目
+   * @param {string} id - 项目 ID
+   * @returns {Promise<Object>} 项目对象
+   */
+  getProject(id) {
+    return this.request(`/api/projects/${id}`);
+  },
+
+  /**
+   * 创建项目
+   * @param {Object} data - 项目数据
+   * @returns {Promise<Object>} 创建的项目
+   */
+  createProject(data) {
+    return this.request("/api/projects", { method: "POST", body: data });
+  },
+
+  /**
+   * 删除项目
+   * @param {string} id - 项目 ID
+   * @returns {Promise<void>}
+   */
+  deleteProject(id) {
+    return this.request(`/api/projects/${id}`, { method: "DELETE" });
+  },
+
+  /**
+   * 更新项目维度映射方式
+   * @param {string} id - 项目 ID
+   * @param {Object} mappings - { idcMapping, environmentMapping, groupMapping }
+   * @returns {Promise<Object>} 更新后的项目
+   */
+  updateMappings(id, mappings) {
+    return this.request(`/api/projects/${id}/mappings`, { method: "PUT", body: mappings });
+  },
+
+  /**
+   * 获取项目下所有配置
+   * @param {string} projectId - 项目 ID
+   * @returns {Promise<Array>} 配置项列表
+   */
+  getConfigs(projectId) {
+    return this.request(`/api/projects/${projectId}/configs`);
+  },
+
+  /**
+   * 新增配置项
+   * @param {string} projectId - 项目 ID
+   * @param {Object} data - 配置项数据
+   * @returns {Promise<Object>} 创建的配置项
+   */
+  createConfig(projectId, data) {
+    return this.request(`/api/projects/${projectId}/configs`, { method: "POST", body: data });
+  },
+
+  /**
+   * 更新配置项
+   * @param {string} projectId - 项目 ID
+   * @param {string} configId - 配置项 ID
+   * @param {Object} data - 要更新的字段
+   * @returns {Promise<Object>} 更新后的配置项
+   */
+  updateConfig(projectId, configId, data) {
+    return this.request(`/api/projects/${projectId}/configs/${configId}`, { method: "PUT", body: data });
+  },
+
+  /**
+   * 删除配置项
+   * @param {string} projectId - 项目 ID
+   * @param {string} configId - 配置项 ID
+   * @returns {Promise<void>}
+   */
+  deleteConfig(projectId, configId) {
+    return this.request(`/api/projects/${projectId}/configs/${configId}`, { method: "DELETE" });
+  },
+
+  /**
+   * 获取当前模式
+   * @returns {Promise<Object>} { mode }
+   */
+  getMode() {
+    return this.request("/api/mode");
+  },
+
+  /**
+   * 切换模式
+   * @param {string} mode - 目标模式（plan/edit/readonly）
+   * @returns {Promise<Object>} { mode }
+   */
+  setMode(mode) {
+    return this.request("/api/mode", { method: "PUT", body: { mode } });
+  },
+};
@@ -0,0 +1,772 @@
+/**
+ * 主应用逻辑
+ * 负责状态管理、事件绑定、界面渲染，以及维度筛选、地址栏导航与三种模式的差异化控制
+ */
+
+// 全局应用状态
+const state = {
+  projects: [],           // 项目列表
+  currentProject: null,   // 当前选中项目
+  configs: [],            // 当前项目全部配置（含 path）
+  visibleConfigs: [],     // 右侧面板当前展示的配置
+  mode: "edit",           // 当前模式: plan/edit/readonly
+  editingConfigId: null,  // 正在编辑的配置项 ID（null 表示新增）
+  confirmCallback: null,  // 确认框回调
+  dimFilter: { idc: "", environment: "", group: "" }, // 维度栏筛选值（空=全部）
+};
+
+/**
+ * 显示 Toast 提示
+ * @param {string} message - 提示内容
+ * @param {string} type - 类型: success/error/info
+ * @returns {void}
+ */
+function toast(message, type = "info") {
+  const el = document.createElement("div");
+  el.className = `toast toast-${type}`;
+  el.textContent = message;
+  document.body.appendChild(el);
+  setTimeout(() => el.remove(), 2500);
+}
+
+/**
+ * 设置状态栏文字
+ * @param {string} text - 状态文字
+ * @returns {void}
+ */
+function setStatus(text) {
+  document.getElementById("status-text").textContent = text;
+}
+
+/**
+ * 打开模态框
+ * @param {string} id - 模态框元素 ID
+ * @returns {void}
+ */
+function openModal(id) {
+  document.getElementById(id).style.display = "flex";
+}
+
+/**
+ * 关闭模态框
+ * @param {string} id - 模态框元素 ID
+ * @returns {void}
+ */
+function closeModal(id) {
+  document.getElementById(id).style.display = "none";
+}
+
+/**
+ * 模式的中文名称映射
+ */
+const MODE_NAMES = { plan: "规划", edit: "编辑", readonly: "只读" };
+
+/**
+ * 映射方式中文名称
+ */
+const MAPPING_NAMES = { path: "路径", label: "标签" };
+
+/**
+ * 应用当前模式到界面（更新样式类、按钮状态、状态栏）
+ * @returns {void}
+ */
+function applyMode() {
+  document.body.classList.remove("mode-plan", "mode-edit", "mode-readonly");
+  document.body.classList.add(`mode-${state.mode}`);
+  document.querySelectorAll(".mode-btn").forEach((btn) => {
+    btn.classList.toggle("active", btn.dataset.mode === state.mode);
+  });
+  document.getElementById("status-mode").textContent = `当前模式：${MODE_NAMES[state.mode]}`;
+}
+
+/**
+ * HTML 转义，防止 XSS
+ * @param {string} str - 原始字符串
+ * @returns {string} 转义后的字符串
+ */
+function escapeHtml(str) {
+  const div = document.createElement("div");
+  div.textContent = str;
+  return div.innerHTML;
+}
+
+/**
+ * 加载项目列表并填充选择器
+ * @returns {Promise<void>}
+ */
+async function loadProjects() {
+  state.projects = await API.getProjects();
+  const selector = document.getElementById("project-selector");
+  selector.innerHTML = '<option value="">-- 选择项目 --</option>';
+  state.projects.forEach((p) => {
+    const opt = document.createElement("option");
+    opt.value = p.id;
+    opt.textContent = p.name;
+    selector.appendChild(opt);
+  });
+}
+
+/**
+ * 选中并加载指定项目的配置
+ * @param {string} projectId - 项目 ID
+ * @returns {Promise<void>}
+ */
+async function selectProject(projectId) {
+  state.dimFilter = { idc: "", environment: "", group: "" };
+  if (!projectId) {
+    state.currentProject = null;
+    state.configs = [];
+    document.getElementById("current-project-name").textContent = "未选择项目";
+    renderDimensionBar();
+    Tree.render(document.getElementById("tree-content"), null, [], onTreeSelect);
+    renderConfigTable([], "/");
+    return;
+  }
+  state.currentProject = state.projects.find((p) => p.id === projectId);
+  state.configs = await API.getConfigs(projectId);
+  document.getElementById("current-project-name").textContent = state.currentProject.name;
+  renderDimensionBar();
+  refreshTree();
+  renderConfigTable(state.configs, "/");
+  setStatus(`已加载项目：${state.currentProject.name}，共 ${state.configs.length} 项配置`);
+}
+
+/**
+ * 依据 label 维度筛选，得到用于展示的配置列表
+ * 仅映射为 label 的维度参与筛选；映射为 path 的维度已体现在树路径中
+ * @returns {Array} 筛选后的配置列表
+ */
+function getFilteredConfigs() {
+  const p = state.currentProject;
+  if (!p) return [];
+  return state.configs.filter((c) => {
+    if (p.enableIdc && p.idcMapping === "label" && state.dimFilter.idc && c.idc !== state.dimFilter.idc) return false;
+    if (p.enableEnvironment && p.environmentMapping === "label" && state.dimFilter.environment && c.environment !== state.dimFilter.environment) return false;
+    if (p.enableGroup && p.groupMapping === "label" && state.dimFilter.group && c.group !== state.dimFilter.group) return false;
+    return true;
+  });
+}
+
+/**
+ * 重新构建并渲染配置树（应用当前维度筛选）
+ * @returns {void}
+ */
+function refreshTree() {
+  Tree.render(document.getElementById("tree-content"), state.currentProject, getFilteredConfigs(), onTreeSelect);
+}
+
+/**
+ * 收集某维度在当前项目配置中出现过的全部取值
+ * @param {string} field - 维度字段名（idc/environment/group）
+ * @returns {Array<string>} 去重后的取值列表
+ */
+function collectDimValues(field) {
+  const set = new Set();
+  state.configs.forEach((c) => {
+    if (c[field]) set.add(c[field]);
+  });
+  return Array.from(set).sort();
+}
+
+/**
+ * 渲染维度栏：展示已启用维度的筛选下拉与映射方式
+ * @returns {void}
+ */
+function renderDimensionBar() {
+  const p = state.currentProject;
+  const empty = document.getElementById("dim-empty");
+  const mappingBtn = document.getElementById("btn-dim-mapping");
+  const items = [
+    { key: "idc", enable: "enableIdc", mapping: "idcMapping", field: "idc", box: "dim-idc", sel: "dim-idc-select", map: "dim-idc-mapping" },
+    { key: "environment", enable: "enableEnvironment", mapping: "environmentMapping", field: "environment", box: "dim-env", sel: "dim-env-select", map: "dim-env-mapping" },
+    { key: "group", enable: "enableGroup", mapping: "groupMapping", field: "group", box: "dim-group", sel: "dim-group-select", map: "dim-group-mapping" },
+  ];
+
+  if (!p) {
+    empty.style.display = "";
+    mappingBtn.style.display = "none";
+    items.forEach((it) => (document.getElementById(it.box).style.display = "none"));
+    return;
+  }
+
+  const anyEnabled = p.enableIdc || p.enableEnvironment || p.enableGroup;
+  empty.style.display = anyEnabled ? "none" : "";
+  mappingBtn.style.display = anyEnabled ? "" : "none";
+
+  items.forEach((it) => {
+    const box = document.getElementById(it.box);
+    if (!p[it.enable]) {
+      box.style.display = "none";
+      return;
+    }
+    box.style.display = "";
+    // 填充筛选下拉
+    const sel = document.getElementById(it.sel);
+    const values = collectDimValues(it.field);
+    sel.innerHTML = '<option value="">全部</option>' + values.map((v) => `<option value="${escapeHtml(v)}">${escapeHtml(v)}</option>`).join("");
+    sel.value = state.dimFilter[it.key] || "";
+    // 展示映射方式
+    document.getElementById(it.map).textContent = `[${MAPPING_NAMES[p[it.mapping]] || "路径"}]`;
+  });
+}
+
+/**
+ * 树节点选中回调
+ * @param {Array} configs - 该节点下的配置列表
+ * @param {string} path - 节点路径
+ * @returns {void}
+ */
+function onTreeSelect(configs, path) {
+  state.visibleConfigs = configs;
+  renderConfigTable(configs, path);
+}
+
+/**
+ * 渲染右侧配置表格并同步地址栏
+ * @param {Array} configs - 配置项列表
+ * @param {string} path - 当前路径
+ * @returns {void}
+ */
+function renderConfigTable(configs, path) {
+  state.visibleConfigs = configs;
+  document.getElementById("address-input").value = path === "/" ? "" : path;
+  const tbody = document.getElementById("config-tbody");
+  tbody.innerHTML = "";
+
+  if (!configs || configs.length === 0) {
+    tbody.innerHTML = '<tr class="empty-row"><td colspan="5">当前节点暂无配置项</td></tr>';
+    return;
+  }
+
+  configs.forEach((cfg) => {
+    const tr = document.createElement("tr");
+    tr.innerHTML = `
+      <td class="config-key-cell">${escapeHtml(cfg.key)}</td>
+      <td class="config-value-cell">${escapeHtml(String(cfg.value))}</td>
+      <td><span class="type-badge">${escapeHtml(cfg.type)}</span></td>
+      <td>${escapeHtml(cfg.description)}</td>
+      <td>
+        <button class="row-btn view" data-action="view" data-id="${cfg.id}">查看</button>
+        <button class="row-btn" data-action="edit" data-id="${cfg.id}">编辑</button>
+        <button class="row-btn danger" data-action="delete" data-id="${cfg.id}">删除</button>
+      </td>
+    `;
+    tbody.appendChild(tr);
+  });
+}
+
+/**
+ * 根据当前项目维度开关，控制配置模态框中维度字段的显示
+ * @returns {void}
+ */
+function updateDimensionFields() {
+  const p = state.currentProject;
+  document.getElementById("dim-idc-group").style.display = p && p.enableIdc ? "" : "none";
+  document.getElementById("dim-env-group").style.display = p && p.enableEnvironment ? "" : "none";
+  document.getElementById("dim-group-group").style.display = p && p.enableGroup ? "" : "none";
+}
+
+/**
+ * 打开配置编辑模态框
+ * @param {Object|null} config - 配置项，null 表示新增
+ * @param {boolean} readonly - 是否只读查看
+ * @returns {void}
+ */
+function openConfigModal(config, readonly) {
+  state.editingConfigId = config ? config.id : null;
+  document.getElementById("modal-config-title").textContent = readonly
+    ? "查看配置项"
+    : config
+    ? "编辑配置项"
+    : "新增配置项";
+
+  // 新增时用维度栏当前筛选值预填维度，方便就地新增
+  const preIdc = config ? config.idc || "" : state.dimFilter.idc || "";
+  const preEnv = config ? config.environment || "" : state.dimFilter.environment || "";
+  const preGroup = config ? config.group || "" : state.dimFilter.group || "";
+
+  document.getElementById("config-key").value = config ? config.key : "";
+  document.getElementById("config-idc").value = preIdc;
+  document.getElementById("config-environment").value = preEnv;
+  document.getElementById("config-group").value = preGroup;
+  document.getElementById("config-value").value = config ? config.value : "";
+  document.getElementById("config-type").value = config ? config.type : "string";
+  document.getElementById("config-value-range").value = config ? config.valueRange || "" : "";
+  document.getElementById("config-description").value = config ? config.description : "";
+  document.getElementById("config-purpose").value = config ? config.purpose || "" : "";
+
+  updateDimensionFields();
+  applyFieldPermissions(readonly);
+  openModal("modal-config");
+}
+
+/**
+ * 根据模式和是否只读查看，设置配置模态框各字段的可编辑性
+ * 规划模式：结构字段(类型/说明/用途/范围/键名/维度)可改，值不可改
+ * 编辑模式：值可改，已有项的结构字段锁定
+ * 只读查看：全部禁用
+ * @param {boolean} readonly - 是否只读查看
+ * @returns {void}
+ */
+function applyFieldPermissions(readonly) {
+  const structFields = [
+    "config-key", "config-type", "config-value-range",
+    "config-description", "config-purpose",
+    "config-idc", "config-environment", "config-group",
+  ];
+  const valueField = "config-value";
+  const saveBtn = document.getElementById("btn-save-config");
+
+  const disableAll = (disabled) => {
+    structFields.forEach((id) => (document.getElementById(id).disabled = disabled));
+    document.getElementById(valueField).disabled = disabled;
+  };
+
+  if (readonly || state.mode === "readonly") {
+    disableAll(true);
+    saveBtn.style.display = "none";
+    return;
+  }
+
+  saveBtn.style.display = "";
+
+  if (state.mode === "plan") {
+    // 规划模式：可改结构，值不可改
+    structFields.forEach((id) => (document.getElementById(id).disabled = false));
+    document.getElementById(valueField).disabled = true;
+  } else if (state.mode === "edit") {
+    // 编辑模式：新增时结构可填；编辑已有项时仅值可改（键名/维度也允许调整路径）
+    const isNew = !state.editingConfigId;
+    document.getElementById("config-type").disabled = !isNew;
+    document.getElementById("config-value-range").disabled = !isNew;
+    document.getElementById("config-description").disabled = !isNew;
+    document.getElementById("config-purpose").disabled = !isNew;
+    document.getElementById("config-key").disabled = false;
+    document.getElementById("config-idc").disabled = false;
+    document.getElementById("config-environment").disabled = false;
+    document.getElementById("config-group").disabled = false;
+    document.getElementById(valueField).disabled = false;
+  }
+}
+
+/**
+ * 收集配置模态框表单数据
+ * @returns {Object} 表单数据
+ */
+function collectConfigForm() {
+  return {
+    key: document.getElementById("config-key").value.trim(),
+    idc: document.getElementById("config-idc").value.trim(),
+    environment: document.getElementById("config-environment").value.trim(),
+    group: document.getElementById("config-group").value.trim(),
+    value: document.getElementById("config-value").value,
+    type: document.getElementById("config-type").value,
+    valueRange: document.getElementById("config-value-range").value.trim(),
+    description: document.getElementById("config-description").value.trim(),
+    purpose: document.getElementById("config-purpose").value.trim(),
+  };
+}
+
+/**
+ * 保存配置项（新增或更新）
+ * @returns {Promise<void>}
+ */
+async function saveConfig() {
+  if (!state.currentProject) {
+    toast("请先选择项目", "error");
+    return;
+  }
+  const data = collectConfigForm();
+  try {
+    if (state.editingConfigId) {
+      await API.updateConfig(state.currentProject.id, state.editingConfigId, data);
+      toast("配置已更新", "success");
+    } else {
+      await API.createConfig(state.currentProject.id, data);
+      toast("配置已新增", "success");
+    }
+    closeModal("modal-config");
+    await selectProject(state.currentProject.id);
+  } catch (err) {
+    toast(err.message, "error");
+  }
+}
+
+/**
+ * 保存新建项目
+ * @returns {Promise<void>}
+ */
+async function saveProject() {
+  const data = {
+    name: document.getElementById("project-name").value.trim(),
+    description: document.getElementById("project-description").value.trim(),
+    enableIdc: document.getElementById("project-enable-idc").checked,
+    enableEnvironment: document.getElementById("project-enable-env").checked,
+    enableGroup: document.getElementById("project-enable-group").checked,
+    idcMapping: document.getElementById("project-idc-mapping").value,
+    environmentMapping: document.getElementById("project-env-mapping").value,
+    groupMapping: document.getElementById("project-group-mapping").value,
+  };
+  try {
+    const project = await API.createProject(data);
+    toast("项目已创建", "success");
+    closeModal("modal-project");
+    await loadProjects();
+    document.getElementById("project-selector").value = project.id;
+    await selectProject(project.id);
+  } catch (err) {
+    toast(err.message, "error");
+  }
+}
+
+/**
+ * 打开维度映射配置模态框，回填当前项目映射方式
+ * @returns {void}
+ */
+function openMappingModal() {
+  const p = state.currentProject;
+  if (!p) {
+    toast("请先选择项目", "error");
+    return;
+  }
+  document.getElementById("map-idc-row").style.display = p.enableIdc ? "" : "none";
+  document.getElementById("map-env-row").style.display = p.enableEnvironment ? "" : "none";
+  document.getElementById("map-group-row").style.display = p.enableGroup ? "" : "none";
+  document.getElementById("map-idc-mapping").value = p.idcMapping || "path";
+  document.getElementById("map-env-mapping").value = p.environmentMapping || "path";
+  document.getElementById("map-group-mapping").value = p.groupMapping || "path";
+  openModal("modal-mapping");
+}
+
+/**
+ * 保存维度映射配置
+ * @returns {Promise<void>}
+ */
+async function saveMapping() {
+  if (!state.currentProject) return;
+  const mappings = {
+    idcMapping: document.getElementById("map-idc-mapping").value,
+    environmentMapping: document.getElementById("map-env-mapping").value,
+    groupMapping: document.getElementById("map-group-mapping").value,
+  };
+  try {
+    await API.updateMappings(state.currentProject.id, mappings);
+    toast("映射配置已保存", "success");
+    closeModal("modal-mapping");
+    await selectProject(state.currentProject.id);
+  } catch (err) {
+    toast(err.message, "error");
+  }
+}
+
+/**
+ * 显示确认框
+ * @param {string} message - 提示信息
+ * @param {Function} callback - 确认回调
+ * @returns {void}
+ */
+function confirmAction(message, callback) {
+  document.getElementById("confirm-message").textContent = message;
+  state.confirmCallback = callback;
+  openModal("modal-confirm");
+}
+
+/**
+ * 导出当前项目配置为 JSON 文件
+ * @returns {void}
+ */
+function exportConfig() {
+  if (!state.currentProject) {
+    toast("请先选择项目", "error");
+    return;
+  }
+  const payload = { project: state.currentProject, configs: state.configs };
+  const blob = new Blob([JSON.stringify(payload, null, 2)], { type: "application/json" });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = `${state.currentProject.name}-configs.json`;
+  a.click();
+  URL.revokeObjectURL(url);
+  toast("配置已导出", "success");
+}
+
+/**
+ * 导入配置文件（逐条新增到当前项目）
+ * @param {File} file - 用户选择的 JSON 文件
+ * @returns {Promise<void>}
+ */
+async function importConfig(file) {
+  if (!state.currentProject) {
+    toast("请先选择项目", "error");
+    return;
+  }
+  if (state.mode === "readonly") {
+    toast("只读模式下不允许导入", "error");
+    return;
+  }
+  try {
+    const text = await file.text();
+    const payload = JSON.parse(text);
+    const configs = payload.configs || [];
+    let count = 0;
+    for (const cfg of configs) {
+      try {
+        await API.createConfig(state.currentProject.id, cfg);
+        count++;
+      } catch {
+        // 忽略单条失败，继续导入其余配置
+      }
+    }
+    toast(`成功导入 ${count} 项配置`, "success");
+    await selectProject(state.currentProject.id);
+  } catch (err) {
+    toast("导入失败：" + err.message, "error");
+  }
+}
+
+/**
+ * 地址栏跳转：按输入路径定位并选中树节点
+ * @returns {void}
+ */
+function navigateToPath() {
+  if (!state.currentProject) {
+    toast("请先选择项目", "error");
+    return;
+  }
+  const target = document.getElementById("address-input").value.trim();
+  if (target === "" || target === "/") {
+    Tree.selectByPath(document.getElementById("tree-content"), "");
+    renderConfigTable(getFilteredConfigs(), "/");
+    return;
+  }
+  const ok = Tree.selectByPath(document.getElementById("tree-content"), target);
+  if (!ok) {
+    toast("未找到该路径：" + target, "error");
+  }
+}
+
+/**
+ * 拷贝地址栏路径到剪贴板
+ * @returns {Promise<void>}
+ */
+async function copyAddress() {
+  const text = document.getElementById("address-input").value;
+  try {
+    await navigator.clipboard.writeText(text);
+    toast("路径已拷贝", "success");
+  } catch {
+    // 剪贴板不可用时退化为选中输入框内容
+    document.getElementById("address-input").select();
+    toast("请手动复制（Ctrl+C）", "info");
+  }
+}
+
+/**
+ * 绑定所有事件监听
+ * @returns {void}
+ */
+function bindEvents() {
+  // 项目选择
+  document.getElementById("project-selector").addEventListener("change", (e) => {
+    selectProject(e.target.value);
+  });
+
+  // 新建项目
+  document.getElementById("btn-new-project").addEventListener("click", () => {
+    document.getElementById("project-name").value = "";
+    document.getElementById("project-description").value = "";
+    document.getElementById("project-enable-idc").checked = true;
+    document.getElementById("project-enable-env").checked = true;
+    document.getElementById("project-enable-group").checked = true;
+    document.getElementById("project-idc-mapping").value = "path";
+    document.getElementById("project-env-mapping").value = "path";
+    document.getElementById("project-group-mapping").value = "path";
+    openModal("modal-project");
+  });
+  document.getElementById("btn-save-project").addEventListener("click", saveProject);
+
+  // 删除项目
+  document.getElementById("btn-delete-project").addEventListener("click", () => {
+    if (!state.currentProject) {
+      toast("请先选择项目", "error");
+      return;
+    }
+    const proj = state.currentProject;
+    confirmAction(`确认删除项目 "${proj.name}" 及其全部配置吗？`, async () => {
+      try {
+        await API.deleteProject(proj.id);
+        toast("项目已删除", "success");
+        closeModal("modal-confirm");
+        await loadProjects();
+        await selectProject("");
+        document.getElementById("project-selector").value = "";
+      } catch (err) {
+        toast(err.message, "error");
+      }
+    });
+  });
+
+  // 模式切换
+  document.querySelectorAll(".mode-btn").forEach((btn) => {
+    btn.addEventListener("click", async () => {
+      try {
+        await API.setMode(btn.dataset.mode);
+        state.mode = btn.dataset.mode;
+        applyMode();
+        toast(`已切换到${MODE_NAMES[state.mode]}模式`, "info");
+      } catch (err) {
+        toast(err.message, "error");
+      }
+    });
+  });
+
+  // 新增配置
+  document.getElementById("btn-add-config").addEventListener("click", () => {
+    if (!state.currentProject) {
+      toast("请先选择项目", "error");
+      return;
+    }
+    if (state.mode === "readonly") {
+      toast("只读模式下不允许新增", "error");
+      return;
+    }
+    openConfigModal(null, false);
+  });
+  document.getElementById("btn-save-config").addEventListener("click", saveConfig);
+
+  // 维度筛选下拉
+  document.getElementById("dim-idc-select").addEventListener("change", (e) => {
+    state.dimFilter.idc = e.target.value;
+    refreshTree();
+    renderConfigTable(getFilteredConfigs(), "/");
+  });
+  document.getElementById("dim-env-select").addEventListener("change", (e) => {
+    state.dimFilter.environment = e.target.value;
+    refreshTree();
+    renderConfigTable(getFilteredConfigs(), "/");
+  });
+  document.getElementById("dim-group-select").addEventListener("change", (e) => {
+    state.dimFilter.group = e.target.value;
+    refreshTree();
+    renderConfigTable(getFilteredConfigs(), "/");
+  });
+
+  // 维度映射配置
+  document.getElementById("btn-dim-mapping").addEventListener("click", openMappingModal);
+  document.getElementById("btn-save-mapping").addEventListener("click", saveMapping);
+
+  // 地址栏
+  document.getElementById("btn-address-go").addEventListener("click", navigateToPath);
+  document.getElementById("btn-address-copy").addEventListener("click", copyAddress);
+  document.getElementById("address-input").addEventListener("keydown", (e) => {
+    if (e.key === "Enter") navigateToPath();
+  });
+
+  // 导出/导入
+  document.getElementById("btn-export-config").addEventListener("click", exportConfig);
+  document.getElementById("btn-import-config").addEventListener("click", () => {
+    document.getElementById("import-file-input").click();
+  });
+  document.getElementById("import-file-input").addEventListener("change", (e) => {
+    if (e.target.files[0]) {
+      importConfig(e.target.files[0]);
+      e.target.value = "";
+    }
+  });
+
+  // 表格操作（事件委托）
+  document.getElementById("config-tbody").addEventListener("click", (e) => {
+    const btn = e.target.closest(".row-btn");
+    if (!btn) return;
+    const id = btn.dataset.id;
+    const action = btn.dataset.action;
+    const config = state.configs.find((c) => c.id === id);
+    if (!config) return;
+
+    if (action === "view") {
+      openConfigModal(config, true);
+    } else if (action === "edit") {
+      if (state.mode === "readonly") {
+        toast("只读模式下不允许编辑", "error");
+        return;
+      }
+      openConfigModal(config, false);
+    } else if (action === "delete") {
+      if (state.mode === "readonly") {
+        toast("只读模式下不允许删除", "error");
+        return;
+      }
+      confirmAction(`确认删除配置项 "${config.key}" 吗？`, async () => {
+        try {
+          await API.deleteConfig(state.currentProject.id, id);
+          toast("配置已删除", "success");
+          closeModal("modal-confirm");
+          await selectProject(state.currentProject.id);
+        } catch (err) {
+          toast(err.message, "error");
+        }
+      });
+    }
+  });
+
+  // 确认框
+  document.getElementById("btn-confirm-ok").addEventListener("click", () => {
+    if (state.confirmCallback) state.confirmCallback();
+  });
+
+  // 全部折叠
+  document.getElementById("btn-collapse-all").addEventListener("click", () => {
+    document.querySelectorAll(".tree-children").forEach((el) => el.classList.add("collapsed"));
+    document.querySelectorAll(".tree-toggle").forEach((el) => {
+      if (el.textContent === "▼") el.textContent = "▶";
+    });
+  });
+
+  // 分隔条拖拽
+  bindResizer();
+}
+
+/**
+ * 绑定左右面板分隔条的拖拽调整宽度功能
+ * @returns {void}
+ */
+function bindResizer() {
+  const resizer = document.getElementById("resizer");
+  const treePanel = document.getElementById("tree-panel");
+  let dragging = false;
+
+  resizer.addEventListener("mousedown", () => {
+    dragging = true;
+    document.body.style.cursor = "col-resize";
+  });
+  document.addEventListener("mousemove", (e) => {
+    if (!dragging) return;
+    const width = Math.max(180, Math.min(600, e.clientX));
+    treePanel.style.width = width + "px";
+  });
+  document.addEventListener("mouseup", () => {
+    dragging = false;
+    document.body.style.cursor = "";
+  });
+}
+
+/**
+ * 应用初始化入口
+ * @returns {Promise<void>}
+ */
+async function init() {
+  bindEvents();
+  try {
+    const modeData = await API.getMode();
+    state.mode = modeData.mode;
+  } catch {
+    state.mode = "edit";
+  }
+  applyMode();
+  await loadProjects();
+  setStatus("就绪");
+}
+
+// 页面加载完成后启动
+window.addEventListener("DOMContentLoaded", init);
@@ -0,0 +1,163 @@
+/**
+ * 树形组件
+ * 将配置项按“路径映射维度前缀 + 嵌套键”构建成注册表风格的树并渲染
+ * 说明：仅映射为 path 的维度进入路径；label 维度由维度栏筛选，不进入树层级；
+ *      配置键 key 自身按 / 拆分为多级目录，叶子节点为真正的配置项。
+ */
+const Tree = {
+  /**
+   * 将配置项列表构建为树形数据结构
+   * 每个节点结构: { name, path, type:"dir"|"leaf", children:{}, config }
+   * @param {Object} project - 项目对象
+   * @param {Array} configs - 已按 label 维度筛选后的配置项列表（含 path 字段）
+   * @returns {Object} 树根节点
+   */
+  buildTree(project, configs) {
+    const root = { name: project.name, path: "", type: "dir", children: {}, config: null };
+
+    configs.forEach((config) => {
+      // path 已由后端按映射规则生成，直接按 / 拆分为层级
+      const segments = String(config.path || config.key).split("/").filter((s) => s !== "");
+      let node = root;
+      let acc = "";
+      segments.forEach((seg, idx) => {
+        acc = acc ? acc + "/" + seg : seg;
+        const isLast = idx === segments.length - 1;
+        if (!node.children[seg]) {
+          node.children[seg] = { name: seg, path: acc, type: "dir", children: {}, config: null };
+        }
+        node = node.children[seg];
+        if (isLast) {
+          // 叶子节点绑定真实配置项
+          node.type = "leaf";
+          node.config = config;
+        }
+      });
+    });
+
+    return root;
+  },
+
+  /**
+   * 渲染树到指定容器
+   * @param {HTMLElement} container - 容器元素
+   * @param {Object} project - 项目对象
+   * @param {Array} configs - 配置项列表
+   * @param {Function} onSelect - 节点选中回调，参数为(配置列表, 路径, 节点)
+   */
+  render(container, project, configs, onSelect) {
+    container.innerHTML = "";
+    if (!project) {
+      container.innerHTML = '<div class="tree-empty">请先选择一个项目</div>';
+      return;
+    }
+    const tree = this.buildTree(project, configs);
+    const rootEl = this._renderNode(tree, onSelect, true);
+    container.appendChild(rootEl);
+  },
+
+  /**
+   * 收集某节点及其子孙下的全部叶子配置项
+   * @param {Object} node - 树节点
+   * @returns {Array} 配置项列表
+   */
+  collectConfigs(node) {
+    let list = [];
+    if (node.type === "leaf" && node.config) {
+      list.push(node.config);
+    }
+    Object.values(node.children).forEach((child) => {
+      list = list.concat(this.collectConfigs(child));
+    });
+    return list;
+  },
+
+  /**
+   * 递归渲染单个树节点
+   * @param {Object} node - 树节点
+   * @param {Function} onSelect - 选中回调
+   * @param {boolean} isRoot - 是否为根节点
+   * @returns {HTMLElement} 节点元素
+   */
+  _renderNode(node, onSelect, isRoot) {
+    const nodeEl = document.createElement("div");
+    nodeEl.className = "tree-node";
+
+    const childKeys = Object.keys(node.children);
+    const hasChildren = childKeys.length > 0;
+    const isLeaf = node.type === "leaf" && !hasChildren;
+
+    const label = document.createElement("div");
+    label.className = "tree-node-label" + (isLeaf ? " is-leaf" : "");
+    label.dataset.path = node.path;
+
+    const toggle = document.createElement("span");
+    toggle.className = "tree-toggle";
+    toggle.textContent = hasChildren ? "▼" : "";
+
+    const icon = document.createElement("span");
+    icon.className = "tree-icon";
+    icon.textContent = isRoot ? "📦" : isLeaf ? "🔑" : "📁";
+
+    const text = document.createElement("span");
+    text.textContent = node.name;
+
+    label.appendChild(toggle);
+    label.appendChild(icon);
+    label.appendChild(text);
+    nodeEl.appendChild(label);
+
+    label.addEventListener("click", (e) => {
+      e.stopPropagation();
+      document.querySelectorAll(".tree-node-label.selected").forEach((el) => el.classList.remove("selected"));
+      label.classList.add("selected");
+      onSelect(this.collectConfigs(node), node.path || "/", node);
+    });
+
+    if (hasChildren) {
+      const childrenEl = document.createElement("div");
+      childrenEl.className = "tree-children";
+      childKeys.sort().forEach((key) => {
+        childrenEl.appendChild(this._renderNode(node.children[key], onSelect, false));
+      });
+      nodeEl.appendChild(childrenEl);
+
+      toggle.addEventListener("click", (e) => {
+        e.stopPropagation();
+        childrenEl.classList.toggle("collapsed");
+        toggle.textContent = childrenEl.classList.contains("collapsed") ? "▶" : "▼";
+      });
+    }
+
+    return nodeEl;
+  },
+
+  /**
+   * 根据路径展开并选中对应节点（供地址栏跳转使用）
+   * @param {HTMLElement} container - 树容器
+   * @param {string} targetPath - 目标路径
+   * @returns {boolean} 是否命中并选中节点
+   */
+  selectByPath(container, targetPath) {
+    const normalized = String(targetPath || "").split("/").map((s) => s.trim()).filter((s) => s !== "").join("/");
+    const labels = container.querySelectorAll(".tree-node-label");
+    for (const label of labels) {
+      if (label.dataset.path === normalized) {
+        // 展开所有祖先节点
+        let parent = label.parentElement;
+        while (parent && parent !== container) {
+          if (parent.classList.contains("tree-children")) {
+            parent.classList.remove("collapsed");
+            const pToggle = parent.previousElementSibling?.querySelector(".tree-toggle");
+            if (pToggle && pToggle.textContent === "▶") pToggle.textContent = "▼";
+          }
+          parent = parent.parentElement;
+        }
+        label.click();
+        label.scrollIntoView({ block: "center" });
+        return true;
+      }
+    }
+    return false;
+  },
+};
@@ -0,0 +1,132 @@
+/**
+ * JSON 文件持久化适配器
+ * 提供项目、配置、系统数据的读写能力，数据存储在 data/ 目录下
+ * 预留扩展接口，后续可替换为 SqliteAdapter、NacosAdapter 等
+ */
+const fs = require("fs");
+const path = require("path");
+
+// 数据存储根目录
+const DATA_DIR = path.join(__dirname, "..", "..", "data");
+const PROJECTS_FILE = path.join(DATA_DIR, "projects.json");
+const SYSTEM_FILE = path.join(DATA_DIR, "system.json");
+const CONFIGS_DIR = path.join(DATA_DIR, "configs");
+
+/**
+ * 确保数据目录和基础文件存在
+ */
+function ensureDataDir() {
+  if (!fs.existsSync(DATA_DIR)) {
+    fs.mkdirSync(DATA_DIR, { recursive: true });
+  }
+  if (!fs.existsSync(CONFIGS_DIR)) {
+    fs.mkdirSync(CONFIGS_DIR, { recursive: true });
+  }
+  if (!fs.existsSync(PROJECTS_FILE)) {
+    fs.writeFileSync(PROJECTS_FILE, "[]", "utf-8");
+  }
+  if (!fs.existsSync(SYSTEM_FILE)) {
+    fs.writeFileSync(SYSTEM_FILE, JSON.stringify({ mode: "edit" }, null, 2), "utf-8");
+  }
+}
+
+/**
+ * 读取 JSON 文件，返回解析后的对象
+ * @param {string} filePath - 文件路径
+ * @returns {any} 解析后的 JSON 数据
+ */
+function readJsonFile(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+  const content = fs.readFileSync(filePath, "utf-8");
+  return JSON.parse(content);
+}
+
+/**
+ * 写入 JSON 文件
+ * @param {string} filePath - 文件路径
+ * @param {any} data - 要写入的数据
+ */
+function writeJsonFile(filePath, data) {
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
+}
+
+/**
+ * 加载所有项目
+ * @returns {Array} 项目列表
+ */
+function loadProjects() {
+  ensureDataDir();
+  return readJsonFile(PROJECTS_FILE) || [];
+}
+
+/**
+ * 保存所有项目
+ * @param {Array} projects - 项目列表
+ */
+function saveProjects(projects) {
+  ensureDataDir();
+  writeJsonFile(PROJECTS_FILE, projects);
+}
+
+/**
+ * 加载指定项目的所有配置
+ * @param {string} projectId - 项目 ID
+ * @returns {Array} 配置项列表
+ */
+function loadConfigs(projectId) {
+  ensureDataDir();
+  const configFile = path.join(CONFIGS_DIR, `${projectId}.json`);
+  return readJsonFile(configFile) || [];
+}
+
+/**
+ * 保存指定项目的所有配置
+ * @param {string} projectId - 项目 ID
+ * @param {Array} configs - 配置项列表
+ */
+function saveConfigs(projectId, configs) {
+  ensureDataDir();
+  const configFile = path.join(CONFIGS_DIR, `${projectId}.json`);
+  writeJsonFile(configFile, configs);
+}
+
+/**
+ * 删除指定项目的配置文件
+ * @param {string} projectId - 项目 ID
+ */
+function deleteConfigs(projectId) {
+  const configFile = path.join(CONFIGS_DIR, `${projectId}.json`);
+  if (fs.existsSync(configFile)) {
+    fs.unlinkSync(configFile);
+  }
+}
+
+/**
+ * 加载系统配置
+ * @returns {Object} 系统配置对象
+ */
+function loadSystem() {
+  ensureDataDir();
+  return readJsonFile(SYSTEM_FILE) || { mode: "edit" };
+}
+
+/**
+ * 保存系统配置
+ * @param {Object} system - 系统配置对象
+ */
+function saveSystem(system) {
+  ensureDataDir();
+  writeJsonFile(SYSTEM_FILE, system);
+}
+
+module.exports = {
+  loadProjects,
+  saveProjects,
+  loadConfigs,
+  saveConfigs,
+  deleteConfigs,
+  loadSystem,
+  saveSystem,
+};
@@ -0,0 +1,97 @@
+/**
+ * 配置路由
+ * 处理配置项相关 API 请求
+ */
+const express = require("express");
+const router = express.Router({ mergeParams: true });
+const configService = require("../services/configService");
+const { loadSystem, saveSystem } = require("../persistence/jsonAdapter");
+
+/**
+ * 获取当前模式
+ * @returns {string} 当前模式
+ */
+function getCurrentMode() {
+  try {
+    const system = loadSystem();
+    return system.mode || "edit";
+  } catch {
+    return "edit";
+  }
+}
+
+/**
+ * GET /api/projects/:projectId/configs
+ * 获取项目下所有配置项
+ */
+router.get("/", (req, res) => {
+  try {
+    const configs = configService.getConfigsByProject(req.params.projectId);
+    res.json({ success: true, data: configs });
+  } catch (err) {
+    res.status(400).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * GET /api/projects/:projectId/configs/:configId
+ * 获取单个配置项
+ */
+router.get("/:configId", (req, res) => {
+  try {
+    const config = configService.getConfigById(req.params.projectId, req.params.configId);
+    if (!config) {
+      return res.status(404).json({ success: false, message: "配置项不存在" });
+    }
+    res.json({ success: true, data: config });
+  } catch (err) {
+    res.status(400).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * POST /api/projects/:projectId/configs
+ * 新增配置项
+ */
+router.post("/", (req, res) => {
+  try {
+    const mode = getCurrentMode();
+    const config = configService.createConfig(req.params.projectId, req.body, mode);
+    res.status(201).json({ success: true, data: config });
+  } catch (err) {
+    res.status(400).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * PUT /api/projects/:projectId/configs/:configId
+ * 修改配置项
+ */
+router.put("/:configId", (req, res) => {
+  try {
+    const mode = getCurrentMode();
+    const config = configService.updateConfig(req.params.projectId, req.params.configId, req.body, mode);
+    res.json({ success: true, data: config });
+  } catch (err) {
+    res.status(400).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * DELETE /api/projects/:projectId/configs/:configId
+ * 删除配置项
+ */
+router.delete("/:configId", (req, res) => {
+  try {
+    const mode = getCurrentMode();
+    const result = configService.deleteConfig(req.params.projectId, req.params.configId, mode);
+    if (!result) {
+      return res.status(404).json({ success: false, message: "配置项不存在" });
+    }
+    res.json({ success: true, message: "配置项已删除" });
+  } catch (err) {
+    res.status(400).json({ success: false, message: err.message });
+  }
+});
+
+module.exports = router;
@@ -0,0 +1,82 @@
+/**
+ * 项目路由
+ * 处理项目相关 API 请求
+ */
+const express = require("express");
+const router = express.Router();
+const projectService = require("../services/projectService");
+
+/**
+ * GET /api/projects
+ * 获取所有项目列表
+ */
+router.get("/", (req, res) => {
+  try {
+    const projects = projectService.getAllProjects();
+    res.json({ success: true, data: projects });
+  } catch (err) {
+    res.status(500).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * GET /api/projects/:id
+ * 获取单个项目详情
+ */
+router.get("/:id", (req, res) => {
+  try {
+    const project = projectService.getProjectById(req.params.id);
+    if (!project) {
+      return res.status(404).json({ success: false, message: "项目不存在" });
+    }
+    res.json({ success: true, data: project });
+  } catch (err) {
+    res.status(500).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * POST /api/projects
+ * 创建新项目
+ * Body: { name, description, enableIdc, enableEnvironment, enableGroup, idcMapping, environmentMapping, groupMapping }
+ */
+router.post("/", (req, res) => {
+  try {
+    const project = projectService.createProject(req.body);
+    res.status(201).json({ success: true, data: project });
+  } catch (err) {
+    res.status(400).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * PUT /api/projects/:id/mappings
+ * 更新项目的维度映射方式（path/label）
+ * Body: { idcMapping, environmentMapping, groupMapping }
+ */
+router.put("/:id/mappings", (req, res) => {
+  try {
+    const project = projectService.updateMappings(req.params.id, req.body);
+    res.json({ success: true, data: project });
+  } catch (err) {
+    res.status(400).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * DELETE /api/projects/:id
+ * 删除项目及其所有配置
+ */
+router.delete("/:id", (req, res) => {
+  try {
+    const result = projectService.deleteProject(req.params.id);
+    if (!result) {
+      return res.status(404).json({ success: false, message: "项目不存在" });
+    }
+    res.json({ success: true, message: "项目已删除" });
+  } catch (err) {
+    res.status(500).json({ success: false, message: err.message });
+  }
+});
+
+module.exports = router;
@@ -0,0 +1,61 @@
+/**
+ * 服务入口
+ * 启动 Express 服务器，挂载路由和静态资源
+ */
+const express = require("express");
+const path = require("path");
+const projectRoutes = require("./routes/projects");
+const configRoutes = require("./routes/configs");
+const { loadSystem, saveSystem } = require("./persistence/jsonAdapter");
+
+const app = express();
+const PORT = process.env.PORT || 3000;
+
+// 解析 JSON 请求体
+app.use(express.json());
+
+// 静态资源服务
+app.use(express.static(path.join(__dirname, "..", "public")));
+
+// API 路由
+app.use("/api/projects", projectRoutes);
+app.use("/api/projects/:projectId/configs", configRoutes);
+
+/**
+ * GET /api/mode
+ * 获取当前系统模式
+ */
+app.get("/api/mode", (req, res) => {
+  try {
+    const system = loadSystem();
+    res.json({ success: true, data: { mode: system.mode || "edit" } });
+  } catch (err) {
+    res.status(500).json({ success: false, message: err.message });
+  }
+});
+
+/**
+ * PUT /api/mode
+ * 切换系统模式
+ * Body: { mode: "plan" | "edit" | "readonly" }
+ */
+app.put("/api/mode", (req, res) => {
+  try {
+    const { mode } = req.body;
+    const validModes = ["plan", "edit", "readonly"];
+    if (!validModes.includes(mode)) {
+      return res.status(400).json({ success: false, message: `无效的模式: ${mode}，支持: ${validModes.join(", ")}` });
+    }
+    const system = loadSystem();
+    system.mode = mode;
+    saveSystem(system);
+    res.json({ success: true, data: { mode } });
+  } catch (err) {
+    res.status(500).json({ success: false, message: err.message });
+  }
+});
+
+// 启动服务
+app.listen(PORT, () => {
+  console.log(`Registry 服务已启动: http://localhost:${PORT}`);
+});
@@ -0,0 +1,285 @@
+/**
+ * 配置服务层
+ * 处理配置项的业务逻辑，包括 CRUD 操作、路径构建、值校验
+ * 路径规则：仅映射方式为 path 的已启用维度作为路径前缀，label 维度仅作筛选标签不进入路径；
+ *          配置键 key 自身可用 / 嵌套，json 类型在前端按 . 分割展示
+ */
+const { loadConfigs, saveConfigs } = require("../persistence/jsonAdapter");
+const { getProjectById } = require("./projectService");
+const { validateByType, validateRange } = require("../utils/validator");
+
+/**
+ * 生成唯一 ID
+ * @returns {string} 基于时间戳的唯一 ID
+ */
+function generateId() {
+  return "cfg-" + Date.now().toString(36) + "-" + Math.random().toString(36).substring(2, 8);
+}
+
+/**
+ * 规整配置键：去除首尾空白与多余的斜杠，压缩连续斜杠
+ * @param {string} key - 原始键（可含 / 嵌套）
+ * @returns {string} 规整后的键
+ */
+function normalizeKey(key) {
+  return String(key || "")
+    .trim()
+    .split("/")
+    .map((s) => s.trim())
+    .filter((s) => s !== "")
+    .join("/");
+}
+
+/**
+ * 根据项目维度映射配置构建配置项的存储显示路径
+ * 仅映射方式为 path 的已启用维度进入路径前缀，label 维度不进入
+ * @param {Object} project - 项目对象
+ * @param {Object} config - 配置项对象
+ * @returns {string} 配置路径
+ */
+function buildConfigPath(project, config) {
+  const parts = [];
+  if (project.enableIdc && project.idcMapping === "path" && config.idc) {
+    parts.push(config.idc);
+  }
+  if (project.enableEnvironment && project.environmentMapping === "path" && config.environment) {
+    parts.push(config.environment);
+  }
+  if (project.enableGroup && project.groupMapping === "path" && config.group) {
+    parts.push(config.group);
+  }
+  if (config.key) {
+    parts.push(config.key);
+  }
+  return parts.join("/");
+}
+
+/**
+ * 获取项目下所有配置项，自动填充路径
+ * @param {string} projectId - 项目 ID
+ * @returns {Array} 配置项列表（含 path 字段）
+ */
+function getConfigsByProject(projectId) {
+  const project = getProjectById(projectId);
+  if (!project) {
+    throw new Error("项目不存在");
+  }
+  const configs = loadConfigs(projectId);
+  return configs.map((c) => ({
+    ...c,
+    path: buildConfigPath(project, c),
+  }));
+}
+
+/**
+ * 根据 ID 获取单个配置项
+ * @param {string} projectId - 项目 ID
+ * @param {string} configId - 配置项 ID
+ * @returns {Object|null} 配置项对象，不存在时返回 null
+ */
+function getConfigById(projectId, configId) {
+  const project = getProjectById(projectId);
+  if (!project) {
+    throw new Error("项目不存在");
+  }
+  const configs = loadConfigs(projectId);
+  const config = configs.find((c) => c.id === configId);
+  if (!config) {
+    return null;
+  }
+  return {
+    ...config,
+    path: buildConfigPath(project, config),
+  };
+}
+
+/**
+ * 新增配置项
+ * @param {string} projectId - 项目 ID
+ * @param {Object} data - 配置项数据
+ * @param {string} data.key - 配置键名，可用 / 嵌套（必填）
+ * @param {any} data.value - 配置值
+ * @param {string} data.type - 值类型（string/number/boolean/json）
+ * @param {string} data.description - 配置说明（必填）
+ * @param {string} data.idc - 机房（维度启用时必填）
+ * @param {string} data.environment - 环境（维度启用时必填）
+ * @param {string} data.group - 分组（维度启用时必填）
+ * @param {string} data.purpose - 用途说明（规划模式）
+ * @param {string} data.valueRange - 值范围（规划模式）
+ * @param {string} mode - 当前模式（plan/edit/readonly）
+ * @returns {Object} 创建的配置项
+ */
+function createConfig(projectId, data, mode) {
+  if (mode === "readonly") {
+    throw new Error("只读模式下不允许新增配置");
+  }
+
+  const project = getProjectById(projectId);
+  if (!project) {
+    throw new Error("项目不存在");
+  }
+
+  const key = normalizeKey(data.key);
+  if (key === "") {
+    throw new Error("配置键名不能为空");
+  }
+
+  if (!data.description || data.description.trim() === "") {
+    throw new Error("配置说明不能为空");
+  }
+
+  // 校验维度必填
+  if (project.enableIdc && (!data.idc || data.idc.trim() === "")) {
+    throw new Error("项目启用了机房维度，机房不能为空");
+  }
+  if (project.enableEnvironment && (!data.environment || data.environment.trim() === "")) {
+    throw new Error("项目启用了环境维度，环境不能为空");
+  }
+  if (project.enableGroup && (!data.group || data.group.trim() === "")) {
+    throw new Error("项目启用了分组维度，分组不能为空");
+  }
+
+  // 校验类型
+  if (data.type && !["string", "number", "boolean", "json"].includes(data.type)) {
+    throw new Error(`不支持的类型: ${data.type}`);
+  }
+
+  const now = new Date().toISOString();
+  const config = {
+    id: generateId(),
+    projectId,
+    key,
+    value: data.value !== undefined ? data.value : "",
+    type: data.type || "string",
+    description: data.description.trim(),
+    purpose: data.purpose || "",
+    valueRange: data.valueRange || "",
+    idc: data.idc || "",
+    environment: data.environment || "",
+    group: data.group || "",
+    createdAt: now,
+    updatedAt: now,
+  };
+
+  // 编辑模式下校验值和范围
+  if (mode === "edit") {
+    const typeResult = validateByType(config.value, config.type);
+    if (!typeResult.valid) {
+      throw new Error(typeResult.message);
+    }
+    const rangeResult = validateRange(config.value, config.valueRange);
+    if (!rangeResult.valid) {
+      throw new Error(rangeResult.message);
+    }
+  }
+
+  const configs = loadConfigs(projectId);
+  configs.push(config);
+  saveConfigs(projectId, configs);
+
+  return {
+    ...config,
+    path: buildConfigPath(project, config),
+  };
+}
+
+/**
+ * 更新配置项
+ * 规划模式：可修改 type、description、purpose、valueRange
+ * 编辑模式：可修改 value
+ * 只读模式：不可修改
+ * @param {string} projectId - 项目 ID
+ * @param {string} configId - 配置项 ID
+ * @param {Object} data - 要更新的字段
+ * @param {string} mode - 当前模式
+ * @returns {Object} 更新后的配置项
+ */
+function updateConfig(projectId, configId, data, mode) {
+  if (mode === "readonly") {
+    throw new Error("只读模式下不允许修改配置");
+  }
+
+  const project = getProjectById(projectId);
+  if (!project) {
+    throw new Error("项目不存在");
+  }
+
+  const configs = loadConfigs(projectId);
+  const index = configs.findIndex((c) => c.id === configId);
+  if (index === -1) {
+    throw new Error("配置项不存在");
+  }
+
+  const config = configs[index];
+
+  if (mode === "plan") {
+    // 规划模式：修改结构定义
+    if (data.type !== undefined) config.type = data.type;
+    if (data.description !== undefined) config.description = data.description;
+    if (data.purpose !== undefined) config.purpose = data.purpose;
+    if (data.valueRange !== undefined) config.valueRange = data.valueRange;
+    if (data.key !== undefined) config.key = normalizeKey(data.key);
+    if (data.idc !== undefined) config.idc = data.idc;
+    if (data.environment !== undefined) config.environment = data.environment;
+    if (data.group !== undefined) config.group = data.group;
+  } else if (mode === "edit") {
+    // 编辑模式：修改值
+    if (data.value !== undefined) {
+      const typeResult = validateByType(data.value, config.type);
+      if (!typeResult.valid) {
+        throw new Error(typeResult.message);
+      }
+      const rangeResult = validateRange(data.value, config.valueRange);
+      if (!rangeResult.valid) {
+        throw new Error(rangeResult.message);
+      }
+      config.value = data.value;
+    }
+    // 编辑模式下也可以修改 key 和维度（路径调整）
+    if (data.key !== undefined) config.key = normalizeKey(data.key);
+    if (data.idc !== undefined) config.idc = data.idc;
+    if (data.environment !== undefined) config.environment = data.environment;
+    if (data.group !== undefined) config.group = data.group;
+  }
+
+  config.updatedAt = new Date().toISOString();
+  configs[index] = config;
+  saveConfigs(projectId, configs);
+
+  return {
+    ...config,
+    path: buildConfigPath(project, config),
+  };
+}
+
+/**
+ * 删除配置项
+ * @param {string} projectId - 项目 ID
+ * @param {string} configId - 配置项 ID
+ * @param {string} mode - 当前模式
+ * @returns {boolean} 是否删除成功
+ */
+function deleteConfig(projectId, configId, mode) {
+  if (mode === "readonly") {
+    throw new Error("只读模式下不允许删除配置");
+  }
+
+  const configs = loadConfigs(projectId);
+  const index = configs.findIndex((c) => c.id === configId);
+  if (index === -1) {
+    return false;
+  }
+  configs.splice(index, 1);
+  saveConfigs(projectId, configs);
+  return true;
+}
+
+module.exports = {
+  getConfigsByProject,
+  getConfigById,
+  createConfig,
+  updateConfig,
+  deleteConfig,
+  buildConfigPath,
+  normalizeKey,
+};
@@ -0,0 +1,142 @@
+/**
+ * 项目服务层
+ * 处理项目的业务逻辑，包括 CRUD 操作、维度校验与维度映射配置
+ * 注意：项目创建后维度开关不可修改，只能通过项目转换机制处理；维度映射方式可后续调整
+ */
+const { loadProjects, saveProjects, deleteConfigs } = require("../persistence/jsonAdapter");
+
+// 维度映射方式白名单：path=作为存储路径前缀；label=仅作为筛选标签不进入路径
+const VALID_MAPPINGS = ["path", "label"];
+
+/**
+ * 生成唯一 ID
+ * @returns {string} 基于时间戳的唯一 ID
+ */
+function generateId() {
+  return "proj-" + Date.now().toString(36) + "-" + Math.random().toString(36).substring(2, 8);
+}
+
+/**
+ * 规整维度映射方式，非法值回退为默认的 path
+ * @param {string} mapping - 传入的映射方式
+ * @returns {string} 合法的映射方式（path/label）
+ */
+function normalizeMapping(mapping) {
+  return VALID_MAPPINGS.includes(mapping) ? mapping : "path";
+}
+
+/**
+ * 获取所有项目列表
+ * @returns {Array} 项目列表
+ */
+function getAllProjects() {
+  return loadProjects();
+}
+
+/**
+ * 根据 ID 获取单个项目
+ * @param {string} id - 项目 ID
+ * @returns {Object|null} 项目对象，不存在时返回 null
+ */
+function getProjectById(id) {
+  const projects = loadProjects();
+  return projects.find((p) => p.id === id) || null;
+}
+
+/**
+ * 创建新项目
+ * 维度开关（enableIdc/enableEnvironment/enableGroup）在创建时确定，后续不可修改
+ * 维度映射方式（idcMapping/environmentMapping/groupMapping）默认 path，可后续调整
+ * @param {Object} data - 项目数据
+ * @param {string} data.name - 项目名称（必填）
+ * @param {string} data.description - 项目描述
+ * @param {boolean} data.enableIdc - 是否启用机房维度
+ * @param {boolean} data.enableEnvironment - 是否启用环境维度
+ * @param {boolean} data.enableGroup - 是否启用分组维度
+ * @param {string} data.idcMapping - 机房映射方式（path/label）
+ * @param {string} data.environmentMapping - 环境映射方式（path/label）
+ * @param {string} data.groupMapping - 分组映射方式（path/label）
+ * @returns {Object} 创建的项目对象
+ */
+function createProject(data) {
+  if (!data.name || data.name.trim() === "") {
+    throw new Error("项目名称不能为空");
+  }
+
+  const projects = loadProjects();
+  const now = new Date().toISOString();
+  const project = {
+    id: generateId(),
+    name: data.name.trim(),
+    description: (data.description || "").trim(),
+    enableIdc: !!data.enableIdc,
+    enableEnvironment: !!data.enableEnvironment,
+    enableGroup: !!data.enableGroup,
+    idcMapping: normalizeMapping(data.idcMapping),
+    environmentMapping: normalizeMapping(data.environmentMapping),
+    groupMapping: normalizeMapping(data.groupMapping),
+    createdAt: now,
+    updatedAt: now,
+  };
+
+  projects.push(project);
+  saveProjects(projects);
+  return project;
+}
+
+/**
+ * 更新项目的维度映射方式
+ * 仅允许修改已启用维度的映射方式，维度开关本身不可变
+ * @param {string} id - 项目 ID
+ * @param {Object} mappings - 映射配置
+ * @param {string} mappings.idcMapping - 机房映射方式（path/label）
+ * @param {string} mappings.environmentMapping - 环境映射方式（path/label）
+ * @param {string} mappings.groupMapping - 分组映射方式（path/label）
+ * @returns {Object} 更新后的项目对象
+ */
+function updateMappings(id, mappings) {
+  const projects = loadProjects();
+  const index = projects.findIndex((p) => p.id === id);
+  if (index === -1) {
+    throw new Error("项目不存在");
+  }
+  const project = projects[index];
+  if (project.enableIdc && mappings.idcMapping !== undefined) {
+    project.idcMapping = normalizeMapping(mappings.idcMapping);
+  }
+  if (project.enableEnvironment && mappings.environmentMapping !== undefined) {
+    project.environmentMapping = normalizeMapping(mappings.environmentMapping);
+  }
+  if (project.enableGroup && mappings.groupMapping !== undefined) {
+    project.groupMapping = normalizeMapping(mappings.groupMapping);
+  }
+  project.updatedAt = new Date().toISOString();
+  projects[index] = project;
+  saveProjects(projects);
+  return project;
+}
+
+/**
+ * 删除项目及其所有关联配置
+ * @param {string} id - 项目 ID
+ * @returns {boolean} 是否删除成功
+ */
+function deleteProject(id) {
+  const projects = loadProjects();
+  const index = projects.findIndex((p) => p.id === id);
+  if (index === -1) {
+    return false;
+  }
+  projects.splice(index, 1);
+  saveProjects(projects);
+  deleteConfigs(id);
+  return true;
+}
+
+module.exports = {
+  getAllProjects,
+  getProjectById,
+  createProject,
+  updateMappings,
+  deleteProject,
+};
@@ -0,0 +1,91 @@
+/**
+ * 配置值校验工具
+ * 根据配置类型校验值的格式，编辑模式下额外校验值范围
+ */
+
+/**
+ * 支持的值类型列表
+ */
+const VALID_TYPES = ["string", "number", "boolean", "json"];
+
+/**
+ * 校验配置值是否符合指定的类型
+ * @param {any} value - 配置值
+ * @param {string} type - 配置类型（string/number/boolean/json）
+ * @returns {{ valid: boolean, message: string }} 校验结果
+ */
+function validateByType(value, type) {
+  if (!VALID_TYPES.includes(type)) {
+    return { valid: false, message: `不支持的类型: ${type}，支持的类型: ${VALID_TYPES.join(", ")}` };
+  }
+
+  switch (type) {
+    case "string":
+      if (typeof value !== "string") {
+        return { valid: false, message: "值必须是字符串类型" };
+      }
+      break;
+    case "number": {
+      const num = Number(value);
+      if (isNaN(num)) {
+        return { valid: false, message: "值必须是有效的数字" };
+      }
+      break;
+    }
+    case "boolean":
+      if (typeof value !== "boolean" && value !== "true" && value !== "false") {
+        return { valid: false, message: "值必须是布尔类型（true 或 false）" };
+      }
+      break;
+    case "json":
+      try {
+        JSON.parse(typeof value === "string" ? value : JSON.stringify(value));
+      } catch {
+        return { valid: false, message: "值必须是有效的 JSON 格式" };
+      }
+      break;
+  }
+  return { valid: true, message: "" };
+}
+
+/**
+ * 校验值范围约束（仅在编辑模式下生效）
+ * 支持简单的范围描述，如 "合法 IPv4 地址"、"1-100"、"枚举: A,B,C"
+ * @param {any} value - 配置值
+ * @param {string} valueRange - 值范围描述
+ * @returns {{ valid: boolean, message: string }} 校验结果
+ */
+function validateRange(value, valueRange) {
+  if (!valueRange || valueRange.trim() === "") {
+    return { valid: true, message: "" };
+  }
+
+  const range = valueRange.trim();
+
+  // 区间范围: "1-100" 或 "0.0-1.0"
+  const rangeMatch = range.match(/^(-?\d+(\.\d+)?)\s*-\s*(-?\d+(\.\d+)?)$/);
+  if (rangeMatch) {
+    const min = Number(rangeMatch[1]);
+    const max = Number(rangeMatch[3]);
+    const num = Number(value);
+    if (isNaN(num) || num < min || num > max) {
+      return { valid: false, message: `值必须在 ${min} 到 ${max} 之间` };
+    }
+    return { valid: true, message: "" };
+  }
+
+  // 枚举范围: "枚举: A,B,C"
+  const enumMatch = range.match(/^枚举[：:]\s*(.+)$/);
+  if (enumMatch) {
+    const options = enumMatch[1].split(/[,，]/).map((s) => s.trim());
+    if (!options.includes(String(value).trim())) {
+      return { valid: false, message: `值必须是以下选项之一: ${options.join(", ")}` };
+    }
+    return { valid: true, message: "" };
+  }
+
+  // 其他描述性范围（如 "合法 IPv4 地址"）目前不做强制校验，仅作提示
+  return { valid: true, message: "" };
+}
+
+module.exports = { VALID_TYPES, validateByType, validateRange };
@@ -0,0 +1,57 @@
+/**
+ * 配置服务单元测试
+ * 覆盖维度映射路径构建与嵌套键规整两项核心逻辑
+ * 运行：npm test
+ */
+const test = require("node:test");
+const assert = require("node:assert");
+const { buildConfigPath, normalizeKey } = require("../src/services/configService");
+
+// 构造测试用项目对象的辅助函数
+function makeProject(overrides) {
+  return {
+    enableIdc: true,
+    enableEnvironment: true,
+    enableGroup: true,
+    idcMapping: "path",
+    environmentMapping: "path",
+    groupMapping: "path",
+    ...overrides,
+  };
+}
+
+test("1-1 全部维度映射为 path 时，路径包含全部维度前缀", () => {
+  const project = makeProject({});
+  const config = { idc: "华北", environment: "dev", group: "用户模块", key: "db.host" };
+  assert.strictEqual(buildConfigPath(project, config), "华北/dev/用户模块/db.host");
+});
+
+test("1-2 分组映射为 label 时，分组不进入路径", () => {
+  const project = makeProject({ groupMapping: "label" });
+  const config = { idc: "华北", environment: "dev", group: "用户模块", key: "db/host" };
+  assert.strictEqual(buildConfigPath(project, config), "华北/dev/db/host");
+});
+
+test("1-3 全部维度映射为 label 时，路径仅含嵌套键", () => {
+  const project = makeProject({ idcMapping: "label", environmentMapping: "label", groupMapping: "label" });
+  const config = { idc: "华北", environment: "dev", group: "用户模块", key: "db/pool/max" };
+  assert.strictEqual(buildConfigPath(project, config), "db/pool/max");
+});
+
+test("1-4 维度未启用时，即便映射为 path 也不进入路径", () => {
+  const project = makeProject({ enableIdc: false });
+  const config = { idc: "华北", environment: "dev", group: "用户模块", key: "db.host" };
+  assert.strictEqual(buildConfigPath(project, config), "dev/用户模块/db.host");
+});
+
+test("2-1 规整键：去除首尾斜杠与空白", () => {
+  assert.strictEqual(normalizeKey("  /db/host/  "), "db/host");
+});
+
+test("2-2 规整键：压缩连续斜杠并去除空段", () => {
+  assert.strictEqual(normalizeKey("db//pool///max"), "db/pool/max");
+});
+
+test("2-3 规整键：空输入返回空字符串", () => {
+  assert.strictEqual(normalizeKey("   "), "");
+});