# layer_manage

**Repository Path**: starry-gray/layer_manage

## Basic Information

- **Project Name**: layer_manage
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-28
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 河道采砂规划管理系统

河道采砂规划管理平台：分区台账（地图绘制/导入）、规划周期与多级审批工作流、权限分级管理，并提供对外数据接口（省市级平台/GIS 系统对接）。

## 技术栈

| 层 | 技术 |
|---|---|
| 后端 | Go + Gin + GORM + MySQL（端口 8088） |
| 前端 | Vue 3 + Vite + Element Plus + Cesium（3D 地图）/ OpenLayers（2D 边界编辑），端口 5173 |
| 外部接口 | `/external/v1`，HMAC-SHA256 签名认证 + 限流，多格式导出（CSV/GeoJSON/KML/SHP） |

## 快速启动

1. 配置 `backend/.env`（数据库连接、端口、JWT 密钥）
2. 双击根目录 `启动项目.bat`（后端 + 前端一起拉起），或分别运行：
   - 后端：`cd backend && go run .`
   - 前端：`cd frontend && npm run dev`
3. 默认登录：`superadmin / 123456`

数据库结构由迁移脚本链管理：`database/migrations/`（001→035 顺序执行可建出完整库）；交接/部署用 `backend/docs/river_dump_20260831.sql` 全量导入。

## 文档索引

| 文档 | 内容 |
|---|---|
| [工作交接.md](工作交接.md) | 项目现状 / 未提交积压 / 踩坑速览（**新会话先读**） |
| [项目目录结构说明.md](项目目录结构说明.md) | 全项目文件功能清单 |
| [API文档.md](API文档.md) | 内部 API 完整接口文档（/api/v1） |
| [external_api_web_doc_8.18.md](external_api_web_doc_8.18.md) | 外部接口文档（/external/v1，给对接方） |
| [用户权限汇总.md](用户权限汇总.md) | 权限等级体系说明 |
| [BUG_AUDIT_REPORT.md](BUG_AUDIT_REPORT.md) | 全库 bug 审查报告 |
| [三维模型加载-实现记录与踩坑指南.md](三维模型加载-实现记录与踩坑指南.md) | Cesium 3D 模型加载指南 |

## 主要功能

- **分区台账**：地图绘制/Excel 批量导入/边界编辑，类型体系（可采/禁采/保留等）字典化管理
- **规划周期**：多级审批工作流（通过/驳回/退回/转办），周期附件管理
- **权限分级**：按用户等级（110 监管员 / 200 管理员 / 250 超管）与区域范围双重控制
- **地图**：Cesium 3D 地形 + 本地静态资源托管（离线可用），统计图表与空间分析
- **外部 API**：行政区划/分区/周期/审批/统计 23 个端点，HMAC 签名防篡改防重放