# fangel123/tokokita architecture

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

- Interactive diagram: https://gitdiagram.com/fangel123/tokokita
- Repository: https://github.com/fangel123/tokokita

## Overview

##### Project Type and Purpose
- This is a full-stack e-commerce web application (“TokoKita”) organized as a monorepo with two main subprojects:
- Frontend: React (Vite) SPA deployed on Vercel
- Backend: Node.js + Express API with Prisma ORM and PostgreSQL, deployed on Railway
- Purpose: Connect Sellers and Buyers, display products, manage orders, reviews, likes, and checkout flow (including external shipping API).

##### File Structure
- Top-level:
- README.md, .gitignore
- client/ → All React code, assets, config, contexts, hooks, pages, components
- server/ → Express app, Prisma schema & migrations, controllers, routes, middleware
- Frontend patterns:
- src/components separated into common, layout, ui
- src/contexts for global state (Auth, Cart, Product)
- src/hooks for reusable logic (API calls, auth, like)
- React Router v6 under src/routes
- Backend patterns:
- src/routes → route definitions per resource (auth, product, order, etc.)
- src/controllers → request handlers following an MVC-light style
- src/middleware → auth checks (JWT, optional)
- prisma/ → schema.prisma, migration history
- Config & scripts:
- client/package.json, vite.config.js, tailwind.config.js
- server/package.json, index.js, .env management via dotenv

##### Insights from README
- Tech stack summary (React, Tailwind, Framer Motion, Axios, Express, Prisma, PostgreSQL, JWT).
- Features breakdown: public buyer flows (catalog, likes, reviews, cart, checkout) and protected seller dashboard (product and order CRUD, review management).
- Deployment targets and environment variable requirements.

