How tomtommao/summer-project-msc works
The repository is a transaction-analysis dashboard with a Python service. The main user workflow is to load transaction records, explore them across calendar, scatter/amount, cluster, and table views, and interact with selections and colour mappings. The source index shows a Python dataset and clustering backend, but the README provides no feature detail and the backend excerpts are unavailable; backend capabilities and its connection to the frontend are therefore represented conservatively.
Main entry points: app.tsx Dashboard shell · clusterViewSlice.ts Cluster view state · interactivitySlice.tsx Interaction state · TransactionDataset.py Transaction dataset
Components 24
Data and service
- Transaction model
frontend/app/dashboard/utilities/DataObject.tsx - Data synchronization
frontend/app/dashboard/hooks/useSyncTransactionDataAndClusterData.tsx - Transaction data hook
frontend/app/dashboard/hooks/useTransactionData.tsx - Service configuration
frontend/app/dashboard/utilities/consts.tsx - Python service
pythonServer/app/main.py - Transaction dataset
pythonServer/app/TransactionDataset.py - String preprocessing
pythonServer/app/stringPreprocessor.py - Clustering engine
pythonServer/app/Cluster.py - Cluster records
frontend/app/dashboard/utilities/clusterDataObject.tsx
Dashboard state
- Interaction state
frontend/app/dashboard/components/Interactivity/interactivitySlice.tsx - Cluster view state
frontend/app/dashboard/components/ClusterView/clusterViewSlice.ts - Colour settings
frontend/app/dashboard/components/ColourChannel/colourChannelSlice.ts - Cluster data hook
frontend/app/dashboard/hooks/useClusterData.tsx - Calendar state
frontend/app/dashboard/components/CalendarView3/calendarViewSlice.ts
Analysis views
- Dashboard shell
frontend/app/dashboard/app.tsx - Cluster view
frontend/app/dashboard/components/ClusterView/ClusterView.tsx - Interactive scatter
frontend/app/dashboard/components/InteractiveScatterPlot/InteractiveScatterPlot.tsx - Amount analysis
frontend/app/dashboard/components/TransactionAmountView.tsx/TransactionAmountView.tsx - Calendar exploration
frontend/app/dashboard/components/CalendarView3/CalendarView3.tsx - Day chart types
frontend/app/dashboard/components/CalendarView3/DayViews - Transaction tables
frontend/app/dashboard/components/TableView/TableView.tsx
Shared presentation
- Colour scales
frontend/app/dashboard/hooks/useColourScales.ts - Colour legends
frontend/app/dashboard/components/ColourLegend/ColourLegends.tsx
Other components
- Dashboard user
Connections 26
- Dashboard user → Dashboard shell: uses
frontend/app/dashboard/app.tsx - Dashboard shell → Calendar exploration: renders
frontend/app/dashboard/app.tsx - Dashboard shell → Transaction tables: renders
frontend/app/dashboard/app.tsx - Dashboard shell → Data synchronization: synchronizes
frontend/app/dashboard/app.tsx - Dashboard shell → Transaction data hook: loads data
frontend/app/dashboard/app.tsx - Transaction data hook → Interaction state: reads state
frontend/app/dashboard/hooks/useTransactionData.tsx - Data synchronization → Transaction model: uses records
frontend/app/dashboard/hooks/useSyncTransactionDataAndClusterData.tsx - Service configuration → Python service: configures endpoint
frontend/app/dashboard/utilities/consts.tsx - Python service → Transaction dataset: uses dataset
pythonServer/app/main.py - Transaction dataset → String preprocessing: uses
pythonServer/app/TransactionDataset.py - Transaction dataset → Clustering engine: uses
pythonServer/app/TransactionDataset.py - Cluster view state → Cluster records: stores records
frontend/app/dashboard/components/ClusterView/clusterViewSlice.ts - Cluster data hook → Interaction state: selects data
frontend/app/dashboard/hooks/useClusterData.tsx - Cluster view state → Cluster data hook: imports hook
frontend/app/dashboard/components/ClusterView/clusterViewSlice.ts - Cluster view → Cluster view state: uses state
frontend/app/dashboard/components/ClusterView/ClusterView.tsx - Cluster view → Interactive scatter: renders
frontend/app/dashboard/components/InteractiveScatterPlot/InteractiveScatterPlot.tsx - Dashboard shell → Amount analysis: renders
frontend/app/dashboard/app.tsx - Dashboard shell → Cluster view: renders
frontend/app/dashboard/app.tsx - Calendar exploration → Day chart types: renders
frontend/app/dashboard/components/CalendarView3/CalendarView3.tsx - Calendar exploration → Calendar state: uses state
frontend/app/dashboard/components/CalendarView3/calendarViewSlice.ts - Interactive scatter → Colour legends: renders
frontend/app/dashboard/components/InteractiveScatterPlot/InteractiveScatterPlot.tsx - Interactive scatter → Colour scales: uses scales
frontend/app/dashboard/components/InteractiveScatterPlot/InteractiveScatterPlot.tsx - Colour scales → Colour settings: selects settings
frontend/app/dashboard/hooks/useColourScales.ts - Transaction tables → Colour settings: uses mappings
frontend/app/dashboard/components/TableView/TableView.tsx - Cluster view state → Interaction state: selects transactions
frontend/app/dashboard/components/ClusterView/clusterViewSlice.ts - Colour settings → Interaction state: selects interactions
frontend/app/dashboard/components/ColourChannel/colourChannelSlice.ts