# God

**Repository Path**: await29/god-g

## Basic Information

- **Project Name**: God
- **Description**: GodApi是一个基于.NET 9和React的现代化API管理系统，采用领域驱动设计(DDD)架构，提供灵活的动态路由管理、多媒体内容分发、访问控制、数据分析等功能。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 14
- **Forks**: 4
- **Created**: 2025-03-20
- **Last Updated**: 2025-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GodApi - 企业级全栈Web应用平台

<div align="center">
  <h3>🚀 基于 .NET 9.0 + React 19.1.0 的现代化Web应用</h3>
  <p>采用领域驱动设计(DDD)架构 | 支持多数据库 | 企业级安全特性</p>
</div>

---

## 📋 项目概述

GodApi 是一个企业级的全栈Web应用平台，旨在提供统一的API管理和内容分发服务。采用前后端分离架构，基于领域驱动设计(DDD)模式，提供高性能、高可用、易扩展的企业级解决方案。

### 🎯 核心特性

- **🏗️ DDD架构设计** - 采用四层架构，清晰的职责分离
- **🔐 企业级安全** - JWT认证、OAuth集成、IP访问控制、速率限制
- **🗄️ 多数据库支持** - SQLite、SQL Server、PostgreSQL、MySQL
- **📊 实时监控** - 系统性能监控、用户行为分析、业务指标追踪
- **🐳 容器化部署** - Docker支持，一键部署
- **📱 响应式设计** - 支持桌面端和移动端

### 💼 业务场景

- **API统一管理** - 提供统一的API接入点和管理界面
- **内容智能分发** - 支持多种内容类型的存储、分类和推荐
- **用户权限控制** - 细粒度的权限管理和VIP订阅体系
- **数据分析洞察** - 实时的业务数据分析和决策支持

## 🛠️ 技术栈

### 后端技术
- **.NET 9.0** - 核心框架
- **ASP.NET Core** - Web API框架
- **Entity Framework Core 9.0.3** - ORM框架
- **AutoMapper 14.0.0** - 对象映射
- **FluentValidation 11.11.0** - 数据验证
- **JWT Bearer** - 身份认证
- **Swagger/OpenAPI** - API文档

### 前端技术
- **React 19.1.0** - 核心UI库
- **TypeScript 5.8.2** - 类型安全
- **Vite 5.4.17** - 构建工具
- **Ant Design 5.24.6** - UI组件库
- **Zustand 4.5.6** - 状态管理
- **React Router 6.30.0** - 路由管理
- **Axios 1.8.4** - HTTP客户端

### 数据库支持
- **SQLite** (默认) - 轻量级开发数据库
- **SQL Server** - 企业级生产数据库
- **PostgreSQL** - 开源高性能数据库
- **MySQL** - 传统关系型数据库

## 🚀 快速开始

### 环境要求

- **Node.js** 18.0+ 
- **.NET** 9.0 SDK
- **Docker** (可选，推荐)
- **Git**

### 📦 获取代码

```bash
# 克隆项目
git clone <repository-url>
cd god-g

# 安装前端依赖
cd frontend
npm ci --legacy-peer-deps
cd ..

# 恢复后端依赖
dotnet restore
```

### 🔧 开发环境启动

#### 方式一：传统开发模式

```bash
# 启动后端服务 (终端1)
dotnet run --project src/GodApi.Api

# 启动前端服务 (终端2)
cd frontend
npm run dev
```

#### 方式二：Docker开发模式

```bash
# 构建并启动完整应用
docker build -t godapi:latest .
docker run -p 5101:80 godapi:latest
```

### 📱 访问应用

- **前端应用**: http://localhost:3000 (开发模式) / http://localhost:5101 (Docker模式)
- **后端API**: http://localhost:5101/api
- **API文档**: http://localhost:5101/swagger

### 🔑 默认账户

- **管理员**: `admin` / `Admin123!`

## 📚 文档导航

### 🎯 按角色快速导航

