# aaron40409/test-k8s-secret-game architecture

> Architecture diagram of the GitHub repository aaron40409/test-k8s-secret-game, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aaron40409/test-k8s-secret-game
- Repository: https://github.com/aaron40409/test-k8s-secret-game

## Overview

This is a NestJS API for a Secret Game, with participant administration and a voter flow alongside OTP verification. The main path is HTTP requests into participant routes, then participant business logic for imports, nominations, login, and voting, with persistence through Prisma; OTP requests go to Twilio. The README is only a generic Nest starter description, so capabilities are inferred from the supplied source excerpts. Authentication and user-controller code shown is commented out; unsampled modules and health behavior are not expanded beyond their indexed wiring.

Main entry points: [`src/participant/participant.service.ts`](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/participant.service.ts) (Participant workflows), [`src/participant/participant.module.ts`](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/participant.module.ts) (Participant module), [`src/app.module.ts`](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/app.module.ts) (Application wiring), [`src/twilio/twilio.module.ts`](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/twilio/twilio.module.ts) (OTP module)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_bootstrap["HTTP bootstrap<br/>[main.ts]"]
  node_app["Application wiring<br/>[app.module.ts]"]
end

subgraph group_participants["Participant workflows"]
  node_participant_module["Participant module"]
  node_participant_api["Participant routes"]
  node_participant_logic["Participant workflows"]
  node_participant_model["Import schema"]
  node_health["Health endpoint"]
end

subgraph group_otp["OTP verification"]
  node_otp_module["OTP module<br/>[twilio.module.ts]"]
  node_otp_api["OTP routes"]
  node_otp_logic["OTP service<br/>[twilio.service.ts]"]
  node_twilio["Twilio Verify"]
end

subgraph group_persistence["Persistence"]
  node_prisma_service["Prisma service<br/>[prisma.service.ts]"]
  node_database[("Application database")]
  node_users_service["User service<br/>[users.service.ts]"]
  node_users_module["Users module<br/>[users.module.ts]"]
end

node_caller(("API caller"))

node_caller -->|"sends requests"| node_bootstrap
node_bootstrap -->|"starts"| node_app
node_app -->|"registers"| node_participant_module
node_app -->|"registers"| node_otp_module
node_participant_module -->|"wires"| node_participant_api
node_participant_module -->|"wires"| node_participant_logic
node_participant_module -->|"wires"| node_health
node_participant_api -->|"calls"| node_participant_logic
node_participant_logic -->|"parses with"| node_participant_model
node_participant_logic -->|"uses"| node_prisma_service
node_participant_logic -->|"reads and writes"| node_database
node_otp_module -->|"wires"| node_otp_api
node_otp_module -->|"wires"| node_otp_logic
node_otp_api -->|"calls"| node_otp_logic
node_otp_logic -->|"sends and verifies"| node_twilio
node_users_module -->|"wires"| node_users_service
node_users_service -->|"uses"| node_prisma_service
node_users_service -->|"reads and writes"| node_database

click node_bootstrap "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/main.ts"
click node_app "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/app.module.ts"
click node_participant_module "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/participant.module.ts"
click node_participant_api "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/participant.controller.ts"
click node_participant_logic "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/participant.service.ts"
click node_participant_model "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/models/participant-model.ts"
click node_health "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/health.controller.ts"
click node_otp_module "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/twilio/twilio.module.ts"
click node_otp_api "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/twilio/twilio.controller.ts"
click node_otp_logic "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/twilio/twilio.service.ts"
click node_prisma_service "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/prisma/prisma.service.ts"
click node_users_service "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/users/users.service.ts"
click node_users_module "https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/users/users.module.ts"

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_bootstrap,node_app toneBlue
class node_participant_module,node_participant_api,node_participant_logic,node_participant_model,node_health toneAmber
class node_otp_module,node_otp_api,node_otp_logic,node_twilio,node_caller toneMint
class node_prisma_service,node_database,node_users_service,node_users_module toneRose
```

## Components

### API runtime

- [HTTP bootstrap](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/main.ts): `src/main.ts`
- [Application wiring](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/app.module.ts): `src/app.module.ts`

### Participant workflows

- [Participant module](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/participant.module.ts): `src/participant/participant.module.ts`
- [Participant routes](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/participant.controller.ts): `src/participant/participant.controller.ts`
- [Participant workflows](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/participant.service.ts): `src/participant/participant.service.ts`
- [Import schema](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/models/participant-model.ts): `src/participant/models/participant-model.ts`
- [Health endpoint](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/participant/health.controller.ts): `src/participant/health.controller.ts`

### OTP verification

- [OTP module](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/twilio/twilio.module.ts): `src/twilio/twilio.module.ts`
- [OTP routes](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/twilio/twilio.controller.ts): `src/twilio/twilio.controller.ts`
- [OTP service](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/twilio/twilio.service.ts): `src/twilio/twilio.service.ts`
- **Twilio Verify**

### Persistence

- [Prisma service](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/prisma/prisma.service.ts): `prisma/prisma.service.ts`
- **Application database**
- [User service](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/users/users.service.ts): `src/users/users.service.ts`
- [Users module](https://github.com/aaron40409/test-k8s-secret-game/blob/k8s/src/users/users.module.ts): `src/users/users.module.ts`

### Other components

- **API caller**

## Connections

- API caller → HTTP bootstrap: sends requests (evidence: `src/main.ts`)
- HTTP bootstrap → Application wiring: starts (evidence: `src/main.ts`)
- Application wiring → Participant module: registers (evidence: `src/app.module.ts`)
- Application wiring → OTP module: registers (evidence: `src/app.module.ts`)
- Participant module → Participant routes: wires (evidence: `src/participant/participant.module.ts`)
- Participant module → Participant workflows: wires (evidence: `src/participant/participant.module.ts`)
- Participant module → Health endpoint: wires (evidence: `src/participant/participant.module.ts`)
- Participant routes → Participant workflows: calls (evidence: `src/participant/participant.controller.ts`)
- Participant workflows → Import schema: parses with (evidence: `src/participant/participant.service.ts`)
- Participant workflows → Prisma service: uses (evidence: `src/participant/participant.service.ts`)
- Participant workflows → Application database: reads and writes (evidence: `src/participant/participant.service.ts`)
- OTP module → OTP routes: wires (evidence: `src/twilio/twilio.module.ts`)
- OTP module → OTP service: wires (evidence: `src/twilio/twilio.module.ts`)
- OTP routes → OTP service: calls (evidence: `src/twilio/twilio.controller.ts`)
- OTP service → Twilio Verify: sends and verifies (evidence: `src/twilio/twilio.service.ts`)
- Users module → User service: wires (evidence: `src/users/users.module.ts`)
- User service → Prisma service: uses (evidence: `src/users/users.service.ts`)
- User service → Application database: reads and writes (evidence: `src/users/users.service.ts`)
