How capstonefpt/giveaway-api works
Main Components
a. API Layer
• REST API endpoints (WebApi2.0 folder)
• Authentication/Authorization system
• SignalR Hub for real-time auctions
b. Core Business Domain
• Account Management
• Product Management (Fashion Items)
• Order Processing
• Auction System
• Consignment System
• Payment Processing
• Transaction Management
c. Infrastructure
• Database (Entity Framework Core)
• External Services Integration
• VNPay Payment Gateway
• GiaoHangNhanh (GHN) Delivery Service
• Background Jobs (Auction ending, Refund processing)
Key Relationships to Highlight
a. User Management Flow:
• Authentication → Account Management → Roles (Member, Staff, Admin)
• Account Balance → Transactions → Withdrawals/Deposits
b. Product Flow:
• Master Fashion Items → Individual Items
• Categories → Products
• Shops → Products
c. Sales Flow:
• Regular Sales
• Auction System
• Consignment System
Architectural Patterns to Emphasize
a. Clean Architecture
• Domain Layer (Business Objects)
• Application Layer (Services)
• Infrastructure Layer
• Presentation Layer (WebApi)
b. Feature-based Organization
• Each business capability is organized in its own feature folder
• Clear separation of concerns
Use these visual elements:
• Red lines for critical paths
• Gray lines for secondary relationships
Layout:
[Client Applications]
• ↓
[API Gateway Layer]
• ↙ ↓ ↘
[Auth] [Core] [Payment]
• ↘ ↓ ↙
[Database Layer]
Technical Details
a. Database:
• Entity Framework Core
• SQL Server
• Migration support
b. Authentication:
• JWT Token-based auth
• Role-based access control
c. Integration Points:
• Payment gateways
• Delivery service
• Real-time notifications