# Parking Admin

**Repository Path**: hngcadmin/parking-admin

## Basic Information

- **Project Name**: Parking Admin
- **Description**: 停车场管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-06
- **Last Updated**: 2026-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 停车场收费管理系统

基于 **Spring Boot 2.7 + Thymeleaf 模版引擎 + JDK 8 + MySQL** 的停车场收费管理示例，包含登录/注册、客户/车辆/停车记录管理、计费规则、停车场档案，以及按日/按月汇总统计。

## 技术栈
- Spring Boot 2.7（Web、Thymeleaf、Data JPA、Validation）
- MySQL 8.x（示例 SQL 兼容 5.7+）
- JDK 8
- Maven 构建

## 功能
- 账号体系：注册/登录/退出（Session 拦截），示例默认用户 demo/demo123
- 仪表盘：客户、车辆、计费规则、停车场数量，累计收费；按日/按月收费统计
- 客户管理：新增/编辑/删除，手机号唯一校验、会员等级
- 车辆管理：新增/编辑/删除，车牌唯一校验、状态、客户绑定
- 停车记录：新增/编辑/删除，录入入/出场时间、时长、金额、支付状态/方式，可关联计费规则与停车场
- 计费规则：新增/编辑/删除，包含免费分钟、小时单价、每日封顶、启用状态
- 停车场档案：新增/编辑/删除，维护位置、车位数、联系方式
- 页面：左侧菜单 + 顶部条的管理后台布局，登录/注册独立页

## 快速开始
1. 准备环境：JDK 8、Maven、MySQL 已安装。
2. 初始化数据库：在 MySQL 执行 `init_db.sql`（会创建库 `parking_mgmt`，6 张表并灌入测试数据）。
3. 配置数据库：修改 `src/main/resources/application.yml` 的 `spring.datasource.username/password` 为本地账号。
4. 启动项目：
   ```bash
   mvn spring-boot:run
   ```
5. 登录体验：浏览器打开 http://localhost:8080 ，使用 demo/demo123 登录；顶部左侧菜单访问各模块。

## 目录结构
- `pom.xml`：项目依赖与构建配置（JDK 8）
- `src/main/java/com/example/parking`
  - `config`：登录拦截器与 Web 配置
  - `controller`：认证、仪表盘、客户、车辆、停车记录、计费规则、停车场
  - `model`：实体（UserAccount/Customer/Vehicle/ParkingRecord/PricingRule/ParkingLot）
  - `repository`：JPA 仓库
  - `service`：认证、仪表盘聚合逻辑
- `src/main/resources/templates`：Thymeleaf 页面与布局
- `src/main/resources/static/css/app.css`：管理后台样式
- `init_db.sql`：数据库表结构（含中文注释）与丰富测试数据

## 其他说明
- JPA 当前配置 `ddl-auto: update` 便于开发；生产建议关闭并使用脚本迁移。
- 密码示例使用 MD5（演示用途）；生产请改为 BCrypt/Argon2 并接入权限体系。
- 可继续扩展：费率自动计费、支付对接、车牌识别、车位实时状态、报表导出等。