# emirkaanozdemr/yarinin-sehirleri-hackathon architecture

> Architecture diagram of the GitHub repository emirkaanozdemr/yarinin-sehirleri-hackathon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/emirkaanozdemr/yarinin-sehirleri-hackathon
- Repository: https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon

## Overview

##### Project type and purpose
- This is a full-stack AI-powered marketplace prototype (“ServeSmart”) built for a hackathon, combining:
- A Streamlit-based web application (5 tabs for sign-up, selling, search, buying, analytics)
- Data-analysis pipelines (price-change mining, sales analysis)
- ML modules (time-series forecasting, text generation via external & local models)
- A static alternative HTML/CSS/JS interface as a backup or demo.

##### File structure
- Top level:
- Dockerfile, Makefile, requirements.txt → build & deployment
- Alternative Interface – Html,Css,Js/… → standalone front-end prototype
- Price Changes/… → CSV datasets & Jupyter notebooks for price-change mining
- Sales Analysis/… → Python scripts for sales metrics
- Text Generation/… → raw data + notebooks + small Flask apps for Llama & Gemma experiments + Gemini integration
- User Interface/… → Streamlit app (app.py), text-generation pipeline & prompt modules, model.h5 (LSTM), .env
- No central database directory—data lives as flat CSVs; user accounts likely managed in memory or via a simple store within Streamlit.

##### README for additional insights
- The Streamlit UI has 5 tabs: Create Account, Sell Product (with on-the-fly title/description improvement via Gemini API), Search Product, Buy Product, See Your Products + Analysis.
- Text generation uses an external Gemini‐1.5‐flash API; prior local fine‐tuned Llama/Gemma models are present but not in the final pipeline.
- A local LSTM model (model.h5) forecasts time-series data for the seller’s analytics tab.

##### Detail
- Every folder’s purpose as its own subcomponent if it contributes to runtime behavior (e.g., include “Sales Analysis/analysisV1.py” under Analytics Service).
- Document environment variables (.env) feeding secrets into the Text Generation and Purchase flows.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Streamlit["Streamlit UI\napp.py"]:::frontend
        StaticUI["Static UI\n(index.html, shop.html, cart.html, deleted.html)"]:::frontend
        ScriptJS["script.js"]:::frontend
        StylesCSS["styles.css"]:::frontend
    end

    %% Services Layer
    subgraph "Services Layer"
        direction TB
        subgraph "Text Generation Service" 
            direction TB
            Pipeline["pipeline.py"]:::ml
            Prompt["prompt.py"]:::ml
            Env[".env"]:::ml
            GeminiAPI["Gemini-1.5-flash API"]:::external
        end
        subgraph "Analytics Service"
            direction TB
            PricePipeline["Price-Change Mining"]:::ml
            SalesAnalysis["Sales Analysis"]:::ml
            ForecastModel["LSTM Forecasting\nmodel.h5"]:::ml
        end
        subgraph "Product Lookup Service"
            direction TB
            Lookup["Product Lookup\n(in-memory/CSV)"]:::ml
        end
    end

    %% Data Storage
    DataStore["Price_Changes/Data CSVs"]:::data

    %% Deployment
    subgraph "Deployment"
        direction TB
        DockerfileNode["Dockerfile"]:::deploy
        MakefileNode["Makefile"]:::deploy
        Req["requirements.txt"]:::deploy
        Gitignore[".gitignore"]:::deploy
    end

    %% Connections
    Streamlit -->|"calls pipeline"| Pipeline
    Pipeline -->|"uses prompt"| Prompt
    Pipeline -->|"calls"| GeminiAPI
    Streamlit -->|"loads LSTM"| ForecastModel
    Streamlit -->|"reads CSVs"| DataStore
    Streamlit -->|"product lookup"| Lookup
    StaticUI -.->|static demo| DataStore

    PricePipeline -->|"reads CSVs"| DataStore
    SalesAnalysis -->|"reads CSVs"| DataStore
    Lookup -->|"reads CSVs"| DataStore

    %% Encapsulate in Docker
    DockerfileNode --> Streamlit
    DockerfileNode --> StaticUI
    DockerfileNode --> Pipeline
    DockerfileNode --> PricePipeline
    DockerfileNode --> SalesAnalysis
    DockerfileNode --> ForecastModel

    %% Click Events
    click Streamlit "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/User Interface/app.py"
    click Pipeline "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/User Interface/Text Generation/pipeline.py"
    click Prompt "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/User Interface/Text Generation/prompt.py"
    click Env "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/User Interface/.env"
    click ForecastModel "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/User Interface/model.h5"
    click StaticUI "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Alternative Interface - Html,Css,Js/index.html"
    click ScriptJS "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Alternative Interface - Html,Css,Js/script.js"
    click StylesCSS "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Alternative Interface - Html,Css,Js/styles.css"
    click PricePipeline "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Price Changes/Data_Mining_Oct_30.ipynb"
    click PricePipeline "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Price Changes/Data_Mining_Nov_06.ipynb"
    click PricePipeline "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Price Changes/Data_Mining_Nov_11.ipynb"
    click PricePipeline "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Price Changes/Train/Train.ipynb"
    click DataStore "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Price Changes/Data/all_data.csv"
    click DataStore "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Price Changes/Data/all_data_oct_30.csv"
    click DataStore "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Price Changes/Data/all_data_nov_06.csv"
    click DataStore "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Price Changes/Data/all_data_nov_11.csv"
    click SalesAnalysis "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Sales Analysis/analysisV1.py"
    click SalesAnalysis "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/Sales Analysis/analysisV2.py"
    click DockerfileNode "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/tree/main/Dockerfile"
    click MakefileNode "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/tree/main/Makefile"
    click Req "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/requirements.txt"
    click Gitignore "https://github.com/emirkaanozdemr/yarinin-sehirleri-hackathon/blob/main/.gitignore"

    %% Styles
    classDef frontend fill:#add8e6,stroke:#333,stroke-width:1px
    classDef ml fill:#90ee90,stroke:#333,stroke-width:1px
    classDef data fill:#ffcc99,stroke:#333,stroke-width:1px
    classDef deploy fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef external fill:#f0f0f0,stroke:#333,stroke-width:1px
```
