# sikandarsubhani/skincare_recommendation_system architecture

> Architecture diagram of the GitHub repository sikandarsubhani/skincare_recommendation_system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sikandarsubhani/skincare_recommendation_system
- Repository: https://github.com/sikandarsubhani/skincare_recommendation_system

## Overview

##### Project Type and Purpose
- This is a full-stack, Flask-based web application named “Skincare_recommendation_system.”
- It allows users to upload skin lesion images, runs them through pre-trained Keras/TensorFlow models, classifies the lesion type, and provides skincare recommendations.
- There is also an admin interface for monitoring predictions and viewing charts.

##### File Structure Analysis
- Top-level files
- run.py – application entry point
- req.txt – Python dependencies
- README.md – project title
- Core application directory: skin/
- admin_routes.py – admin-side endpoints
- routes.py – user-side endpoints (upload, prediction)
- forms.py – Flask-WTForms definitions for login/register/upload
- models.py – database ORM definitions (SQLite via skin.db)
- best_model.h5, dermnet_*.h5, skin.h5 – saved Keras models in root and skin/model/
- skin.db – SQLite database storing user info, predictions, logs
- Static assets: skin/static/assets/(css, js, img, vendor)
- Templates: skin/templates/(login.html, register.html, prediction.html, dashboard.html, admin_dashboard.html, Graph.html…)
- Upload storage: skin/upload/<lesion-type>/ – sample dataset or uploads

##### Key Architectural Insights from README
- We infer a classic MVC pattern (Flask controllers, Jinja2 views, models.py as data layer), integrated with a machine-learning inference component.

a. Main Components
- User Interface (Web browser)
- Frontend Layer
- Static web assets (CSS/JavaScript)
- Jinja2 templates (HTML views)
- Backend Layer (Flask application)
- run.py + Flask app factory
- Routes/controllers (routes.py, admin_routes.py)
- Form handling (forms.py)
- Business logic (prediction pipeline, recommendation logic)
- Machine-Learning Component
- Model loader (Keras/TensorFlow)
- Pre-trained .h5 files stored on disk
- Data Layer
- SQLite database (skin.db) via models.py
- File storage for uploads (skin/upload/)
- Optional External Services (if added later)
- Email service for notifications
- Cloud storage for large datasets

b. Relationships and Data Flows
1. User requests page → Web server (Flask)
2. Flask returns HTML via templates + static assets
3. User uploads image → HTTP POST to /predict route
4. Controller validates form → saves file to upload directory
5. Prediction pipeline loads image → passes to Keras model → inference result
6. Result persisted to SQLite (via models.py) → recommendation logic runs
7. Flask renders prediction.html with result → response to user
8. Admin flows query DB → generate charts → render Graph.html/dashboard

c. Architectural Patterns and Principles
- MVC: Controllers (routes), Views (templates), Models (models.py & DB)
- Separation of Concerns: ML code isolated in prediction functions.
- Layered architecture: Presentation → Application → ML Service → Data.
- Stateless HTTP requests, with state stored in DB or filesystem.

d. Key Technologies
- Python 3 & Flask (web framework)
- SQLite via SQLAlchemy or Flask-SQLAlchemy
- Keras/TensorFlow for model inference
- WTForms for form handling
- HTML5/CSS3/JavaScript for frontend
- Jinja2 templating

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Web Browser"]:::external
        StaticAssets["Static Assets\n(CSS/JS/Images)"]:::presentation
        Templates["Jinja2 Templates"]:::presentation
    end

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        Run["run.py\n(Entry Point)"]:::backend
        Controllers["Flask Controllers"]:::backend
        Forms["Form Handling\n(forms.py)"]:::backend
        ModelsDef["ORM Definitions\n(models.py)"]:::backend
    end

    %% ML Layer
    subgraph "ML Layer"
        direction TB
        ModelLoader["Keras/TensorFlow Loader"]:::ml
        ModelFiles["Pre-trained Models\n(.h5 files)"]:::ml
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        DB[(skin.db)]:::persistence
        FileStorage["Upload Storage\n(skin/upload/)"]:::persistence
    end

    %% External Services
    subgraph "External Services"
        direction TB
        EmailService["Email Service"]:::external
        CloudStorage["Cloud Storage"]:::external
    end

    %% Connections
    Browser -->|"requests pages"| Run
    Run -->|uses| Controllers
    Controllers -->|renders| Templates
    Controllers -->|serves| StaticAssets
    Controllers -->|validates| Forms
    Controllers -->|uses| ModelsDef
    Controllers -->|calls| ModelLoader
    ModelLoader -->|loads files| ModelFiles
    ModelLoader -->|inference| Controllers
    Controllers -->|reads/writes| DB
    Controllers -->|saves files| FileStorage
    Controllers -->|sends notifications| EmailService
    Controllers -->|stores large data| CloudStorage

    %% Click Events
    click Run "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/run.py"
    click Controllers "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/routes.py"
    click Controllers "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/admin_routes.py"
    click Forms "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/forms.py"
    click ModelsDef "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/models.py"
    click DB "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/skin.db"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/best_model.h5"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/dermnet_m1.h5"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/skin.h5"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/model/best_model.h5"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/model/dermnet_m1.h5"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/model/dermnet_m2.h5"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/model/dermnet_m2.keras"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/model/dermnet_m4.keras"
    click ModelFiles "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/model/skin.h5"
    click Templates "https://github.com/sikandarsubhani/skincare_recommendation_system/tree/main/skin/templates/"
    click StaticAssets "https://github.com/sikandarsubhani/skincare_recommendation_system/tree/main/skin/static/assets/"
    click FileStorage "https://github.com/sikandarsubhani/skincare_recommendation_system/tree/main/skin/upload/"
    click Req "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/req.txt"
    click Readme "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/README.md"
    click Accuracy "https://github.com/sikandarsubhani/skincare_recommendation_system/blob/main/skin/Accuracy.txt"
    click ModelLoader "https://github.com/sikandarsubhani/skincare_recommendation_system/tree/main/skin/model/"

    %% Styles
    classDef presentation fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#000,stroke-width:1px
    classDef ml fill:#FFA500,stroke:#000,stroke-width:1px
    classDef persistence fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef external fill:#D5D8DC,stroke:#000,stroke-width:1px
```
