How fodohl/seng202-project works
TrashApp is a JavaFX desktop application for finding Christchurch public bins, reporting bin conditions, logging rubbish disposal, and viewing community sustainability information. The principal workflow runs from a user through routed pages and shared application state to data services, local persistence, and TrashDB operations; background tasks maintain synchronized and calculated data. The README also identifies map, home statistics, community, and CSV export capabilities. Several page and task implementations were not sampled, so those feature branches are represented without speculative internal call chains.
Main entry points: DataService.java Data service · pages Feature pages · GlobalState.java Shared app state · TrashDBClient.java TrashDB client
Components 24
Desktop interface
- Application startup
src/main/java/seng202/team1/Main.java - Shared app state
src/main/java/seng202/team1/state/GlobalState.java - Page router
src/main/java/seng202/team1/gui/Router.java - Feature pages
src/main/java/seng202/team1/gui/pages - Bin map
src/main/java/seng202/team1/gui/pages/MapPage.java - Home statistics
src/main/java/seng202/team1/gui/pages/HomePage.java - Community view
src/main/java/seng202/team1/gui/pages/CommunityPage.java - Activity timeline
src/main/java/seng202/team1/gui/pages/TimelinePage.java
Bin and activity data
- Data service
src/main/java/seng202/team1/data/DataService.java - Bin dataset
src/main/java/seng202/team1/data/bin/BinDataset.java - Bin reports
src/main/java/seng202/team1/types/status/StatusReport.java - Disposal logs
src/main/java/seng202/team1/types/trashlog/TrashLog.java - CSV export
src/main/java/seng202/team1/data/export/ExportManager.java
Local persistence
- Local tables
src/main/java/seng202/team1/database/TableCollection.java - Disposal persistence
src/main/java/seng202/team1/database/DAO/TrashLogDAO.java - Database manager
src/main/java/seng202/team1/database/DatabaseManager.java
API and background services
- API client registry
src/main/java/seng202/team1/api/AppClients.java - TrashDB client
src/main/java/seng202/team1/api/trashdb/TrashDBClient.java - TrashDB backend
src/main/java/seng202/team1/api/trashdb/TrashDBBackend.java - Location search
src/main/java/seng202/team1/api/photon/PhotonClient.java - Background tasks
src/main/java/seng202/team1/tasks/AppTasks.java - Startup preparation
src/main/java/seng202/team1/tasks/preflight/PreflightManager.java
Other components
- Desktop user
- Photon geocoder
Connections 25
- Desktop user → Application startup: launches
src/main/java/seng202/team1/Main.java - Application startup → Shared app state: creates
src/main/java/seng202/team1/Main.java - Shared app state → Page router: initializes UI
src/main/java/seng202/team1/state/GlobalState.java - Desktop user → Page router: navigates
- Page router → Feature pages: switches pages
src/main/java/seng202/team1/gui/Router.java - Feature pages → Bin map: includes map
- Feature pages → Home statistics: includes statistics
- Feature pages → Community view: includes community
- Feature pages → Activity timeline: shows activity
- Shared app state → Data service: creates
src/main/java/seng202/team1/state/GlobalState.java - Data service → Bin dataset: loads dataset
src/main/java/seng202/team1/data/DataService.java - Desktop user → Data service: logs disposal
- Data service → Disposal logs: creates logs
src/main/java/seng202/team1/data/DataService.java - Data service → Bin reports: creates reports
src/main/java/seng202/team1/data/DataService.java - Data service → Local tables: uses local tables
src/main/java/seng202/team1/data/DataService.java - Local tables → Disposal persistence: accesses logs
- Disposal persistence → Database manager: uses connection
src/main/java/seng202/team1/database/DAO/TrashLogDAO.java - Data service → TrashDB client: syncs activity
src/main/java/seng202/team1/data/DataService.java - API client registry → TrashDB client: registers client
src/main/java/seng202/team1/api/AppClients.java - TrashDB client → TrashDB backend: invokes backend
src/main/java/seng202/team1/api/trashdb/TrashDBClient.java - API client registry → Location search: registers client
src/main/java/seng202/team1/api/AppClients.java - Location search → Photon geocoder: searches locations
src/main/java/seng202/team1/api/photon/PhotonClient.java - TrashDB client → CSV export: exports data
- Shared app state → Background tasks: creates tasks
src/main/java/seng202/team1/state/GlobalState.java - Background tasks → Startup preparation: starts preparation
src/main/java/seng202/team1/tasks/AppTasks.java