How medali-chihi/nekovault works
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: client.js API Client · App.jsx App Router · UserRepository.java User Store · CartController.java Cart API
Components 26
Storefront
- App Router
frontend/src/App.jsx - Catalog Pages
frontend/src/pages - Cart and Checkout
frontend/src/pages/CheckoutPage.jsx - Order Pages
frontend/src/pages/OrdersPage.jsx - Favorites Pages
frontend/src/pages/FavoritesPage.jsx - Account Pages
frontend/src/pages/ProfilePage.jsx - Admin Pages
frontend/src/pages/AdminProducts.jsx - Auth State
frontend/src/context/AuthContext.jsx - Cart State
frontend/src/context/CartContext.jsx - Favorites State
frontend/src/context/FavoritesContext.jsx - API Client
frontend/src/api/client.js
Commerce API
- Catalog API
backend/src/main/java/com/ecommerce/controller/ProductController.java - Cart API
backend/src/main/java/com/ecommerce/controller/CartController.java - Orders API
backend/src/main/java/com/ecommerce/controller/OrderController.java - Favorites API
backend/src/main/java/com/ecommerce/controller/FavoriteController.java - Users API
backend/src/main/java/com/ecommerce/controller/UserController.java
Identity and Access
- Auth API
backend/src/main/java/com/ecommerce/controller/AuthController.java - JWT Security
backend/src/main/java/com/ecommerce/security/JwtService.java
Persistence
- User Store
backend/src/main/java/com/ecommerce/repository/UserRepository.java - Product Store
backend/src/main/java/com/ecommerce/repository/ProductRepository.java - Cart Store
backend/src/main/java/com/ecommerce/repository/CartRepository.java - Order Store
backend/src/main/java/com/ecommerce/repository/OrderRepository.java - Favorites Store
backend/src/main/java/com/ecommerce/repository/FavoriteRepository.java
Other components
- Shopper
- Admin
- MySQL
Connections 35
- Shopper → App Router: uses
- Admin → App Router: uses
- App Router → Catalog Pages: routes to
frontend/src/App.jsx - App Router → Cart and Checkout: routes to
frontend/src/App.jsx - App Router → Order Pages: routes to
frontend/src/App.jsx - App Router → Favorites Pages: routes to
frontend/src/App.jsx - App Router → Account Pages: routes to
frontend/src/App.jsx - App Router → Admin Pages: routes to
frontend/src/App.jsx - Auth State → API Client: calls
frontend/src/context/AuthContext.jsx - Cart State → API Client: calls
frontend/src/context/CartContext.jsx - Favorites State → API Client: calls
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
backend/src/main/java/com/ecommerce/controller/AuthController.java - Auth API → JWT Security: issues tokens
backend/src/main/java/com/ecommerce/controller/AuthController.java - Catalog API → Product Store: queries catalog
backend/src/main/java/com/ecommerce/controller/ProductController.java - Cart API → Cart Store: reads and writes
backend/src/main/java/com/ecommerce/controller/CartController.java - Cart API → User Store: loads user
backend/src/main/java/com/ecommerce/controller/CartController.java - Cart API → Product Store: loads products
backend/src/main/java/com/ecommerce/controller/CartController.java - Orders API → Cart Store: loads and clears cart
backend/src/main/java/com/ecommerce/controller/OrderController.java - Orders API → User Store: loads user
backend/src/main/java/com/ecommerce/controller/OrderController.java - Orders API → Order Store: saves and reads orders
backend/src/main/java/com/ecommerce/controller/OrderController.java - Favorites API → Favorites Store: manages favorites
backend/src/main/java/com/ecommerce/controller/FavoriteController.java - Favorites API → Product Store: loads products
backend/src/main/java/com/ecommerce/controller/FavoriteController.java - Favorites API → User Store: loads user
backend/src/main/java/com/ecommerce/controller/FavoriteController.java - Users API → User Store: reads and updates
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