# zinhlemm/track-my-impact-1509 architecture

> Architecture diagram of the GitHub repository zinhlemm/track-my-impact-1509, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zinhlemm/track-my-impact-1509
- Repository: https://github.com/zinhlemm/track-my-impact-1509

## Overview

##### Project type and purpose
- This is a full-stack web application (“Track My Impact”) combining:
– A Next.js + React frontend (TypeScript, Tailwind, Radix UI, TFJS)
– A FastAPI backend (Python async, SQLAlchemy, SQLite, JWT auth)
– On-device AI inference (TensorFlow.js model)
– Shared JSON data files for environmental impact factors

##### File structure
- Top-level directories:
– backend/ (FastAPI app, routers, models, config, seed script)
– track-my-impact/ (Next.js app)
– scripts/, render.yaml, run_instructions.txt
- Patterns:
– Frontend follows Next.js App Router (src/app, src/components, public/data, public/model)
– Backend follows MVC‐style: routers (controllers), models (SQLAlchemy + Pydantic), core (config/auth), utils
– Deployment config for Render (backend) & Vercel (frontend)

##### README for additional insights
- Confirms tech stack, API endpoints, data flow (client ↔ backend ↔ DB), AI model placement, seed process
- Describes features: AI classification, dynamic waste logger, impact calculator, user progress, community stats

- Review with stakeholders to ensure accuracy and completeness

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Next.js App" 
        direction TB
        UI["Frontend UI"]:::frontend
        APIClient["API Client\n(track-my-impact/src/lib/api.ts)"]:::frontend
        AuthContext["AuthContext\n(track-my-impact/src/contexts/AuthContext.tsx)"]:::frontend
        DataHook["useTrackMyImpactData\n(track-my-impact/src/hooks/useTrackMyImpactData.tsx)"]:::frontend
        subgraph "AI Classification" 
            direction TB
            ModelLoader["Model Loader\n(track-my-impact/src/utils/model-loader.ts)"]:::frontend
            TFJSModel["TFJS Model\n(public/model/model.json + shards)"]:::frontend
        end
        subgraph "Data Store (Client)" 
            direction TB
            JSONData["JSON Data Files\n(public/data/*.json)"]:::storage
        end
    end

    %% Backend Layer
    subgraph "FastAPI Service" 
        direction TB
        Routers["API Routers\n(backend/routers/)"]:::backend
        Models["ORM Models\n(backend/models/)"]:::backend
        AuthUtils["Auth Utilities\n(backend/core/auth.py)"]:::backend
        CoreDB["DB Config\n(backend/core/)"]:::backend
        Utils["Backend Utils"]:::backend
    end

    %% Persistence
    DB["SQLite Database"]:::storage
    SeedJob["Seed Job\n(backend/scripts/init_database.py)"]:::utils

    %% Deployment
    subgraph "Deployment" 
        direction TB
        Vercel["Vercel\n(track-my-impact/next.config.js)"]:::deployment
        Netlify["Netlify\n(track-my-impact/netlify.toml)"]:::deployment
        Render["Render\n(render.yaml)"]:::deployment
    end

    %% Relationships
    UI -->|"uses"| APIClient
    UI -->|"consumes"| JSONData
    UI -->|"displays"| DataHook
    UI -->|"calls"| ModelLoader
    ModelLoader -->|"loads"| TFJSModel
    APIClient -->|"REST calls"| Routers
    AuthContext -->|"provides tokens to"| APIClient
    DataHook -->|"fetches data via"| APIClient

    Routers -->|"CRUD"| Models
    Routers -->|"auth via"| AuthUtils
    CoreDB -->|"connects to"| DB
    SeedJob -.->|"reads JSON data"| JSONData
    SeedJob -->|"populates"| DB

    %% Deployment arrows
    UI -->|"deployed on"| Vercel
    UI -->|"deployed on"| Netlify
    Routers -->|"deployed on"| Render
    CoreDB -->|"hosted by"| Render

    %% Click Events
    click UI "https://github.com/zinhlemm/track-my-impact-1509/tree/main/track-my-impact/src/app/"
    click APIClient "https://github.com/zinhlemm/track-my-impact-1509/blob/main/track-my-impact/src/lib/api.ts"
    click AuthContext "https://github.com/zinhlemm/track-my-impact-1509/blob/main/track-my-impact/src/contexts/AuthContext.tsx"
    click DataHook "https://github.com/zinhlemm/track-my-impact-1509/blob/main/track-my-impact/src/hooks/useTrackMyImpactData.tsx"
    click ModelLoader "https://github.com/zinhlemm/track-my-impact-1509/blob/main/track-my-impact/src/utils/model-loader.ts"
    click TFJSModel "https://github.com/zinhlemm/track-my-impact-1509/blob/main/track-my-impact/public/model/model.json"
    click JSONData "https://github.com/zinhlemm/track-my-impact-1509/tree/main/track-my-impact/public/data/"
    click Routers "https://github.com/zinhlemm/track-my-impact-1509/tree/main/backend/routers/"
    click Models "https://github.com/zinhlemm/track-my-impact-1509/tree/main/backend/models/"
    click AuthUtils "https://github.com/zinhlemm/track-my-impact-1509/blob/main/backend/core/auth.py"
    click CoreDB "https://github.com/zinhlemm/track-my-impact-1509/tree/main/backend/core/"
    click SeedJob "https://github.com/zinhlemm/track-my-impact-1509/blob/main/backend/scripts/init_database.py"
    click Vercel "https://github.com/zinhlemm/track-my-impact-1509/blob/main/track-my-impact/next.config.js"
    click Netlify "https://github.com/zinhlemm/track-my-impact-1509/blob/main/track-my-impact/netlify.toml"
    click Render "https://github.com/zinhlemm/track-my-impact-1509/blob/main/render.yaml"

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#006064,color:#004D40
    classDef backend fill:#E8F5E9,stroke:#1B5E20,color:#2E7D32
    classDef storage fill:#FFF3E0,stroke:#E65100,color:#BF360C
    classDef utils fill:#FFFDE7,stroke:#F9A825,color:#F57F17
    classDef deployment fill:#EDE7F6,stroke:#4527A0,color:#311B92
```
