# jcalistop/centinela-public architecture

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

- Interactive diagram: https://gitdiagram.com/jcalistop/centinela-public
- Repository: https://github.com/jcalistop/centinela-public

## Overview

Centinela is a multi-Service health platform for tracking evaluation instruments, evidence, and results. The principal workflow is staff operating Metas or COMGES instruments for a selected year and establishment or health service, then reviewing consolidated results; the README also identifies establishment browsing, public dashboards, messaging, and administration. The map preserves these product branches and the agent read API. Several subsystems are represented from the README and file tree rather than sampled implementation; their uncertain internal links are omitted. Evidence for the agent coverage links comes from the sampled service excerpt.

Main entry points: [`app/Livewire/MetasInstrument`](https://github.com/jcalistop/centinela-public/tree/main/app/Livewire/MetasInstrument) (Metas evaluation), [`app/Services/Agent/AgentCoverageService.php`](https://github.com/jcalistop/centinela-public/blob/main/app/Services/Agent/AgentCoverageService.php) (Instrument coverage), [`app/Models/IndicatorTypeSetting.php`](https://github.com/jcalistop/centinela-public/blob/main/app/Models/IndicatorTypeSetting.php) (Instrument settings), [`app/Services/Dashboard`](https://github.com/jcalistop/centinela-public/tree/main/app/Services/Dashboard) (Public dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_evaluation["Evaluation instruments"]
  node_metas["Metas evaluation"]
  node_metas_calc["Metas calculations"]
  node_met_indicator["Metas indicators<br/>[MetIndicator.php]"]
  node_comges["COMGES commitments"]
  node_com_indicator["COMGES indicators<br/>[ComIndicator.php]"]
  node_year[("Indicator year<br/>[Year.php]")]
end

subgraph group_catalog["Catalogs and establishments"]
  node_instrument_catalog[("Instrument catalog<br/>[IndicatorType.php]")]
  node_instrument_settings[("Instrument settings")]
  node_center_browse[("Establishment catalog<br/>[CenCenter.php]")]
  node_health_service[("Health service hierarchy")]
end

subgraph group_insight["Dashboards and access"]
  node_public_dashboard["Public dashboard"]
  node_dashboard_panel[("Public info panels")]
  node_admin["Platform administration"]
end

subgraph group_engagement["Messaging and support"]
  node_messaging["Campaign messaging"]
  node_support["Support tickets"]
end

subgraph group_integration["Agent API"]
  node_agent_api["Agent API"]
  node_agent_coverage["Instrument coverage"]
  node_comges_adapter["COMGES read adapter"]
  node_metas_adapter["Metas read adapter"]
end

node_staff(("Institutional staff"))
node_external_agent(("Agent client"))

node_staff -->|"records evaluations"| node_metas
node_staff -->|"manages commitments"| node_comges
node_staff -->|"explores centers"| node_center_browse
node_staff -->|"views panels"| node_public_dashboard
node_staff -->|"sends campaigns"| node_messaging
node_staff -->|"administers platform"| node_admin
node_staff -.->|"requests support"| node_support
node_metas -.->|"captures data"| node_met_indicator
node_metas -.->|"calculates results"| node_metas_calc
node_comges -.->|"evaluates indicators"| node_com_indicator
node_agent_api -.->|"serves coverage"| node_agent_coverage
node_agent_coverage -->|"counts indicators"| node_comges_adapter
node_agent_coverage -->|"counts indicators"| node_metas_adapter
node_external_agent -.->|"requests data"| node_agent_api
node_metas -.->|"uses year context"| node_year
node_metas -->|"checks stage"| node_instrument_settings
node_instrument_settings -->|"belongs to type"| node_instrument_catalog
node_public_dashboard -->|"reads settings"| node_instrument_settings
node_dashboard_panel -.->|"feeds dashboard"| node_public_dashboard

click node_metas "https://github.com/jcalistop/centinela-public/tree/main/app/Livewire/MetasInstrument"
click node_metas_calc "https://github.com/jcalistop/centinela-public/blob/main/app/Services/MetCalculationService.php"
click node_met_indicator "https://github.com/jcalistop/centinela-public/blob/main/app/Models/MetIndicator.php"
click node_comges "https://github.com/jcalistop/centinela-public/blob/main/app/Http/Controllers/ComgesController.php"
click node_com_indicator "https://github.com/jcalistop/centinela-public/blob/main/app/Models/ComIndicator.php"
click node_year "https://github.com/jcalistop/centinela-public/blob/main/app/Models/Year.php"
click node_instrument_catalog "https://github.com/jcalistop/centinela-public/blob/main/app/Models/IndicatorType.php"
click node_instrument_settings "https://github.com/jcalistop/centinela-public/blob/main/app/Models/IndicatorTypeSetting.php"
click node_center_browse "https://github.com/jcalistop/centinela-public/blob/main/app/Models/CenCenter.php"
click node_health_service "https://github.com/jcalistop/centinela-public/blob/main/app/Models/CenHieDependency.php"
click node_public_dashboard "https://github.com/jcalistop/centinela-public/tree/main/app/Services/Dashboard"
click node_dashboard_panel "https://github.com/jcalistop/centinela-public/blob/main/app/Models/PublicInfoPanel.php"
click node_admin "https://github.com/jcalistop/centinela-public/tree/main/app/Http/Controllers/Voyager"
click node_messaging "https://github.com/jcalistop/centinela-public/tree/main/app/Livewire/Messaging"
click node_support "https://github.com/jcalistop/centinela-public/blob/main/app/Http/Controllers/Support/SupportTicketController.php"
click node_agent_api "https://github.com/jcalistop/centinela-public/tree/main/app/Http/Controllers/Api/V1"
click node_agent_coverage "https://github.com/jcalistop/centinela-public/blob/main/app/Services/Agent/AgentCoverageService.php"
click node_comges_adapter "https://github.com/jcalistop/centinela-public/blob/main/app/Services/Agent/ComgesReadAdapter.php"
click node_metas_adapter "https://github.com/jcalistop/centinela-public/blob/main/app/Services/Agent/MetasReadAdapter.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_metas,node_metas_calc,node_met_indicator,node_comges,node_com_indicator,node_year,node_external_agent toneBlue
class node_instrument_catalog,node_instrument_settings,node_center_browse,node_health_service toneAmber
class node_public_dashboard,node_dashboard_panel,node_admin toneMint
class node_messaging,node_support toneRose
class node_agent_api,node_agent_coverage,node_comges_adapter,node_metas_adapter,node_staff toneIndigo
```

## Components

### Evaluation instruments

- [Metas evaluation](https://github.com/jcalistop/centinela-public/tree/main/app/Livewire/MetasInstrument): `app/Livewire/MetasInstrument`
- [Metas calculations](https://github.com/jcalistop/centinela-public/blob/main/app/Services/MetCalculationService.php): `app/Services/MetCalculationService.php`
- [Metas indicators](https://github.com/jcalistop/centinela-public/blob/main/app/Models/MetIndicator.php): `app/Models/MetIndicator.php`
- [COMGES commitments](https://github.com/jcalistop/centinela-public/blob/main/app/Http/Controllers/ComgesController.php): `app/Http/Controllers/ComgesController.php`
- [COMGES indicators](https://github.com/jcalistop/centinela-public/blob/main/app/Models/ComIndicator.php): `app/Models/ComIndicator.php`
- [Indicator year](https://github.com/jcalistop/centinela-public/blob/main/app/Models/Year.php): `app/Models/Year.php`

### Catalogs and establishments

- [Instrument catalog](https://github.com/jcalistop/centinela-public/blob/main/app/Models/IndicatorType.php): `app/Models/IndicatorType.php`
- [Instrument settings](https://github.com/jcalistop/centinela-public/blob/main/app/Models/IndicatorTypeSetting.php): `app/Models/IndicatorTypeSetting.php`
- [Establishment catalog](https://github.com/jcalistop/centinela-public/blob/main/app/Models/CenCenter.php): `app/Models/CenCenter.php`
- [Health service hierarchy](https://github.com/jcalistop/centinela-public/blob/main/app/Models/CenHieDependency.php): `app/Models/CenHieDependency.php`

### Dashboards and access

- [Public dashboard](https://github.com/jcalistop/centinela-public/tree/main/app/Services/Dashboard): `app/Services/Dashboard`
- [Public info panels](https://github.com/jcalistop/centinela-public/blob/main/app/Models/PublicInfoPanel.php): `app/Models/PublicInfoPanel.php`
- [Platform administration](https://github.com/jcalistop/centinela-public/tree/main/app/Http/Controllers/Voyager): `app/Http/Controllers/Voyager`

### Messaging and support

- [Campaign messaging](https://github.com/jcalistop/centinela-public/tree/main/app/Livewire/Messaging): `app/Livewire/Messaging`
- [Support tickets](https://github.com/jcalistop/centinela-public/blob/main/app/Http/Controllers/Support/SupportTicketController.php): `app/Http/Controllers/Support/SupportTicketController.php`

### Agent API

- [Agent API](https://github.com/jcalistop/centinela-public/tree/main/app/Http/Controllers/Api/V1): `app/Http/Controllers/Api/V1`
- [Instrument coverage](https://github.com/jcalistop/centinela-public/blob/main/app/Services/Agent/AgentCoverageService.php): `app/Services/Agent/AgentCoverageService.php`
- [COMGES read adapter](https://github.com/jcalistop/centinela-public/blob/main/app/Services/Agent/ComgesReadAdapter.php): `app/Services/Agent/ComgesReadAdapter.php`
- [Metas read adapter](https://github.com/jcalistop/centinela-public/blob/main/app/Services/Agent/MetasReadAdapter.php): `app/Services/Agent/MetasReadAdapter.php`

### Other components

- **Institutional staff**
- **Agent client**

## Connections

- Institutional staff → Metas evaluation: records evaluations
- Institutional staff → COMGES commitments: manages commitments
- Institutional staff → Establishment catalog: explores centers
- Institutional staff → Public dashboard: views panels
- Institutional staff → Campaign messaging: sends campaigns
- Institutional staff → Platform administration: administers platform
- Institutional staff → Support tickets: requests support
- Metas evaluation → Metas indicators: captures data
- Metas evaluation → Metas calculations: calculates results
- COMGES commitments → COMGES indicators: evaluates indicators
- Agent API → Instrument coverage: serves coverage
- Instrument coverage → COMGES read adapter: counts indicators (evidence: `app/Services/Agent/AgentCoverageService.php`)
- Instrument coverage → Metas read adapter: counts indicators (evidence: `app/Services/Agent/AgentCoverageService.php`)
- Agent client → Agent API: requests data
- Metas evaluation → Indicator year: uses year context (evidence: `app/Livewire/MetasInstrument/MeasurementUnitsManagerComponent.php`)
- Metas evaluation → Instrument settings: checks stage (evidence: `app/Livewire/MetasInstrument/MeasurementUnitsManagerComponent.php`)
- Instrument settings → Instrument catalog: belongs to type (evidence: `app/Models/IndicatorTypeSetting.php`)
- Public dashboard → Instrument settings: reads settings (evidence: `app/Models/IndicatorTypeSetting.php`)
- Public info panels → Public dashboard: feeds dashboard
