# avinashdoniparthi/app_final_project architecture

> Architecture diagram of the GitHub repository avinashdoniparthi/app_final_project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/avinashdoniparthi/app_final_project
- Repository: https://github.com/avinashdoniparthi/app_final_project

## Overview

FinSight is a desktop investment and portfolio intelligence terminal. The user signs in, then navigates modules for portfolio oversight, market research, trading, analytics, risk, dividends, watchlists, reports, and administration. Trading requests quotes and executes virtual orders; portfolio services value holdings and calculate performance. Repository and service edges are supported by the supplied source index or excerpts; unsampled module capabilities and the market-data fallback behavior are represented from README documentation, not inferred implementation details.

Main entry points: [`ui/app_shell.py`](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/app_shell.py) (App shell), [`services/trading_service.py`](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/trading_service.py) (Trading service), [`services/portfolio_service.py`](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/portfolio_service.py) (Portfolio service), [`services/market_data_service.py`](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/market_data_service.py) (Market data service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop application"]
  node_shell["App shell<br/>[app_shell.py]"]
  node_authview["Authentication view<br/>[auth_view.py]"]
  node_dashboard["Dashboard<br/>[dashboard_view.py]"]
  node_explorer["Stock explorer"]
  node_portfolio_view["Portfolio view<br/>[portfolio_view.py]"]
  node_trading_view["Trading desk<br/>[trading_view.py]"]
  node_analytics["Analytics view<br/>[analytics_view.py]"]
  node_riskview["Risk view<br/>[risk_view.py]"]
  node_watchview["Watchlist view<br/>[watchlist_view.py]"]
  node_dividend_view["Dividend view<br/>[dividend_view.py]"]
  node_reports_view["Reports view<br/>[reports_view.py]"]
  node_admin_view["Admin panel<br/>[admin_view.py]"]
end

subgraph group_portfolio["Portfolio and analysis"]
  node_portfolio_service["Portfolio service"]
  node_financial["Financial engine"]
  node_riskservice["Risk service<br/>[risk_service.py]"]
  node_reportservice["Report service<br/>[report_service.py]"]
end

subgraph group_trading["Trading and market data"]
  node_trading["Trading service<br/>[trading_service.py]"]
  node_market["Market data service"]
end

subgraph group_identity["Identity and governance"]
  node_authservice["Authentication service<br/>[auth_service.py]"]
  node_adminservice["Administration service<br/>[admin_service.py]"]
end

subgraph group_persistence["Persistence"]
  node_portfolio_repo["Portfolio repository<br/>[portfolio_repo.py]"]
  node_stock_repo["Stock repository<br/>[stock_repo.py]"]
  node_transaction_repo["Transaction repository"]
  node_audit_repo["Audit repository<br/>[audit_repo.py]"]
  node_database[("Relational database<br/>[connection.py]")]
end

node_investor(("Investor / admin"))
node_yfinance{{"yfinance feed"}}

node_investor -->|"uses"| node_shell
node_shell -->|"shows"| node_authview
node_authview -->|"authenticates"| node_authservice
node_shell -->|"routes to"| node_dashboard
node_shell -->|"routes to"| node_explorer
node_shell -->|"routes to"| node_portfolio_view
node_shell -->|"routes to"| node_trading_view
node_shell -->|"routes to"| node_analytics
node_shell -->|"routes to"| node_riskview
node_shell -->|"routes to"| node_watchview
node_shell -->|"routes to"| node_dividend_view
node_shell -->|"routes to"| node_reports_view
node_shell -->|"routes to"| node_admin_view
node_portfolio_view -->|"requests portfolio data"| node_portfolio_service
node_trading_view -->|"submits orders"| node_trading
node_trading -->|"gets quotes"| node_market
node_trading -->|"calculates trade impact"| node_financial
node_market -.->|"fetches live quotes"| node_yfinance
node_market -->|"reads and caches quotes"| node_stock_repo
node_portfolio_service -->|"calculates valuation"| node_financial
node_portfolio_service -->|"gets prices and FX"| node_market
node_portfolio_service -->|"reads portfolios"| node_portfolio_repo
node_trading -->|"updates holdings and lots"| node_portfolio_repo
node_trading -->|"records orders"| node_transaction_repo
node_trading -->|"records audit events"| node_audit_repo
node_authservice -->|"logs authentication events"| node_audit_repo
node_authservice -->|"creates default portfolio"| node_portfolio_repo
node_reportservice -->|"uses portfolio data"| node_portfolio_service
node_portfolio_repo -->|"queries and writes"| node_database
node_stock_repo -->|"queries and writes"| node_database

click node_shell "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/app_shell.py"
click node_authview "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/auth_view.py"
click node_dashboard "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/dashboard_view.py"
click node_explorer "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/stock_explorer_view.py"
click node_portfolio_view "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/portfolio_view.py"
click node_trading_view "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/trading_view.py"
click node_analytics "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/analytics_view.py"
click node_riskview "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/risk_view.py"
click node_watchview "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/watchlist_view.py"
click node_dividend_view "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/dividend_view.py"
click node_reports_view "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/reports_view.py"
click node_admin_view "https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/admin_view.py"
click node_authservice "https://github.com/avinashdoniparthi/app_final_project/blob/main/services/auth_service.py"
click node_adminservice "https://github.com/avinashdoniparthi/app_final_project/blob/main/services/admin_service.py"
click node_portfolio_service "https://github.com/avinashdoniparthi/app_final_project/blob/main/services/portfolio_service.py"
click node_financial "https://github.com/avinashdoniparthi/app_final_project/blob/main/services/financial_engine.py"
click node_riskservice "https://github.com/avinashdoniparthi/app_final_project/blob/main/services/risk_service.py"
click node_reportservice "https://github.com/avinashdoniparthi/app_final_project/blob/main/services/report_service.py"
click node_trading "https://github.com/avinashdoniparthi/app_final_project/blob/main/services/trading_service.py"
click node_market "https://github.com/avinashdoniparthi/app_final_project/blob/main/services/market_data_service.py"
click node_portfolio_repo "https://github.com/avinashdoniparthi/app_final_project/blob/main/repositories/portfolio_repo.py"
click node_stock_repo "https://github.com/avinashdoniparthi/app_final_project/blob/main/repositories/stock_repo.py"
click node_transaction_repo "https://github.com/avinashdoniparthi/app_final_project/blob/main/repositories/transaction_repo.py"
click node_audit_repo "https://github.com/avinashdoniparthi/app_final_project/blob/main/repositories/audit_repo.py"
click node_database "https://github.com/avinashdoniparthi/app_final_project/blob/main/database/connection.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shell,node_authview,node_dashboard,node_explorer,node_portfolio_view,node_trading_view,node_analytics,node_riskview,node_watchview,node_dividend_view,node_reports_view,node_admin_view toneBlue
class node_portfolio_service,node_financial,node_riskservice,node_reportservice toneAmber
class node_trading,node_market toneMint
class node_authservice,node_adminservice toneRose
class node_portfolio_repo,node_stock_repo,node_transaction_repo,node_audit_repo,node_database,node_investor,node_yfinance toneIndigo
```

## Components

### Desktop application

- [App shell](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/app_shell.py): `ui/app_shell.py`
- [Authentication view](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/auth_view.py): `ui/views/auth_view.py`
- [Dashboard](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/dashboard_view.py): `ui/views/dashboard_view.py`
- [Stock explorer](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/stock_explorer_view.py): `ui/views/stock_explorer_view.py`
- [Portfolio view](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/portfolio_view.py): `ui/views/portfolio_view.py`
- [Trading desk](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/trading_view.py): `ui/views/trading_view.py`
- [Analytics view](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/analytics_view.py): `ui/views/analytics_view.py`
- [Risk view](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/risk_view.py): `ui/views/risk_view.py`
- [Watchlist view](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/watchlist_view.py): `ui/views/watchlist_view.py`
- [Dividend view](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/dividend_view.py): `ui/views/dividend_view.py`
- [Reports view](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/reports_view.py): `ui/views/reports_view.py`
- [Admin panel](https://github.com/avinashdoniparthi/app_final_project/blob/main/ui/views/admin_view.py): `ui/views/admin_view.py`

### Portfolio and analysis

- [Portfolio service](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/portfolio_service.py): `services/portfolio_service.py`
- [Financial engine](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/financial_engine.py): `services/financial_engine.py`
- [Risk service](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/risk_service.py): `services/risk_service.py`
- [Report service](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/report_service.py): `services/report_service.py`

### Trading and market data

- [Trading service](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/trading_service.py): `services/trading_service.py`
- [Market data service](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/market_data_service.py): `services/market_data_service.py`

### Identity and governance

- [Authentication service](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/auth_service.py): `services/auth_service.py`
- [Administration service](https://github.com/avinashdoniparthi/app_final_project/blob/main/services/admin_service.py): `services/admin_service.py`

### Persistence

- [Portfolio repository](https://github.com/avinashdoniparthi/app_final_project/blob/main/repositories/portfolio_repo.py): `repositories/portfolio_repo.py`
- [Stock repository](https://github.com/avinashdoniparthi/app_final_project/blob/main/repositories/stock_repo.py): `repositories/stock_repo.py`
- [Transaction repository](https://github.com/avinashdoniparthi/app_final_project/blob/main/repositories/transaction_repo.py): `repositories/transaction_repo.py`
- [Audit repository](https://github.com/avinashdoniparthi/app_final_project/blob/main/repositories/audit_repo.py): `repositories/audit_repo.py`
- [Relational database](https://github.com/avinashdoniparthi/app_final_project/blob/main/database/connection.py): `database/connection.py`

### Other components

- **Investor / admin**
- **yfinance feed**

## Connections

- Investor / admin → App shell: uses
- App shell → Authentication view: shows (evidence: `ui/app_shell.py`)
- Authentication view → Authentication service: authenticates (evidence: `ui/views/auth_view.py`)
- App shell → Dashboard: routes to (evidence: `ui/app_shell.py`)
- App shell → Stock explorer: routes to (evidence: `ui/app_shell.py`)
- App shell → Portfolio view: routes to (evidence: `ui/app_shell.py`)
- App shell → Trading desk: routes to (evidence: `ui/app_shell.py`)
- App shell → Analytics view: routes to (evidence: `ui/app_shell.py`)
- App shell → Risk view: routes to (evidence: `ui/app_shell.py`)
- App shell → Watchlist view: routes to (evidence: `ui/app_shell.py`)
- App shell → Dividend view: routes to (evidence: `ui/app_shell.py`)
- App shell → Reports view: routes to (evidence: `ui/app_shell.py`)
- App shell → Admin panel: routes to (evidence: `ui/app_shell.py`)
- Portfolio view → Portfolio service: requests portfolio data (evidence: `ui/views/portfolio_view.py`)
- Trading desk → Trading service: submits orders (evidence: `ui/views/trading_view.py`)
- Trading service → Market data service: gets quotes (evidence: `services/trading_service.py`)
- Trading service → Financial engine: calculates trade impact (evidence: `services/trading_service.py`)
- Market data service → yfinance feed: fetches live quotes
- Market data service → Stock repository: reads and caches quotes (evidence: `services/market_data_service.py`)
- Portfolio service → Financial engine: calculates valuation (evidence: `services/portfolio_service.py`)
- Portfolio service → Market data service: gets prices and FX (evidence: `services/portfolio_service.py`)
- Portfolio service → Portfolio repository: reads portfolios (evidence: `services/portfolio_service.py`)
- Trading service → Portfolio repository: updates holdings and lots (evidence: `services/trading_service.py`)
- Trading service → Transaction repository: records orders (evidence: `services/trading_service.py`)
- Trading service → Audit repository: records audit events (evidence: `services/trading_service.py`)
- Authentication service → Audit repository: logs authentication events (evidence: `services/auth_service.py`)
- Authentication service → Portfolio repository: creates default portfolio (evidence: `services/auth_service.py`)
- Report service → Portfolio service: uses portfolio data (evidence: `services/report_service.py`)
- Portfolio repository → Relational database: queries and writes (evidence: `repositories/portfolio_repo.py`)
- Stock repository → Relational database: queries and writes (evidence: `repositories/stock_repo.py`)
