Compare commits
5 Commits
4b39b2c425
...
9612645071
| Author | SHA1 | Date |
|---|---|---|
zhaozhenjing
|
9612645071 | 2 months ago |
|
zhaozhenjing
|
c384f24cc1 | 2 months ago |
|
zhaozhenjing
|
a40f4beea1 | 2 months ago |
|
zhaozhenjing
|
5ee99b0d21 | 2 months ago |
|
zhaozhenjing
|
1d2253a523 | 2 months ago |
26 changed files with 643 additions and 84 deletions
@ -1,3 +1,159 @@
|
||||
# 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） |
||||
@ -0,0 +1,64 @@
|
||||
using System; |
||||
using System.Collections.Generic; |
||||
using System.ComponentModel; |
||||
using System.Linq; |
||||
using System.Text; |
||||
using System.Threading.Tasks; |
||||
|
||||
namespace ATS.NonCustodial.Application.Contracts.Interfaces.Business.ViolationStatistics.Output |
||||
{ |
||||
public class ViolationExportDto |
||||
{ |
||||
/// <summary> |
||||
/// 案件Id |
||||
/// </summary> |
||||
public long CaseId { get; set; } |
||||
|
||||
/// <summary> |
||||
/// 案件名称 |
||||
/// </summary> |
||||
[DisplayName("案件名称")] |
||||
public string? CaseName { get; set; } |
||||
|
||||
/// <summary> |
||||
/// 被监管人Id |
||||
/// </summary> |
||||
public long SupervisedPersonId { get; set; } |
||||
|
||||
/// <summary> |
||||
/// 被监管人员 |
||||
/// </summary> |
||||
[DisplayName("被监管人员")] |
||||
public string? SupervisedPersonName { get; set; } |
||||
/// <summary> |
||||
/// 部门受案号 |
||||
/// </summary> |
||||
[DisplayName("部门受案号")] |
||||
public string? Bmsah { get; set; } |
||||
|
||||
/// <summary> |
||||
/// 监督单位 |
||||
/// </summary> |
||||
[DisplayName("监督单位")] |
||||
public string? SupervisionUnit { get; set; } |
||||
|
||||
|
||||
/// <summary> |
||||
/// 案件类型 |
||||
/// </summary> |
||||
[DisplayName("案件类型")] |
||||
public string? CaseTypeName { get; set; } |
||||
|
||||
|
||||
/// <summary> |
||||
/// 违规越界次数 |
||||
/// </summary> |
||||
[DisplayName("违规越界次数")] |
||||
public int ViolationCount { get; set; } |
||||
/// <summary> |
||||
/// 案件创建日期 |
||||
/// </summary> |
||||
[DisplayName("案件创建日期")] |
||||
public DateTime? CreatedTime { get; set; } |
||||
} |
||||
} |
||||
Loading…
Reference in new issue