# ny-panha/koupreng-invitation_project architecture

> Architecture diagram of the GitHub repository ny-panha/koupreng-invitation_project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ny-panha/koupreng-invitation_project
- Repository: https://github.com/ny-panha/koupreng-invitation_project

## Overview

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: [`apps/backend/src/main/java/com/koupreng/backend/BackendApplication.java`](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/BackendApplication.java) (Spring REST API), [`apps/backend/src/main/java/com/koupreng/backend/guest/application/GuestService.java`](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/guest/application/GuestService.java) (Guest Management), [`apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java`](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java) (Authentication), [`apps/frontend-user/src/app/App.jsx`](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/frontend-user/src/app/App.jsx) (User App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Guest And Host Experience"]
  node_user_app["User App<br/>[App.jsx]"]
  node_admin_app["Admin App<br/>[App.jsx]"]
end

subgraph group_event_ops["Invitation And Event Operations"]
  node_template_catalog["Templates"]
  node_event_setup["Event Setup<br/>[EventService.java]"]
  node_invitations["Invitations"]
  node_guest_lists["Guest Management<br/>[GuestService.java]"]
  node_rsvp["RSVP<br/>[RsvpService.java]"]
  node_delivery["Invitation Delivery"]
  node_seating["Seating"]
  node_checkin["Check-In"]
  node_budgets_gifts["Budgets And Gifts<br/>[BudgetService.java]"]
  node_reports["Host Dashboard"]
end

subgraph group_platform["Identity And Platform Controls"]
  node_backend_api["Spring REST API"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_user_identity["User Identity<br/>[AppUser.java]"]
  node_admin_controls["Admin Controls"]
  node_audit["Audit Logs"]
end

subgraph group_commerce["Payments And Integrations"]
  node_payment["Payment Workflows"]
  node_telegram_bot["Telegram Assistance<br/>[main.py]"]
end

subgraph group_data["Persistence And Infrastructure"]
  node_mysql[("MySQL")]
  node_redis[("Redis")]
end

node_guests(("Guests"))
node_hosts(("Hosts"))
node_admins(("Administrators"))

node_guests -->|"view invitations"| node_user_app
node_hosts -->|"manage events"| node_user_app
node_admins -->|"administer platform"| node_admin_app
node_user_app -->|"use API"| node_backend_api
node_admin_app -->|"use API"| node_backend_api
node_backend_api -->|"persist data"| node_mysql
node_backend_api -->|"use cache"| node_redis
node_template_catalog -->|"choose template"| node_event_setup
node_event_setup -->|"customize and publish"| node_invitations
node_invitations -->|"share invitation"| node_delivery
node_guests -->|"submit response"| node_rsvp
node_rsvp -->|"manage guests"| node_guest_lists
node_guest_lists -->|"arrange seating"| node_seating
node_guest_lists -->|"record arrivals"| node_checkin
node_hosts -->|"track operations"| node_budgets_gifts
node_hosts -->|"review summaries"| node_reports
node_backend_api -.->|"handle identity"| node_auth
node_auth -->|"load and update"| node_user_identity
node_auth -.->|"log failures"| node_audit
node_admins -->|"moderate platform"| node_admin_controls
node_admin_controls -.->|"review activity"| node_audit
node_telegram_bot -->|"coordinate confirmations"| node_backend_api
node_payment -.->|"confirm payments"| node_backend_api
node_audit -.->|"read log records"| node_mysql

click node_user_app "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/frontend-user/src/app/App.jsx"
click node_admin_app "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/frontend-admin/src/app/App.jsx"
click node_template_catalog "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/template/domain/InvitationTemplate.java"
click node_event_setup "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/event/application/EventService.java"
click node_invitations "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/invitation/application/InvitationService.java"
click node_guest_lists "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/guest/application/GuestService.java"
click node_rsvp "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/rsvp/application/RsvpService.java"
click node_delivery "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/delivery/application/InvitationDeliveryService.java"
click node_seating "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/seating/application/SeatingService.java"
click node_checkin "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/checkin/application/CheckInService.java"
click node_budgets_gifts "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/budget/application/BudgetService.java"
click node_reports "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/reporting/application/DashboardReportService.java"
click node_backend_api "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/BackendApplication.java"
click node_auth "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java"
click node_user_identity "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/user/domain/AppUser.java"
click node_admin_controls "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/admin/application/AdminManagementService.java"
click node_audit "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/audit/application/AuditLogService.java"
click node_payment "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/payment/application/TemplatePaymentService.java"
click node_telegram_bot "https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/telegram-bot/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_user_app,node_admin_app toneBlue
class node_template_catalog,node_event_setup,node_invitations,node_guest_lists,node_rsvp,node_delivery,node_seating,node_checkin,node_budgets_gifts,node_reports toneAmber
class node_backend_api,node_auth,node_user_identity,node_admin_controls,node_audit toneMint
class node_payment,node_telegram_bot toneRose
class node_mysql,node_redis,node_guests,node_hosts,node_admins toneIndigo
```

## Components

### Guest And Host Experience

- [User App](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/frontend-user/src/app/App.jsx): `apps/frontend-user/src/app/App.jsx`
- [Admin App](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/frontend-admin/src/app/App.jsx): `apps/frontend-admin/src/app/App.jsx`

### Invitation And Event Operations

- [Templates](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/template/domain/InvitationTemplate.java): `apps/backend/src/main/java/com/koupreng/backend/template/domain/InvitationTemplate.java`
- [Event Setup](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/event/application/EventService.java): `apps/backend/src/main/java/com/koupreng/backend/event/application/EventService.java`
- [Invitations](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/invitation/application/InvitationService.java): `apps/backend/src/main/java/com/koupreng/backend/invitation/application/InvitationService.java`
- [Guest Management](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/guest/application/GuestService.java): `apps/backend/src/main/java/com/koupreng/backend/guest/application/GuestService.java`
- [RSVP](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/rsvp/application/RsvpService.java): `apps/backend/src/main/java/com/koupreng/backend/rsvp/application/RsvpService.java`
- [Invitation Delivery](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/delivery/application/InvitationDeliveryService.java): `apps/backend/src/main/java/com/koupreng/backend/delivery/application/InvitationDeliveryService.java`
- [Seating](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/seating/application/SeatingService.java): `apps/backend/src/main/java/com/koupreng/backend/seating/application/SeatingService.java`
- [Check-In](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/checkin/application/CheckInService.java): `apps/backend/src/main/java/com/koupreng/backend/checkin/application/CheckInService.java`
- [Budgets And Gifts](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/budget/application/BudgetService.java): `apps/backend/src/main/java/com/koupreng/backend/budget/application/BudgetService.java`
- [Host Dashboard](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/reporting/application/DashboardReportService.java): `apps/backend/src/main/java/com/koupreng/backend/reporting/application/DashboardReportService.java`

### Identity And Platform Controls

- [Spring REST API](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/BackendApplication.java): `apps/backend/src/main/java/com/koupreng/backend/BackendApplication.java`
- [Authentication](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java): `apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java`
- [User Identity](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/user/domain/AppUser.java): `apps/backend/src/main/java/com/koupreng/backend/user/domain/AppUser.java`
- [Admin Controls](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/admin/application/AdminManagementService.java): `apps/backend/src/main/java/com/koupreng/backend/admin/application/AdminManagementService.java`
- [Audit Logs](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/audit/application/AuditLogService.java): `apps/backend/src/main/java/com/koupreng/backend/audit/application/AuditLogService.java`

### Payments And Integrations

- [Payment Workflows](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/backend/src/main/java/com/koupreng/backend/payment/application/TemplatePaymentService.java): `apps/backend/src/main/java/com/koupreng/backend/payment/application/TemplatePaymentService.java`
- [Telegram Assistance](https://github.com/ny-panha/koupreng-invitation_project/blob/main/apps/telegram-bot/main.py): `apps/telegram-bot/main.py`

### Persistence And Infrastructure

- **MySQL**
- **Redis**

### Other components

- **Guests**
- **Hosts**
- **Administrators**

## Connections

- 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 (evidence: `apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java`)
- Authentication → Audit Logs: log failures (evidence: `apps/backend/src/main/java/com/koupreng/backend/auth/application/AuthService.java`)
- Administrators → Admin Controls: moderate platform
- Admin Controls → Audit Logs: review activity (evidence: `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
