# road_manage

**Repository Path**: ssiagu/road_manage

## Basic Information

- **Project Name**: road_manage
- **Description**: 以地图为核心的交通设施空间数据管理系统（道路/桥梁/隧道/区域/POI），四端架构：服务端 + 桌面在线/离线版 + 安卓移动端。离线版 Windows 成品下载见发行版：https://gitee.com/zjywchenhui/road_manage/releases
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2026-09-14
- **Last Updated**: 2026-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 交通设施管理系统

一个以地图为核心的交通设施空间数据管理系统，覆盖**道路、桥梁、隧道、区域、POI（兴趣点）** 五大模块。数据以 GeoJSON 格式存储，支持在线协同编辑与离线单机使用，并提供安卓移动端进行现场数据采集与同步。

## 下载（免构建，开箱即用）

不想折腾源码？直接下载打包好的**离线版**（Windows 64 位，纯单机，无需部署服务器）：

- [交通设施管理系统（离线版）v1.0.6 安装版](https://gitee.com/zjywchenhui/road_manage/releases/download/v1.0.6/%E4%BA%A4%E9%80%9A%E8%AE%BE%E6%96%BD%E7%AE%A1%E7%90%86%E7%B3%BB%E7%BB%9F%EF%BC%88%E7%A6%BB%E7%BA%BF%E7%89%88%EF%BC%89-1.0.6-x64-setup.exe)
- [交通设施管理系统（离线版）v1.0.6 免安装绿色版](https://gitee.com/zjywchenhui/road_manage/releases/download/v1.0.6/%E4%BA%A4%E9%80%9A%E8%AE%BE%E6%96%BD%E7%AE%A1%E7%90%86%E7%B3%BB%E7%BB%9F%EF%BC%88%E7%A6%BB%E7%BA%BF%E7%89%88%EF%BC%89-1.0.6-x64-portable.exe)

首次打开会引导填写高德地图密钥（[免费申请](https://lbs.amap.com/)，约 2 分钟）。更多版本见[发行版页面](https://gitee.com/zjywchenhui/road_manage/releases)。

## 系统组成

本仓库包含四个可独立部署的子项目：

| 目录 | 说明 | 适用场景 |
|---|---|---|
| [`server/`](server/) | 服务端（Node.js + Express + SQLite），提供网页端管理后台与数据同步 API | 团队协同、多终端数据汇聚 |
| [`desktop-online/`](desktop-online/) | 桌面在线版（Electron），本质是指向服务器的网页客户端外壳 | 办公电脑上免浏览器使用 |
| [`desktop-offline/`](desktop-offline/) | 桌面离线版（Electron），纯单机运行，数据保存在本机 | 无外网环境、单人使用 |
| [`mobile/`](mobile/) | 安卓移动端（WebView + 本地 SQLite），可从服务器同步数据、现场采集 | 户外实地采集、巡查 |

## 主要功能

- **五类空间数据管理**：道路、桥梁、隧道、区域、POI 的增删改查，支持线/面/点图形绘制
- **地图可视化**：基于高德地图 JS API，支持行政区划边界显示、沿线文字标注、坐标系转换（GCJ-02 ↔ WGS-84）
- **多格式导入导出**：GeoJSON、GPS 坐标 GeoJSON、TXT、Excel（含地图截图）、ZIP（含图片）
- **图片附件**：每条数据可挂多张现场照片，自动生成缩略图
- **多用户权限**：管理员 / 用户 / 访客三级邀请码注册，账号锁定、单设备登录、操作审计日志
- **版本化数据同步**：按 `YYYYMMDD-序号` 版本号增量比对，移动端一键同步
- **批量导入**：GeoJSON / ZIP 上传导入，带进度推送与事务回滚保护
- **编辑锁**：防止多人同时编辑同一条数据造成冲突
- **全屏模式**：系统菜单一键进入/退出全屏，图标与文字随状态自动切换

## 快速开始

> 完全没有部署经验也没关系，每一步都有中文向导引导。

**第一步：部署服务端**（详见 [server/README.md](server/README.md)）

Windows 用户直接双击 `server/初次设置.bat`，全程自动引导。或使用命令行：

```bash
cd server
npm install      # 安装依赖
npm run setup    # 首次运行配置向导（约 2 分钟，跟着提示走即可）
npm start        # 启动服务器
```

然后在浏览器打开 `http://127.0.0.1:42763`，用向导生成的**管理员邀请码**注册第一个账号。

**第二步：按需选择客户端**

- 电脑上免浏览器使用 → 运行 [desktop-online](desktop-online/)（改一下 `config.json` 里的服务器地址即可）
- 完全离线单机使用 → 运行 [desktop-offline](desktop-offline/)
- 手机现场采集 → 用 Android Studio 构建安装 [mobile](mobile/)，首次打开会引导填写服务器地址和同步 Key

## 配置说明

服务端的配置分为两类（详见 [server/README.md](server/README.md)）：

- **自动生成的**：登录保护密钥、注册邀请码、数据同步 API Key —— `npm run setup` 自动生成
- **需要手动准备的**：高德地图密钥（[免费申请](https://lbs.amap.com/)，向导中有图文指引）、行政区划代号、默认经纬度 —— 向导会逐一引导填写，均可稍后补配

## 技术栈

- **服务端**：Node.js、Express 5、SQLite（WAL 模式）、bcrypt、sharp、原生 JavaScript 前端（无框架）
- **桌面端**：Electron
- **移动端**：Android（Java + WebView + 本地 SQLite）
- **地图**：高德地图 JS API 2.0

## 开源协议

[MIT](LICENSE) © 残剑斩龙

## 免责声明

- 本项目使用高德地图服务，使用前请遵守[高德开放平台服务条款](https://lbs.amap.com/)并申请您自己的 API Key。
- 默认 HTTP 模式仅建议在局域网/内网环境使用；如需公网部署，请自行评估安全风险并配置 HTTPS。