# siddhiparkar151992/online-book-store architecture

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

- Interactive diagram: https://gitdiagram.com/siddhiparkar151992/online-book-store
- Repository: https://github.com/siddhiparkar151992/online-book-store

## Overview

##### Project Type and Purpose
- This is a full-stack Online Book Store application.
- Frontend: Angular/Bootstrap single-page app (served as static assets by Flask).
- Backend: Python Flask REST API (server.py, bookstore/app.py).
- Data Stores: MySQL (primary), with a MongoConnection hook (optional) and in-memory Trie for search optimizations.
- Features: Book catalog, search, categories, cart, wishlist, orders, payment, shipment, user auth.

##### File Structure Analysis
Top-level
- server.py / setup.py – entry point and packaging.
- db/ – SQL scripts + exportdb.py for schema and seed data.
- bookstore/ – application package:
– app.py, config.py – Flask app initialization & config.
– index.html – main HTML shell.
– static/ – compiled Angular assets, CSS/SCSS, images, JS components, templates.
– templates/ – Flask-served HTML views (index).
– src/ – Python source split by domain:
· Database (DBConnection, MongoConnection)
· Trie (search index structure)
· auth, book, cart, category, order, payment, shipment, wishlist – each with Api classes and Dao classes.
· models/core/business – domain entities & repositories.
· config – parameter classes and constants.

##### README Insights
- Uses Python/Flask REST, MySQL 5.7+ (full-text search).
- Angular modules for UI, responsive design.
- Data structures (Trie) for performance.
- Modules: cart, wishlist, payment, order, search, categories.

a. Main Components
1. Client Browser (Angular SPA)
2. Flask REST API (Python)
3. MySQL Database
4. (Optional) MongoDB via MongoConnection
5. In-memory Search Engine (Trie)
6. External Services / Payment Gateway (if any)

b. Relationships & Data Flow
- Browser ↔ HTTP(S) ↔ Flask API endpoints (AuthApi, BookApi, CartApi, etc.).
- Flask services use DAOs → SQL queries on MySQL (and/or Mongo).
- On startup, Flask loads Trie module to index books for fast text search.
- Frontend angular services call REST endpoints then update UI templates.
- DB scripts in db/ define schema; setup.py installs the package; server.py starts Flask.

c. Architectural Patterns & Principles
- Separation of Concerns: Static Angular assets vs. Python API layers.
- Layered Architecture: Controllers (Api classes) → Services (CategoryService) → DAOs → Data Store.
- Repository Pattern: Business repositories in models/core/business.
- Client-side MVC: Angular controllers, directives, services, templates.
- Data Structure Optimization: In-memory Trie for search.

d. Key Technologies & Frameworks
- Frontend: AngularJS, Bootstrap, SCSS/SASS for styling.
- Backend: Flask, Flask-REST; config in Python modules.
- Database: MySQL (full-text), optional MongoDB connector.
- Build/Deploy: setup.py, Python packaging.

