# jumen-ux/sinep-rd architecture

> Architecture diagram of the GitHub repository jumen-ux/sinep-rd, 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/jumen-ux/sinep-rd
- Repository: https://github.com/jumen-ux/sinep-rd

## Overview

SINEP RD is a Dominican ecclesiastical information system combining public directories and profiles with administrative workflows over a canonical, historical Supabase-backed dataset. Public visitors browse people and institutions or submit corrections; administrators manage records, appointments, events, imports, reviews, and access. The map highlights major documented capabilities and sampled call relationships. Several feature routes and services are represented by their exact tree paths, but their internal wiring was not sampled, so those connections are omitted rather than inferred.

Main entry points: [`src/app/(admin)/admin`](https://github.com/jumen-ux/sinep-rd/tree/main/src/app/(admin)/admin) (Admin workspace), [`src/app/api/admin/persona-canonica/route.ts`](https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/admin/persona-canonica/route.ts) (Canonical registration), [`src/features/public`](https://github.com/jumen-ux/sinep-rd/tree/main/src/features/public) (Public portal), [`src/app/api/sugerencias/route.ts`](https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/sugerencias/route.ts) (Public suggestions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public portal"]
  node_public_portal["Public portal"]
  node_public_people["People directory<br/>[route.ts]"]
  node_public_entities["Entity directory<br/>[route.ts]"]
  node_public_profiles["Public profiles<br/>[entity-detail.ts]"]
  node_suggestions["Public suggestions<br/>[route.ts]"]
end

subgraph group_admin["Administration"]
  node_admin_portal["Admin workspace"]
  node_access["Access management"]
  node_dashboard["Admin dashboard"]
  node_imports["Batch imports"]
  node_review["Review queues"]
end

subgraph group_domain["Canonical workflows"]
  node_people_admin["People records"]
  node_canonical_people["Canonical registration<br/>[route.ts]"]
  node_organization["Organization units"]
  node_appointments["Appointments"]
  node_events["Events"]
  node_structures["Ecclesial structures"]
end

subgraph group_platform["Shared platform"]
  node_supabase_client["Browser client<br/>[client.ts]"]
  node_supabase_server["Server client<br/>[server.ts]"]
  node_supabase_rest["REST access<br/>[rest.ts]"]
  node_supabase_config["Supabase config<br/>[config.ts]"]
  node_authorization["Admin authorization<br/>[authorization.ts]"]
  node_validation["Request validation<br/>[validation.ts]"]
  node_audit["Audit logging<br/>[audit.ts]"]
  node_public_cache["Public cache<br/>[cache.ts]"]
end

node_visitor(("Public visitor"))
node_admin_user(("Administrator"))
node_supabase[("Supabase")]

node_visitor -->|"browses"| node_public_portal
node_public_portal -.->|"loads directory"| node_public_people
node_public_portal -.->|"loads directory"| node_public_entities
node_public_portal -.->|"opens profiles"| node_public_profiles
node_visitor -.->|"submits corrections"| node_suggestions
node_public_people -->|"fetches records"| node_supabase_rest
node_public_entities -->|"fetches records"| node_supabase_rest
node_suggestions -->|"writes suggestions"| node_supabase_rest
node_suggestions -->|"validates input"| node_validation
node_public_cache -->|"caches details"| node_public_profiles
node_admin_user -.->|"manages records"| node_admin_portal
node_admin_portal -.->|"presents metrics"| node_dashboard
node_admin_portal -.->|"manages access"| node_access
node_admin_portal -.->|"manages batches"| node_imports
node_admin_portal -.->|"reviews changes"| node_review
node_admin_portal -.->|"manages people"| node_people_admin
node_admin_portal -.->|"manages units"| node_organization
node_admin_portal -->|"manages appointments"| node_appointments
node_appointments -->|"uses placement"| node_people_admin
node_admin_portal -.->|"manages events"| node_events
node_admin_portal -.->|"configures structures"| node_structures
node_canonical_people -->|"checks access"| node_authorization
node_canonical_people -->|"validates payload"| node_validation
node_canonical_people -->|"records action"| node_audit
node_canonical_people -->|"revalidates pages"| node_public_cache
node_appointments -->|"loads catalogs"| node_supabase_client
node_organization -->|"uses client"| node_supabase_client
node_supabase_client -->|"reads settings"| node_supabase_config
node_supabase_server -->|"reads settings"| node_supabase_config
node_supabase_rest -->|"reads settings"| node_supabase_config
node_authorization -->|"creates session"| node_supabase_server
node_audit -->|"writes audit"| node_supabase_server
node_public_people -.->|"reads data"| node_supabase
node_public_entities -.->|"reads data"| node_supabase
node_canonical_people -->|"saves canonical data"| node_supabase
node_suggestions -->|"stores suggestions"| node_supabase

click node_public_portal "https://github.com/jumen-ux/sinep-rd/tree/main/src/features/public"
click node_public_people "https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/personas/route.ts"
click node_public_entities "https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/entidades/route.ts"
click node_public_profiles "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/public/entity-detail.ts"
click node_suggestions "https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/sugerencias/route.ts"
click node_admin_portal "https://github.com/jumen-ux/sinep-rd/tree/main/src/app/(admin)/admin"
click node_access "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/access/services/authentication-admin-service.ts"
click node_dashboard "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/admin/dashboard/admin-dashboard-service.ts"
click node_imports "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/importaciones/services/batch-import-admin-service.ts"
click node_review "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/review/services/review-admin-service.ts"
click node_people_admin "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/personas/services/person-admin-service.ts"
click node_canonical_people "https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/admin/persona-canonica/route.ts"
click node_organization "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/organizacion/services/organization-unit-admin-service.ts"
click node_appointments "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/appointments/services/assignment-admin-service.ts"
click node_events "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/events/services/event-registry-admin-service.ts"
click node_structures "https://github.com/jumen-ux/sinep-rd/blob/main/src/features/structures/services/structure-admin-service.ts"
click node_supabase_client "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/supabase/client.ts"
click node_supabase_server "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/supabase/server.ts"
click node_supabase_rest "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/supabase/rest.ts"
click node_supabase_config "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/supabase/config.ts"
click node_authorization "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/admin/authorization.ts"
click node_validation "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/admin/validation.ts"
click node_audit "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/admin/audit.ts"
click node_public_cache "https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/public/cache.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_public_portal,node_public_people,node_public_entities,node_public_profiles,node_suggestions toneBlue
class node_admin_portal,node_access,node_dashboard,node_imports,node_review,node_supabase toneAmber
class node_people_admin,node_canonical_people,node_organization,node_appointments,node_events,node_structures toneMint
class node_supabase_client,node_supabase_server,node_supabase_rest,node_supabase_config,node_authorization,node_validation,node_audit,node_public_cache toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Public portal

- [Public portal](https://github.com/jumen-ux/sinep-rd/tree/main/src/features/public): `src/features/public`
- [People directory](https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/personas/route.ts): `src/app/api/personas/route.ts`
- [Entity directory](https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/entidades/route.ts): `src/app/api/entidades/route.ts`
- [Public profiles](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/public/entity-detail.ts): `src/lib/public/entity-detail.ts`
- [Public suggestions](https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/sugerencias/route.ts): `src/app/api/sugerencias/route.ts`

### Administration

- [Admin workspace](https://github.com/jumen-ux/sinep-rd/tree/main/src/app/(admin)/admin): `src/app/(admin)/admin`
- [Access management](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/access/services/authentication-admin-service.ts): `src/features/access/services/authentication-admin-service.ts`
- [Admin dashboard](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/admin/dashboard/admin-dashboard-service.ts): `src/features/admin/dashboard/admin-dashboard-service.ts`
- [Batch imports](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/importaciones/services/batch-import-admin-service.ts): `src/features/importaciones/services/batch-import-admin-service.ts`
- [Review queues](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/review/services/review-admin-service.ts): `src/features/review/services/review-admin-service.ts`

### Canonical workflows

- [People records](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/personas/services/person-admin-service.ts): `src/features/personas/services/person-admin-service.ts`
- [Canonical registration](https://github.com/jumen-ux/sinep-rd/blob/main/src/app/api/admin/persona-canonica/route.ts): `src/app/api/admin/persona-canonica/route.ts`
- [Organization units](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/organizacion/services/organization-unit-admin-service.ts): `src/features/organizacion/services/organization-unit-admin-service.ts`
- [Appointments](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/appointments/services/assignment-admin-service.ts): `src/features/appointments/services/assignment-admin-service.ts`
- [Events](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/events/services/event-registry-admin-service.ts): `src/features/events/services/event-registry-admin-service.ts`
- [Ecclesial structures](https://github.com/jumen-ux/sinep-rd/blob/main/src/features/structures/services/structure-admin-service.ts): `src/features/structures/services/structure-admin-service.ts`

### Shared platform

- [Browser client](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/supabase/client.ts): `src/lib/supabase/client.ts`
- [Server client](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [REST access](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/supabase/rest.ts): `src/lib/supabase/rest.ts`
- [Supabase config](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/supabase/config.ts): `src/lib/supabase/config.ts`
- [Admin authorization](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/admin/authorization.ts): `src/lib/admin/authorization.ts`
- [Request validation](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/admin/validation.ts): `src/lib/admin/validation.ts`
- [Audit logging](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/admin/audit.ts): `src/lib/admin/audit.ts`
- [Public cache](https://github.com/jumen-ux/sinep-rd/blob/main/src/lib/public/cache.ts): `src/lib/public/cache.ts`

### Other components

- **Public visitor**
- **Administrator**
- **Supabase**

## Connections

- Public visitor → Public portal: browses (evidence: `README.md`)
- Public portal → People directory: loads directory
- Public portal → Entity directory: loads directory
- Public portal → Public profiles: opens profiles
- Public visitor → Public suggestions: submits corrections
- People directory → REST access: fetches records (evidence: `src/app/api/personas/route.ts`)
- Entity directory → REST access: fetches records (evidence: `src/app/api/entidades/route.ts`)
- Public suggestions → REST access: writes suggestions (evidence: `src/app/api/sugerencias/route.ts`)
- Public suggestions → Request validation: validates input (evidence: `src/app/api/sugerencias/route.ts`)
- Public cache → Public profiles: caches details (evidence: `src/lib/public/cache.ts`)
- Administrator → Admin workspace: manages records
- Admin workspace → Admin dashboard: presents metrics
- Admin workspace → Access management: manages access
- Admin workspace → Batch imports: manages batches
- Admin workspace → Review queues: reviews changes
- Admin workspace → People records: manages people
- Admin workspace → Organization units: manages units
- Admin workspace → Appointments: manages appointments
- Appointments → People records: uses placement (evidence: `src/features/appointments/services/assignment-admin-service.ts`)
- Admin workspace → Events: manages events
- Admin workspace → Ecclesial structures: configures structures
- Canonical registration → Admin authorization: checks access (evidence: `src/app/api/admin/persona-canonica/route.ts`)
- Canonical registration → Request validation: validates payload (evidence: `src/app/api/admin/persona-canonica/route.ts`)
- Canonical registration → Audit logging: records action (evidence: `src/app/api/admin/persona-canonica/route.ts`)
- Canonical registration → Public cache: revalidates pages (evidence: `src/app/api/admin/persona-canonica/route.ts`)
- Appointments → Browser client: loads catalogs (evidence: `src/features/appointments/admin/AssignmentManagerPage.tsx`)
- Organization units → Browser client: uses client (evidence: `src/features/organizacion/admin/OrganizationUnitManagerPage.tsx`)
- Browser client → Supabase config: reads settings (evidence: `src/lib/supabase/client.ts`)
- Server client → Supabase config: reads settings (evidence: `src/lib/supabase/server.ts`)
- REST access → Supabase config: reads settings (evidence: `src/lib/supabase/rest.ts`)
- Admin authorization → Server client: creates session (evidence: `src/lib/admin/authorization.ts`)
- Audit logging → Server client: writes audit (evidence: `src/lib/admin/audit.ts`)
- People directory → Supabase: reads data
- Entity directory → Supabase: reads data
- Canonical registration → Supabase: saves canonical data (evidence: `src/app/api/admin/persona-canonica/route.ts`)
- Public suggestions → Supabase: stores suggestions (evidence: `src/app/api/sugerencias/route.ts`)
