# Microservice

**Repository Path**: cplmlm/microservice

## Basic Information

- **Project Name**: Microservice
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Microservice 微服务项目

基于 .NET 8 的微服务架构演示项目，包含购物车服务、认证中心和管理后台。

## 项目简介

Microservice 是一个完整的微服务架构演示系统，采用现代化的技术栈构建，旨在展示微服务架构的最佳实践。项目包含以下核心服务：

- **Cart.API** - 购物车服务，提供购物车的增删改查操作
- **IDS4.AuthCenter** - 基于 IdentityServer4 的认证授权中心
- **Microservice.Web** - 用户管理后台前端应用
- **Microservice.AppHost** - 应用主机/网关入口

## 技术栈

- **后端框架**: .NET 8 / ASP.NET Core
- **数据库**: SQL Server (使用 Entity Framework Core)
- **缓存**: Redis (分布式缓存)
- **身份认证**: IdentityServer4
- **前端框架**: ASP.NET Core MVC + Bootstrap 5
- **日志**: Serilog
- **容器化**: Docker

## 项目结构

```
├── Cart.API/                    # 购物车 API 服务
│   ├── Controllers/             # API 控制器
│   ├── Data/                   # 数据库上下文和迁移
│   ├── Helper/                 # 辅助工具类
│   ├── Models/                  # 数据模型
│   └── Services/               # 业务服务层
│
├── IDS4.AuthCenter/            # 认证授权中心
│   ├── Controllers/            # 账户控制器
│   ├── Data/                   # 数据库和迁移
│   ├── Models/                 # 视图模型
│   ├── Views/                  # 登录页面视图
│   └── wwwroot/                # 静态资源
│
├── Microservice.AppHost/        # 应用主机
│
└── Microservice.Web/            # 管理后台前端
    ├── Controllers/            # MVC 控制器
    ├── Helper/                 # 服务辅助类
    ├── Models/                 # 视图模型
    └── Views/                  # 前端视图
```

## 功能特性

### 购物车服务 (Cart.API)

- 获取购物车内容
- 添加商品到购物车
- 更新购物车商品数量
- 删除购物车商品
- 清空购物车
- 结算下单

### 认证服务 (IDS4.AuthCenter)

- 用户登录/登出
- OAuth 2.0 / OpenID Connect 协议支持
- JWT Token 颁发
- 多种客户端支持（MVC、Web API）

### 管理后台 (Microservice.Web)

- 商品浏览与搜索
- 购物车管理
- 订单查看与支付
- 用户仪表盘

## 快速开始

### 环境要求

- .NET 8 SDK
- SQL Server
- Redis
- Docker (可选)

### 配置说明

在各项目的 `appsettings.json` 中配置数据库连接字符串和 Redis 连接：

```json
{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=Microservice;User Id=sa;Password=YourPassword;TrustServerCertificate=True"
  },
  "Redis": {
    "ConnectionString": "localhost:6379"
  }
}
```

### 运行项目

1. 克隆项目后，在解决方案根目录执行：

```bash
dotnet restore
dotnet build
```

2. 按需启动各服务：

```bash
# 启动认证中心
cd IDS4.AuthCenter
dotnet run

# 启动购物车服务
cd Cart.API
dotnet run

# 启动管理后台
cd Microservice.Web
dotnet run
```

### Docker 部署

项目包含 Dockerfile，支持容器化部署：

```bash
# 构建镜像
docker build -t microservice/web -f Microservice.Web/Dockerfile .
docker build -t microservice/auth -f IDS4.AuthCenter/Dockerfile .
```

## API 接口

### 购物车 API

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/cart` | 获取购物车 |
| POST | `/cart/add` | 添加商品 |
| PUT | `/cart/update` | 更新数量 |
| DELETE | `/cart/remove/{productId}` | 删除商品 |
| DELETE | `/cart/clear` | 清空购物车 |
| POST | `/cart/checkout` | 结算下单 |

## 架构说明

项目采用经典的微服务架构模式：

1. **认证服务** - 统一处理用户身份认证和授权
2. **业务服务** - 各微服务独立部署，提供专用业务能力
3. **网关/前端** - 统一入口，路由到对应服务

使用 Redis 实现分布式缓存，提高购物车操作的性能，同时通过数据库持久化确保数据可靠性。

## 许可证

MIT License