# thilina-fer/colloq-mock-interview-backend architecture

> Architecture diagram of the GitHub repository thilina-fer/colloq-mock-interview-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thilina-fer/colloq-mock-interview-backend
- Repository: https://github.com/thilina-fer/colloq-mock-interview-backend

## Overview

ColloQ is a mock-interview platform backend. Candidates authenticate, complete a profile, find interviewers and availability, then book a session; interviewers manage availability and bookings, while admins approve interviewers and inspect platform profit. Payments and wallet accounting support the documented 90/10 revenue split. The graph reflects documented product capabilities and relationships visible in the sampled controllers and service interfaces; implementation details for several unsampled services and integrations remain uncertain.

Main entry points: [`src/main/java/lk/ijse/springbootbackend/service/impl/AuthServiceImpl.java`](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/impl/AuthServiceImpl.java) (Authentication), [`src/main/java/lk/ijse/springbootbackend/service/BookingService.java`](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/BookingService.java) (Booking services), [`src/main/java/lk/ijse/springbootbackend/service/WalletService.java`](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/WalletService.java) (Wallet accounting), [`src/main/java/lk/ijse/springbootbackend/controller/AdminController.java`](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/AdminController.java) (Admin API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and profiles"]
  node_auth_api["Authentication API"]
  node_auth_logic["Authentication"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_auth_data[("Account records<br/>[Auth.java]")]
  node_candidate_api["Candidate profiles"]
  node_interviewer_api["Interviewer profiles"]
  node_interviewer_logic["Interviewer management"]
end

subgraph group_sessions["Interview sessions"]
  node_availability["Availability API"]
  node_booking_api["Booking API"]
  node_booking_logic["Booking services"]
  node_booking_data[("Bookings and feedback<br/>[Bookings.java]")]
  node_calendar["Calendar integration"]
end

subgraph group_finance["Payments and finance"]
  node_payment_api["Payment API"]
  node_wallet_api["Wallet API"]
  node_wallet_service["Wallet accounting<br/>[WalletService.java]"]
  node_wallet_data[("Wallet and transactions<br/>[Wallet.java]")]
end

subgraph group_operations["Platform operations"]
  node_admin_api["Admin API"]
  node_profit_api["Profit reporting"]
  node_profit_service["Platform profit"]
end

node_candidate(("Candidate"))
node_interviewer(("Interviewer"))
node_admin(("Administrator"))

node_candidate -->|"authenticates"| node_auth_api
node_interviewer -->|"authenticates"| node_auth_api
node_auth_api -.->|"delegates"| node_auth_logic
node_auth_logic -->|"reads and writes"| node_auth_data
node_auth_logic -->|"generates tokens"| node_jwt
node_candidate -->|"completes profile"| node_candidate_api
node_interviewer -.->|"completes profile"| node_interviewer_api
node_interviewer_api -->|"delegates"| node_interviewer_logic
node_candidate -->|"checks availability"| node_availability
node_candidate -->|"books session"| node_booking_api
node_booking_api -->|"delegates"| node_booking_logic
node_booking_logic -.->|"persists bookings"| node_booking_data
node_booking_logic -.->|"creates meeting links"| node_calendar
node_candidate -.->|"pays for session"| node_payment_api
node_interviewer -.->|"manages earnings"| node_wallet_api
node_wallet_api -.->|"delegates"| node_wallet_service
node_wallet_service -.->|"records transactions"| node_wallet_data
node_wallet_service -.->|"allocates revenue share"| node_profit_service
node_admin -->|"reviews platform"| node_admin_api
node_admin_api -->|"approves interviewers"| node_interviewer_logic
node_admin_api -->|"requests profit"| node_profit_service
node_admin -.->|"views reports"| node_profit_api

click node_auth_api "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/AuthController.java"
click node_auth_logic "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/impl/AuthServiceImpl.java"
click node_jwt "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/util/JwtUtil.java"
click node_auth_data "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/entity/Auth.java"
click node_candidate_api "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/CandidateController.java"
click node_interviewer_api "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/InterviewerController.java"
click node_interviewer_logic "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/impl/InterviewerServiceImpl.java"
click node_availability "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/AvailabilityController.java"
click node_booking_api "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/BookingController.java"
click node_booking_logic "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/BookingService.java"
click node_booking_data "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/entity/Bookings.java"
click node_calendar "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/impl/GoogleCalendarService.java"
click node_payment_api "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/PaymentController.java"
click node_wallet_api "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/WalletController.java"
click node_wallet_service "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/WalletService.java"
click node_wallet_data "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/entity/Wallet.java"
click node_admin_api "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/AdminController.java"
click node_profit_api "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/SystemProfitController.java"
click node_profit_service "https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/SystemProfitService.java"

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_auth_api,node_auth_logic,node_jwt,node_auth_data,node_candidate_api,node_interviewer_api,node_interviewer_logic,node_interviewer toneBlue
class node_availability,node_booking_api,node_booking_logic,node_booking_data,node_calendar toneAmber
class node_payment_api,node_wallet_api,node_wallet_service,node_wallet_data toneMint
class node_admin_api,node_profit_api,node_profit_service toneRose
class node_candidate,node_admin toneIndigo
```

## Components

### Identity and profiles

- [Authentication API](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/AuthController.java): `src/main/java/lk/ijse/springbootbackend/controller/AuthController.java`
- [Authentication](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/impl/AuthServiceImpl.java): `src/main/java/lk/ijse/springbootbackend/service/impl/AuthServiceImpl.java`
- [JWT utilities](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/util/JwtUtil.java): `src/main/java/lk/ijse/springbootbackend/util/JwtUtil.java`
- [Account records](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/entity/Auth.java): `src/main/java/lk/ijse/springbootbackend/entity/Auth.java`
- [Candidate profiles](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/CandidateController.java): `src/main/java/lk/ijse/springbootbackend/controller/CandidateController.java`
- [Interviewer profiles](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/InterviewerController.java): `src/main/java/lk/ijse/springbootbackend/controller/InterviewerController.java`
- [Interviewer management](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/impl/InterviewerServiceImpl.java): `src/main/java/lk/ijse/springbootbackend/service/impl/InterviewerServiceImpl.java`

### Interview sessions

- [Availability API](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/AvailabilityController.java): `src/main/java/lk/ijse/springbootbackend/controller/AvailabilityController.java`
- [Booking API](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/BookingController.java): `src/main/java/lk/ijse/springbootbackend/controller/BookingController.java`
- [Booking services](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/BookingService.java): `src/main/java/lk/ijse/springbootbackend/service/BookingService.java`
- [Bookings and feedback](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/entity/Bookings.java): `src/main/java/lk/ijse/springbootbackend/entity/Bookings.java`
- [Calendar integration](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/impl/GoogleCalendarService.java): `src/main/java/lk/ijse/springbootbackend/service/impl/GoogleCalendarService.java`

### Payments and finance

- [Payment API](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/PaymentController.java): `src/main/java/lk/ijse/springbootbackend/controller/PaymentController.java`
- [Wallet API](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/WalletController.java): `src/main/java/lk/ijse/springbootbackend/controller/WalletController.java`
- [Wallet accounting](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/WalletService.java): `src/main/java/lk/ijse/springbootbackend/service/WalletService.java`
- [Wallet and transactions](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/entity/Wallet.java): `src/main/java/lk/ijse/springbootbackend/entity/Wallet.java`

### Platform operations

- [Admin API](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/AdminController.java): `src/main/java/lk/ijse/springbootbackend/controller/AdminController.java`
- [Profit reporting](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/controller/SystemProfitController.java): `src/main/java/lk/ijse/springbootbackend/controller/SystemProfitController.java`
- [Platform profit](https://github.com/thilina-fer/colloq-mock-interview-backend/blob/main/src/main/java/lk/ijse/springbootbackend/service/SystemProfitService.java): `src/main/java/lk/ijse/springbootbackend/service/SystemProfitService.java`

### Other components

- **Candidate**
- **Interviewer**
- **Administrator**

## Connections

- Candidate → Authentication API: authenticates
- Interviewer → Authentication API: authenticates
- Authentication API → Authentication: delegates
- Authentication → Account records: reads and writes (evidence: `src/main/java/lk/ijse/springbootbackend/service/impl/AuthServiceImpl.java`)
- Authentication → JWT utilities: generates tokens (evidence: `src/main/java/lk/ijse/springbootbackend/service/impl/AuthServiceImpl.java`)
- Candidate → Candidate profiles: completes profile
- Interviewer → Interviewer profiles: completes profile
- Interviewer profiles → Interviewer management: delegates (evidence: `src/main/java/lk/ijse/springbootbackend/controller/InterviewerController.java`)
- Candidate → Availability API: checks availability
- Candidate → Booking API: books session
- Booking API → Booking services: delegates (evidence: `src/main/java/lk/ijse/springbootbackend/controller/BookingController.java`)
- Booking services → Bookings and feedback: persists bookings
- Booking services → Calendar integration: creates meeting links
- Candidate → Payment API: pays for session
- Interviewer → Wallet API: manages earnings
- Wallet API → Wallet accounting: delegates
- Wallet accounting → Wallet and transactions: records transactions
- Wallet accounting → Platform profit: allocates revenue share
- Administrator → Admin API: reviews platform (evidence: `src/main/java/lk/ijse/springbootbackend/controller/AdminController.java`)
- Admin API → Interviewer management: approves interviewers (evidence: `src/main/java/lk/ijse/springbootbackend/controller/AdminController.java`)
- Admin API → Platform profit: requests profit (evidence: `src/main/java/lk/ijse/springbootbackend/controller/AdminController.java`)
- Administrator → Profit reporting: views reports
