Gifts Catalog	Login Page

Manage Gifts	Manage Purchases

Chinese Auction System is a full-stack web application that digitizes a classic charity raffle event ("Chinese auction"): donors contribute gifts, each gift is assigned a category and a ticket price, and users purchase tickets to enter the draw for the gifts they want. Admins run the show from a management dashboard — creating gifts, categories and donors, reviewing purchases, and picking winners.

The backend is a .NET 8 Web API built around a clean Repository + Service layered architecture, secured with JWT authentication and role-based authorization (User / Admin), with Serilog structured logging, custom rate-limiting middleware, and interactive API docs via Swagger. The frontend is an Angular 20 single-page app (with SSR support) styled with PrimeNG/PrimeFlex, and includes Excel export for admin reports via xlsx.

For Users

• Browse the gift catalog by category, with images, descriptions and ticket price
• Add gifts to a cart and check out by purchasing tickets
• Secure registration & login with JWT-based sessions

For Admins

• Full CRUD for Gifts, Categories and Donors
• Review and manage all ticket purchases
• Draw and record gift winners
• Seeded sample data for a realistic local setup out of the box

ChineseAuction-FullStack-Angular-DotNet/
├── client/
│   └── my-app/                   # Angular 20 SPA
│       └── src/app/               # components, services, routes
│
├── server/
│   ├── ChineseSaleApi/            # .NET 8 Web API
│   │   ├── Controllers/           # Auth, User, Gift, Category, Donor, Purchase
│   │   ├── Models/                # User, Gift, Category, Donor, Ticket, Order, OrderItem
│   │   ├── Repositories/          # data access layer
│   │   ├── Services/               # business logic layer
│   │   ├── Middleware/              # request logging, rate limiting
│   │   ├── Data/                     # DbContext + seed data
│   │   └── Migrations/                # EF Core migrations
│   └── ChineseSaleApi.Tests/      # xUnit test suite
│
└── screenshots/                  # README assets

• .NET 8 SDK
• Node.js (LTS) and npm
• SQL Server (local or remote instance)
• (Optional) Angular CLI and EF Core tools for local development

cd server/ChineseSaleApi
dotnet restore
dotnet run

• Configure your SQL Server connection string and JWT settings in appsettings.json (ConnectionStrings:DefaultConnection, JwtSettings).
• On first run, the app seeds sample categories, donors and gifts (with images from wwwroot/images) so you have realistic demo data immediately.
• To apply EF Core migrations manually:

dotnet ef database update

• Interactive API docs are available at /swagger in development.

cd client/my-app
npm install
npm start
# or
ng serve --open

The client expects the API at the base URL configured in the Angular app config/environment — update it if your API runs on a different host or port. By default the API allows requests from http://localhost:4200.

# Server unit tests
cd server/ChineseSaleApi.Tests
dotnet test

# Client unit tests
cd client/my-app
npm test

# Backend
cd server/ChineseSaleApi
dotnet publish -c Release

# Frontend
cd client/my-app
npm run build
# or
ng build --configuration production

Serve the generated frontend assets from your web server of choice, or integrate them into the backend's static file pipeline.

• Authentication is JWT-based; protected endpoints require a valid Bearer token and enforce role checks (User vs Admin).
• Custom middleware applies request rate limiting and structured request logging (Serilog) on every call.
• CORS is locked down to the configured client origin.

Contributions and improvements are welcome — open an issue or a PR describing the change and its rationale.