# manuelequinteros/agendas-visuales architecture

> Architecture diagram of the GitHub repository manuelequinteros/agendas-visuales, 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/manuelequinteros/agendas-visuales
- Repository: https://github.com/manuelequinteros/agendas-visuales

## Overview

Agendas Visuales lets users create, edit, save, browse, and print visual schedules, with AI-assisted drafting and ARASAAC pictograms. The main flow is editor UI → agenda API/service → validation, mapping, and persistence; separate flows interpret natural-language requests and search or select pictograms. The graph preserves those distinct capabilities and the editor’s draft state. Some AI and UI subsystems are represented from the file tree and README only; their internal links are omitted or marked unverified where no shown source establishes them.

Main entry points: [`frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts`](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts) (Agenda editor), [`backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java`](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java) (Agenda operations), [`frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts`](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts) (Pictogram selector), [`backend/src/main/java/com/agendasvisuales/ai/application/AgendaInterpreter.java`](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/application/AgendaInterpreter.java) (Agenda interpreter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Frontend experience"]
  node_agenda_list_ui["Agenda list"]
  node_editor_ui["Agenda editor"]
  node_editor_state["Draft state"]
  node_editor_views["Editor views"]
  node_final_view["Final agenda view"]
  node_selector_ui["Pictogram selector"]
  node_agenda_api_front["Agenda API client"]
  node_assistant_api_front["Assistant API client"]
  node_pictogram_api_front["Pictogram API client"]
  node_suggestions["Pictogram suggestions"]
  node_candidate_cache["Candidate cache"]
end

subgraph group_agenda["Agenda management"]
  node_agenda_controller["Agenda endpoints"]
  node_agenda_service["Agenda operations<br/>[AgendaService.java]"]
  node_agenda_validation["Agenda validation"]
  node_agenda_mapping["Agenda mapping<br/>[AgendaMapper.java]"]
  node_agenda_domain["Schedule model<br/>[AgendaVisual.java]"]
  node_agenda_store[("Agenda repository")]
  node_pictogram_store[("Pictogram repository")]
end

subgraph group_ai["AI assistance"]
  node_assistant_controller["Assistant endpoint"]
  node_agenda_interpreter["Agenda interpreter"]
  node_interpretation_validation["Interpretation validation"]
  node_fake_interpreter["Fake interpreter"]
  node_spring_ai["Spring AI integration"]
end

subgraph group_pictograms["Pictogram services"]
  node_pictogram_controller["Pictogram endpoints"]
  node_pictogram_service["Pictogram search"]
  node_arasaac_client["ARASAAC client<br/>[ArasaacClient.java]"]
  node_arasaac_mapper["Candidate mapping<br/>[ArasaacMapper.java]"]
end

node_user(("Agenda creator"))
node_gemini{{"Gemini API"}}
node_arasaac{{"ARASAAC REST API"}}

node_user -->|"browses"| node_agenda_list_ui
node_user -->|"edits"| node_editor_ui
node_agenda_list_ui -.->|"loads agendas"| node_agenda_api_front
node_editor_ui -->|"loads and saves"| node_agenda_api_front
node_editor_ui -->|"updates draft"| node_editor_state
node_editor_ui -->|"renders"| node_editor_views
node_editor_ui -->|"renders"| node_final_view
node_editor_ui -->|"opens"| node_selector_ui
node_editor_state -->|"supplies draft"| node_suggestions
node_suggestions -->|"searches"| node_pictogram_api_front
node_suggestions -->|"reads and writes"| node_candidate_cache
node_selector_ui -->|"assigns selection"| node_editor_state
node_selector_ui -->|"searches"| node_pictogram_api_front
node_selector_ui -->|"reads and writes"| node_candidate_cache
node_agenda_api_front -.->|"HTTP requests"| node_agenda_controller
node_agenda_controller -->|"delegates"| node_agenda_service
node_agenda_service -->|"validates"| node_agenda_validation
node_agenda_service -->|"maps entities"| node_agenda_mapping
node_agenda_service -->|"reads and writes"| node_agenda_store
node_agenda_service -->|"resolves pictograms"| node_pictogram_store
node_agenda_service -->|"operates on"| node_agenda_domain
node_assistant_api_front -.->|"HTTP requests"| node_assistant_controller
node_assistant_controller -->|"interprets request"| node_agenda_interpreter
node_agenda_interpreter -.->|"validates result"| node_interpretation_validation
node_agenda_interpreter -.->|"uses integration"| node_spring_ai
node_agenda_interpreter -.->|"uses integration"| node_fake_interpreter
node_spring_ai -.->|"queries"| node_gemini
node_pictogram_api_front -.->|"HTTP requests"| node_pictogram_controller
node_pictogram_controller -->|"delegates"| node_pictogram_service
node_pictogram_service -->|"searches"| node_arasaac_client
node_pictogram_service -->|"maps candidates"| node_arasaac_mapper
node_arasaac_client -.->|"queries"| node_arasaac

click node_agenda_list_ui "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agendas-list/agendas-list-page.component.ts"
click node_editor_ui "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts"
click node_editor_state "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/services/agenda-editor-state.service.ts"
click node_editor_views "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/components/agenda-canvas/agenda-canvas.component.ts"
click node_final_view "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/components/final-agenda-view/final-agenda-view.component.ts"
click node_selector_ui "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts"
click node_agenda_api_front "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/api/agenda-api.service.ts"
click node_assistant_api_front "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/api/assistant-api.service.ts"
click node_pictogram_api_front "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/api/pictogram-api.service.ts"
click node_suggestions "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/services/pictogram-suggestion.service.ts"
click node_candidate_cache "https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/services/pictogram-candidate-cache.service.ts"
click node_agenda_controller "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/api/AgendaController.java"
click node_agenda_service "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java"
click node_agenda_validation "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/application/AgendaValidator.java"
click node_agenda_mapping "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/application/AgendaMapper.java"
click node_agenda_domain "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/domain/AgendaVisual.java"
click node_agenda_store "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/persistence/AgendaRepository.java"
click node_assistant_controller "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/api/AssistantController.java"
click node_agenda_interpreter "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/application/AgendaInterpreter.java"
click node_interpretation_validation "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/application/InterpretationValidationService.java"
click node_fake_interpreter "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/integration/FakeAgendaInterpreter.java"
click node_spring_ai "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/integration/SpringAiAgendaInterpreter.java"
click node_pictogram_controller "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/pictogram/api/PictogramController.java"
click node_pictogram_service "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/pictogram/application/PictogramService.java"
click node_arasaac_client "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/pictogram/integration/ArasaacClient.java"
click node_arasaac_mapper "https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/pictogram/integration/ArasaacMapper.java"

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_agenda_list_ui,node_editor_ui,node_editor_state,node_editor_views,node_final_view,node_selector_ui,node_agenda_api_front,node_assistant_api_front,node_pictogram_api_front,node_suggestions,node_candidate_cache toneBlue
class node_agenda_controller,node_agenda_service,node_agenda_validation,node_agenda_mapping,node_agenda_domain,node_agenda_store,node_pictogram_store toneAmber
class node_assistant_controller,node_agenda_interpreter,node_interpretation_validation,node_fake_interpreter,node_spring_ai,node_gemini,node_arasaac toneMint
class node_pictogram_controller,node_pictogram_service,node_arasaac_client,node_arasaac_mapper toneRose
class node_user toneIndigo
```

## Components

### Frontend experience

- [Agenda list](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agendas-list/agendas-list-page.component.ts): `frontend/src/app/features/agendas-list/agendas-list-page.component.ts`
- [Agenda editor](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts): `frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts`
- [Draft state](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/services/agenda-editor-state.service.ts): `frontend/src/app/features/agenda-editor/services/agenda-editor-state.service.ts`
- [Editor views](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/components/agenda-canvas/agenda-canvas.component.ts): `frontend/src/app/features/agenda-editor/components/agenda-canvas/agenda-canvas.component.ts`
- [Final agenda view](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/agenda-editor/components/final-agenda-view/final-agenda-view.component.ts): `frontend/src/app/features/agenda-editor/components/final-agenda-view/final-agenda-view.component.ts`
- [Pictogram selector](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts): `frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts`
- [Agenda API client](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/api/agenda-api.service.ts): `frontend/src/app/core/api/agenda-api.service.ts`
- [Assistant API client](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/api/assistant-api.service.ts): `frontend/src/app/core/api/assistant-api.service.ts`
- [Pictogram API client](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/api/pictogram-api.service.ts): `frontend/src/app/core/api/pictogram-api.service.ts`
- [Pictogram suggestions](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/services/pictogram-suggestion.service.ts): `frontend/src/app/core/services/pictogram-suggestion.service.ts`
- [Candidate cache](https://github.com/manuelequinteros/agendas-visuales/blob/main/frontend/src/app/core/services/pictogram-candidate-cache.service.ts): `frontend/src/app/core/services/pictogram-candidate-cache.service.ts`

### Agenda management

- [Agenda endpoints](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/api/AgendaController.java): `backend/src/main/java/com/agendasvisuales/agenda/api/AgendaController.java`
- [Agenda operations](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java): `backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java`
- [Agenda validation](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/application/AgendaValidator.java): `backend/src/main/java/com/agendasvisuales/agenda/application/AgendaValidator.java`
- [Agenda mapping](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/application/AgendaMapper.java): `backend/src/main/java/com/agendasvisuales/agenda/application/AgendaMapper.java`
- [Schedule model](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/domain/AgendaVisual.java): `backend/src/main/java/com/agendasvisuales/agenda/domain/AgendaVisual.java`
- [Agenda repository](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/agenda/persistence/AgendaRepository.java): `backend/src/main/java/com/agendasvisuales/agenda/persistence/AgendaRepository.java`
- **Pictogram repository**

### AI assistance

- [Assistant endpoint](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/api/AssistantController.java): `backend/src/main/java/com/agendasvisuales/ai/api/AssistantController.java`
- [Agenda interpreter](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/application/AgendaInterpreter.java): `backend/src/main/java/com/agendasvisuales/ai/application/AgendaInterpreter.java`
- [Interpretation validation](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/application/InterpretationValidationService.java): `backend/src/main/java/com/agendasvisuales/ai/application/InterpretationValidationService.java`
- [Fake interpreter](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/integration/FakeAgendaInterpreter.java): `backend/src/main/java/com/agendasvisuales/ai/integration/FakeAgendaInterpreter.java`
- [Spring AI integration](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/ai/integration/SpringAiAgendaInterpreter.java): `backend/src/main/java/com/agendasvisuales/ai/integration/SpringAiAgendaInterpreter.java`

### Pictogram services

- [Pictogram endpoints](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/pictogram/api/PictogramController.java): `backend/src/main/java/com/agendasvisuales/pictogram/api/PictogramController.java`
- [Pictogram search](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/pictogram/application/PictogramService.java): `backend/src/main/java/com/agendasvisuales/pictogram/application/PictogramService.java`
- [ARASAAC client](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/pictogram/integration/ArasaacClient.java): `backend/src/main/java/com/agendasvisuales/pictogram/integration/ArasaacClient.java`
- [Candidate mapping](https://github.com/manuelequinteros/agendas-visuales/blob/main/backend/src/main/java/com/agendasvisuales/pictogram/integration/ArasaacMapper.java): `backend/src/main/java/com/agendasvisuales/pictogram/integration/ArasaacMapper.java`

### Other components

- **Agenda creator**
- **Gemini API**
- **ARASAAC REST API**

## Connections

- Agenda creator → Agenda list: browses
- Agenda creator → Agenda editor: edits
- Agenda list → Agenda API client: loads agendas (evidence: `frontend/src/app/features/agendas-list/agendas-list-page.component.ts`)
- Agenda editor → Agenda API client: loads and saves (evidence: `frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts`)
- Agenda editor → Draft state: updates draft (evidence: `frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts`)
- Agenda editor → Editor views: renders (evidence: `frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts`)
- Agenda editor → Final agenda view: renders (evidence: `frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts`)
- Agenda editor → Pictogram selector: opens (evidence: `frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts`)
- Draft state → Pictogram suggestions: supplies draft (evidence: `frontend/src/app/core/services/pictogram-suggestion.service.ts`)
- Pictogram suggestions → Pictogram API client: searches (evidence: `frontend/src/app/core/services/pictogram-suggestion.service.ts`)
- Pictogram suggestions → Candidate cache: reads and writes (evidence: `frontend/src/app/core/services/pictogram-suggestion.service.ts`)
- Pictogram selector → Draft state: assigns selection (evidence: `frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts`)
- Pictogram selector → Pictogram API client: searches (evidence: `frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts`)
- Pictogram selector → Candidate cache: reads and writes (evidence: `frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts`)
- Agenda API client → Agenda endpoints: HTTP requests
- Agenda endpoints → Agenda operations: delegates (evidence: `backend/src/main/java/com/agendasvisuales/agenda/api/AgendaController.java`)
- Agenda operations → Agenda validation: validates (evidence: `backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java`)
- Agenda operations → Agenda mapping: maps entities (evidence: `backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java`)
- Agenda operations → Agenda repository: reads and writes (evidence: `backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java`)
- Agenda operations → Pictogram repository: resolves pictograms (evidence: `backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java`)
- Agenda operations → Schedule model: operates on (evidence: `backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java`)
- Assistant API client → Assistant endpoint: HTTP requests
- Assistant endpoint → Agenda interpreter: interprets request (evidence: `backend/src/main/java/com/agendasvisuales/ai/api/AssistantController.java`)
- Agenda interpreter → Interpretation validation: validates result
- Agenda interpreter → Spring AI integration: uses integration
- Agenda interpreter → Fake interpreter: uses integration
- Spring AI integration → Gemini API: queries
- Pictogram API client → Pictogram endpoints: HTTP requests
- Pictogram endpoints → Pictogram search: delegates (evidence: `backend/src/main/java/com/agendasvisuales/pictogram/api/PictogramController.java`)
- Pictogram search → ARASAAC client: searches (evidence: `backend/src/main/java/com/agendasvisuales/pictogram/application/PictogramService.java`)
- Pictogram search → Candidate mapping: maps candidates (evidence: `backend/src/main/java/com/agendasvisuales/pictogram/application/PictogramService.java`)
- ARASAAC client → ARASAAC REST API: queries
