# xc20-team01

**Repository Path**: beituo/xc20-team01

## Basic Information

- **Project Name**: xc20-team01
- **Description**: 信创数字化综合管理系统 | 企业级OA平台，涵盖人事行政、财务报销、后勤会议、数据统计等模块。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-09-19
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 交管对接信息化管理系统
## SC-DIMS (Docking Information Management System)

<div style="text-align: center;">

<p>
  <img src="https://img.shields.io/badge/Spring%20Boot-3.2.5-brightgreen.svg" alt="Spring Boot"/>
  <img src="https://img.shields.io/badge/Spring%20Cloud-2023.0.1-blue.svg" alt="Spring Cloud"/>
  <img src="https://img.shields.io/badge/Vue.js-3.4.15-4FC08D.svg" alt="Vue.js"/>
  <img src="https://img.shields.io/badge/Element%20Plus-2.4.4-409EFF.svg" alt="Element Plus"/>
  <img src="https://img.shields.io/badge/TypeScript-5.3.3-3178C6.svg" alt="TypeScript"/>
  <img src="https://img.shields.io/badge/达梦数据库-DM8-red.svg" alt="DM Database"/>
  <img src="https://img.shields.io/badge/JDK-17+-orange.svg" alt="JDK"/>
  <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"/>
</p>

**现代化企业级信息管理系统 | 基于 Spring Cloud 微服务架构**

