MSuMshk
4b53862ded
核心功能:
- 账单CRUD操作（创建、查询、详情、更新状态、删除）
- 支付记录管理（创建支付、审核支付）
- 批量操作支持（批量更新账单状态）
- 统计分析功能（账单统计、逾期账单查询）
- 导出功能（Excel/PDF/CSV）
API端点 (16个):
- GET /api/admin/v1/billings - 账单列表（分页、筛选、排序）
- POST /api/admin/v1/billings - 创建账单
- GET /api/admin/v1/billings/{id} - 账单详情
- DELETE /api/admin/v1/billings/{id} - 删除账单
- PUT /api/admin/v1/billings/{id}/status - 更新状态
- POST /api/admin/v1/billings/batch/status - 批量更新
- GET /api/admin/v1/billings/{id}/payments - 支付记录
- POST /api/admin/v1/billings/{id}/payments - 创建支付
- PUT /api/admin/v1/billings/payments/{paymentId}/verify - 审核支付
- GET /api/admin/v1/billings/statistics - 统计数据
- GET /api/admin/v1/billings/overdue - 逾期账单
- POST /api/admin/v1/billings/export - 导出账单
架构优化:
- 采用CQRS模式分离读写（MediatR + Dapper + EF Core）
- 完整的领域模型设计（TenantBillingStatement, TenantPayment等）
- FluentValidation请求验证
- 状态机管理账单和支付状态流转
API设计优化 (三项改进):
1. 导出API响应Content-Type改为application/octet-stream
2. 支付审核API添加Approved和Notes可选参数，支持通过/拒绝
3. 移除TenantBillings API中重复的TenantId参数
数据库变更:
- 新增账单相关表及关系
- 支持Snowflake ID主键
- 完整的审计字段支持
🤖 Generated with Claude Code
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
外卖SaaS系统 (TakeoutSaaS)
项目简介
外卖SaaS系统是一个基于.NET 10的多租户外卖管理平台，为中小型餐饮企业提供完整的外卖业务解决方案。系统采用现代化的技术栈，支持商家管理、菜品管理、订单处理、配送管理、支付集成等核心功能。
核心特性
- 🏢 多租户架构：支持多租户数据隔离，SaaS模式运营
- 🍔 商家管理：完善的商家入驻、门店管理、菜品管理功能
- 📦 订单管理：订单全生命周期管理，实时状态跟踪 🚚 配送管理：配送任务、路线规划、第三方配送对接
- 💰 支付集成：支持微信、支付宝等多种支付方式
- 🎁 营销功能：优惠券、满减活动、会员积分
- 📊 数据分析：实时数据统计、经营报表、趋势分析
- 🔒 安全可靠：JWT认证、权限控制、数据加密
技术栈
后端技术
- .NET 10：最新的.NET平台
- ASP.NET Core Web API：RESTful API服务
- Entity Framework Core 10：最新ORM框架
- Dapper 2.1+：高性能数据访问
- PostgreSQL 16+：主数据库
- Redis 7.0+：分布式缓存
- RabbitMQ 3.12+：消息队列
开发框架
- AutoMapper：对象映射
- FluentValidation：数据验证
- Serilog：结构化日志
- MediatR：CQRS模式
- Hangfire：后台任务
- Swagger：API文档
运行条件
开发环境要求
- .NET SDK 10.0 或更高版本
- PostgreSQL 16+
- Redis 7.0+
- RabbitMQ 3.12+（可选）
- Docker Desktop（推荐，用于容器化开发）
推荐IDE
- Visual Studio 2022
- JetBrains Rider
- Visual Studio Code
快速开始
1. 克隆项目
git clone https://github.com/your-org/takeout-saas.git
cd takeout-saas
2. 使用Docker Compose启动依赖服务（推荐）
# 启动PostgreSQL、Redis、RabbitMQ等服务
docker-compose up -d
# 查看服务状态
docker-compose ps
3. 配置数据库连接
编辑 src/TakeoutSaaS.Api/appsettings.Development.json
4. 执行数据库迁移
cd src/TakeoutSaaS.Api
dotnet ef database update
5. 运行项目
dotnet run
访问 API 文档：
- 管理后台 AdminApi Swagger：http://localhost:5001/swagger
- 小程序/用户端 MiniApi Swagger：http://localhost:5002/swagger
项目结构
TakeoutSaaS/
├── 0_Document/ # 项目文档
│ ├── 01_项目概述.md
│ ├── 02_技术架构.md
│ ├── 03_数据库设计.md
│ ├── 04A_管理后台API.md
│ ├── 04B_小程序API.md
│ ├── 05_部署运维.md
│ └── 06_开发规范.md
├── src/
│ ├── TakeoutSaaS.AdminApi/ # 管理后台 Web API
│ ├── TakeoutSaaS.MiniApi/ # 小程序/用户端 Web API
│ ├── TakeoutSaaS.Application/ # 应用层
│ ├── TakeoutSaaS.Domain/ # 领域层
│ ├── TakeoutSaaS.Infrastructure/ # 基础设施层
│ └── TakeoutSaaS.Shared/ # 共享层
├── tests/
│ ├── TakeoutSaaS.UnitTests/ # 单元测试
│ └── TakeoutSaaS.IntegrationTests/ # 集成测试
├── docker-compose.yml # Docker编排文件
└── README.md
测试说明
运行单元测试
dotnet test tests/TakeoutSaaS.UnitTests
运行集成测试
dotnet test tests/TakeoutSaaS.IntegrationTests
部署说明
Docker部署
# 构建镜像
docker build -t takeout-saas-api:latest .
# 运行容器
docker run -d -p 8080:80 --name takeout-api takeout-saas-api:latest
详细部署文档请参考：部署运维文档
文档
- 项目概述 - 系统介绍和业务说明
- 技术架构 - 技术栈和架构设计
- 数据库设计 - 数据模型和表结构
- API接口设计 - RESTful API规范
- 部署运维 - 部署和运维指南
- 开发规范 - 代码规范和最佳实践
开发规范
请遵循项目的开发规范
贡献指南
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'feat: Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
许可证
本项目采用 MIT 许可证
联系方式
协作者
感谢所有为本项目做出贡献的开发者！
⭐ 如果这个项目对你有帮助，请给我们一个星标！