# NonDetainmentSoft

非羁押人员管理系统

## 1. 项目概述
ATS.NonCustodial.Admin 是一个基于 .NET 9.0 开发的后端管理系统，主要用于非监禁人员管理业务，提供案件管理、业务申请、设备管理等功能模块。系统采用分层架构设计，具有良好的扩展性和可维护性。

## 2. 技术栈
- 开发框架 ：.NET 9.0
- ORM框架 ：Entity Framework Core 9.0.8
- 数据库 ：MySQL
- 身份认证 ：JWT / IdentityServer4
- 依赖注入 ：Autofac
- 实时通信 ：SignalR
- 任务调度 ：Quartz
- API文档 ：Swagger
- 缓存 ：Redis
- 日志 ：Serilog
- 数据映射 ：AutoMapper
## 3. 项目架构
项目采用典型的分层架构设计，各层职责明确：

```
src/
├── 1.datas/                # 数据层
│   ├── ATS.NonCustodial.DbMigrations/      # 数据库迁移
│   ├── ATS.NonCustodial.Domain/            # 领域模型
│   └── ATS.NonCustodial.EntityFrameworkCore/ # EF Core 实现
├── 2.services/             # 业务服务层
│   └── ATS.NonCustodial.Application/        # 应用服务实现
├── 3.contracts/            # 接口层
│   └── ATS.NonCustodial.Application.Contracts/ # 服务接口定义
├── 4.apps/                 # 应用层
│   └── ATS.NonCustodial.Admin.Api/          # Web API 应用
└── 5.shared/               # 共享层
    ├── ATS.NonCustodial.Admin.Jobs/         # 定时任务
    ├── ATS.NonCustodial.AdminUi/            # 管理UI组件
    ├── ATS.NonCustodial.AuditLogging/       # 审计日志
    ├── ATS.NonCustodial.Domain.Shared/      # 领域共享
    ├── ATS.NonCustodial.DynamicApi/         # 动态API
    └── ATS.NonCustodial.Shared/             # 通用工具
```

## 4. 核心模块
### 4.1 案件管理模块
负责非监禁人员案件的创建、查询、更新和删除，包含案件信息、监管人员和被监管人员管理。

主要实体：

- AppCaseManagement ：案件管理实体
- AppCaseSupervisor ：监管人员实体
- AppCaseSupervisedPerson ：被监管人员实体
### 4.2 业务申请模块
处理被监管人员的各类业务申请，如请假、外出活动等，包含申请提交、审核、统计等功能。

主要服务：

- AppBusinessApplicationService ：业务申请服务
- 提供申请创建、查询、审核、统计等功能
### 4.3 设备管理模块
管理与被监管人员关联的电子设备，如定位设备等。

主要服务：

- AppDeviceManagementService ：设备管理服务
### 4.4 用户权限管理
处理系统用户、角色和权限的管理。

主要服务：

- RoleService ：角色管理服务
- UserService ：用户管理服务
### 4.5 文件管理模块
提供文件上传、下载、管理功能，支持多种文件类型。

主要配置：

- UploadConfigConfiguration ：文件上传配置，支持头像、图片、资料等类型
## 5. 系统配置
### 5.1 数据库配置
系统使用 MySQL 数据库，配置位于 appsettings.json 的 ConnectionStringsConfiguration 节点：

```
"ConnectionStringsConfiguration": {
  "AdminAuditLogDbConnection": "Server=localhost;database=fsl_cs;uid=root;pwd=sa@admin;...",
  "AdminDbConnection": "Server=localhost;database=fsl_cs;uid=root;pwd=sa@admin;..."
},
"DatabaseProviderConfiguration": {
  "ProviderType": "MySql"
}
```

### 5.2 身份认证配置
支持 JWT 和 IdentityServer4 两种认证方式，JWT 配置如下：

```
"JwtConfiguration": {
  "Issuer": "http://127.0.0.1:8006",
  "Audience": "http://127.0.0.1:8006",
  "SymmetricSecurityKey": "ertJKl#521*a@790asD&1#0123456789",
  "Expires": 1440,
  "RefreshTokenExpires": 1440
}
```

### 5.3 文件上传配置
定义了多种文件类型的上传规则：

```
"UploadConfigConfiguration": {
  "Avatar": {
    "UploadPath": "../upload/admin/avatar",
    "RequestPath": "/upload/admin/avatar",
    "MaxSize": 1048576
  },
  "Image": {
    "UploadPath": "../upload/admin/image",
    "RequestPath": "/upload/admin/image",
    "MaxSize": 10485760
  },
  "MaterialManager": {
    "UploadPath": "../upload/admin/materials",
    "RequestPath": "/upload/admin/materials"
  }
}
```

## 6. 服务启动流程
1. 入口点 ： Program.cs 调用 HostApp.Run() 方法启动服务
2. 配置加载 ：通过 ConfigHelper 加载配置文件
3. 依赖注入 ：使用 Autofac 注册服务组件
4. 数据库初始化 ：应用数据库迁移和种子数据
5. 中间件配置 ：配置认证授权、CORS、路由等中间件
6. 服务运行 ：启动 Web 服务器和 SignalR 服务
## 7. 关键特性
### 7.1 动态 API
使用自定义的 DynamicApi 属性自动生成 API 接口，简化开发流程。

### 7.2 实时通信
通过 SignalR 实现监管人员和系统之间的实时消息推送和通知。

### 7.3 审计日志
系统内置审计日志功能，记录用户操作和系统事件。

### 7.4 定时任务
使用 Quartz 框架实现系统定时任务，如数据同步、状态更新等。

### 7.5 多数据库支持
通过 EF Core 支持多种数据库，当前使用 MySQL。

## 8. 部署配置
系统支持 Docker 容器化部署，提供了 Dockerfile 用于构建镜像。默认监听端口为 8006。

## 9. 安全措施
- JWT/IdentityServer4 身份认证
- 基于角色的访问控制
- 输入验证和防注入
- CORS 跨域配置
- 请求限流（使用 AspNetCoreRateLimit）