How machadoluiz/daric works
Project Type and Purpose
• This is a full-stack, single-page web application built with Python and Streamlit.
File Structure Analysis
• Top-level:
• financial_tracker/app.py – the Streamlit entry point (UI layer + orchestration).
• financial_tracker/data – bundled sample CSVs and JSON template (static assets).
• financial_tracker/extractors – modules that pull raw data from three sources: Sample, LocalFile, GoogleDrive.
• financial_tracker/transformations – core business logic to clean, normalize, and categorize transactions.
• financial_tracker/visualizations – routines that build charts, tables, and KPIs for the UI.
• Configuration files: pyproject.toml, .pre-commit-config.yaml, .python-version, indicating Python package setup and code quality tooling.
• Deployment: runs via “streamlit run financial_tracker/app.py”, no separate backend service or database server—data lives in CSVs or Google Drive folders.
README Insights
• Describes end-to-end user flow: data selection → data loading → optional category JSON mapping → submit → dashboard.
• Lists external dependency: Google Drive API (GCP service account credentials).
• No mention of a persistent database; data is ephemeral per session.