# tropicalfish041/aacorn-visual-aac-communication-board architecture

> Architecture diagram of the GitHub repository tropicalfish041/aacorn-visual-aac-communication-board, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tropicalfish041/aacorn-visual-aac-communication-board
- Repository: https://github.com/tropicalfish041/aacorn-visual-aac-communication-board

## Overview

AACorn is a visual AAC communication-board application for children, with caregiver tools for board customization and message history. The documented child workflow selects board pictograms, builds a readable draft, and sends a completed message; separate workflows provide Help/Stop/Break messages, board customization with ARASAAC search, and history viewing. The supplied Java sources implement domain entities and data-access interfaces, but not the UI, controllers, interactors, or storage implementations. Those documented subsystems are shown at their exact directory paths; their connections reflect README workflows, not inspected runtime wiring.

Main entry points: [`src/main/java/interface_adapter`](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/interface_adapter) (Interface adapters), [`src/main/java/use_case/communicate_request`](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/communicate_request) (Request communication), [`src/main/java/use_case/customize_board`](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/customize_board) (Board customization), [`src/main/java/view`](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/view) (Swing screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_screens["Swing screens"]
  node_adapters["Interface adapters"]
end

subgraph group_usecases["Communication workflows"]
  node_request["Request communication"]
  node_core["Core messages"]
  node_customize["Board customization"]
  node_history["History viewing"]
  node_searchcontract["Pictogram search contract"]
  node_searcherror["Search exception"]
end

subgraph group_domain["Domain model"]
  node_draft["Message draft"]
  node_message["Completed message"]
  node_board["Communication board"]
  node_pictogram["Pictogram<br/>[Pictogram.java]"]
  node_profile["Child profile<br/>[ChildProfile.java]"]
end

subgraph group_integrations["Data and services"]
  node_profiledata[("Profile persistence")]
  node_arasaac{{"ARASAAC API"}}
end

node_child(("Child"))
node_caregiver(("Caregiver"))

node_child -->|"selects pictograms"| node_screens
node_caregiver -->|"customizes board"| node_screens
node_caregiver -->|"opens history"| node_screens
node_screens -.->|"routes actions"| node_adapters
node_adapters -.->|"dispatches request"| node_request
node_adapters -.->|"dispatches core message"| node_core
node_adapters -.->|"dispatches edits"| node_customize
node_adapters -.->|"dispatches history"| node_history
node_request -->|"loads vocabulary"| node_board
node_request -->|"builds draft"| node_draft
node_draft -->|"builds message"| node_message
node_core -->|"creates message"| node_message
node_customize -->|"updates board"| node_board
node_customize -->|"searches pictograms"| node_searchcontract
node_searchcontract -->|"queries keyword"| node_arasaac
node_searchcontract -->|"may throw"| node_searcherror
node_history -->|"loads messages"| node_profiledata
node_request -->|"saves message"| node_profiledata
node_core -->|"saves message"| node_profiledata
node_customize -->|"saves board"| node_profiledata
node_board -->|"contains pictograms"| node_pictogram
node_profile -->|"holds board"| node_board
node_profile -->|"records history"| node_message
node_message -->|"contains selections"| node_pictogram

click node_screens "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/view"
click node_adapters "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/interface_adapter"
click node_request "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/communicate_request"
click node_core "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/core_message"
click node_customize "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/customize_board"
click node_history "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/view_history"
click node_draft "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/CommunicationDraft.java"
click node_message "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/CommunicationMessage.java"
click node_board "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/CommunicationBoard.java"
click node_pictogram "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/Pictogram.java"
click node_profile "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/ChildProfile.java"
click node_profiledata "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/data_access"
click node_searchcontract "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/use_case/customize_board/PictogramSearchDataAccessInterface.java"
click node_searcherror "https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/use_case/customize_board/PictogramSearchException.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_screens,node_adapters toneBlue
class node_request,node_core,node_customize,node_history,node_searchcontract,node_searcherror toneAmber
class node_draft,node_message,node_board,node_pictogram,node_profile toneMint
class node_profiledata,node_arasaac toneRose
class node_child,node_caregiver toneIndigo
```

## Components

### User interaction

- [Swing screens](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/view): `src/main/java/view`
- [Interface adapters](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/interface_adapter): `src/main/java/interface_adapter`

### Communication workflows

- [Request communication](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/communicate_request): `src/main/java/use_case/communicate_request`
- [Core messages](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/core_message): `src/main/java/use_case/core_message`
- [Board customization](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/customize_board): `src/main/java/use_case/customize_board`
- [History viewing](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/use_case/view_history): `src/main/java/use_case/view_history`
- [Pictogram search contract](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/use_case/customize_board/PictogramSearchDataAccessInterface.java): `src/main/java/use_case/customize_board/PictogramSearchDataAccessInterface.java`
- [Search exception](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/use_case/customize_board/PictogramSearchException.java): `src/main/java/use_case/customize_board/PictogramSearchException.java`

### Domain model

- [Message draft](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/CommunicationDraft.java): `src/main/java/entity/CommunicationDraft.java`
- [Completed message](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/CommunicationMessage.java): `src/main/java/entity/CommunicationMessage.java`
- [Communication board](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/CommunicationBoard.java): `src/main/java/entity/CommunicationBoard.java`
- [Pictogram](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/Pictogram.java): `src/main/java/entity/Pictogram.java`
- [Child profile](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/blob/main/src/main/java/entity/ChildProfile.java): `src/main/java/entity/ChildProfile.java`

### Data and services

- [Profile persistence](https://github.com/tropicalfish041/aacorn-visual-aac-communication-board/tree/main/src/main/java/data_access): `src/main/java/data_access`
- **ARASAAC API**

### Other components

- **Child**
- **Caregiver**

## Connections

- Child → Swing screens: selects pictograms (evidence: `README.md`)
- Caregiver → Swing screens: customizes board (evidence: `README.md`)
- Caregiver → Swing screens: opens history (evidence: `README.md`)
- Swing screens → Interface adapters: routes actions
- Interface adapters → Request communication: dispatches request
- Interface adapters → Core messages: dispatches core message
- Interface adapters → Board customization: dispatches edits
- Interface adapters → History viewing: dispatches history
- Request communication → Communication board: loads vocabulary (evidence: `README.md`)
- Request communication → Message draft: builds draft (evidence: `README.md`)
- Message draft → Completed message: builds message (evidence: `src/main/java/entity/CommunicationDraft.java`)
- Core messages → Completed message: creates message (evidence: `README.md`)
- Board customization → Communication board: updates board (evidence: `README.md`)
- Board customization → Pictogram search contract: searches pictograms (evidence: `README.md`)
- Pictogram search contract → ARASAAC API: queries keyword (evidence: `README.md`)
- Pictogram search contract → Search exception: may throw (evidence: `src/main/java/use_case/customize_board/PictogramSearchDataAccessInterface.java`)
- History viewing → Profile persistence: loads messages (evidence: `README.md`)
- Request communication → Profile persistence: saves message (evidence: `README.md`)
- Core messages → Profile persistence: saves message (evidence: `README.md`)
- Board customization → Profile persistence: saves board (evidence: `README.md`)
- Communication board → Pictogram: contains pictograms (evidence: `src/main/java/entity/CommunicationBoard.java`)
- Child profile → Communication board: holds board (evidence: `src/main/java/entity/ChildProfile.java`)
- Child profile → Completed message: records history (evidence: `src/main/java/entity/ChildProfile.java`)
- Completed message → Pictogram: contains selections (evidence: `src/main/java/entity/CommunicationMessage.java`)
