# ElectricDDD

**Repository Path**: YFKael/electric-ddd

## Basic Information

- **Project Name**: ElectricDDD
- **Description**: No description available
- **Primary Language**: C#
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-04
- **Last Updated**: 2025-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ElectricDDD

ElectricDDD 是一个基于领域驱动设计（DDD）的项目模板，旨在为开发者提供一套结构清晰、易于扩展的基础架构。该项目适用于构建现代化的 Web 应用程序，并集成了身份验证、权限管理、审计日志等常见功能模块。

## 技术栈

- **后端**：使用 C# 编写的 .NET Core 应用程序，采用 DDD 架构模式。
- **前端**：基于 Vue.js 的前端框架，提供用户界面交互。
- **数据库**：支持 Entity Framework Core 和 SqlSugarCore 两种 ORM 框架，可灵活切换。
- **身份验证与授权**：集成 JWT 认证机制，支持角色和权限管理。
- **日志记录**：通过审计日志功能记录用户操作和系统行为。

## 主要功能模块

- **账户管理**：包括账户信息、权限分配、密码更新等功能。
- **权限管理**：支持权限的创建、更新、删除和查询。
- **角色管理**：角色的创建、更新、删除以及权限分配。
- **用户管理**：用户注册、更新、删除及角色分配。
- **审计日志**：记录系统操作日志，支持按时间、IP、用户等条件进行筛选。

## 安装与部署

### 后端

1. 克隆仓库：
   ```bash
   git clone https://gitee.com/YFKael/electric-ddd.git
   ```

2. 进入项目目录：
   ```bash
   cd electric-ddd
   ```

3. 安装依赖并运行：
   - 使用 .NET CLI：
     ```bash
     dotnet restore
     dotnet run --project src/Electric.Application/Electric.Application.csproj
     ```

4. 数据库迁移（如使用 EF Core）：
   ```bash
   dotnet ef database update
   ```

### 前端

1. 进入前端目录：
   ```bash
   cd src/Electric.Web
   ```

2. 安装依赖：
   ```bash
   npm install
   ```

3. 启动开发服务器：
   ```bash
   npm run dev
   ```

4. 构建生产环境代码：
   ```bash
   npm run build
   ```

## 使用说明

- **身份验证**：通过 `/api/auth/login` 接口进行登录，获取 JWT Token。
- **权限控制**：使用 `[EletricAuthorize]` 特性对控制器或方法进行权限限制。
- **审计日志**：通过 `AuditLogAttribute` 自动记录接口调用日志。
- **数据访问**：使用统一的仓储接口（`IBasicRepository`）进行数据库操作。

## 贡献指南

欢迎贡献代码和建议！请遵循以下步骤：

1. Fork 本项目。
2. 创建新分支（`git checkout -b feature/new-feature`）。
3. 提交更改（`git commit -am 'Add new feature'`）。
4. 推送分支（`git push origin feature/new-feature`）。
5. 创建 Pull Request。

## 许可证

本项目采用 MIT 许可证。详情请参阅 [LICENSE](LICENSE) 文件。

## 联系方式

如有问题或建议，请提交 Issue 或联系作者。

---

ElectricDDD 提供了一个良好的起点，帮助开发者快速构建符合 DDD 原则的企业级应用。欢迎使用并参与社区建设！