How manuelequinteros/agendas-visuales works
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: agenda-editor-page.component.ts Agenda editor · AgendaService.java Agenda operations · pictogram-selector-page.component.ts Pictogram selector · AgendaInterpreter.java Agenda interpreter
Components 30
Frontend experience
- Agenda list
frontend/src/app/features/agendas-list/agendas-list-page.component.ts - Agenda editor
frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts - Draft state
frontend/src/app/features/agenda-editor/services/agenda-editor-state.service.ts - Editor views
frontend/src/app/features/agenda-editor/components/agenda-canvas/agenda-canvas.component.ts - Final agenda view
frontend/src/app/features/agenda-editor/components/final-agenda-view/final-agenda-view.component.ts - Pictogram selector
frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts - Agenda API client
frontend/src/app/core/api/agenda-api.service.ts - Assistant API client
frontend/src/app/core/api/assistant-api.service.ts - Pictogram API client
frontend/src/app/core/api/pictogram-api.service.ts - Pictogram suggestions
frontend/src/app/core/services/pictogram-suggestion.service.ts - Candidate cache
frontend/src/app/core/services/pictogram-candidate-cache.service.ts
Agenda management
- Agenda endpoints
backend/src/main/java/com/agendasvisuales/agenda/api/AgendaController.java - Agenda operations
backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java - Agenda validation
backend/src/main/java/com/agendasvisuales/agenda/application/AgendaValidator.java - Agenda mapping
backend/src/main/java/com/agendasvisuales/agenda/application/AgendaMapper.java - Schedule model
backend/src/main/java/com/agendasvisuales/agenda/domain/AgendaVisual.java - Agenda repository
backend/src/main/java/com/agendasvisuales/agenda/persistence/AgendaRepository.java - Pictogram repository
AI assistance
- Assistant endpoint
backend/src/main/java/com/agendasvisuales/ai/api/AssistantController.java - Agenda interpreter
backend/src/main/java/com/agendasvisuales/ai/application/AgendaInterpreter.java - Interpretation validation
backend/src/main/java/com/agendasvisuales/ai/application/InterpretationValidationService.java - Fake interpreter
backend/src/main/java/com/agendasvisuales/ai/integration/FakeAgendaInterpreter.java - Spring AI integration
backend/src/main/java/com/agendasvisuales/ai/integration/SpringAiAgendaInterpreter.java
Pictogram services
- Pictogram endpoints
backend/src/main/java/com/agendasvisuales/pictogram/api/PictogramController.java - Pictogram search
backend/src/main/java/com/agendasvisuales/pictogram/application/PictogramService.java - ARASAAC client
backend/src/main/java/com/agendasvisuales/pictogram/integration/ArasaacClient.java - Candidate mapping
backend/src/main/java/com/agendasvisuales/pictogram/integration/ArasaacMapper.java
Other components
- Agenda creator
- Gemini API
- ARASAAC REST API
Connections 32
- Agenda creator → Agenda list: browses
- Agenda creator → Agenda editor: edits
- Agenda list → Agenda API client: loads agendas
frontend/src/app/features/agendas-list/agendas-list-page.component.ts - Agenda editor → Agenda API client: loads and saves
frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts - Agenda editor → Draft state: updates draft
frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts - Agenda editor → Editor views: renders
frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts - Agenda editor → Final agenda view: renders
frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts - Agenda editor → Pictogram selector: opens
frontend/src/app/features/agenda-editor/agenda-editor-page.component.ts - Draft state → Pictogram suggestions: supplies draft
frontend/src/app/core/services/pictogram-suggestion.service.ts - Pictogram suggestions → Pictogram API client: searches
frontend/src/app/core/services/pictogram-suggestion.service.ts - Pictogram suggestions → Candidate cache: reads and writes
frontend/src/app/core/services/pictogram-suggestion.service.ts - Pictogram selector → Draft state: assigns selection
frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts - Pictogram selector → Pictogram API client: searches
frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts - Pictogram selector → Candidate cache: reads and writes
frontend/src/app/features/pictogram-selector/pictogram-selector-page.component.ts - Agenda API client → Agenda endpoints: HTTP requests
- Agenda endpoints → Agenda operations: delegates
backend/src/main/java/com/agendasvisuales/agenda/api/AgendaController.java - Agenda operations → Agenda validation: validates
backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java - Agenda operations → Agenda mapping: maps entities
backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java - Agenda operations → Agenda repository: reads and writes
backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java - Agenda operations → Pictogram repository: resolves pictograms
backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java - Agenda operations → Schedule model: operates on
backend/src/main/java/com/agendasvisuales/agenda/application/AgendaService.java - Assistant API client → Assistant endpoint: HTTP requests
- Assistant endpoint → Agenda interpreter: interprets request
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
backend/src/main/java/com/agendasvisuales/pictogram/api/PictogramController.java - Pictogram search → ARASAAC client: searches
backend/src/main/java/com/agendasvisuales/pictogram/application/PictogramService.java - Pictogram search → Candidate mapping: maps candidates
backend/src/main/java/com/agendasvisuales/pictogram/application/PictogramService.java - ARASAAC client → ARASAAC REST API: queries