【限时免费】 Admin.NET 通用权限开发框架技术文档

1. 安装指南

1.1 环境要求

• 操作系统：Windows/Linux/麒麟操作系统
• 数据库：支持多种数据库（SQL Server/MySQL/PostgreSQL/Oracle等）
• 开发环境：
  • .NET 6 SDK
  • Node.js 16+
  • pnpm 包管理工具

1.2 后端安装

1. 克隆项目仓库：

git clone https://gitee.com/zuohuaijun/Admin.NET.git

2. 修改数据库配置：

• 打开Admin.NET.Web/appsettings.json文件
• 修改ConnectionStrings节点下的数据库连接字符串

3. 自动生成数据库：

• 运行项目后会自动创建数据库并初始化种子数据

2. 项目使用说明

2.1 前端运行

1. 安装依赖：

cd Web
pnpm install

2. 开发模式运行：

pnpm run dev

3. 生产环境构建：

pnpm run build

2.2 登录系统

• 默认管理员账号：superadmin
• 默认密码：Admin.NET++010101

2.3 主要功能模块

1. 系统管理：包含用户、角色、菜单、机构等基础权限管理
2. 系统监控：包含操作日志、访问日志、服务监控等
3. 系统工具：包含代码生成、在线构建器等开发辅助工具
4. 扩展功能：包含文件管理、任务调度、邮件短信等业务功能

3. 项目API使用文档

3.1 API基础信息

• 采用RESTful风格设计
• 使用JWT进行身份认证
• 集成Swagger UI文档

3.2 认证方式

1. 获取Token：

POST /api/auth/login
Content-Type: application/json

{
  "account": "superadmin",
  "password": "Admin.NET++010101"
}

2. 使用Token：

GET /api/system/user
Authorization: Bearer {your_token}

3.3 常用API示例

1. 获取用户列表：

GET /api/system/user/page?pageNo=1&pageSize=10

2. 创建用户：

POST /api/system/user
Content-Type: application/json

{
  "account": "testuser",
  "password": "123456",
  "name": "测试用户",
  "roleId": 1
}

4. 项目安装方式

4.1 开发环境安装

1. 安装Visual Studio 2022或Rider
2. 安装.NET 6 SDK
3. 安装Node.js和pnpm
4. 克隆项目并配置数据库连接
5. 运行后端项目（自动创建数据库）
6. 运行前端项目

4.2 生产环境部署

1. 后端部署：

   • 发布项目到IIS或使用Kestrel自托管
   • 配置Nginx反向代理（可选）

2. 前端部署：

   • 执行pnpm run build生成静态文件
   • 部署到Nginx或IIS

4.3 数据库支持

项目支持多种数据库，通过修改配置即可切换：

• SQL Server
• MySQL
• PostgreSQL
• Oracle
• SQLite

修改appsettings.json中的数据库连接字符串即可实现数据库切换。