| 角色 | 推荐文档路径 | 说明 |
|-----|------------|------|
| **新开发者** | [快速入门](docs-cn/02-快速入门/) → [项目概述](docs-cn/01-项目概述/) | 快速上手项目开发 |
| **前端开发** | [前端开发](docs-cn/05-前端开发/) → [技术架构](docs-cn/03-技术架构/前端架构.md) | React + TypeScript 开发指导 |
| **后端开发** | [后端开发](docs-cn/06-后端开发/) → [技术架构](docs-cn/03-技术架构/后端架构.md) | .NET Core + DDD 开发指导 |
| **运维工程师** | [部署运维](docs-cn/08-部署运维/) → [工作流程](docs-cn/09-工作流程/) | Docker 部署和监控指导 |
| **项目经理** | [项目概述](docs-cn/01-项目概述/) → [工作流程](docs-cn/09-工作流程/) | 项目管理和流程规范 |

### 📖 完整文档目录

- **📋 [01-项目概述](docs-cn/01-项目概述/)** - 项目背景、技术栈、团队角色
- **🚀 [02-快速入门](docs-cn/02-快速入门/)** - 环境搭建、项目启动、开发工具
- **🏗️ [03-技术架构](docs-cn/03-技术架构/)** - DDD架构、前后端设计、数据库架构
- **📋 [04-开发规范](docs-cn/04-开发规范/)** - 编码规范、命名约定、代码审查
- **🎨 [05-前端开发](docs-cn/05-前端开发/)** - React 开发、TypeScript、状态管理
- **⚙️ [06-后端开发](docs-cn/06-后端开发/)** - .NET Core、API 设计、数据访问
- **🗄️ [07-数据库](docs-cn/07-数据库/)** - EF Core、数据库迁移、性能优化
- **🐳 [08-部署运维](docs-cn/08-部署运维/)** - Docker 部署、监控告警、故障排查
- **🔄 [09-工作流程](docs-cn/09-工作流程/)** - 开发流程、Git 工作流、质量保证

## 🔧 开发命令速查

### 后端开发
```bash
# 构建项目
dotnet build

# 运行API服务
dotnet run --project src/GodApi.Api

# 运行测试
dotnet test

# 数据库迁移
dotnet ef migrations add <MigrationName> --project src/Infrastructure --startup-project src/GodApi.Api
dotnet ef database update --project src/Infrastructure --startup-project src/GodApi.Api
```

### 前端开发
```bash
# 开发服务器
npm run dev

# 构建生产版本
npm run build

# 代码检查
npm run lint

# 类型检查
npm run typecheck

# 运行测试
npm run test
```

### Docker操作
```bash
# 构建镜像
docker build -t godapi:latest .

# 运行容器
docker run -d --name godapi-container -p 5101:80 godapi:latest

# 查看日志
docker logs godapi-container
```

## 🏗️ 项目结构

```
god-g/
├── src/                          # 后端源码
│   ├── Domain/                   # 领域层 - 业务逻辑和规则
│   ├── Application/              # 应用层 - 用例和服务
│   ├── Infrastructure/           # 基础设施层 - 数据访问和外部服务
│   └── GodApi.Api/              # API层 - 控制器和中间件
├── frontend/                     # 前端源码
│   ├── src/
│   │   ├── components/          # React组件
│   │   ├── pages/               # 页面组件
│   │   ├── services/            # API服务
│   │   ├── types/               # TypeScript类型定义
│   │   └── store/               # 状态管理
│   └── dist/                    # 构建输出
├── docs-cn/                     # 中文技术文档
└── docs/                        # 英文技术文档
```

## 🤝 贡献指南

我们欢迎各种形式的贡献！请参考以下指南：

1. **代码贡献** - 遵循[开发规范](docs-cn/04-开发规范/)和[Git工作流](docs-cn/09-工作流程/Git工作流.md)
2. **问题报告** - 使用 GitHub Issues 报告 Bug 或提出新功能建议
3. **文档改进** - 帮助完善和更新技术文档
4. **代码审查** - 参与代码审查，提供建设性反馈

## 📞 支持与反馈

- **技术文档**: [中文文档](docs-cn/) | [English Docs](CLAUDE.md)
- **问题反馈**: GitHub Issues
- **技术交流**: 项目讨论区

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE)。

---

<div align="center">
  <p>🌟 如果这个项目对您有帮助，请考虑给个 Star ⭐</p>
  <p>📖 第一次使用？建议从 <a href="docs-cn/01-项目概述/项目介绍.md">项目介绍</a> 开始阅读</p>
</div>