# medali-chihi/nekovault architecture

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

- Interactive diagram: https://gitdiagram.com/medali-chihi/nekovault
- Repository: https://github.com/medali-chihi/nekovault

## Overview

NekoVault is a React/Spring Boot storefront for anime and manga merchandise. Shoppers browse products and categories, manage a cart, check out, and view orders; accounts also support favorites and profile updates, while admins manage catalog data and users. The graph includes the documented product capabilities, frontend routing and state, backend request handlers, and MySQL persistence. Several backend controllers and pages are represented from the README and file tree; their internal calls were not sampled, so those links are omitted rather than inferred.

Main entry points: [`frontend/src/api/client.js`](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/api/client.js) (API Client), [`frontend/src/App.jsx`](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/App.jsx) (App Router), [`backend/src/main/java/com/ecommerce/repository/UserRepository.java`](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/UserRepository.java) (User Store), [`backend/src/main/java/com/ecommerce/controller/CartController.java`](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/CartController.java) (Cart API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Storefront"]
  node_app["App Router<br/>[App.jsx]"]
  node_catalog_ui["Catalog Pages"]
  node_cart_ui["Cart and Checkout<br/>[CheckoutPage.jsx]"]
  node_orders_ui["Order Pages<br/>[OrdersPage.jsx]"]
  node_favorites_ui["Favorites Pages<br/>[FavoritesPage.jsx]"]
  node_account_ui["Account Pages<br/>[ProfilePage.jsx]"]
  node_admin_ui["Admin Pages<br/>[AdminProducts.jsx]"]
  node_auth_state["Auth State<br/>[AuthContext.jsx]"]
  node_cart_state["Cart State<br/>[CartContext.jsx]"]
  node_favorites_state["Favorites State"]
  node_api_client["API Client<br/>[client.js]"]
end

subgraph group_backend["Commerce API"]
  node_catalog_api["Catalog API"]
  node_cart_api["Cart API"]
  node_orders_api["Orders API"]
  node_favorites_api["Favorites API"]
  node_users_api["Users API"]
end

subgraph group_security["Identity and Access"]
  node_auth_api["Auth API"]
  node_security_layer["JWT Security<br/>[JwtService.java]"]
end

subgraph group_persistence["Persistence"]
  node_user_store[("User Store")]
  node_product_store[("Product Store")]
  node_cart_store[("Cart Store")]
  node_order_store[("Order Store")]
  node_favorites_store[("Favorites Store")]
end

node_shopper(("Shopper"))
node_admin(("Admin"))
node_mysql[("MySQL")]

node_shopper -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes to"| node_catalog_ui
node_app -->|"routes to"| node_cart_ui
node_app -->|"routes to"| node_orders_ui
node_app -->|"routes to"| node_favorites_ui
node_app -->|"routes to"| node_account_ui
node_app -->|"routes to"| node_admin_ui
node_auth_state -->|"calls"| node_api_client
node_cart_state -->|"calls"| node_api_client
node_favorites_state -->|"calls"| node_api_client
node_api_client -.->|"sends requests"| node_auth_api
node_api_client -.->|"sends requests"| node_catalog_api
node_api_client -.->|"sends requests"| node_cart_api
node_api_client -.->|"sends requests"| node_orders_api
node_api_client -.->|"sends requests"| node_favorites_api
node_api_client -.->|"sends requests"| node_users_api
node_auth_api -->|"reads and writes"| node_user_store
node_auth_api -->|"issues tokens"| node_security_layer
node_catalog_api -->|"queries catalog"| node_product_store
node_cart_api -->|"reads and writes"| node_cart_store
node_cart_api -->|"loads user"| node_user_store
node_cart_api -->|"loads products"| node_product_store
node_orders_api -->|"loads and clears cart"| node_cart_store
node_orders_api -->|"loads user"| node_user_store
node_orders_api -->|"saves and reads orders"| node_order_store
node_favorites_api -->|"manages favorites"| node_favorites_store
node_favorites_api -->|"loads products"| node_product_store
node_favorites_api -->|"loads user"| node_user_store
node_users_api -->|"reads and updates"| node_user_store
node_user_store -.->|"persists users"| node_mysql
node_product_store -.->|"persists products"| node_mysql
node_cart_store -.->|"persists carts"| node_mysql
node_order_store -.->|"persists orders"| node_mysql
node_favorites_store -.->|"persists favorites"| node_mysql

click node_app "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/App.jsx"
click node_catalog_ui "https://github.com/medali-chihi/nekovault/tree/main/frontend/src/pages"
click node_cart_ui "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/CheckoutPage.jsx"
click node_orders_ui "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/OrdersPage.jsx"
click node_favorites_ui "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/FavoritesPage.jsx"
click node_account_ui "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/ProfilePage.jsx"
click node_admin_ui "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/AdminProducts.jsx"
click node_auth_state "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/context/AuthContext.jsx"
click node_cart_state "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/context/CartContext.jsx"
click node_favorites_state "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/context/FavoritesContext.jsx"
click node_api_client "https://github.com/medali-chihi/nekovault/blob/main/frontend/src/api/client.js"
click node_auth_api "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/AuthController.java"
click node_catalog_api "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/ProductController.java"
click node_cart_api "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/CartController.java"
click node_orders_api "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/OrderController.java"
click node_favorites_api "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/FavoriteController.java"
click node_users_api "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/UserController.java"
click node_security_layer "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/security/JwtService.java"
click node_user_store "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/UserRepository.java"
click node_product_store "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/ProductRepository.java"
click node_cart_store "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/CartRepository.java"
click node_order_store "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/OrderRepository.java"
click node_favorites_store "https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/FavoriteRepository.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_catalog_ui,node_cart_ui,node_orders_ui,node_favorites_ui,node_account_ui,node_admin_ui,node_auth_state,node_cart_state,node_favorites_state,node_api_client toneBlue
class node_catalog_api,node_cart_api,node_orders_api,node_favorites_api,node_users_api,node_mysql toneAmber
class node_auth_api,node_security_layer toneMint
class node_user_store,node_product_store,node_cart_store,node_order_store,node_favorites_store toneRose
class node_shopper,node_admin toneIndigo
```

## Components

### Storefront

- [App Router](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Catalog Pages](https://github.com/medali-chihi/nekovault/tree/main/frontend/src/pages): `frontend/src/pages`
- [Cart and Checkout](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/CheckoutPage.jsx): `frontend/src/pages/CheckoutPage.jsx`
- [Order Pages](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/OrdersPage.jsx): `frontend/src/pages/OrdersPage.jsx`
- [Favorites Pages](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/FavoritesPage.jsx): `frontend/src/pages/FavoritesPage.jsx`
- [Account Pages](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/ProfilePage.jsx): `frontend/src/pages/ProfilePage.jsx`
- [Admin Pages](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/pages/AdminProducts.jsx): `frontend/src/pages/AdminProducts.jsx`
- [Auth State](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Cart State](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/context/CartContext.jsx): `frontend/src/context/CartContext.jsx`
- [Favorites State](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/context/FavoritesContext.jsx): `frontend/src/context/FavoritesContext.jsx`
- [API Client](https://github.com/medali-chihi/nekovault/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Commerce API

- [Catalog API](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/ProductController.java): `backend/src/main/java/com/ecommerce/controller/ProductController.java`
- [Cart API](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/CartController.java): `backend/src/main/java/com/ecommerce/controller/CartController.java`
- [Orders API](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/OrderController.java): `backend/src/main/java/com/ecommerce/controller/OrderController.java`
- [Favorites API](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/FavoriteController.java): `backend/src/main/java/com/ecommerce/controller/FavoriteController.java`
- [Users API](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/UserController.java): `backend/src/main/java/com/ecommerce/controller/UserController.java`

### Identity and Access

- [Auth API](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/controller/AuthController.java): `backend/src/main/java/com/ecommerce/controller/AuthController.java`
- [JWT Security](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/security/JwtService.java): `backend/src/main/java/com/ecommerce/security/JwtService.java`

### Persistence

- [User Store](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/UserRepository.java): `backend/src/main/java/com/ecommerce/repository/UserRepository.java`
- [Product Store](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/ProductRepository.java): `backend/src/main/java/com/ecommerce/repository/ProductRepository.java`
- [Cart Store](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/CartRepository.java): `backend/src/main/java/com/ecommerce/repository/CartRepository.java`
- [Order Store](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/OrderRepository.java): `backend/src/main/java/com/ecommerce/repository/OrderRepository.java`
- [Favorites Store](https://github.com/medali-chihi/nekovault/blob/main/backend/src/main/java/com/ecommerce/repository/FavoriteRepository.java): `backend/src/main/java/com/ecommerce/repository/FavoriteRepository.java`

### Other components

- **Shopper**
- **Admin**
- **MySQL**

## Connections

- Shopper → App Router: uses
- Admin → App Router: uses
- App Router → Catalog Pages: routes to (evidence: `frontend/src/App.jsx`)
- App Router → Cart and Checkout: routes to (evidence: `frontend/src/App.jsx`)
- App Router → Order Pages: routes to (evidence: `frontend/src/App.jsx`)
- App Router → Favorites Pages: routes to (evidence: `frontend/src/App.jsx`)
- App Router → Account Pages: routes to (evidence: `frontend/src/App.jsx`)
- App Router → Admin Pages: routes to (evidence: `frontend/src/App.jsx`)
- Auth State → API Client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Cart State → API Client: calls (evidence: `frontend/src/context/CartContext.jsx`)
- Favorites State → API Client: calls (evidence: `frontend/src/context/FavoritesContext.jsx`)
- API Client → Auth API: sends requests
- API Client → Catalog API: sends requests
- API Client → Cart API: sends requests
- API Client → Orders API: sends requests
- API Client → Favorites API: sends requests
- API Client → Users API: sends requests
- Auth API → User Store: reads and writes (evidence: `backend/src/main/java/com/ecommerce/controller/AuthController.java`)
- Auth API → JWT Security: issues tokens (evidence: `backend/src/main/java/com/ecommerce/controller/AuthController.java`)
- Catalog API → Product Store: queries catalog (evidence: `backend/src/main/java/com/ecommerce/controller/ProductController.java`)
- Cart API → Cart Store: reads and writes (evidence: `backend/src/main/java/com/ecommerce/controller/CartController.java`)
- Cart API → User Store: loads user (evidence: `backend/src/main/java/com/ecommerce/controller/CartController.java`)
- Cart API → Product Store: loads products (evidence: `backend/src/main/java/com/ecommerce/controller/CartController.java`)
- Orders API → Cart Store: loads and clears cart (evidence: `backend/src/main/java/com/ecommerce/controller/OrderController.java`)
- Orders API → User Store: loads user (evidence: `backend/src/main/java/com/ecommerce/controller/OrderController.java`)
- Orders API → Order Store: saves and reads orders (evidence: `backend/src/main/java/com/ecommerce/controller/OrderController.java`)
- Favorites API → Favorites Store: manages favorites (evidence: `backend/src/main/java/com/ecommerce/controller/FavoriteController.java`)
- Favorites API → Product Store: loads products (evidence: `backend/src/main/java/com/ecommerce/controller/FavoriteController.java`)
- Favorites API → User Store: loads user (evidence: `backend/src/main/java/com/ecommerce/controller/FavoriteController.java`)
- Users API → User Store: reads and updates (evidence: `backend/src/main/java/com/ecommerce/controller/UserController.java`)
- User Store → MySQL: persists users
- Product Store → MySQL: persists products
- Cart Store → MySQL: persists carts
- Order Store → MySQL: persists orders
- Favorites Store → MySQL: persists favorites