[🚀 快速开始](#-快速开始) • [🛠️ 技术栈](#-技术栈) • [🏗️ 系统架构](#-系统架构) • [📋 功能模块](#-功能模块) • [💻 开发指南](#-开发指南) • [📚 部署文档](#-部署文档)

</div>

---

## 📑 目录

- [项目简介](#-项目简介)
- [技术栈](#-技术栈)
- [系统架构](#-系统架构)
- [功能模块](#-功能模块)
- [快速开始](#-快速开始)
- [配置说明](#-配置说明)
- [部署文档](#-部署文档)
- [开发指南](#-开发指南)

---

## 📖 项目简介

SC-DIMS（交管对接信息化管理系统）是一个基于现代化微服务架构构建的企业级综合管理平台。系统采用前后端分离设计，为政府机关、企事业单位提供完整的内部管理数字化解决方案。

### 🎯 系统定位

- **企业级应用** - 面向中大型组织的综合管理平台
- **全流程覆盖** - 从员工入职到离职的全生命周期管理
- **数字化转型** - 传统纸质流程向数字化、智能化转变
- **国产化适配** - 支持国产数据库和基础软件生态

### ✨ 核心特性

- 🏗️ **微服务架构** - 基于 Spring Cloud 的分布式架构，服务独立部署，易于扩展维护
- 🔐 **安全可靠** - UUID+Redis 会话认证 + Spring Security 权限控制，支持立即撤销
- 📊 **数据可视化** - 基于 ECharts 的统计分析和数据展示，支持多维度报表
- 💾 **国产化支持** - 完全支持达梦数据库（DM8），满足信创和国产化要求
- 🚀 **高性能缓存** - Redis 分层缓存策略，显著提升系统响应速度
- 🎨 **现代化UI** - Vue 3 + TypeScript + Element Plus 响应式界面设计
- 📱 **移动端适配** - 响应式设计，支持PC端、平板、手机多端访问
- ✅ **审批管理** - 支持请假、报销、招待费等多种业务的审批流程
- 📈 **运行监控** - Druid 数据源监控，业务数据统计分析
- 🔧 **高度可配置** - 菜单权限、字典数据、业务规则均可灵活配置
- ⚡ **代码质量** - 遵循现代Java开发规范，代码结构清晰

---

## 🛠️ 技术栈

### 后端技术

| 技术 | 版本 | 说明 |
|------|------|------|
| **JDK** | 17+ | Java 开发环境 |
| **Spring Boot** | 3.2.5 | 核心框架 |
| **Spring Cloud** | 2023.0.1 | 微服务框架 |
| **Spring Cloud Alibaba** | 2023.0.1.0 | 微服务组件 |
| **Spring Security** | 6.x | 安全框架 |
| **MyBatis Plus** | 3.5.14 | ORM 框架 |
| **Spring Cloud Gateway** | - | API 网关 |
| **Nacos** | 3.1.0 | 服务注册与配置中心 |
| **Druid** | 1.2.27 | 数据库连接池 |
| **Hutool** | 5.8.42 | Java 工具库 |
| **Fastjson2** | 2.0.60 | JSON 处理 |

### 前端技术

| 技术 | 版本 | 说明 |
|------|------|------|
| **Vue.js** | 3.4.15 | 前端框架 |
| **TypeScript** | 5.3.3 | 类型化 JavaScript |
| **Element Plus** | 2.4.4+ | UI 组件库 |
| **Vite** | 5.0.12 | 构建工具 |
| **Pinia** | 2.1.7 | 状态管理 |
| **Vue Router** | 4.2.5 | 路由管理 |
| **Axios** | 1.6.2 | HTTP 客户端 |
| **ECharts** | 5.4.3 | 数据可视化 |

### 数据存储

| 技术 | 版本 | 说明 |
|------|------|------|
| **达梦数据库** | DM8 | 国产主数据库 |
| **Redis** | 7.x | 缓存数据库 |
| **本地文件系统** | - | 文件存储 |

---

## 🏗️ 系统架构

### 系统架构图

```
┌─────────────────────────────────────────────────────────────────────────┐
│                             用户界面层                                   │
│                  Vue 3 + Element Plus + TypeScript                      │
│                        http://localhost:3000                            │
└────────────────────────────────┬────────────────────────────────────────┘
                                 │
┌────────────────────────────────▼────────────────────────────────────────┐
│                             API 网关层                                   │
│                  Spring Cloud Gateway (Port: 8080)                      │
│                  路由转发 │ 负载均衡 │ 限流 │ 认证                       │
└────────────────────────────────┬────────────────────────────────────────┘
                                 │
         ┌───────────────────────┼───────────────────────┐
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐   ┌─────────────────┐   ┌─────────────────┐
│    认证服务      │   │    系统管理      │   │    行政管理      │
│   Port: 9200    │   │   Port: 9201    │   │   Port: 9202    │
│   登录/Token    │   │   用户/角色     │   │   考勤/薪资     │
└─────────────────┘   └─────────────────┘   └─────────────────┘

┌─────────────────┐   ┌─────────────────┐   ┌─────────────────┐
│    后勤管理      │   │    财务报销      │   │    统计分析      │
│   Port: 9203    │   │   Port: 9204    │   │   Port: 9205    │
│   会议/报修     │   │   报销/补助     │   │   数据统计      │
└─────────────────┘   └─────────────────┘   └─────────────────┘

┌─────────────────┐
│    公共模块      │
│  sc-dims-common │
│  工具类/实体类   │
└─────────────────┘
         │
         └───────────────────────┬───────────────────────┘
                                 │
         ┌───────────────────────┼───────────────────────┐
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐   ┌─────────────────┐   ┌─────────────────┐
│   达梦数据库     │   │     Redis       │   │     Nacos       │
│      DM8        │   │      缓存       │   │    服务注册      │
│  Port: 5236     │   │  Port: 6379     │   │  Port: 8848     │
└─────────────────┘   └─────────────────┘   └─────────────────┘
```

### 微服务模块

| 服务名称 | 端口 | 说明 | 主要功能 |
|---------|------|------|---------|
| **sc-dims-gateway** | 8080 | API 网关 | 路由转发、负载均衡、限流、认证 |
| **sc-dims-auth** | 9200 | 认证授权服务 | 用户登录、UUID Token、权限验证 |
| **sc-dims-system** | 9201 | 系统管理服务 | 用户、角色、部门、菜单、字典管理 |
| **sc-dims-admin** | 9202 | 行政管理服务 | 入职、考勤、请假、薪资、合同管理 |
| **sc-dims-logistics** | 9203 | 后勤管理服务 | 会议室、报修、点餐、资产、通告 |
| **sc-dims-finance** | 9204 | 财务报销服务 | 费用报销、补助申请、招待费管理 |
| **sc-dims-statistics** | 9205 | 统计分析服务 | 考勤统计、报修统计、用餐统计、综合报表 |
| **sc-dims-common** | - | 公共模块 | 通用工具类、实体类、常量定义 |

### 前端模块结构

```
DIMS-Frontend/
├── src/
│   ├── api/                    # API 接口封装
│   │   ├── auth.ts            # 认证相关接口
│   │   ├── admin.ts           # 行政管理接口
│   │   ├── logistics.ts       # 后勤管理接口
│   │   ├── finance.ts         # 财务报销接口
│   │   ├── statistics.ts      # 统计分析接口
│   │   ├── system.ts          # 系统管理接口
│   │   ├── user.ts            # 用户接口
│   │   ├── config.ts          # 配置文件
│   │   └── http.ts            # HTTP 请求封装
│   ├── components/            # 公共组件
│   │   ├── Layout.vue         # 布局组件
│   │   ├── MenuItem.vue       # 菜单组件
│   │   └── ImportDialog.vue   # 导入对话框
│   ├── composables/           # 组合式函数
│   │   └── useErrorHandler.ts # 错误处理
│   ├── router/                # 路由配置
│   │   └── index.ts           # 路由定义
│   ├── store/                 # 状态管理（Pinia）
│   │   └── user.ts            # 用户状态
│   ├── utils/                 # 工具函数
│   │   ├── dateUtil.ts        # 日期工具
│   │   ├── exportUtil.ts      # 导出工具
│   │   └── resignationUtil.ts # 离职工具
│   ├── views/                 # 页面视图
│   │   ├── auth/              # 登录认证（登录、注册、密码重置）
│   │   ├── common/            # 公共模块（首页、通讯录、待办、个人信息）
│   │   ├── system/            # 系统管理（用户、角色、部门、菜单、字典）
│   │   ├── admin/             # 行政管理（入职、考勤、薪资、离职、事件）
│   │   ├── logistics/         # 后勤管理（会议、报修、点餐、资产、通告）
│   │   ├── finance/           # 财务报销（报销、补助、招待费）
│   │   └── statistics/        # 统计分析（考勤、报修、用餐统计）
│   ├── App.vue                # 根组件
│   ├── main.ts                # 入口文件
│   └── style.css              # 全局样式
```

---

## 📋 功能模块

### 🔐 1. 认证授权模块

| 功能 | 说明 | 技术实现 |
|------|------|---------|
| **用户登录** | 支持用户名/密码登录，记住我功能 | UUID Token + Redis 缓存 |
| **用户注册** | 新用户注册流程，邮箱验证 | Spring Security + 邮件服务 |
| **密码管理** | 密码找回、重置、修改功能 | 安全令牌机制 |
| **验证码** | 图形验证码防护，防止自动化攻击 | Kaptcha + Redis 缓存 |
| **Token 管理** | 会话令牌生成、验证、刷新 | UUID + Redis 分布式会话 |
| **权限控制** | 基于角色的访问控制（RBAC） | Spring Security + 动态权限 |

**认证机制说明：**
- 🔑 **认证方式**：UUID Token + Redis 存储（高安全性，可立即撤销）
- ⚡ **会话管理**：支持记住我（7天）和普通登录（12小时）
- 🚫 **安全防护**：验证码保护、请求频率限制（每分钟100次）
- 🎯 **Token 特性**：服务端可控、支持即时失效

### 🏠 2. 首页模块

| 功能 | 说明 |
|------|------|
| **我的单据** | 快速查看个人申请单据状态 |
| **通讯录** | 员工通讯录查询 |
| **消息通告** | 系统消息和通告发布 |
| **我的待办** | 待审批事项提醒 |
| **数据统计** | 关键业务数据可视化展示 |

### ⚙️ 3. 系统管理模块

| 功能 | 说明 |
|------|------|
| **用户管理** | 用户的增删改查、状态管理 |
| **角色管理** | 角色定义、权限分配 |
| **部门管理** | 组织架构树形管理 |
| **菜单管理** | 系统菜单配置、权限绑定 |
| **字典管理** | 系统字典数据维护 |
| **消息通知** | 系统消息发送与查看 |

### 👥 4. 行政管理模块

| 功能分类 | 具体功能 |
|---------|---------|
| **入职管理** | 正式员工入职、实习生管理、聘用人员登记、合同归档 |
| **考勤管理** | 考勤记录、出勤统计、考勤月报、第三方数据接口 |
| **请假管理** | 请假申请、销假申请、假期余额、公休计算 |
| **出勤申请** | 出差申请、加班申请、外出申请 |
| **合同管理** | 劳务合同归档、合同续签提醒、文档管理 |
| **薪资管理** | 薪资核算、工资条查询、薪资发布 |
| **事件管理** | 重大事项报告、出国报告、证件借还 |
| **一卡通管理** | 员工一卡通信息设置、状态监控 |
| **离职管理** | 离职申请、离职交接、档案处理 |
| **个人信息** | 基础信息、教育信息、证件信息管理 |

### 🏢 5. 后勤管理模块

| 功能 | 说明 |
|------|------|
| **会议室管理** | 会议室预约、使用统计、会议签到、会议纪要 |
| **通告管理** | 内部通告发布、群组设置、阅读统计 |
| **报事报修** | 故障报修、维修进度跟踪、工单管理 |
| **点餐管理** | 员工餐饮预订、菜品管理、用餐统计 |
| **资产管理** | 资产申请、领用、归还、资产台账 |

### 💰 6. 财务报销模块

| 功能 | 说明 |
|------|------|
| **费用报销** | 一般报销、出差报销、发票管理 |
| **补助申请** | 员工补助、实习生补助、加班费补助 |
| **招待费管理** | 招待费用统计、月度结算 |
| **审批功能** | 报销审批、补助审批、招待费审批 |
| **报表统计** | 报销金额统计分析、财务报表 |

### 📊 7. 统计分析模块

| 功能 | 说明 |
|------|------|
| **考勤统计** | 部门/个人考勤数据统计、出勤率分析 |
| **报修统计** | 报修工单量、响应时长统计、维修效率 |
| **用餐统计** | 餐饮订单量、费用统计 |
| **数据可视化** | 基于 ECharts 的图表展示、仪表盘 |
| **综合报表** | 多维度业务数据分析、决策支持 |

---

## 🚀 快速开始

### 环境要求

| 软件 | 版本要求 | 说明 |
|------|---------|------|
| **JDK** | 17+ | Java 开发环境 |
| **Maven** | 3.8+ | 项目构建工具 |
| **Node.js** | 18+ | 前端运行环境（推荐 v22+） |
| **达梦数据库** | DM8 | 主数据库 |
| **Redis** | 7.x | 缓存服务 |
| **Nacos** | 3.1.0 | 服务注册与配置中心 |

### 📦 步骤一：准备数据库

#### 1. 启动达梦数据库

确保达梦数据库服务正在运行，默认端口：`5236`

#### 2. 执行初始化脚本

⚠️ **重要**：请按以下顺序依次执行 `database/` 目录下的 SQL 脚本

```bash
# 执行顺序
1️⃣ 00_database_connection_info.sql    # 查看数据库连接信息
2️⃣ 01_user_tables.sql      # 创建用户权限表
3️⃣ 02_business_tables.sql             # 创建业务功能表
4️⃣ 03_init_data.sql                   # 初始化基础数据
```

**数据库连接信息：**

| 配置项 | 值 |
|--------|-----|
| **URL** | `jdbc:dm://127.0.0.1:5236/XC-TEAM` |
| **用户名** | 环境变量 `DM_USERNAME`（默认：SYSDBA） |
| **密码** | 环境变量 `DM_PASSWORD`（默认：Abc123456） |

### 🔧 步骤二：启动 Redis

```bash
# Windows
redis-server.exe

# Linux/Mac
redis-server
```

✅ Redis 默认端口：`6379`

### ⚙️ 步骤三：启动后端服务

#### 方式一：IDE 启动（推荐开发调试）

📌 **启动顺序建议**：按以下顺序依次启动各服务的主类

1. 🌐 **网关服务**
   - `sc-dims-gateway/src/main/java/com/scdims/gateway/GatewayApplication.java`
   - 端口：8080

2. 🔐 **认证服务**
   - `sc-dims-auth/src/main/java/com/scdims/auth/AuthApplication.java`
   - 端口：9200

3. ⚙️ **系统服务**
   - `sc-dims-system/src/main/java/com/scdims/system/SystemApplication.java`
   - 端口：9201

4. 📋 **业务服务**
   - 📊 行政管理：`sc-dims-admin/.../AdminApplication.java` (9202)
   - 🏢 后勤管理：`sc-dims-logistics/.../LogisticsApplication.java` (9203)
   - 💰 财务报销：`sc-dims-finance/.../FinanceApplication.java` (9204)
   - 📈 统计分析：`sc-dims-statistics/.../StatisticsApplication.java` (9205)

#### 方式二：Maven 命令启动

```bash
# 先编译整个项目
mvn clean install -DskipTests

# 启动各个服务（在各服务目录下执行）
cd sc-dims-gateway && mvn spring-boot:run &
cd sc-dims-auth && mvn spring-boot:run &
cd sc-dims-system && mvn spring-boot:run &
cd sc-dims-admin && mvn spring-boot:run &
cd sc-dims-logistics && mvn spring-boot:run &
cd sc-dims-finance && mvn spring-boot:run &
cd sc-dims-statistics && mvn spring-boot:run &
```

### 💻 步骤四：启动前端服务

```bash
# 进入前端目录
cd DIMS-Frontend

# 首次运行：安装依赖
npm install

# 启动开发服务器
npm run dev
```

### 🎉 步骤五：访问系统

#### 🌐 前端应用

访问地址：**http://localhost:3000**

#### 🔑 默认测试账号

| 用户名 | 密码 | 角色 | 权限范围 |
|--------|------|------|---------|
| admin | password | 管理员 | 全部功能 |
| niexinshuo | password | 人事经理 | 行政管理模块 |
| luxinru | password | 财务经理 | 财务报销模块 |
| zhangshaoqing | password | 后勤经理 | 后勤管理模块 |
| maxiaolong | password | 行政专员 | 行政管理模块 |
| zhaowei | password | 行政专员 | 基础功能 |
| intern | password | 实习生 | 基础功能 |

#### 🔌 后端服务接口

| 服务名称 | 访问地址 | 端口 | 说明 |
|---------|---------|------|------|
| 🌐 API 网关 | http://localhost:8080 | 8080 | 统一入口 |
| 🔐 认证服务 | http://localhost:9200 | 9200 | 用户登录认证 |
| ⚙️ 系统管理 | http://localhost:9201 | 9201 | 用户权限管理 |
| 📊 行政管理 | http://localhost:9202 | 9202 | 考勤薪资管理 |
| 🏢 后勤管理 | http://localhost:9203 | 9203 | 会议报修管理 |
| 💰 财务报销 | http://localhost:9204 | 9204 | 报销补助管理 |
| 📈 统计分析 | http://localhost:9205 | 9205 | 数据统计分析 |

#### 📊 监控面板

| 监控系统 | 访问地址 | 用户名 | 密码 |
|---------|---------|--------|------|
| Druid 数据监控 | http://localhost:{port}/druid | admin | admin123 |

> 💡 **提示**：将 `{port}` 替换为对应服务的端口号
> 
> 例如：
> - 系统服务 (9201)：`http://localhost:9201/druid`
> - 行政服务 (9202)：`http://localhost:9202/druid`
> - 后勤服务 (9203)：`http://localhost:9203/druid`

---

## ⚙️ 配置说明

### 数据库配置

#### 达梦数据库

各服务的 `application.yml` 已配置为使用环境变量，支持灵活部署：

```yaml
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: dm.jdbc.driver.DmDriver
    url: jdbc:dm://127.0.0.1:5236/XC-TEAM
    username: ${DM_USERNAME:SYSDBA}      # 环境变量，默认值 SYSDBA
    password: ${DM_PASSWORD:Abc123456}   # 环境变量，默认值 Abc123456
    druid:
      # 连接池配置
      initial-size: 10
      min-idle: 10
      max-active: 200
      max-wait: 60000
      # 性能监控
      stat-view-servlet:
        enabled: true
        url-pattern: /druid/*
        login-username: admin
        login-password: admin123
```

### Redis 配置

#### 数据库配置

所有微服务共享同一个 Redis Database（database: 1），通过 key 前缀区分不同服务的缓存数据：

| 服务模块 | Database | 端口 | Key 前缀示例 | 缓存内容 |
|---------|---------|------|-------------|---------|
| 🌐 **Gateway** | 1 | 8080 | `gateway:*` | 限流规则、黑名单 |
| 🔐 **Auth** | 1 | 9200 | `auth:token:*`, `auth:captcha:*` | UUID Token、验证码 |
| ⚙️ **System** | 1 | 9201 | `system:user:*`, `system:role:*` | 用户、角色、权限、菜单 |
| 📊 **Admin** | 1 | 9202 | `admin:attendance:*`, `admin:salary:*` | 考勤、薪资、合同数据 |
| 🏢 **Logistics** | 1 | 9203 | `logistics:meeting:*`, `logistics:repair:*` | 会议、报修、点餐数据 |
| 💰 **Finance** | 1 | 9204 | `finance:reimburse:*`, `finance:subsidy:*` | 报销、补助数据 |
| 📈 **Statistics** | 1 | 9205 | `statistics:*` | 统计结果缓存 |

配置示例：

```yaml
spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      database: 1  # 所有服务统一使用 database 1
      password:    # 如需密码认证
      timeout: 10s
      lettuce:
        pool:
          max-active: 8
          max-idle: 8
          min-idle: 0
          max-wait: -1ms
```

### 缓存策略

系统使用 Redis 进行数据缓存，主要缓存内容包括：

- **用户会话**：登录 Token 及用户信息
- **验证码**：图形验证码（2分钟有效期）
- **密码重置令牌**：24小时有效期
- **会议签到码**：30分钟有效期

### 认证配置

UUID Token 配置（各服务 `application.yml`）：

```yaml
# Redis 配置（用于存储 Token）
spring:
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      database: 1  # Auth 服务使用 database 1
      timeout: 10s

# Token 过期时间配置
token:
  expireTime: 720      # 普通登录过期时间（分钟，默认12小时）
  rememberMeExpireTime: 10080  # 记住我过期时间（分钟，默认7天）
```

### Nacos 配置

服务注册与配置中心：

```yaml
spring:
  cloud:
    nacos:
      # 服务注册中心
      discovery:
        server-addr: 127.0.0.1:8848
        namespace: public
        group: DEFAULT_GROUP
      # 配置中心
      config:
        server-addr: 127.0.0.1:8848
        file-extension: yml
        namespace: public
        group: DEFAULT_GROUP
```

---

## 📚 部署文档

### 🔧 生产环境配置

#### 1. 数据库优化

在 DM 数据库管理员工具中执行以下 SQL 语句进行性能优化：

```sql
-- 1. 调整内存参数（根据服务器实际内存调整）
ALTER SYSTEM SET MEMORY_TARGET = 2G;
ALTER SYSTEM SET BUFFER_POOL_SIZE = 1G;

-- 2. 优化连接数
ALTER SYSTEM SET MAX_SESSIONS = 200;

-- 3. 启用并行查询
ALTER SYSTEM SET PARALLEL_MAX_SERVERS = 8;
```

> ⚠️ **注意**：请根据实际服务器配置调整参数值

#### 2. Redis 配置

编辑 Redis 配置文件 `redis.conf`：

```conf
# 端口配置
port 6379

# 绑定地址（生产环境建议绑定内网IP）
bind 127.0.0.1

# 密码认证（强烈建议设置）
requirepass your_strong_password

# 内存限制
maxmemory 1gb

# 内存淘汰策略
maxmemory-policy allkeys-lru

# 持久化配置
save 900 1
save 300 10
save 60 10000
```

> ⚠️ **安全提示**：生产环境务必设置强密码并配置防火墙规则

#### 3. Nginx 反向代理

```nginx
# /etc/nginx/sites-available/sc-dims
server {
    listen 80;
    server_name your-domain.com;
    
    # 前端静态资源
    location / {
        root /var/www/sc-dims-frontend;
        try_files $uri $uri/ /index.html;
    }
    
    # API 代理 - 所有后端服务通过网关转发
    location ~ ^/(auth|admin|finance|logistics|statistics|system|common)/ {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    
    # 文件上传大小限制
    client_max_body_size 100M;
}
```

---

## 💻 开发指南

### 项目结构

后端服务标准目录结构：

```
sc-dims-{module}/
├── src/main/java/com/scdims/{module}/
│   ├── controller/              # 控制器层
│   │   └── *Controller.java    # RESTful API 接口
│   ├── service/                 # 服务层
│   │   ├── I*Service.java      # 服务接口
│   │   └── impl/               # 服务实现
│   │       └── *ServiceImpl.java
│   ├── mapper/                  # 数据访问层
│   │   └── *Mapper.java        # MyBatis Mapper 接口
│   ├── model/                   # 数据模型
│   │   ├── entity/             # 实体类（对应数据库表）
│   │   ├── dto/                # 数据传输对象
│   │   └── vo/                 # 视图对象
│   ├── config/                  # 配置类（部分服务）
│   └── {Module}Application.java # 启动类
├── src/main/resources/
│   ├── application.yml          # 配置文件
│   └── mapper/                  # MyBatis XML 映射文件
│       └── *.xml
└── pom.xml                      # Maven 配置
```

### 代码规范

#### 后端规范

- ✅ 遵循《阿里巴巴 Java 开发手册》
- ✅ 使用 Lombok 简化实体类
- ✅ Controller 层只做参数校验和调用 Service
- ✅ Service 层处理业务逻辑
- ✅ 异常统一处理，返回标准格式
- ✅ 使用 MyBatis-Plus 进行数据访问
- ✅ 实体类统一继承 BaseEntity

#### 前端规范

- ✅ 遵循 Vue.js 官方风格指南
- ✅ 使用 TypeScript 类型系统
- ✅ 组件命名采用 PascalCase
- ✅ 使用 Composition API
- ✅ 统一使用 Element Plus 组件
- ✅ 路由懒加载优化性能

### 接口规范

#### RESTful API 设计

| 方法 | 路径示例 | 说明 |
|------|---------|------|
| GET | `/system/user/list` | 获取用户列表 |
| GET | `/system/user/{id}` | 获取单个用户 |
| POST | `/system/user` | 创建用户 |
| PUT | `/system/user` | 更新用户 |
| DELETE | `/system/user/{id}` | 删除用户 |

#### 统一返回格式

```json
{
  "code": 200,
  "message": "操作成功",
  "data": {},
  "timestamp": 1234567890
}
```

**状态码说明：**
- `200` - 成功
- `400` - 请求参数错误
- `401` - 未认证
- `403` - 无权限
- `404` - 资源不存在
- `500` - 服务器错误

### 数据库规范

| 规范类型 | 说明 |
|---------|------|
| **命名规范** | 表名、字段名使用小写+下划线 |
| **主键** | 统一使用 `id`，类型 BIGINT |
| **时间字段** | `create_time`、`update_time` |
| **逻辑删除** | 使用 `deleted` 字段（0-未删除，1-已删除） |
| **索引策略** | 根据查询频率建立合适索引 |
| **注释** | 表和字段必须有中文注释 |

---

## 📝 项目文档

| 文档名称 | 路径 | 说明 |
|---------|------|------|
| 项目说明 | `README.md` | 项目介绍、快速开始、开发指南 |
| 任务分配 | `项目要求+任务分配.md` | 功能需求和团队分工 |
| 数据库设计 | `database/*.sql` | 数据库表结构和初始化脚本 |

---

<div style="text-align: center;">

---

## 🌟 致谢

感谢所有为本项目做出贡献的开发者！

特别感谢使用本系统的各位用户和提供宝贵意见的朋友们！

---

## 📚 快速导航

[⬆️ 返回顶部](#交管对接信息化管理系统) • 
[🚀 快速开始](#-快速开始) • 
[📖 开发指南](#-开发指南)

---

## 📄 开源协议

本项目采用 **MIT License** 开源协议

任何人都可以自由使用、修改和分发本项目代码

---

## 📬 联系方式

如有问题或建议，欢迎联系开发团队

- 📧 邮件：联系项目负责人
- 💬 讨论：提交 Issue 或 Pull Request
- 📝 文档：查看项目 Wiki

---

<br>

<p>
  <strong>交管对接信息化管理系统</strong><br>
  <em>基于 Spring Cloud 微服务架构的企业级管理平台</em>
</p>

<br>

<p>
  Made with ❤️ by SC-DIMS Team
</p>

<br>

<p>
  <img src="https://img.shields.io/badge/version-1.0.0-blue.svg" alt="Version"/>
  <img src="https://img.shields.io/badge/status-active-success.svg" alt="Status"/>
  <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"/>
</p>

<p>
  © 2025-2026 SC-DIMS 开发团队 • All Rights Reserved
</p>

<br>

</div>