How lfvelosoh/investortracker-streamlit works
Project Type and Purpose
• From the file tree and README, it’s clear this is a single-repository, multi-page dashboard application written in Python (likely using a framework such as Streamlit or Dash).
• Main purpose: render different financial views (portfolio, trades, products, dividends, subscriptions), allow uploads and configuration.
File Structure
• Top-level files:
• Dashboard.py – the application entry point that routes between pages.
• requirements.txt – enumerates Python dependencies (e.g., Streamlit/Dash, pandas).
• readme.md – project description (empty here).
• pages/ – contains numbered modules for each screen:
1. Carteira.py
2. Negociacoes.py
…
7. Configuracoes.py
• utils/ – contains shared functions (utils/functions.py) used by all pages.
README for Additional Insights
• README placeholder indicates no extra details, so we infer architecture solely from code layout.
Main Components
a. User (browser or CLI)
b. Web UI layer (Streamlit/Dash framework)
c. Application entry point (Dashboard.py)
d. Page modules (pages/1_*.py … pages/7_*.py)
e. Utilities library (utils/functions.py)
f. Data sources:
• Local files (uploads via pages/6_Upload.py)
• External APIs or databases (if referenced in requirements.txt)
g. Environment: Python runtime with dependencies
Relationships & Data Flows
• User → Web UI (HTTP/websocket) → Dashboard.py
• Dashboard.py ↔ imports → pages/*.py
• pages/*.py ↔ calls → utils/functions.py
• pages/*.py ↔ reads/writes → Data sources (upload folder, CSVs, DB/API)
• Results propagate back: Data sources → utils → pages → Dashboard → User
Architectural Patterns & Design Principles
• Modular “multi-page” pattern: each screen is its own module.
• Single-process web app: no separate backend service—UI and business logic co-located.
• Utility layer abstracting data manipulation and external integrations.
Technologies & Frameworks
• Python 3.x
• Streamlit or Dash (based on Dashboard.py)
• pandas/numpy (data handling), requests or SQL client (external data)
• OS/filesystem (for uploads)