# joaovitorchaves-05/revoada-digital architecture

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

- Interactive diagram: https://gitdiagram.com/joaovitorchaves-05/revoada-digital
- Repository: https://github.com/joaovitorchaves-05/revoada-digital

## Overview

Revoada Digital is an ENEM study platform; the sampled implementation currently establishes a small backend MVP for user registration and profile management, administrator approvals, and health checks. The README also describes study practice, performance reporting, collaboration, points, rewards, and employment features, but the excerpts do not show their implementation or wiring. Those capabilities are included as unverified branches rather than asserted runtime flows; the frontend excerpt is only a scaffold. Connections in the implemented backend follow sampled code or SOURCE INDEX references.

Main entry points: [`apps/backend/src/server.ts`](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/server.ts) (Express app), [`apps/backend/src/routes/users.routes.ts`](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/routes/users.routes.ts) (User routes), [`apps/backend/src/routes/approvals.routes.ts`](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/routes/approvals.routes.ts) (Approval routes), [`apps/backend/src/lib/prisma.ts`](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/lib/prisma.ts) (Prisma client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP entry"]
  node_backend["Express app<br/>[server.ts]"]
  node_user_routes["User routes<br/>[users.routes.ts]"]
  node_approval_routes["Approval routes"]
  node_health_routes["Health routes<br/>[health.routes.ts]"]
  node_validation["Request validation"]
  node_health_controller["Health controller"]
  node_health_service["Health service<br/>[health.service.ts]"]
end

subgraph group_accounts["Accounts and approvals"]
  node_user_controller["User controller"]
  node_user_service["User service<br/>[user.service.ts]"]
  node_user_schema["User schema<br/>[user.schema.ts]"]
  node_approval_controller["Approval controller"]
  node_approval_service["Approval service"]
  node_approval_schema["Approval schema<br/>[approval.schema.ts]"]
end

subgraph group_learning["Study and community"]
  node_practice["ENEM practice"]
  node_reporting["Performance reports"]
  node_community["Forum and chat"]
end

subgraph group_rewards["Rewards and opportunities"]
  node_points["Points and rewards"]
  node_employment["Talent opportunities"]
  node_payment["Payment provider"]
end

subgraph group_persistence["Persistence"]
  node_user_repository["User repository<br/>[user.repository.ts]"]
  node_approval_repository["Approval repository"]
  node_health_repository["Health repository"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_database[("PostgreSQL<br/>[schema.prisma]")]
end

node_student(("Student"))
node_administrator(("Administrator"))

node_backend -->|"mounts"| node_user_routes
node_backend -->|"mounts"| node_approval_routes
node_backend -->|"mounts"| node_health_routes
node_user_routes -->|"routes requests"| node_user_controller
node_user_routes -->|"validates input"| node_validation
node_user_routes -->|"uses schema"| node_user_schema
node_approval_routes -->|"routes requests"| node_approval_controller
node_approval_routes -->|"validates input"| node_validation
node_approval_routes -->|"uses schema"| node_approval_schema
node_health_routes -->|"routes requests"| node_health_controller
node_user_controller -->|"calls"| node_user_service
node_approval_controller -->|"calls"| node_approval_service
node_health_controller -->|"calls"| node_health_service
node_user_service -->|"queries"| node_user_repository
node_approval_service -->|"queries"| node_approval_repository
node_health_service -->|"queries"| node_health_repository
node_user_repository -->|"queries"| node_prisma
node_approval_repository -->|"queries"| node_prisma
node_health_repository -->|"queries"| node_prisma
node_prisma -.->|"persists data"| node_database
node_student -.->|"uses platform"| node_backend
node_administrator -.->|"uses platform"| node_backend
node_student -.->|"takes practice"| node_practice
node_practice -.->|"informs reports"| node_reporting
node_student -.->|"uses community"| node_community
node_student -.->|"earns points"| node_points
node_points -.->|"may fund"| node_payment
node_employment -.->|"serves students"| node_student

click node_backend "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/server.ts"
click node_user_routes "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/routes/users.routes.ts"
click node_approval_routes "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/routes/approvals.routes.ts"
click node_health_routes "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/routes/health.routes.ts"
click node_validation "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/middlewares/validate.middleware.ts"
click node_user_controller "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/controllers/users.controller.ts"
click node_user_service "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/services/user.service.ts"
click node_user_schema "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/schemas/user.schema.ts"
click node_approval_controller "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/controllers/approval.controller.ts"
click node_approval_service "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/services/approval.service.ts"
click node_approval_schema "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/schemas/approval.schema.ts"
click node_health_controller "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/controllers/health.controller.ts"
click node_health_service "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/services/health.service.ts"
click node_user_repository "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/repositories/user.repository.ts"
click node_approval_repository "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/repositories/approval.repository.ts"
click node_health_repository "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/repositories/health.repository.ts"
click node_prisma "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/lib/prisma.ts"
click node_database "https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/prisma/schema.prisma"
click node_practice "https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src"
click node_reporting "https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src"
click node_community "https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src"
click node_points "https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src"
click node_employment "https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src"

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_backend,node_user_routes,node_approval_routes,node_health_routes,node_validation,node_health_controller,node_health_service toneBlue
class node_user_controller,node_user_service,node_user_schema,node_approval_controller,node_approval_service,node_approval_schema toneAmber
class node_practice,node_reporting,node_community toneMint
class node_points,node_employment,node_payment toneRose
class node_user_repository,node_approval_repository,node_health_repository,node_prisma,node_database,node_student,node_administrator toneIndigo
```

## Components

### HTTP entry

- [Express app](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/server.ts): `apps/backend/src/server.ts`
- [User routes](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/routes/users.routes.ts): `apps/backend/src/routes/users.routes.ts`
- [Approval routes](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/routes/approvals.routes.ts): `apps/backend/src/routes/approvals.routes.ts`
- [Health routes](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/routes/health.routes.ts): `apps/backend/src/routes/health.routes.ts`
- [Request validation](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/middlewares/validate.middleware.ts): `apps/backend/src/middlewares/validate.middleware.ts`
- [Health controller](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/controllers/health.controller.ts): `apps/backend/src/controllers/health.controller.ts`
- [Health service](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/services/health.service.ts): `apps/backend/src/services/health.service.ts`

### Accounts and approvals

- [User controller](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/controllers/users.controller.ts): `apps/backend/src/controllers/users.controller.ts`
- [User service](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/services/user.service.ts): `apps/backend/src/services/user.service.ts`
- [User schema](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/schemas/user.schema.ts): `apps/backend/src/schemas/user.schema.ts`
- [Approval controller](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/controllers/approval.controller.ts): `apps/backend/src/controllers/approval.controller.ts`
- [Approval service](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/services/approval.service.ts): `apps/backend/src/services/approval.service.ts`
- [Approval schema](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/schemas/approval.schema.ts): `apps/backend/src/schemas/approval.schema.ts`

### Study and community

- [ENEM practice](https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src): `apps/backend/src`
- [Performance reports](https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src): `apps/backend/src`
- [Forum and chat](https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src): `apps/backend/src`

### Rewards and opportunities

- [Points and rewards](https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src): `apps/backend/src`
- [Talent opportunities](https://github.com/joaovitorchaves-05/revoada-digital/tree/main/apps/backend/src): `apps/backend/src`
- **Payment provider**

### Persistence

- [User repository](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/repositories/user.repository.ts): `apps/backend/src/repositories/user.repository.ts`
- [Approval repository](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/repositories/approval.repository.ts): `apps/backend/src/repositories/approval.repository.ts`
- [Health repository](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/repositories/health.repository.ts): `apps/backend/src/repositories/health.repository.ts`
- [Prisma client](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/src/lib/prisma.ts): `apps/backend/src/lib/prisma.ts`
- [PostgreSQL](https://github.com/joaovitorchaves-05/revoada-digital/blob/main/apps/backend/prisma/schema.prisma): `apps/backend/prisma/schema.prisma`

### Other components

- **Student**
- **Administrator**

## Connections

- Express app → User routes: mounts (evidence: `apps/backend/src/server.ts`)
- Express app → Approval routes: mounts (evidence: `apps/backend/src/server.ts`)
- Express app → Health routes: mounts (evidence: `apps/backend/src/server.ts`)
- User routes → User controller: routes requests (evidence: `apps/backend/src/routes/users.routes.ts`)
- User routes → Request validation: validates input (evidence: `apps/backend/src/routes/users.routes.ts`)
- User routes → User schema: uses schema (evidence: `apps/backend/src/routes/users.routes.ts`)
- Approval routes → Approval controller: routes requests (evidence: `apps/backend/src/routes/approvals.routes.ts`)
- Approval routes → Request validation: validates input (evidence: `apps/backend/src/routes/approvals.routes.ts`)
- Approval routes → Approval schema: uses schema (evidence: `apps/backend/src/routes/approvals.routes.ts`)
- Health routes → Health controller: routes requests (evidence: `apps/backend/src/routes/health.routes.ts`)
- User controller → User service: calls (evidence: `apps/backend/src/controllers/users.controller.ts`)
- Approval controller → Approval service: calls (evidence: `apps/backend/src/controllers/approval.controller.ts`)
- Health controller → Health service: calls (evidence: `apps/backend/src/controllers/health.controller.ts`)
- User service → User repository: queries (evidence: `apps/backend/src/services/user.service.ts`)
- Approval service → Approval repository: queries (evidence: `apps/backend/src/services/approval.service.ts`)
- Health service → Health repository: queries (evidence: `apps/backend/src/services/health.service.ts`)
- User repository → Prisma client: queries (evidence: `apps/backend/src/repositories/user.repository.ts`)
- Approval repository → Prisma client: queries (evidence: `apps/backend/src/repositories/approval.repository.ts`)
- Health repository → Prisma client: queries (evidence: `apps/backend/src/repositories/health.repository.ts`)
- Prisma client → PostgreSQL: persists data
- Student → Express app: uses platform
- Administrator → Express app: uses platform
- Student → ENEM practice: takes practice (evidence: `readme.md`)
- ENEM practice → Performance reports: informs reports (evidence: `readme.md`)
- Student → Forum and chat: uses community (evidence: `readme.md`)
- Student → Points and rewards: earns points (evidence: `readme.md`)
- Points and rewards → Payment provider: may fund (evidence: `readme.md`)
- Talent opportunities → Student: serves students (evidence: `readme.md`)
