🎟️ Chinese Auction System

A full-stack raffle & fundraising platform

Angular 20 + .NET 8 Web API application for running a Chinese auction: donors contribute gifts, users buy tickets, admins manage everything and draw winners

---

📸 App Screenshots

User Experience

Gifts Catalog	Login Page

Administrative Dashboard

Manage Gifts	Manage Purchases

---

📖 About the Project

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.

---

🚀 Key Features

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

---

🧱 Tech Stack

Layer	Technologies
Frontend	Angular 20 (standalone, SSR-ready), PrimeNG, PrimeFlex, RxJS, xlsx (Excel export)
Backend	.NET 8 Web API, C#, Repository + Service architecture
Data access	Entity Framework Core 9, SQL Server
Auth & Security	JWT Bearer authentication, role-based authorization, custom rate-limiting middleware, CORS
Observability	Serilog structured logging, request-logging middleware
API Docs	Swagger / OpenAPI (Swashbuckle)
Testing	xUnit (server), Jasmine/Karma (client)

---

🗂️ Project Structure

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

---

⚙️ Prerequisites

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

---

🧩 Setup & Run — Server

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.

---

🖥️ Setup & Run — Client

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.

---

🧪 Tests

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

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

---

📦 Production Build

# 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.

---

🔐 Security Notes

• 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.

---

🤝 Contributing

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

---

Built with ❤️ by Ester-Developer