How kristiandl/yarn-project-ai works
Awesome Garn is a single-user JavaFX desktop app for managing a personal yarn inventory, stored locally without a database or external services. The workflow is to add or edit yarn through a form, validate and persist changes, then browse, search, filter, sort, and delete inventory items; a separate view calculates inventory statistics. The README documents these capabilities and the layer structure. Some view/controller details and statistics internals were not excerpted, so the graph limits those links to documented or indexed evidence.
Main entry points: YarnController.java Inventory controller · ViewHandler.java View navigation · Yarn.java Yarn record · Main.java JavaFX startup
Components 21
Desktop interface
- JavaFX startup
src/main/java/awesomegarn/Main.java - View navigation
src/main/java/awesomegarn/view/ViewHandler.java - Inventory overview
src/main/java/awesomegarn/view/YarnOverviewView.java - Add/edit form
src/main/java/awesomegarn/view/YarnFormPane.java - Add screen
src/main/java/awesomegarn/view/AddYarnView.java - Edit screen
src/main/java/awesomegarn/view/EditYarnView.java - Statistics screen
src/main/java/awesomegarn/view/StatisticsView.java - Delete confirmation
src/main/java/awesomegarn/view/ConfirmDeleteOverlay.java - Error overlays
src/main/java/awesomegarn/view/ErrorOverlay.java
Inventory workflow
- Inventory controller
src/main/java/awesomegarn/controller/YarnController.java - Input validation
src/main/java/awesomegarn/controller/YarnValidator.java - Search and filters
src/main/java/awesomegarn/controller/YarnFilter.java - Sort options
src/main/java/awesomegarn/controller/SortOption.java - Form data
src/main/java/awesomegarn/controller/YarnData.java
Yarn domain
- Yarn collection
src/main/java/awesomegarn/model/YarnCollection.java - Yarn record
src/main/java/awesomegarn/model/Yarn.java - Inventory statistics
src/main/java/awesomegarn/model/Statistics.java - Yarn attributes
src/main/java/awesomegarn/model/Material.java
Local persistence
- Storage interface
src/main/java/awesomegarn/storage/YarnStorage.java - Binary file storage
src/main/java/awesomegarn/storage/BinaryYarnStorage.java
Other components
- Inventory user
Connections 28
- Inventory user → JavaFX startup: launches
README.md - JavaFX startup → View navigation: starts UI
src/main/java/awesomegarn/Main.java - View navigation → Inventory overview: shows
src/main/java/awesomegarn/view/ViewHandler.java - View navigation → Add screen: opens
src/main/java/awesomegarn/view/ViewHandler.java - View navigation → Edit screen: opens
src/main/java/awesomegarn/view/ViewHandler.java - View navigation → Statistics screen: opens
src/main/java/awesomegarn/view/ViewHandler.java - View navigation → Delete confirmation: shows
src/main/java/awesomegarn/view/ViewHandler.java - View navigation → Error overlays: shows
src/main/java/awesomegarn/view/ViewHandler.java - Add screen → Add/edit form: uses
src/main/java/awesomegarn/view/AddYarnView.java - Edit screen → Add/edit form: uses
src/main/java/awesomegarn/view/EditYarnView.java - Inventory overview → View navigation: requests navigation
src/main/java/awesomegarn/view/YarnOverviewView.java - Add/edit form → Inventory controller: submits changes
- Inventory overview → Inventory controller: requests inventory
src/main/java/awesomegarn/view/YarnOverviewView.java - Statistics screen → Inventory controller: requests statistics
src/main/java/awesomegarn/view/StatisticsView.java - Delete confirmation → Inventory controller: deletes item
src/main/java/awesomegarn/view/ViewHandler.java - Inventory controller → Input validation: validates input
src/main/java/awesomegarn/controller/YarnController.java - Inventory controller → Yarn collection: mutates inventory
src/main/java/awesomegarn/controller/YarnController.java - Inventory controller → Storage interface: saves inventory
src/main/java/awesomegarn/controller/YarnController.java - Inventory controller → Inventory statistics: calculates statistics
src/main/java/awesomegarn/controller/YarnController.java - Inventory controller → Search and filters: matches items
src/main/java/awesomegarn/controller/YarnController.java - Inventory controller → Sort options: sorts results
src/main/java/awesomegarn/controller/YarnController.java - Input validation → Form data: validates fields
src/main/java/awesomegarn/controller/YarnValidator.java - Inventory controller → Yarn record: creates records
src/main/java/awesomegarn/controller/YarnController.java - Yarn collection → Yarn record: holds records
src/main/java/awesomegarn/model/YarnCollection.java - Binary file storage → Storage interface: implements
src/main/java/awesomegarn/storage/BinaryYarnStorage.java - JavaFX startup → Binary file storage: configures storage
src/main/java/awesomegarn/Main.java - Yarn record → Yarn attributes: uses attributes
src/main/java/awesomegarn/model/Yarn.java - Inventory statistics → Yarn record: aggregates records
src/main/java/awesomegarn/model/Statistics.java