How tropicalfish041/aacorn-visual-aac-communication-board works
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: interface_adapter Interface adapters · communicate_request Request communication · customize_board Board customization · view Swing screens
Components 17
User interaction
- Swing screens
src/main/java/view - Interface adapters
src/main/java/interface_adapter
Communication workflows
- Request communication
src/main/java/use_case/communicate_request - Core messages
src/main/java/use_case/core_message - Board customization
src/main/java/use_case/customize_board - History viewing
src/main/java/use_case/view_history - Pictogram search contract
src/main/java/use_case/customize_board/PictogramSearchDataAccessInterface.java - Search exception
src/main/java/use_case/customize_board/PictogramSearchException.java
Domain model
- Message draft
src/main/java/entity/CommunicationDraft.java - Completed message
src/main/java/entity/CommunicationMessage.java - Communication board
src/main/java/entity/CommunicationBoard.java - Pictogram
src/main/java/entity/Pictogram.java - Child profile
src/main/java/entity/ChildProfile.java
Data and services
- Profile persistence
src/main/java/data_access - ARASAAC API
Other components
- Child
- Caregiver
Connections 24
- Child → Swing screens: selects pictograms
README.md - Caregiver → Swing screens: customizes board
README.md - Caregiver → Swing screens: opens history
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
README.md - Request communication → Message draft: builds draft
README.md - Message draft → Completed message: builds message
src/main/java/entity/CommunicationDraft.java - Core messages → Completed message: creates message
README.md - Board customization → Communication board: updates board
README.md - Board customization → Pictogram search contract: searches pictograms
README.md - Pictogram search contract → ARASAAC API: queries keyword
README.md - Pictogram search contract → Search exception: may throw
src/main/java/use_case/customize_board/PictogramSearchDataAccessInterface.java - History viewing → Profile persistence: loads messages
README.md - Request communication → Profile persistence: saves message
README.md - Core messages → Profile persistence: saves message
README.md - Board customization → Profile persistence: saves board
README.md - Communication board → Pictogram: contains pictograms
src/main/java/entity/CommunicationBoard.java - Child profile → Communication board: holds board
src/main/java/entity/ChildProfile.java - Child profile → Completed message: records history
src/main/java/entity/ChildProfile.java - Completed message → Pictogram: contains selections
src/main/java/entity/CommunicationMessage.java