# luciano-mendesz9/salamaker-cmt architecture

> Architecture diagram of the GitHub repository luciano-mendesz9/salamaker-cmt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luciano-mendesz9/salamaker-cmt
- Repository: https://github.com/luciano-mendesz9/salamaker-cmt

## Overview

This is a school-classroom web application with teacher and student areas, activities and attendance, virtual currency and investments, collectibles, and multiplayer/solo games. The principal workflow is teacher-authored activities reaching students, who participate and submit work for grading; attendance and classroom administration form adjacent flows. The source index and excerpts support several API-to-domain and API-to-database relationships, but do not establish most page-to-API wiring, so those links are omitted. Game coverage is represented by the sampled Pong implementation and the listed game-service modules.

Main entry points: [`src/lib/db.ts`](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/db.ts) (Application database), [`src/app/api/professor/treasury/route.ts`](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/professor/treasury/route.ts) (Treasury management), [`src/app/api/student/dev-coins/route.ts`](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/student/dev-coins/route.ts) (Student coin economy), [`src/lib/treasury.ts`](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/treasury.ts) (Treasury ledger)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_classroom["Classroom work"]
  node_teacher["Teacher workspace"]
  node_activity_api["Activity management<br/>[route.ts]"]
  node_activities["Activity rules<br/>[activities.ts]"]
  node_student["Student workspace"]
  node_submissions["Activity submissions<br/>[route.ts]"]
  node_attendance["Attendance endpoints<br/>[route.ts]"]
  node_presence_rules["Presence rules<br/>[presence-rules.ts]"]
end

subgraph group_economy["Economy and collectibles"]
  node_finance_ui["Treasury workspace"]
  node_treasury_api["Treasury management<br/>[route.ts]"]
  node_treasury["Treasury ledger<br/>[treasury.ts]"]
  node_investments["Student investments<br/>[investments.ts]"]
  node_dev_coins["Student coin economy<br/>[route.ts]"]
  node_stickers["Sticker collections<br/>[stickers.ts]"]
end

subgraph group_games["Games"]
  node_game_ui["Game experiences<br/>[pong-room.tsx]"]
  node_pong_engine["Pong engine<br/>[pong-engine.ts]"]
  node_pong_service["Pong rooms<br/>[pong-service.ts]"]
  node_ludo_service["Ludo rooms<br/>[ludo-service.ts]"]
  node_other_games["Other game services"]
end

subgraph group_platform["Platform services"]
  node_authorization["Role authorization<br/>[authorization.ts]"]
  node_security["Request security"]
  node_readiness["Feature readiness"]
  node_database[("Application database<br/>[db.ts]")]
end

node_activity_api -->|"requires teacher"| node_authorization
node_activity_api -->|"uses activity rules"| node_activities
node_activity_api -->|"reads and writes"| node_database
node_attendance -->|"checks participation"| node_presence_rules
node_attendance -->|"reads and writes"| node_database
node_treasury_api -->|"requires teacher"| node_authorization
node_treasury_api -->|"secures requests"| node_security
node_treasury_api -->|"checks schema"| node_readiness
node_treasury_api -->|"reads and writes"| node_database
node_treasury_api -.->|"uses ledger"| node_treasury
node_dev_coins -->|"requires student"| node_authorization
node_dev_coins -->|"secures requests"| node_security
node_dev_coins -->|"checks schema"| node_readiness
node_dev_coins -->|"updates balances"| node_database
node_dev_coins -->|"debits treasury"| node_treasury
node_investments -->|"uses ledger"| node_treasury
node_investments -->|"reads and writes"| node_database
node_pong_engine -->|"records points"| node_pong_service
node_pong_engine -->|"loads rooms"| node_database
node_pong_service -->|"credits settlement"| node_treasury
node_pong_service -->|"manages rooms"| node_database
node_ludo_service -->|"uses ledger"| node_treasury
node_ludo_service -->|"stores game state"| node_database
node_other_games -.->|"serves game features"| node_game_ui

