# water

**Repository Path**: makeupforever/water

## Basic Information

- **Project Name**: water
- **Description**: 基于uniapp 水务管理系统
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-09-25
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 水务工程管控小程序

一个基于 UniApp 框架开发的水务工程监管小程序，为水务工程建设提供全方位的数字化管控解决方案。

## ✨ 特性

- 🏗️ **工程监管**: 支持文明施工、安全监督、质量管理三大巡查类型
- 📱 **多端兼容**: 基于 UniApp 开发，支持微信小程序、H5、APP 等多平台
- 🎨 **现代化UI**: 采用现代化设计语言，提供优秀的用户体验
- 🔧 **组件化架构**: 完善的组件库，提高开发效率和代码复用性
- 📊 **数据可视化**: 实时监控工程进度和质量指标
- 🛡️ **权限管理**: 基于角色的权限控制，确保数据安全

## 🚀 快速开始

### 环境要求
- Node.js >= 12.0.0
- HBuilderX 或 VSCode + uni-app 插件
- 微信开发者工具（小程序开发）

### 安装依赖
```bash
# 进入项目目录
cd water

# 安装依赖（如使用npm包管理）
npm install
```

### 运行项目
```bash
# 运行到微信小程序
npm run dev:mp-weixin

# 运行到H5
npm run dev:h5

# 运行到APP
npm run dev:app-plus
```

## 📁 项目结构

```
water/
├── components/          # 公共组件
│   ├── common/         # 通用组件
│   │   ├── LoadingSpinner.vue    # 加载动画
│   │   ├── EmptyState.vue        # 空状态
│   │   └── StatusBadge.vue       # 状态标签
│   └── README.md       # 组件使用说明
├── constants/          # 常量配置
│   └── index.js       # 全局常量（巡查类型、存储键等）
├── docs/              # 项目文档
│   ├── coding-standards.md     # 代码规范
│   └── performance-guide.md    # 性能优化指南
├── pages/             # 页面文件
│   ├── index/         # 首页（地图、项目管理）
│   ├── login/         # 登录页
│   ├── my/            # 个人中心
│   ├── manage/        # 管理中心
│   ├── cpatrol/       # 巡查记录
│   └── monitor/       # 监控中心
├── request/           # API请求封装
│   └── index.js       # 请求拦截器和封装
├── static/            # 静态资源
│   └── images/        # 图片资源
├── styles/            # 样式文件
│   ├── variables.scss # 设计变量（颜色、尺寸等）
│   ├── base.scss     # 基础样式和重置
│   └── components.scss # 组件样式库
├── utils/             # 工具函数
│   └── index.js       # 通用工具（防抖、节流、存储等）
├── App.vue            # 应用入口
├── main.js            # 应用配置
├── manifest.json      # 应用配置文件
├── pages.json         # 页面路由配置
└── uni.scss          # 全局样式入口
```

## 🎯 主要功能

### 1. 工程地图管理
- 实时地图显示工程项目位置
- 项目标记点击查看详情
- 地图缩放、定位功能
- 项目筛选和搜索

### 2. 巡查管理
- **文明施工巡查**: 施工现场文明管理检查
- **安全监督巡查**: 安全生产监督检查记录
- **质量管理巡查**: 工程质量管理监控
- 巡查记录的增删改查
- 巡查结果统计分析

### 3. 用户权限管理
- 多角色权限控制（市场监督员、科负责人、工地负责人等）
- 基于角色的功能访问控制
- 用户信息管理和认证

### 4. 数据统计分析
- 巡查数据统计
- 项目进度跟踪
- 质量安全指标分析
- 报表生成和导出

## 🛠️ 技术栈

- **框架**: UniApp
- **语言**: JavaScript + Vue.js
- **样式**: SCSS + CSS Variables
- **地图**: 高德地图 API
- **存储**: UniApp Storage API
- **网络**: UniApp Request API

## 📐 设计系统

项目采用统一的设计系统，包含：

### 颜色规范
```scss
// 主色调
$primary-color: #1890ff;
$primary-light: #40a9ff;
$primary-dark: #096dd9;

// 功能色
$success-color: #52c41a;
$warning-color: #faad14;
$error-color: #ff4d4f;
$info-color: #1890ff;
```

### 间距规范
```scss
$spacing-xs: 8rpx;
$spacing-sm: 12rpx;
$spacing-md: 16rpx;
$spacing-lg: 20rpx;
$spacing-xl: 24rpx;
$spacing-xxl: 32rpx;
```

### 字体规范
```scss
$font-size-xs: 20rpx;
$font-size-sm: 24rpx;
$font-size-base: 28rpx;
$font-size-lg: 32rpx;
$font-size-xl: 36rpx;
```

## 🔧 开发规范

### 代码规范
- 遵循 ESLint 规则
- 使用 Prettier 格式化代码
- 组件命名使用 PascalCase
- 文件命名使用 kebab-case

### Git 提交规范
```
<type>(<scope>): <subject>

# 示例
feat(patrol): 添加巡查记录筛选功能
fix(login): 修复登录状态判断问题
docs(readme): 更新项目文档
```

### 性能优化
- 图片懒加载
- 组件按需加载
- 数据缓存策略
- 防抖节流处理

详细规范请查看 [代码规范文档](./docs/coding-standards.md) 和 [性能优化指南](./docs/performance-guide.md)。

## 📱 页面预览

### 首页
- 地图显示工程项目
- 实时位置定位
- 项目统计概览

### 巡查管理
- 巡查记录列表
- 筛选和搜索功能
- 巡查详情查看

### 管理中心
- 待办事项统计
- 功能入口导航
- 数据分析展示

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🙋‍♀️ 支持

如果您在使用过程中遇到任何问题，请通过以下方式获取帮助：

- 提交 Issue
- 查看项目文档
- 联系开发团队

---

**注意**: 本项目为水务工程管控专用系统，请确保在授权范围内使用。