# CoreManager

**Repository Path**: chengtao98/core-manager

## Basic Information

- **Project Name**: CoreManager
- **Description**: 🎯 一个基于 .NET 8 + React 18 + TypeScript 构建的现代化企业级后台管理系统。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-09-03
- **Last Updated**: 2025-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Csharp, React, uni-app

## README

# CoreManager - 后台管理系统

一个基于 C# .NET Core 和 React 构建的现代化后台管理系统。

## 🚀 技术栈

### 后端技术栈
- **框架**: ASP.NET Core 8.0
- **数据库**: MySQL
- **ORM**: SqlSugar
- **身份验证**: JWT (JSON Web Tokens)
- **API文档**: Swagger/OpenAPI
- **缓存**: Redis
- **日志**: Serilog
- **依赖注入**: Autofac
- **数据验证**: FluentValidation
- **消息队列**: Kafka (可选)
- **单元测试**: xUnit

### 前端技术栈
- **框架**: React 18+
- **语言**: TypeScript
- **状态管理**: Redux Toolkit
- **UI组件库**: Ant Design 
- **路由**: React Router
- **HTTP客户端**: Axios
- **构建工具**: Vite / Create React App
- **样式**: CSS Modules / Styled Components
- **表单处理**: React Hook Form
- **图表**: ECharts / Chart.js

### 移动端技术栈
- **跨平台框架**: UniApp
- **开发语言**: Vue 3 + TypeScript
- **UI组件库**: uni-ui / uView UI
- **状态管理**: Pinia / Vuex
- **HTTP客户端**: uni.request (Axios适配)
- **构建工具**: Vite + UniApp CLI
- **样式**: SCSS / Less
- **图表**: uCharts / ECharts
- **多端支持**: 微信小程序、支付宝小程序、H5、App(iOS/Android)
- **原生插件**: UniApp插件市场
- **推送服务**: UniPush
- **地图服务**: 高德地图/百度地图
- **支付集成**: 微信支付/支付宝支付

## 📋 功能特性

### 核心功能
- 🔐 **用户认证与授权**: 安全的身份验证系统
- 👥 **用户管理**: 完整的用户CRUD操作
- 🛡️ **角色权限管理**: 基于角色的访问控制
- 📊 **数据统计面板**: 实时数据可视化
- 📝 **内容管理**: 支持富文本编辑
- 🔍 **高级搜索与筛选**: 强大的查询功能
- 📋 **操作日志**: 完整的用户行为记录
- 🔔 **消息通知**: 实时推送和站内信

### 多端特性
- 💻 **Web端**: 响应式设计，支持PC和平板
- 📱 **移动端**: UniApp跨平台支持
- 🏪 **小程序**: 微信/支付宝小程序
- 📲 **原生App**: iOS/Android应用
- 🌐 **国际化**: 多语言支持

## 🛠️ 环境要求

### 后端要求
- .NET 8.0 SDK
-  MySQL 8.0+ /SQL Server 2019+
- Redis 6.0+ (可选)
- Visual Studio 2022 / Rider/ VSCode

### 前端要求
- Node.js 18+
- npm 9+ / yarn 1.22+
- 现代浏览器 (Chrome 90+, Firefox 88+, Safari 14+)

### 移动端要求
- **Node.js**: 18+ LTS
- **UniApp CLI**: `npm install -g @dcloudio/uvm`
- **HBuilderX**: 官方推荐IDE (可选)
- **微信开发者工具**: 用于小程序调试
- **支付宝小程序开发者工具**: 用于支付宝小程序调试
- **Android Studio**: Android App开发 (可选)
- **Xcode**: iOS App开发 (仅Mac, 可选)

## 🚀 快速开始

### 后端启动

1. **克隆项目**
```bash
git clone <repository-url>
cd CoreManager
```

2. **配置数据库连接**
```bash
# 编辑 appsettings.json
{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=CoreManagerDB;Trusted_Connection=true;"
  }
}
```

3. **安装依赖并运行迁移**
```bash
dotnet restore
dotnet ef database update
```

4. **启动后端服务**
```bash
dotnet run --project CoreManager.API
```

后端API将在 `https://localhost:7001` 启动

### 前端启动 (React)

1. **进入前端目录**
```bash
cd frontend
```

2. **安装依赖**
```bash
npm install
# 或
yarn install
```

3. **配置API地址**
```bash
# 编辑 .env.local
REACT_APP_API_URL=https://localhost:7001/api
```

