# pedrohdemelorosa/scom---motor-de-elegibilidade architecture

> Architecture diagram of the GitHub repository pedrohdemelorosa/scom---motor-de-elegibilidade, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pedrohdemelorosa/scom---motor-de-elegibilidade
- Repository: https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade

## Overview

SCOM is a Laravel web application for maintaining student socioeconomic profiles and triaging them against published opportunity rules. Students register, authenticate, complete a profile, and receive explainable eligibility results with separate logistics alerts; coordinators manage and publish calls and version rule corrections; directors administer accounts and review activity. The graph preserves the documented map capability and the present-but-out-of-scope AI import subsystem. Some controller excerpts are partial, so uncertain view and integration links are omitted.

Main entry points: [`routes/web.php`](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/routes/web.php) (Web routes), [`app/Http/Controllers/Diretor/GestaoUsuarioController.php`](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Diretor/GestaoUsuarioController.php) (Account administration), [`app/Http/Controllers/Coordenador/GestaoEditalController.php`](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Coordenador/GestaoEditalController.php) (Call management), [`app/Http/Controllers/PainelEstudanteController.php`](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/PainelEstudanteController.php) (Student panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and profiles"]
  node_auth["Registration and login<br/>[AuthController.php]"]
  node_account[("User accounts<br/>[User.php]")]
  node_profile[("Socioeconomic profile")]
end

subgraph group_opportunities["Calls and rules"]
  node_public_calls["Public call details"]
  node_call_view["Public call view<br/>[edital.blade.php]"]
  node_call_management["Call management"]
  node_calls[("Calls<br/>[Edital.php]")]
  node_rules[("Eligibility rules")]
  node_corrections[("Rule correction history")]
  node_coord_view["Coordinator dashboard"]
end

subgraph group_triage["Eligibility triage"]
  node_student_panel["Student panel"]
  node_evaluator["Eligibility evaluator"]
  node_student_view["Student panel view<br/>[painel.blade.php]"]
end

subgraph group_governance["Administration and audit"]
  node_user_admin["Account administration"]
  node_director_view["Director dashboard"]
  node_audit[("Audit log<br/>[LogAuditoria.php]")]
end

subgraph group_ai["AI import"]
  node_ia_import["AI call import"]
  node_text_extract["PDF text extraction"]
  node_ai_analysis["AI analysis"]
end

node_student(("Student"))
node_coordinator(("Coordinator"))
node_director(("Director"))
node_routing["Web routes<br/>[web.php]"]

node_student -->|"opens"| node_routing
node_coordinator -->|"opens"| node_routing
node_director -->|"opens"| node_routing
node_routing -->|"routes to"| node_auth
node_routing -->|"routes to"| node_student_panel
node_routing -->|"routes to"| node_public_calls
node_routing -->|"routes to"| node_call_management
node_routing -->|"routes to"| node_user_admin
node_auth -->|"authenticates"| node_account
node_student_panel -->|"loads user"| node_account
node_student_panel -->|"reads and saves"| node_profile
node_student_panel -->|"loads active rules"| node_rules
node_student_panel -->|"evaluates"| node_evaluator
node_student_panel -.->|"renders"| node_student_view
node_public_calls -->|"reads"| node_calls
node_public_calls -->|"renders"| node_call_view
node_call_management -->|"creates and updates"| node_calls
node_call_management -->|"manages"| node_rules
node_call_management -->|"records corrections"| node_corrections
node_call_management -->|"records actions"| node_audit
node_call_management -.->|"renders"| node_coord_view
node_user_admin -->|"administers"| node_account
node_user_admin -->|"reads profiles"| node_profile
node_user_admin -->|"loads published rules"| node_rules
node_user_admin -->|"evaluates eligibility"| node_evaluator
node_user_admin -->|"reads activity"| node_audit
node_user_admin -->|"renders"| node_director_view
node_routing -->|"routes to"| node_ia_import
node_coordinator -.->|"requests scan"| node_ia_import
node_ia_import -->|"extracts text"| node_text_extract
node_ia_import -->|"analyzes text"| node_ai_analysis

click node_auth "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/AuthController.php"
click node_account "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/User.php"
click node_profile "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/PerfilEstudante.php"
click node_student_panel "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/PainelEstudanteController.php"
click node_evaluator "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Services/Elegibilidade/AvaliadorElegibilidade.php"
click node_student_view "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/resources/views/estudante/painel.blade.php"
click node_public_calls "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Estudante/EditalPublicoController.php"
click node_call_view "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/resources/views/estudante/edital.blade.php"
click node_call_management "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Coordenador/GestaoEditalController.php"
click node_calls "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/Edital.php"
click node_rules "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/RegraElegibilidade.php"
click node_corrections "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/HistoricoRetificacao.php"
click node_coord_view "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/resources/views/editor/dashboard_coordenador.blade.php"
click node_user_admin "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Diretor/GestaoUsuarioController.php"
click node_director_view "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/resources/views/editor/dashboard_diretor.blade.php"
click node_audit "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/LogAuditoria.php"
click node_ia_import "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Coordenador/ImportacaoEditalIAController.php"
click node_text_extract "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Services/IA/ExtratorTextoEdital.php"
click node_ai_analysis "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Services/IA/AnalisadorEditalIA.php"
click node_routing "https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/routes/web.php"

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,node_account,node_profile toneBlue
class node_public_calls,node_call_view,node_call_management,node_calls,node_rules,node_corrections,node_coord_view toneAmber
class node_student_panel,node_evaluator,node_student_view,node_routing toneMint
class node_user_admin,node_director_view,node_audit toneRose
class node_ia_import,node_text_extract,node_ai_analysis,node_student,node_coordinator,node_director toneIndigo
```

## Components

### Access and profiles

- [Registration and login](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/AuthController.php): `app/Http/Controllers/AuthController.php`
- [User accounts](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/User.php): `app/Models/User.php`
- [Socioeconomic profile](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/PerfilEstudante.php): `app/Models/PerfilEstudante.php`

### Calls and rules

- [Public call details](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Estudante/EditalPublicoController.php): `app/Http/Controllers/Estudante/EditalPublicoController.php`
- [Public call view](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/resources/views/estudante/edital.blade.php): `resources/views/estudante/edital.blade.php`
- [Call management](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Coordenador/GestaoEditalController.php): `app/Http/Controllers/Coordenador/GestaoEditalController.php`
- [Calls](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/Edital.php): `app/Models/Edital.php`
- [Eligibility rules](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/RegraElegibilidade.php): `app/Models/RegraElegibilidade.php`
- [Rule correction history](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/HistoricoRetificacao.php): `app/Models/HistoricoRetificacao.php`
- [Coordinator dashboard](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/resources/views/editor/dashboard_coordenador.blade.php): `resources/views/editor/dashboard_coordenador.blade.php`

### Eligibility triage

- [Student panel](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/PainelEstudanteController.php): `app/Http/Controllers/PainelEstudanteController.php`
- [Eligibility evaluator](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Services/Elegibilidade/AvaliadorElegibilidade.php): `app/Services/Elegibilidade/AvaliadorElegibilidade.php`
- [Student panel view](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/resources/views/estudante/painel.blade.php): `resources/views/estudante/painel.blade.php`

### Administration and audit

- [Account administration](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Diretor/GestaoUsuarioController.php): `app/Http/Controllers/Diretor/GestaoUsuarioController.php`
- [Director dashboard](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/resources/views/editor/dashboard_diretor.blade.php): `resources/views/editor/dashboard_diretor.blade.php`
- [Audit log](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Models/LogAuditoria.php): `app/Models/LogAuditoria.php`

### AI import

- [AI call import](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Http/Controllers/Coordenador/ImportacaoEditalIAController.php): `app/Http/Controllers/Coordenador/ImportacaoEditalIAController.php`
- [PDF text extraction](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Services/IA/ExtratorTextoEdital.php): `app/Services/IA/ExtratorTextoEdital.php`
- [AI analysis](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/app/Services/IA/AnalisadorEditalIA.php): `app/Services/IA/AnalisadorEditalIA.php`

### Other components

- **Student**
- **Coordinator**
- **Director**
- [Web routes](https://github.com/pedrohdemelorosa/scom---motor-de-elegibilidade/blob/main/routes/web.php): `routes/web.php`

## Connections

- Student → Web routes: opens (evidence: `routes/web.php`)
- Coordinator → Web routes: opens (evidence: `routes/web.php`)
- Director → Web routes: opens (evidence: `routes/web.php`)
- Web routes → Registration and login: routes to (evidence: `routes/web.php`)
- Web routes → Student panel: routes to (evidence: `routes/web.php`)
- Web routes → Public call details: routes to (evidence: `routes/web.php`)
- Web routes → Call management: routes to (evidence: `routes/web.php`)
- Web routes → Account administration: routes to (evidence: `routes/web.php`)
- Registration and login → User accounts: authenticates (evidence: `app/Http/Controllers/AuthController.php`)
- Student panel → User accounts: loads user (evidence: `app/Http/Controllers/PainelEstudanteController.php`)
- Student panel → Socioeconomic profile: reads and saves (evidence: `app/Http/Controllers/PainelEstudanteController.php`)
- Student panel → Eligibility rules: loads active rules (evidence: `app/Http/Controllers/PainelEstudanteController.php`)
- Student panel → Eligibility evaluator: evaluates (evidence: `app/Http/Controllers/PainelEstudanteController.php`)
- Student panel → Student panel view: renders
- Public call details → Calls: reads (evidence: `app/Http/Controllers/Estudante/EditalPublicoController.php`)
- Public call details → Public call view: renders (evidence: `app/Http/Controllers/Estudante/EditalPublicoController.php`)
- Call management → Calls: creates and updates (evidence: `app/Http/Controllers/Coordenador/GestaoEditalController.php`)
- Call management → Eligibility rules: manages (evidence: `app/Http/Controllers/Coordenador/GestaoEditalController.php`)
- Call management → Rule correction history: records corrections (evidence: `app/Http/Controllers/Coordenador/GestaoEditalController.php`)
- Call management → Audit log: records actions (evidence: `app/Http/Controllers/Coordenador/GestaoEditalController.php`)
- Call management → Coordinator dashboard: renders
- Account administration → User accounts: administers (evidence: `app/Http/Controllers/Diretor/GestaoUsuarioController.php`)
- Account administration → Socioeconomic profile: reads profiles (evidence: `app/Http/Controllers/Diretor/GestaoUsuarioController.php`)
- Account administration → Eligibility rules: loads published rules (evidence: `app/Http/Controllers/Diretor/GestaoUsuarioController.php`)
- Account administration → Eligibility evaluator: evaluates eligibility (evidence: `app/Http/Controllers/Diretor/GestaoUsuarioController.php`)
- Account administration → Audit log: reads activity (evidence: `app/Http/Controllers/Diretor/GestaoUsuarioController.php`)
- Account administration → Director dashboard: renders (evidence: `app/Http/Controllers/Diretor/GestaoUsuarioController.php`)
- Web routes → AI call import: routes to (evidence: `routes/web.php`)
- Coordinator → AI call import: requests scan
- AI call import → PDF text extraction: extracts text (evidence: `app/Http/Controllers/Coordenador/ImportacaoEditalIAController.php`)
- AI call import → AI analysis: analyzes text (evidence: `app/Http/Controllers/Coordenador/ImportacaoEditalIAController.php`)