##### Detailed & Essential Capture
- Explicitly show all major modules (auth, book, cart, category, order, payment, shipment, wishlist).
- Angular module structure: controllers, services, directives, templates.
- How config modules supply parameters to DBConnection and services.
- Initialization flow: server.py → app.py loads config, registers blueprints for each Api.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (Angular SPA)"
        direction TB
        Browser["Client Browser (Angular SPA)"]:::frontend
        NGJS["Angular JS Components"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend (Flask API)"
        direction TB
        SP["server.py"]:::backend
        App["app.py"]:::backend
        Config["config.py"]:::backend

        subgraph "API Controllers"
            direction TB
            AuthApi["AuthApi"]:::backend
            BookApi["BookApi"]:::backend
            CategoryApi["CategoryApi"]:::backend
            CartApi["CartApi"]:::backend
            CartDetailsApi["CartDetailsApi"]:::backend
            OrderApi["OrderApi"]:::backend
            PaymentApi["PaymentApi"]:::backend
            ShipmentApi["ShipmentApi"]:::backend
            WishlistApi["WishlistApi"]:::backend
        end

        subgraph "Service Layer"
            direction TB
            CategorySvc["CategoryService"]:::backend
        end

        subgraph "DAO Layer"
            direction TB
            BookDao["BookDao"]:::backend
            CategoryDao["CategoryDao"]:::backend
            CartDao["CartDao"]:::backend
            CartDetailsDao["CartDetailsDao"]:::backend
            OrderDao["OrderDao"]:::backend
            PaymentDao["PaymentDao"]:::backend
            ShipmentDao["ShipmentDao"]:::backend
            WishlistDao["WishlistDao"]:::backend
            DBConn["DBConnection"]:::backend
            MongoConn["MongoConnection"]:::backend
        end

        Trie["In-Memory Search Engine (Trie)"]:::memory
    end

    %% Data Stores
    subgraph "Data Stores"
        direction TB
        Scripts["DB Scripts"]:::datastore
        MySQL["MySQL Database"]:::datastore
        Mongo["MongoDB (Optional)"]:::datastore
    end

    %% Connections
    Browser -->|"HTTP(S) Requests"| AuthApi
    Browser --> BookApi
    Browser --> CategoryApi
    Browser --> CartApi
    Browser --> CartDetailsApi
    Browser --> OrderApi
    Browser --> PaymentApi
    Browser --> ShipmentApi
    Browser --> WishlistApi

    SP --> App
    App --> Config
    App --> AuthApi
    App --> BookApi
    App --> CategoryApi
    App --> CartApi
    App --> CartDetailsApi
    App --> OrderApi
    App --> PaymentApi
    App --> ShipmentApi
    App --> WishlistApi

    BookApi -->|"uses"| Trie
    AuthApi -->|"calls DAO"| DBConn
    BookApi -->|"calls DAO"| BookDao
    CategoryApi -->|"calls Service"| CategorySvc
    CategorySvc -->|"calls DAO"| CategoryDao
    CartApi -->|"calls DAO"| CartDao
    CartDetailsApi -->|"calls DAO"| CartDetailsDao
    OrderApi -->|"calls DAO"| OrderDao
    PaymentApi -->|"calls DAO"| PaymentDao
    ShipmentApi -->|"calls DAO"| ShipmentDao
    WishlistApi -->|"calls DAO"| WishlistDao

    BookDao --> DBConn
    CategoryDao --> DBConn
    CartDao --> DBConn
    CartDetailsDao --> DBConn
    OrderDao --> DBConn
    PaymentDao --> DBConn
    ShipmentDao --> DBConn
    WishlistDao --> DBConn

    DBConn --> MySQL
    MongoConn --> Mongo
    Scripts --> MySQL

    %% Click Events
    click Browser "https://github.com/siddhiparkar151992/online-book-store/tree/master/bookstore/static"
    click NGJS "https://github.com/siddhiparkar151992/online-book-store/tree/master/bookstore/static/js"
    click SP "https://github.com/siddhiparkar151992/online-book-store/blob/master/server.py"
    click App "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/app.py"
    click Config "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/config.py"
    click Scripts "https://github.com/siddhiparkar151992/online-book-store/blob/master/db/exportdb.py"
    click MongoConn "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/Database/MongoConnection.py"
    click DBConn "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/Database/DBConnection.py"
    click Trie "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/Trie/TRIE.py"
    click BookApi "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/book/BookApi.py"
    click BookDao "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/book/dao/BookDao.py"
    click CategoryApi "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/category/CategoryApi.py"
    click CategorySvc "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/category/CategoryService.py"
    click CategoryDao "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/category/dao/CategoryDao.py"
    click CartApi "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/cart/CartApi.py"
    click CartDetailsApi "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/cart/CartDetailsApi.py"
    click CartDao "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/cart/dao/CartDao.py"
    click CartDetailsDao "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/cart/dao/CartDetailsDao.py"
    click OrderApi "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/order/OrderApi.py"
    click OrderDao "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/order/OrderDao.py"
    click PaymentApi "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/payment/PaymentApi.py"
    click PaymentDao "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/payment/dao/PaymentDao.py"
    click ShipmentApi "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/shipment/ShipementApi.py"
    click ShipmentDao "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/shipment/dao/ShipmentDao.py"
    click WishlistApi "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/wishlist/WishlistApi.py"
    click WishlistDao "https://github.com/siddhiparkar151992/online-book-store/blob/master/bookstore/src/wishlist/dao/WishlistDao.py"

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#0044CC,color:#0044CC
    classDef backend fill:#DFFFE0,stroke:#24A000,color:#24A000
    classDef datastore fill:#FFE5CC,stroke:#FF8000,color:#FF8000
    classDef memory fill:#F4D1FF,stroke:#A000D2,color:#A000D2
```
