# smart_construction_site

**Repository Path**: weicong1992/smart_construction_site

## Basic Information

- **Project Name**: smart_construction_site
- **Description**: 智慧工地后端服务
用于工地的设备维护、人员维护、摄像机监控、信息管理
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-08-23
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# smart_construction_site


## 项目简介
	智慧工地后端服务
	用于工地的设备维护、人员维护、摄像机监控、信息管理
## 技术架构
1. Web架构要求, 分别是 	Controller：应用于前后端交互数据处理；
						Service：核心业务层，保证核心业务标准；
						mapper：方法不可随意定义，和数据库设计关联极大。
2. 技术栈 ：spring boot 2.7.18 + spring cloud 2021.0.9 + nacos 2.3.2 + mysql 8.0.36 + JDK 1.8 + redis 7.2.4
3. 为了以后的扩展和基础代码重用性，
    manage  主业务服务
	common  是该微服务的基础模块，主要存放基础工具类，公共方法。
	gateway 是该微服务的网关模块，主要用于鉴权和转发，包括：token鉴权、请求地址鉴权，之后可能还需要补充防篡改和防冲刷。
	generator 代码生成器
	
## 分支说明
	master 主干分支, 用于发布测试环境
	dev 开发总分支，用于发布开发环境
    release/* 阶段性封板分支
## 编码规范 

	1. 日期统一使用Date,请勿试用其他类型
	2. 规范要求，请求方法不用PUT和DELETE，只用GET和POST。GET请求参数放query，POST请求参数只能放body里面。
	3. controller中的url尽量不使用PathVariable(后期后端接口单独鉴权，确保接口单一功能)。
	4. 前后端数据交互格式尽量保证一致。日期字段注意使用格式接收返回。
	5. 工具尽量使用hutool和apache的。
	6. mybatis书写的数据查询，请勿有SQL 注入问题，参数需要用"#",不能使用"$".
	7. 写SQL查询的原则是： 复杂查询写xml文件，简单些的参数在mapper 里用@Select 写查询， 非常简单的用Lambda表达式查询。
	8. 分页列表接口一定要问产品排序。
	9. 代码要写注释，包含行内注释、文本注释以及打印注释（记录日志文件）
	
## 及其他说明和注意事项
#### build 方法
	1. mvn clean install -Dmaven.test.skip=ture  来进行普通的本地build ,不能存在 checkstyle 的警告和错误。
	2. mvn checkstyle:check  单独运行 checkstyle 检查，不能存在 checkstyle 的警告和错误。
	3. 如果以上命令出现中文乱码，在windows 控制台下请录入 chcp 65001 改变windows代码页为utf-8.
	4. jenkins build 环境： http://192.168.1.168:9081/ 中的 AI-OPS 2.0* 开头的项目,账号和密码请走公司OA系统申请，账密忘了的，可以联系运维部。
#### 表规范
	1. 数据库表一定要有id主键
	2. 数据库表命名要有层次性
	3. 数据库状态值要求：只有两个状态使用0-否和1-是，超过两个状态使用两位序号（如：01、02、03）（非系统级的状态除外）
	4. 建表时提前考虑数据量问题，关联性能，关联需要走索引
#### 参与者
	GLink 智慧工地 后端开发团队：邱绍山、鲁猛猛、杨稀