4. **启动前端服务**
```bash
npm start
# 或
yarn start
```

前端应用将在 `http://localhost:3000` 启动

### 移动端启动 (UniApp)

1. **创建UniApp项目**
```bash
# 使用HBuilderX创建项目，或使用CLI
npx @dcloudio/uvm create uniapp-mobile
cd uniapp-mobile
```

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

3. **配置API接口**
```javascript
// 在 common/config.js 中配置
export const config = {
  baseUrl: 'https://localhost:7001',
  // 其他配置...
}
```

4. **运行到不同平台**
```bash
# H5
npm run dev:h5

# 微信小程序 (需要微信开发者工具)
npm run dev:mp-weixin

# 支付宝小程序
npm run dev:mp-alipay

# App (需要HBuilderX)
# 在HBuilderX中运行到手机或模拟器
```

## 📁 项目结构

```
CoreManager/
├── server/                    # 后端项目
│   ├── CoreManager.API/       # Web API 项目
│   ├── CoreManager.Core/      # 核心业务逻辑
│   ├── CoreManager.Data/      # 数据访问层
│   ├── CoreManager.Models/    # 数据模型
│   ├── CoreManager.Services/  # 业务服务
│   └── CoreManager.Tests/     # 单元测试
├── admin/                  # React前端项目
│   ├── public/               # 静态资源
│   ├── src/                  # 源代码
│   │   ├── components/       # 公共组件
│   │   ├── pages/           # 页面组件
│   │   ├── services/        # API服务
│   │   ├── store/           # 状态管理
│   │   ├── utils/           # 工具函数
│   │   └── types/           # TypeScript类型
│   ├── package.json
│   └── tsconfig.json
├── uniapp-mobile/            # UniApp移动端项目
│   ├── pages/               # 页面文件
│   ├── components/          # 公共组件
│   ├── static/              # 静态资源
│   ├── common/              # 公共文件
│   │   ├── api/             # API接口
│   │   ├── config/          # 配置文件
│   │   ├── utils/           # 工具函数
│   │   └── store/           # 状态管理
│   ├── uni_modules/         # uni插件
│   ├── pages.json           # 页面路由配置
│   ├── manifest.json        # 应用配置
│   ├── App.vue              # 应用入口
│   ├── main.js              # 入口文件
│   └── package.json
├── docs/                    # 文档
├── docker-compose.yml       # Docker配置
└── README.md
```

## 📚 开发指南

### 移动端开发 (UniApp)

#### 1. API请求封装
```javascript
// common/api/request.js
const baseUrl = 'https://localhost:7001'

export const request = (options) => {
  return new Promise((resolve, reject) => {
    uni.request({
      url: baseUrl + options.url,
      method: options.method || 'GET',
      data: options.data || {},
      header: {
        'Authorization': 'Bearer ' + uni.getStorageSync('token'),
        'Content-Type': 'application/json',
        ...options.header
      },
      success: (res) => {
        if (res.statusCode === 200) {
          resolve(res.data)
        } else {
          reject(res)
        }
      },
      fail: reject
    })
  })
}
```

#### 2. 用户认证
```javascript
// common/api/auth.js
import { request } from './request.js'

export const login = (data) => {
  return request({
    url: '/api/auth/login',
    method: 'POST',
    data
  })
}

export const getUserInfo = () => {
  return request({
    url: '/api/user/profile',
    method: 'GET'
  })
}
```

#### 3. 状态管理 (Pinia)
```javascript
// common/store/user.js
import { defineStore } from 'pinia'

export const useUserStore = defineStore('user', {
  state: () => ({
    token: uni.getStorageSync('token') || '',
    userInfo: {}
  }),
  
  actions: {
    setToken(token) {
      this.token = token
      uni.setStorageSync('token', token)
    },
    
    setUserInfo(userInfo) {
      this.userInfo = userInfo
    }
  }
})
```

#### 4. 多端适配
```javascript
// common/utils/platform.js
export const getPlatform = () => {
  // #ifdef H5
  return 'h5'
  // #endif
  
  // #ifdef MP-WEIXIN
  return 'weixin'
  // #endif
  
  // #ifdef APP-PLUS
  return 'app'
  // #endif
}
```

## 🐳 Docker 部署

1. **构建并启动服务**
```bash
docker-compose up -d
```

2. **访问应用**
- 前端: http://localhost:3000
- 后端API: http://localhost:8000
- Swagger文档: http://localhost:8000/swagger