# vineethkumar3/mybookstore architecture

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

- Interactive diagram: https://gitdiagram.com/vineethkumar3/mybookstore
- Repository: https://github.com/vineethkumar3/mybookstore

## Overview

##### Project type and purpose
- This is a full-stack web application built with Flask (Python) on the back end, serving HTML/CSS/JavaScript on the front end, and backed by a PostgreSQL database hosted on AWS.
- Primary use cases: user registration/login, browsing books, cart management, and payment simulation.

##### File structure
- Top-level files:
- app.py – your Flask application entry point and routing logic
- Database_Connection.py – sets up and manages the PostgreSQL connection (via AWS)
- requirements.txt, Dockerfile, buildspec.yml – define dependencies, containerization, and CI/CD build steps
- Directories:
- static/ – client-side assets (CSS, JS, JSON data)
- templates/ – Jinja2 HTML templates for views (home, cart, checkout, login, register)

##### README for additional context
- Tech stack confirmation, feature list, AWS RDS for PostgreSQL, local JS cart syncing, session-based user state

##### Main components
a. Client (Browser) – fetches static assets and interacts with Flask via HTTP(S)
b. Web Server / Application Container – runs Flask (app.py), serves endpoints, renders templates, executes business logic
c. Database Layer – PostgreSQL instance on AWS RDS, accessed via Database_Connection.py
d. CI/CD Pipeline (optional) – CodeBuild (buildspec.yml) → container image → deployment
e. Static Asset Store – served directly by Flask or via a CDN if configured
f. External Services – AWS EC2/RDS, optional payment simulator

##### Relationships & data flows
- Web Server ↔ PostgreSQL: “SQL queries (psycopg2 or SQLAlchemy)”
- Web Server → Static Asset Store: “serves JS/CSS/JSON”
- Client ↔ JavaScript code: “AJAX calls to cart endpoints”
- CI/CD Pipeline → Web Server Container: “build → push → deploy”

##### Architectural patterns & tech
- MVC-style separation:
- Models: Database_Connection.py + SQL
- Views: Jinja2 templates in /templates
- Controllers: app.py route handlers
- Session management for user state
- Static-dynamic separation: heavy lifting in Python, dynamic UI via vanilla JS
- Containerization: Dockerfile defines image; buildspec.yml automates AWS CodeBuild

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Side
    subgraph "Client Side"
        Browser(["Client (Browser)"]):::frontend
    end

    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline"
        Build["AWS CodeBuild\n(buildspec.yml)"]:::ci
        Docker["Docker Container\n(Dockerfile)"]:::ci
        Deploy["Deployment to EC2/ECS"]:::ci
        Build --> Docker
        Docker --> Deploy
    end

    %% Documentation & Dependencies
    Requirements["requirements.txt"]:::docs
    README["README.md"]:::docs

    %% Web Server Container
    subgraph "Web Server Container"
        FlaskApp["Flask App\n(app.py)"]:::backend
        Static["Static Assets\n(static/)"]:::frontend
        Templates["Jinja2 Templates\n(templates/)"]:::frontend
        DBConn["Database Connection\n(Database_Connection.py)"]:::backend
        FlaskApp -->|serves JS/CSS/JSON| Static
        FlaskApp -->|renders HTML views| Templates
        FlaskApp -->|uses DB connection| DBConn
    end

    %% Database Layer
    subgraph "AWS VPC"
        DB[(PostgreSQL RDS)]:::db
    end
    DBConn -->|SQL queries| DB

    %% Client interactions
    Browser -->|HTTP GET/POST| FlaskApp
    Browser -->|AJAX calls to cart endpoints| FlaskApp

    %% CI/CD to Server
    Docker -.->|deploy container| FlaskApp
    Requirements -->|defines deps| Docker
    README -.->|project docs| FlaskApp

    %% Click Events
    click Browser "https://github.com/vineethkumar3/mybookstore/tree/main/static/"
    click Static "https://github.com/vineethkumar3/mybookstore/tree/main/static/"
    click Templates "https://github.com/vineethkumar3/mybookstore/tree/main/templates/"
    click FlaskApp "https://github.com/vineethkumar3/mybookstore/blob/main/app.py"
    click DBConn "https://github.com/vineethkumar3/mybookstore/blob/main/Database_Connection.py"
    click Requirements "https://github.com/vineethkumar3/mybookstore/blob/main/requirements.txt"
    click Docker "https://github.com/vineethkumar3/mybookstore/tree/main/Dockerfile"
    click Build "https://github.com/vineethkumar3/mybookstore/blob/main/buildspec.yml"
    click README "https://github.com/vineethkumar3/mybookstore/blob/main/README.md"

    %% Styles
    classDef frontend fill:#f9f,stroke:#333,stroke-width:1px
    classDef backend fill:#bbf,stroke:#333,stroke-width:1px
    classDef db fill:#bfb,stroke:#333,stroke-width:1px
    classDef ci fill:#ffb,stroke:#333,stroke-width:1px
    classDef docs fill:#ffd,stroke:#333,stroke-width:1px
```
