# table2net

**Repository Path**: watermeta_admin/table2net

## Basic Information

- **Project Name**: table2net
- **Description**: 表格转网页
- #/status
- 页面标题： 地下水与土壤监测数据展示 - 系统状态
- 模块： 最近导入 、 数据库状态 、 当前运行信息 、 最近日志
- 右上会显示 本地模式
- 页面标题： 地下水与土壤监测数据展示 - 系统设置
- 模块： 数据来源设置 、 系统标题设置 、 地图设置
- **Primary Language**: Unknown
- **License**: EPL-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# table2net

## 介绍
本仓库用于保存「地下水与土壤监测数据」多源展示平台的代码。当前已实现多数据源接入、通用 CSV 导入、大屏总览、历史查询与对比分析，并规划扩展为涵盖采集 / 存储 / 分析 / 模型 / 大屏 / 对接的一体化平台。

## 目录结构
- `hkydata`：主项目，包含前端、后端、示例数据、启动脚本
- `hky-auth`：二进制授权校验器，以及可选的密码计算工具

## 功能说明
当前系统为「地下水与土壤监测数据」的多源展示平台，已具备以下能力：

### 1. 多数据源隔离
- 通过站点 `page` 字段与运行时 `activePage` 隔离不同数据源，切换来源后大屏 / 历史 / 对比页面只展示当前源数据。
- 已接入数据源：
  - `xiongan`：雄安新区地下水与土壤监测
  - `zhangjiakou`：张家口
  - `bjwater`：四海桥管网水质（余氯 / pH / 浊度 / 电导率 / 水温 / 水压）
- 多源数据共存、互不破坏；运行时记录当前激活源，刷新后保持。

### 2. 通用 CSV 导入
- 系统设置中读取数据文件夹，可切换来源并按所选文件导入。
- 按「名称 + 单位 + 类别」自动识别 / 创建指标，不再受限于固定列，管网水质等任意结构数据均可自动建表并归属到对应数据源。

### 3. 大屏总览
- 区域趋势图：数据驱动，按当前源指标渲染。
- 近 30 天柱图：自动取当前源第一个监测指标（如四海桥取「余氯」）。
- 大屏实时总览：仅展示当前源站点。
- 近 7 天数据曲线：仅当前源。
- 默认剔除全 0 数据（复选框已隐藏，行为保持默认开启）。

### 4. 地图总览
- 按当前源居中显示站点，切换源后自动重新定位。

### 5. 历史查询
- 按区域 / 站点 / 时间范围查询历史数据，区域与站点列表随当前源更新。

### 6. 对比分析
- 支持按类别 / 站点 / 归一化对比，维度随当前源更新。

### 后续规划（平台化）
本项目计划扩展为涵盖「数据采集 → 存储 → 展示 → 分析 → 模型分析 → 大屏展示 → 对外对接」的一体化平台，上述模块为展示 / 分析 / 大屏部分的基础。

## 技术栈
- 前端：Vue 3 + Vite + ECharts + Leaflet
- 后端：Node.js + Express + SQLite

## 在其它电脑运行
### 方式一：直接克隆仓库
1. 在目标电脑安装 Git，确保电脑可联网
2. 打开命令行，进入目标目录
3. 执行 `git clone https://gitee.com/watermeta_admin/table2net.git`
4. 克隆完成后进入 `table2net\hkydata`
5. 双击运行 `install.bat`
6. 首次安装会自动下载便携版 Node.js，并安装前后端依赖
7. 安装完成后双击运行 `start.bat`
8. 浏览器打开脚本窗口提示的地址，通常为 `http://localhost:8080`

### 方式二：直接拷贝整个项目文件夹
1. 将整个 `table2net` 文件夹完整拷贝到目标电脑
2. 不要只拷贝 `hkydata`，必须同时保留同级的 `hky-auth\year-password-verifier.exe`
3. `year-password-calculator.html` 只是手工算密码的可选工具，不参与程序运行，可不转移
4. 进入 `table2net\hkydata`
5. 双击运行 `install.bat`
6. 安装完成后双击运行 `start.bat`

## 运行前要求
- 操作系统：Windows
- 首次安装需要联网，用于下载 Node.js 和依赖包
- 建议使用有管理员权限的普通桌面环境
- 如果本机 8080 端口被占用，系统会自动尝试 8081、8082、8083

## 启动与停止
### 启动
1. 进入 `table2net\hkydata`
2. 双击 `start.bat`
3. 后端默认运行在 `http://localhost:3010`
4. 前端默认运行在 `http://localhost:8080`
5. 若 8080 被占用，会自动切换到 8081/8082/8083

### 停止
1. 返回 `table2net\hkydata`
2. 双击 `stop.bat`
3. 会自动结束标题为 `HKY-Backend` 和 `HKY-Frontend` 的窗口进程

## 授权说明
- 系统登录密码按年份计算
- 程序运行必需文件：`hky-auth\year-password-verifier.exe`
- 可选工具文件：`hky-auth\year-password-calculator.html`
- 如果你不想把手工算密码的页面一起给对方，可以不转移 `year-password-calculator.html`
- 但只要程序还需要本地自行校验密码，就必须保留 `year-password-verifier.exe`
- 当前采用本地编译后的二进制校验模块，运行时不再依赖脚本版 `.cjs` 校验器
- 目标电脑只要保留 `table2net\hkydata` 和 `table2net\hky-auth\year-password-verifier.exe` 的相对位置，程序就能自行校验授权密码

## 数据与配置
- 示例数据按数据源分目录存放：`hkydata\daxiongan`（xiongan）、`hkydata\bjwater`（四海桥管网水质）等
- 站点地图与指标配置位于 `hkydata\daxiongan\site-config.json`，内含各 source 的 `center` / `zoom` / `groupColors` / `defaultSelectedSite`
- 运行时数据库位于 `hkydata\backend\data`
- `runtime-config.json` 记录当前激活数据源（`activePage`），属运行期文件，不建议直接放入版本库修改
- 如需在环境变量中指定数据目录或授权文件，建议使用相对路径，例如 `./daxiongan`、`../hky-auth/year-password-verifier.exe`

## 首次使用建议
1. 先运行 `install.bat`
2. 再运行 `start.bat`
3. 登录后进入“系统设置”检查标题、地图、站点配置
4. 如修改了前端或后端代码，建议重新执行 `start.bat` 前先运行 `stop.bat`
5. 如果页面还是旧内容，请在浏览器按 `Ctrl + F5` 强制刷新

## 常见问题
### 1. install.bat 很久没结束
- 首次安装下载 Node.js 和安装依赖时，耗时 5 到 20 分钟都可能正常
- 网络较慢时，耗时会更长

### 2. start.bat 提示缺少 Node 或依赖
- 说明 `install.bat` 还没成功完成
- 请先重新运行 `install.bat`

### 3. 页面能打开但没有数据
- 检查 `hkydata\daxiongan` 下是否存在 CSV 文件
- 检查 `hkydata\daxiongan\site-config.json` 是否被误改
- 检查是否已经完成 `install.bat` 中的 CSV 导入步骤

### 4. 换电脑后登录失败
- 请确认 `hky-auth\year-password-verifier.exe` 与 `hkydata` 保持预期相对位置
- 如需手工计算密码，可单独使用你自己保存的 `year-password-calculator.html`

## 快速命令
```bash
git clone https://gitee.com/watermeta_admin/table2net.git
cd table2net/hkydata
install.bat
start.bat
```