click node_teacher "https://github.com/luciano-mendesz9/salamaker-cmt/tree/main/src/app/professor"
click node_activity_api "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/professor/activities/route.ts"
click node_activities "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/activities.ts"
click node_student "https://github.com/luciano-mendesz9/salamaker-cmt/tree/main/src/app/aluno"
click node_submissions "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/student/activities/%5Bid%5D/submit/route.ts"
click node_attendance "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/presence/route.ts"
click node_presence_rules "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/presence-rules.ts"
click node_finance_ui "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/components/treasury-manager.tsx"
click node_treasury_api "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/professor/treasury/route.ts"
click node_treasury "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/treasury.ts"
click node_investments "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/investments.ts"
click node_dev_coins "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/student/dev-coins/route.ts"
click node_stickers "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/stickers.ts"
click node_game_ui "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/components/pong-room.tsx"
click node_pong_engine "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/pong-engine.ts"
click node_pong_service "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/pong-service.ts"
click node_ludo_service "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/ludo-service.ts"
click node_other_games "https://github.com/luciano-mendesz9/salamaker-cmt/tree/main/src/lib"
click node_authorization "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/authorization.ts"
click node_security "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/request-security.ts"
click node_readiness "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/feature-readiness.ts"
click node_database "https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/db.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_teacher,node_activity_api,node_activities,node_student,node_submissions,node_attendance,node_presence_rules toneBlue
class node_finance_ui,node_treasury_api,node_treasury,node_investments,node_dev_coins,node_stickers toneAmber
class node_game_ui,node_pong_engine,node_pong_service,node_ludo_service,node_other_games toneMint
class node_authorization,node_security,node_readiness,node_database toneRose
```

## Components

### Classroom work

- [Teacher workspace](https://github.com/luciano-mendesz9/salamaker-cmt/tree/main/src/app/professor): `src/app/professor`
- [Activity management](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/professor/activities/route.ts): `src/app/api/professor/activities/route.ts`
- [Activity rules](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/activities.ts): `src/lib/activities.ts`
- [Student workspace](https://github.com/luciano-mendesz9/salamaker-cmt/tree/main/src/app/aluno): `src/app/aluno`
- [Activity submissions](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/student/activities/%5Bid%5D/submit/route.ts): `src/app/api/student/activities/[id]/submit/route.ts`
- [Attendance endpoints](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/presence/route.ts): `src/app/api/presence/route.ts`
- [Presence rules](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/presence-rules.ts): `src/lib/presence-rules.ts`

### Economy and collectibles

- [Treasury workspace](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/components/treasury-manager.tsx): `src/components/treasury-manager.tsx`
- [Treasury management](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/professor/treasury/route.ts): `src/app/api/professor/treasury/route.ts`
- [Treasury ledger](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/treasury.ts): `src/lib/treasury.ts`
- [Student investments](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/investments.ts): `src/lib/investments.ts`
- [Student coin economy](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/app/api/student/dev-coins/route.ts): `src/app/api/student/dev-coins/route.ts`
- [Sticker collections](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/stickers.ts): `src/lib/stickers.ts`

### Games

- [Game experiences](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/components/pong-room.tsx): `src/components/pong-room.tsx`
- [Pong engine](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/pong-engine.ts): `src/lib/pong-engine.ts`
- [Pong rooms](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/pong-service.ts): `src/lib/pong-service.ts`
- [Ludo rooms](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/ludo-service.ts): `src/lib/ludo-service.ts`
- [Other game services](https://github.com/luciano-mendesz9/salamaker-cmt/tree/main/src/lib): `src/lib`

### Platform services

- [Role authorization](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/authorization.ts): `src/lib/authorization.ts`
- [Request security](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/request-security.ts): `src/lib/request-security.ts`
- [Feature readiness](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/feature-readiness.ts): `src/lib/feature-readiness.ts`
- [Application database](https://github.com/luciano-mendesz9/salamaker-cmt/blob/main/src/lib/db.ts): `src/lib/db.ts`

## Connections

- Activity management → Role authorization: requires teacher (evidence: `src/app/api/professor/activities/route.ts`)
- Activity management → Activity rules: uses activity rules (evidence: `src/app/api/professor/activities/route.ts`)
- Activity management → Application database: reads and writes (evidence: `src/app/api/professor/activities/route.ts`)
- Attendance endpoints → Presence rules: checks participation (evidence: `src/app/api/presence/route.ts`)
- Attendance endpoints → Application database: reads and writes (evidence: `src/app/api/presence/route.ts`)
- Treasury management → Role authorization: requires teacher (evidence: `src/app/api/professor/treasury/route.ts`)
- Treasury management → Request security: secures requests (evidence: `src/app/api/professor/treasury/route.ts`)
- Treasury management → Feature readiness: checks schema (evidence: `src/app/api/professor/treasury/route.ts`)
- Treasury management → Application database: reads and writes (evidence: `src/app/api/professor/treasury/route.ts`)
- Treasury management → Treasury ledger: uses ledger
- Student coin economy → Role authorization: requires student (evidence: `src/app/api/student/dev-coins/route.ts`)
- Student coin economy → Request security: secures requests (evidence: `src/app/api/student/dev-coins/route.ts`)
- Student coin economy → Feature readiness: checks schema (evidence: `src/app/api/student/dev-coins/route.ts`)
- Student coin economy → Application database: updates balances (evidence: `src/app/api/student/dev-coins/route.ts`)
- Student coin economy → Treasury ledger: debits treasury (evidence: `src/app/api/student/dev-coins/route.ts`)
- Student investments → Treasury ledger: uses ledger (evidence: `src/lib/investments.ts`)
- Student investments → Application database: reads and writes (evidence: `src/lib/investments.ts`)
- Pong engine → Pong rooms: records points (evidence: `src/lib/pong-engine.ts`)
- Pong engine → Application database: loads rooms (evidence: `src/lib/pong-engine.ts`)
- Pong rooms → Treasury ledger: credits settlement (evidence: `src/lib/pong-service.ts`)
- Pong rooms → Application database: manages rooms (evidence: `src/lib/pong-service.ts`)
- Ludo rooms → Treasury ledger: uses ledger (evidence: `src/lib/ludo-service.ts`)
- Ludo rooms → Application database: stores game state (evidence: `src/lib/ludo-service.ts`)
- Other game services → Game experiences: serves game features
