# isrrael-sirpa/sistema-certificados architecture

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

- Interactive diagram: https://gitdiagram.com/isrrael-sirpa/sistema-certificados
- Repository: https://github.com/isrrael-sirpa/sistema-certificados

## Overview

This Laravel application manages institutional activities, beneficiaries, certificate-template design, issuance, PDF generation, and public verification. The main workflow is to enroll beneficiaries in activities, issue certificates, render downloadable PDFs, and let recipients verify them. Administration, reporting, organizational-unit access, and audit logging are supporting capabilities. The README describes Laravel rather than this product, so architecture details come from the file tree and SOURCE INDEX; unsampled controllers and integrations are represented conservatively.

Main entry points: [`routes/web.php`](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/routes/web.php) (Web routes), [`app/Models/Certificate.php`](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Certificate.php) (Certificate records), [`app/Http/Controllers/ActivityController.php`](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/ActivityController.php) (Activity management), [`app/Services/CertificateService.php`](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/CertificateService.php) (Certificate issuance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Activities &amp; beneficiaries"]
  node_activity["Activity management"]
  node_beneficiary["Beneficiary management"]
  node_imports["Import &amp; enrollment"]
end

subgraph group_certificates["Certificate lifecycle"]
  node_certcontroller["Certificate actions"]
  node_certservice["Certificate issuance"]
  node_pdf["PDF rendering"]
  node_templates["Template design"]
  node_templateengine["Template engine"]
  node_layout["Layout presets"]
  node_verification["Public verification"]
end

subgraph group_administration["Administration &amp; access"]
  node_web["Web routes<br/>[web.php]"]
  node_dashboard["Dashboard"]
  node_reports["Reports"]
  node_users["User administration<br/>[UserController.php]"]
  node_settings["System settings"]
  node_assets["Institutional assets"]
end

subgraph group_domain["Domain records"]
  node_activitymodel["Activity records<br/>[Activity.php]"]
  node_beneficiarymodel["Beneficiary records<br/>[Beneficiary.php]"]
  node_certificate["Certificate records<br/>[Certificate.php]"]
  node_type["Certificate types"]
  node_templatemodel["Template records"]
  node_unit["Organizational units"]
  node_audit["Audit records<br/>[AuditLog.php]"]
  node_settingmodel["Setting records<br/>[Setting.php]"]
end

node_user(("Staff user"))

node_user -->|"requests pages"| node_web
node_web -->|"routes to"| node_activity
node_web -->|"routes to"| node_beneficiary
node_web -->|"routes to"| node_certcontroller
node_web -->|"routes to"| node_templates
node_web -->|"routes to"| node_verification
node_web -->|"routes to"| node_dashboard
node_web -->|"routes to"| node_reports
node_web -->|"routes to"| node_users
node_web -->|"routes to"| node_settings
node_activity -->|"uses records"| node_activitymodel
node_activity -->|"delegates imports"| node_imports
node_activity -->|"requests issuance"| node_certservice
node_activity -->|"uses records"| node_beneficiarymodel
node_beneficiary -->|"delegates imports"| node_imports
node_beneficiary -->|"uses records"| node_beneficiarymodel
node_imports -->|"creates records"| node_beneficiarymodel
node_imports -->|"requests issuance"| node_certservice
node_certcontroller -->|"delegates issuance"| node_certservice
node_certcontroller -->|"requests PDFs"| node_pdf
node_certservice -->|"generates PDFs"| node_pdf
node_certservice -->|"creates records"| node_certificate
node_pdf -->|"resolves template text"| node_templateengine
node_pdf -->|"resolves assets"| node_assets
node_templates -->|"uses engine"| node_templateengine
node_templates -->|"loads presets"| node_layout
node_templates -->|"manages records"| node_templatemodel
node_verification -.->|"looks up certificates"| node_certificate
node_reports -.->|"reports on"| node_certificate
node_users -->|"manages access scope"| node_unit
node_settings -->|"updates settings"| node_settingmodel
node_activitymodel -->|"belongs to"| node_unit
node_activitymodel -->|"enrolls participants"| node_beneficiarymodel
node_certificate -->|"belongs to"| node_beneficiarymodel
node_certificate -->|"belongs to"| node_activitymodel
node_certificate -->|"belongs to"| node_type
node_certificate -->|"uses template"| node_templatemodel
node_templatemodel -->|"scopes templates"| node_unit
node_activity -->|"writes audit log"| node_audit
node_beneficiary -->|"writes audit log"| node_audit

click node_web "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/routes/web.php"
click node_activity "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/ActivityController.php"
click node_beneficiary "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/BeneficiaryController.php"
click node_imports "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/BeneficiaryImportService.php"
click node_certcontroller "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/CertificateController.php"
click node_certservice "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/CertificateService.php"
click node_pdf "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/CertificatePdfService.php"
click node_templates "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/CertificateTemplateController.php"
click node_templateengine "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/TemplateEngineService.php"
click node_layout "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/CertificateLayoutService.php"
click node_verification "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/VerificationController.php"
click node_dashboard "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/DashboardController.php"
click node_reports "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/ReportController.php"
click node_users "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/UserController.php"
click node_settings "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/SettingController.php"
click node_assets "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/AssetManagerService.php"
click node_activitymodel "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Activity.php"
click node_beneficiarymodel "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Beneficiary.php"
click node_certificate "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Certificate.php"
click node_type "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/CertificateType.php"
click node_templatemodel "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/CertificateTemplate.php"
click node_unit "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/OrganizationalUnit.php"
click node_audit "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/AuditLog.php"
click node_settingmodel "https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Setting.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_activity,node_beneficiary,node_imports,node_user toneBlue
class node_certcontroller,node_certservice,node_pdf,node_templates,node_templateengine,node_layout,node_verification toneAmber
class node_web,node_dashboard,node_reports,node_users,node_settings,node_assets toneMint
class node_activitymodel,node_beneficiarymodel,node_certificate,node_type,node_templatemodel,node_unit,node_audit,node_settingmodel toneRose
```

## Components

### Activities & beneficiaries

- [Activity management](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/ActivityController.php): `app/Http/Controllers/ActivityController.php`
- [Beneficiary management](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/BeneficiaryController.php): `app/Http/Controllers/BeneficiaryController.php`
- [Import & enrollment](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/BeneficiaryImportService.php): `app/Services/BeneficiaryImportService.php`

### Certificate lifecycle

- [Certificate actions](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/CertificateController.php): `app/Http/Controllers/CertificateController.php`
- [Certificate issuance](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/CertificateService.php): `app/Services/CertificateService.php`
- [PDF rendering](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/CertificatePdfService.php): `app/Services/CertificatePdfService.php`
- [Template design](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/CertificateTemplateController.php): `app/Http/Controllers/CertificateTemplateController.php`
- [Template engine](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/TemplateEngineService.php): `app/Services/TemplateEngineService.php`
- [Layout presets](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/CertificateLayoutService.php): `app/Services/CertificateLayoutService.php`
- [Public verification](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/VerificationController.php): `app/Http/Controllers/VerificationController.php`

### Administration & access

- [Web routes](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/routes/web.php): `routes/web.php`
- [Dashboard](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Reports](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/ReportController.php): `app/Http/Controllers/ReportController.php`
- [User administration](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/UserController.php): `app/Http/Controllers/UserController.php`
- [System settings](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Http/Controllers/SettingController.php): `app/Http/Controllers/SettingController.php`
- [Institutional assets](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Services/AssetManagerService.php): `app/Services/AssetManagerService.php`

### Domain records

- [Activity records](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Activity.php): `app/Models/Activity.php`
- [Beneficiary records](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Beneficiary.php): `app/Models/Beneficiary.php`
- [Certificate records](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Certificate.php): `app/Models/Certificate.php`
- [Certificate types](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/CertificateType.php): `app/Models/CertificateType.php`
- [Template records](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/CertificateTemplate.php): `app/Models/CertificateTemplate.php`
- [Organizational units](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/OrganizationalUnit.php): `app/Models/OrganizationalUnit.php`
- [Audit records](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/AuditLog.php): `app/Models/AuditLog.php`
- [Setting records](https://github.com/isrrael-sirpa/sistema-certificados/blob/main/app/Models/Setting.php): `app/Models/Setting.php`

### Other components

- **Staff user**

## Connections

- Staff user → Web routes: requests pages (evidence: `routes/web.php`)
- Web routes → Activity management: routes to (evidence: `routes/web.php`)
- Web routes → Beneficiary management: routes to (evidence: `routes/web.php`)
- Web routes → Certificate actions: routes to (evidence: `routes/web.php`)
- Web routes → Template design: routes to (evidence: `routes/web.php`)
- Web routes → Public verification: routes to (evidence: `routes/web.php`)
- Web routes → Dashboard: routes to (evidence: `routes/web.php`)
- Web routes → Reports: routes to (evidence: `routes/web.php`)
- Web routes → User administration: routes to (evidence: `routes/web.php`)
- Web routes → System settings: routes to (evidence: `routes/web.php`)
- Activity management → Activity records: uses records (evidence: `app/Http/Controllers/ActivityController.php`)
- Activity management → Import & enrollment: delegates imports (evidence: `app/Http/Controllers/ActivityController.php`)
- Activity management → Certificate issuance: requests issuance (evidence: `app/Http/Controllers/ActivityController.php`)
- Activity management → Beneficiary records: uses records (evidence: `app/Http/Controllers/ActivityController.php`)
- Beneficiary management → Import & enrollment: delegates imports (evidence: `app/Http/Controllers/BeneficiaryController.php`)
- Beneficiary management → Beneficiary records: uses records (evidence: `app/Http/Controllers/BeneficiaryController.php`)
- Import & enrollment → Beneficiary records: creates records (evidence: `app/Services/BeneficiaryImportService.php`)
- Import & enrollment → Certificate issuance: requests issuance (evidence: `app/Services/BeneficiaryImportService.php`)
- Certificate actions → Certificate issuance: delegates issuance (evidence: `app/Http/Controllers/CertificateController.php`)
- Certificate actions → PDF rendering: requests PDFs (evidence: `app/Http/Controllers/CertificateController.php`)
- Certificate issuance → PDF rendering: generates PDFs (evidence: `app/Services/CertificateService.php`)
- Certificate issuance → Certificate records: creates records (evidence: `app/Services/CertificateService.php`)
- PDF rendering → Template engine: resolves template text (evidence: `app/Services/CertificatePdfService.php`)
- PDF rendering → Institutional assets: resolves assets (evidence: `app/Services/CertificatePdfService.php`)
- Template design → Template engine: uses engine (evidence: `app/Http/Controllers/CertificateTemplateController.php`)
- Template design → Layout presets: loads presets (evidence: `app/Http/Controllers/CertificateTemplateController.php`)
- Template design → Template records: manages records (evidence: `app/Http/Controllers/CertificateTemplateController.php`)
- Public verification → Certificate records: looks up certificates
- Reports → Certificate records: reports on
- User administration → Organizational units: manages access scope (evidence: `app/Http/Controllers/UserController.php`)
- System settings → Setting records: updates settings (evidence: `app/Http/Controllers/SettingController.php`)
- Activity records → Organizational units: belongs to (evidence: `app/Models/Activity.php`)
- Activity records → Beneficiary records: enrolls participants (evidence: `app/Models/Activity.php`)
- Certificate records → Beneficiary records: belongs to (evidence: `app/Models/Certificate.php`)
- Certificate records → Activity records: belongs to (evidence: `app/Models/Certificate.php`)
- Certificate records → Certificate types: belongs to (evidence: `app/Models/Certificate.php`)
- Certificate records → Template records: uses template (evidence: `app/Models/Certificate.php`)
- Template records → Organizational units: scopes templates (evidence: `app/Models/CertificateTemplate.php`)
- Activity management → Audit records: writes audit log (evidence: `app/Http/Controllers/ActivityController.php`)
- Beneficiary management → Audit records: writes audit log (evidence: `app/Http/Controllers/BeneficiaryController.php`)
