How ny-panha/koupreng-invitation_project works
Koupreng is a Khmer-first digital invitation and event-operations platform. Guests and hosts use the React user app to choose templates, configure and publish invitations, share them, and collect RSVPs; hosts then manage guests and event-day operations. A separate admin app handles platform workflows, while the Spring API owns domain services and persistence. Payment confirmation also has a Telegram-assisted path. The README documents the product flow and system boundaries; sampled source confirms selected authentication, audit, and storage details, but not every domain call or frontend-to-API endpoint.
Main entry points: BackendApplication.java Spring REST API · GuestService.java Guest Management · AuthService.java Authentication · App.jsx User App
Components 24
Guest And Host Experience
Invitation And Event Operations
- Templates
apps/backend/src/main/java/com/koupreng/backend/template/domain/InvitationTemplate.java - Event Setup
apps/backend/src/main/java/com/koupreng/backend/event/application/EventService.java - Invitations
apps/backend/src/main/java/com/koupreng/backend/invitation/application/InvitationService.java - Guest Management
apps/backend/src/main/java/com/koupreng/backend/guest/application/GuestService.java - RSVP
apps/backend/src/main/java/com/koupreng/backend/rsvp/application/RsvpService.java - Invitation Delivery
apps/backend/src/main/java/com/koupreng/backend/delivery/application/InvitationDeliveryService.java - Seating
apps/backend/src/main/java/com/koupreng/backend/seating/application/SeatingService.java - Check-In
apps/backend/src/main/java/com/koupreng/backend/checkin/application/CheckInService.java - Budgets And Gifts
apps/backend/src/main/java/com/koupreng/backend/budget/application/BudgetService.java - Host Dashboard
apps/backend/src/main/java/com/koupreng/backend/reporting/application/DashboardReportService.java
Identity And Platform Controls
- Spring REST API
apps/backend/src/main/java/com/koupreng/backend/BackendApplication.java - Authentication
apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java - User Identity
apps/backend/src/main/java/com/koupreng/backend/user/domain/AppUser.java - Admin Controls
apps/backend/src/main/java/com/koupreng/backend/admin/application/AdminManagementService.java - Audit Logs
apps/backend/src/main/java/com/koupreng/backend/audit/application/AuditLogService.java
Payments And Integrations
- Payment Workflows
apps/backend/src/main/java/com/koupreng/backend/payment/application/TemplatePaymentService.java - Telegram Assistance
apps/telegram-bot/main.py
Persistence And Infrastructure
- MySQL
- Redis
Other components
- Guests
- Hosts
- Administrators
Connections 24
- Guests → User App: view invitations
- Hosts → User App: manage events
- Administrators → Admin App: administer platform
- User App → Spring REST API: use API
- Admin App → Spring REST API: use API
- Spring REST API → MySQL: persist data
- Spring REST API → Redis: use cache
- Templates → Event Setup: choose template
- Event Setup → Invitations: customize and publish
- Invitations → Invitation Delivery: share invitation
- Guests → RSVP: submit response
- RSVP → Guest Management: manage guests
- Guest Management → Seating: arrange seating
- Guest Management → Check-In: record arrivals
- Hosts → Budgets And Gifts: track operations
- Hosts → Host Dashboard: review summaries
- Spring REST API → Authentication: handle identity
- Authentication → User Identity: load and update
apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java - Authentication → Audit Logs: log failures
apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java - Administrators → Admin Controls: moderate platform
- Admin Controls → Audit Logs: review activity
apps/backend/src/main/java/com/koupreng/backend/admin/application/AdminManagementService.java - Telegram Assistance → Spring REST API: coordinate confirmations
- Payment Workflows → Spring REST API: confirm payments
- Audit Logs → MySQL: read log records