a. Main Components
- User’s Browser (Buyer & Seller roles)
- Frontend SPA (React + Vite):
– UI Components, Layout, Pages
– Context Providers (Auth, Cart, Product)
– React Router (AppRoutes, ProtectedRoute)
– HTTP Client (Axios via useApi & api.js)
- Backend API (Express):
– Routes → Controllers → Services
– Middleware (auth, optionalAuth)
– Prisma ORM → PostgreSQL
- External Service: Shipping API (Komerce/RajaOngkir)
b. Relationships & Interactions
- Browser ↔ Frontend: UI events → Context/Hooks → Axios calls
- Frontend → Backend: RESTful HTTP requests (/api/auth, /api/products, /api/orders…)
- Backend → PostgreSQL: Prisma executes migrations & queries
- Backend → External Shipping API: HTTP calls for cost calculation
- JWT tokens flow: Frontend stores token → attaches to subsequent requests → validated by auth.middleware
c. Architectural Patterns & Principles
- Monorepo separation (client vs server)
- Layered backend (Routes → Controllers → ORM)
- Component-based frontend with Context API for state
- REST API design
- Protected routes and role-based access
- Environment-driven configuration
d. Key Technologies
- React 18, Vite, Tailwind CSS, Framer Motion, Zod, Axios
- Node.js, Express.js, Prisma, PostgreSQL, JWT, bcryptjs, CORS

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Browser
    Browser["Browser (Buyer & Seller)"]:::client

    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        SPA["React SPA"]:::client
        subgraph "UI Components"
            direction TB
            Common["Common Components"]:::client
            Layout["Layout Components"]:::client
            UI["UI Primitives"]:::client
        end
        subgraph "Context Providers"
            direction TB
            AuthContext["AuthContext"]:::client
            CartContext["CartContext"]:::client
            ProductContext["ProductContext"]:::client
        end
        subgraph "Routing"
            direction TB
            AppRoutes["AppRoutes"]:::client
            ProtectedRoute["ProtectedRoute"]:::client
        end
        subgraph "HTTP Client & Hooks"
            direction TB
            ApiInstance["api.js"]:::client
            UseApi["useApi"]:::client
            UseAuth["useAuth"]:::client
            UseProductLike["useProductLike"]:::client
        end
    end

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        API["Express API"]:::server
        subgraph "Routes"
            direction TB
            AuthRoute["auth.routes.js"]:::server
            ProdRoute["product.routes.js"]:::server
            OrderRoute["order.routes.js"]:::server
            ReviewRoute["review.routes.js"]:::server
            LikeRoute["like.routes.js"]:::server
            CatRoute["category.routes.js"]:::server
            SellerRoute["seller.routes.js"]:::server
            ShipRoute["shipping.routes.js"]:::server
        end
        subgraph "Controllers"
            direction TB
            AuthCtrl["AuthController"]:::server
            ProdCtrl["ProductController"]:::server
            OrderCtrl["OrderController"]:::server
            ReviewCtrl["ReviewController"]:::server
            LikeCtrl["LikeController"]:::server
            CatCtrl["CategoryController"]:::server
            SellerCtrl["SellerController"]:::server
            ShipCtrl["ShippingController"]:::server
        end
        subgraph "Middleware"
            direction TB
            AuthMw["auth.middleware.js"]:::server
            OptAuthMw["optionalAuth.middleware.js"]:::server
        end
        subgraph "Prisma ORM"
            direction TB
            Schema["schema.prisma"]:::server
            Migrations["migrations/"]:::server
        end
    end

    %% Data Stores and External
    DB["PostgreSQL DB"]:::db
    ShippingAPI["Komerce Shipping API"]:::external

    %% Connections Frontend
    Browser -->|"renders"| SPA
    SPA -->|"render UI"| Common
    SPA -->|"render UI"| Layout
    SPA -->|"render UI"| UI
    SPA -->|"manage state"| AuthContext
    SPA -->|"manage state"| CartContext
    SPA -->|"manage state"| ProductContext
    SPA -->|"routing"| AppRoutes
    AppRoutes -->|"protects"| ProtectedRoute
    SPA -->|"uses HTTP client"| UseApi
    SPA -->|"uses auth hook"| UseAuth
    SPA -->|"uses like hook"| UseProductLike
    UseApi -->|"HTTP requests"| API

    %% Connections Backend
    API -->|"route calls"| AuthRoute
    API -->|"route calls"| ProdRoute
    API -->|"route calls"| OrderRoute
    API -->|"route calls"| ReviewRoute
    API -->|"route calls"| LikeRoute
    API -->|"route calls"| CatRoute
    API -->|"route calls"| SellerRoute
    API -->|"route calls"| ShipRoute

    AuthRoute --> AuthMw
    ProdRoute --> OptAuthMw
    ProdRoute --> AuthMw
    OrderRoute --> AuthMw
    ReviewRoute --> OptAuthMw
    LikeRoute --> OptAuthMw
    SellerRoute --> AuthMw
    ShipRoute --> AuthMw

    AuthRoute --> AuthCtrl
    ProdRoute --> ProdCtrl
    OrderRoute --> OrderCtrl
    ReviewRoute --> ReviewCtrl
    LikeRoute --> LikeCtrl
    CatRoute --> CatCtrl
    SellerRoute --> SellerCtrl
    ShipRoute --> ShipCtrl

    AuthCtrl -->|"Prisma query"| Schema
    ProdCtrl -->|"Prisma query"| Schema
    OrderCtrl -->|"Prisma query"| Schema
    ReviewCtrl -->|"Prisma query"| Schema
    LikeCtrl -->|"Prisma query"| Schema
    CatCtrl -->|"Prisma query"| Schema
    SellerCtrl -->|"Prisma query"| Schema
    ShipCtrl -->|"Prisma query"| Schema

    Schema -->|"executes SQL"| DB
    ShipCtrl -->|"shipping request"| ShippingAPI

    %% Click Events
    click SPA "https://github.com/fangel123/tokokita/tree/main/client/"
    click Common "https://github.com/fangel123/tokokita/tree/main/client/src/components/"
    click Layout "https://github.com/fangel123/tokokita/tree/main/client/src/components/layout/"
    click UI "https://github.com/fangel123/tokokita/tree/main/client/src/components/ui/"
    click AuthContext "https://github.com/fangel123/tokokita/blob/main/client/src/contexts/AuthContext.jsx"
    click CartContext "https://github.com/fangel123/tokokita/blob/main/client/src/contexts/CartContext.jsx"
    click ProductContext "https://github.com/fangel123/tokokita/blob/main/client/src/contexts/ProductContext.jsx"
    click AppRoutes "https://github.com/fangel123/tokokita/blob/main/client/src/routes/AppRoutes.jsx"
    click ProtectedRoute "https://github.com/fangel123/tokokita/blob/main/client/src/routes/ProtectedRoute.jsx"
    click ApiInstance "https://github.com/fangel123/tokokita/blob/main/client/src/lib/api.js"
    click UseApi "https://github.com/fangel123/tokokita/blob/main/client/src/hooks/useApi.js"
    click UseAuth "https://github.com/fangel123/tokokita/blob/main/client/src/hooks/useAuth.js"
    click UseProductLike "https://github.com/fangel123/tokokita/blob/main/client/src/hooks/useProductLike.js"
    click API "https://github.com/fangel123/tokokita/blob/main/server/index.js"
    click AuthRoute "https://github.com/fangel123/tokokita/blob/main/server/src/routes/auth.routes.js"
    click ProdRoute "https://github.com/fangel123/tokokita/blob/main/server/src/routes/product.routes.js"
    click OrderRoute "https://github.com/fangel123/tokokita/blob/main/server/src/routes/order.routes.js"
    click ReviewRoute "https://github.com/fangel123/tokokita/blob/main/server/src/routes/review.routes.js"
    click LikeRoute "https://github.com/fangel123/tokokita/blob/main/server/src/routes/like.routes.js"
    click CatRoute "https://github.com/fangel123/tokokita/blob/main/server/src/routes/category.routes.js"
    click SellerRoute "https://github.com/fangel123/tokokita/blob/main/server/src/routes/seller.routes.js"
    click ShipRoute "https://github.com/fangel123/tokokita/blob/main/server/src/routes/shipping.routes.js"
    click AuthCtrl "https://github.com/fangel123/tokokita/blob/main/server/src/controllers/auth.controller.js"
    click ProdCtrl "https://github.com/fangel123/tokokita/blob/main/server/src/controllers/product.controller.js"
    click OrderCtrl "https://github.com/fangel123/tokokita/blob/main/server/src/controllers/order.controller.js"
    click ReviewCtrl "https://github.com/fangel123/tokokita/blob/main/server/src/controllers/review.controller.js"
    click LikeCtrl "https://github.com/fangel123/tokokita/blob/main/server/src/controllers/like.controller.js"
    click CatCtrl "https://github.com/fangel123/tokokita/blob/main/server/src/controllers/category.controller.js"
    click SellerCtrl "https://github.com/fangel123/tokokita/blob/main/server/src/controllers/seller.controller.js"
    click ShipCtrl "https://github.com/fangel123/tokokita/blob/main/server/src/controllers/shipping.controller.js"
    click AuthMw "https://github.com/fangel123/tokokita/blob/main/server/src/middleware/auth.middleware.js"
    click OptAuthMw "https://github.com/fangel123/tokokita/blob/main/server/src/middleware/optionalAuth.middleware.js"
    click Schema "https://github.com/fangel123/tokokita/blob/main/server/prisma/schema.prisma"
    click Migrations "https://github.com/fangel123/tokokita/tree/main/server/prisma/migrations/"

    %% Styles
    classDef client fill:#cce5ff,stroke:#0066cc,color:#004085
    classDef server fill:#d4edda,stroke:#28a745,color:#155724
    classDef db fill:#fff3cd,stroke:#ffc107,color:#856404
    classDef external fill:#f8f9fa,stroke:#6c757d,color:#343a40
```
