BodegaX is a full-stack web application purpose-built for beer warehouse distributors. It replaces error-prone manual processes — spreadsheets, paper logs, and phone-based order coordination — with a centralized platform that gives both warehouse administrators and client users a real-time, role-appropriate view of every crate, sale, and transaction moving through the operation. Built on Angular 17, Spring Boot, and PostgreSQL, BodegaX is designed to be deployed on-premises or in the cloud, and is ready for production use today.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Edwin950821/BodegaX/llms.txt
Use this file to discover all available pages before exploring further.
User Roles
BodegaX enforces a two-role access model that controls which features and data each user can see and act on.Admin
Administrators own the full operational surface of the warehouse. They dispatch crate sales (Despachar Caja), manage and view the complete inventory (Mi Bodega), review all transactions across every user, approve or reject incoming orders (Pedidos), manage user accounts in Settings, and generate the end-of-day PDF summary report (Terminar Jornada) to close out each working shift.
User / Client
Client users interact with the warehouse on the request side. They submit crate requests (Solicitar Caja), monitor the live status of their open orders in Pedidos, and review their own personal sales and transaction history in Historial. Clients never see other users’ data or warehouse-level inventory figures.
Key Modules
BodegaX is organized into six functional modules, each serving a distinct stage of the warehouse workflow.Sales Dispatch — Despachar Caja
Sales Dispatch — Despachar Caja
The core transaction module for administrators. When a client order is approved, the admin dispatches crates directly from this view, which decrements stock in real time and records the sale against the session’s transaction log.
Inventory Management — Mi Bodega
Inventory Management — Mi Bodega
Provides admins with a live count of every beer brand and SKU held in the warehouse. Stock levels update automatically as dispatches are confirmed and new inventory entries are recorded.
Order Tracking — Pedidos
Order Tracking — Pedidos
A shared module visible to both roles. Clients see their own pending and fulfilled orders; admins see all open orders across the user base and can approve or process them from this view.
Transaction History — Historial
Transaction History — Historial
A read-only audit trail of completed sales. Admins can view the full history across all users; clients are scoped to their own records only. Each entry shows beer brand, quantity dispatched, and sale total.
End-of-Day Report — Terminar Jornada
End-of-Day Report — Terminar Jornada
An admin-only action that aggregates the current day’s dispatches and generates a downloadable PDF summary report using jsPDF. Running this report marks the workday as closed and resets the session’s daily counters.
User Settings
User Settings
Accessible only to administrators. This module supports creating new user accounts, editing existing user details, and removing users from the system. Role assignment is handled here.
Technology Stack
BodegaX is built on a conventional three-tier architecture with well-supported, production-grade technologies at each layer.| Layer | Technology | Version |
|---|---|---|
| Frontend | Angular | 17.x |
| UI Component Library | Angular Material + CDK | 17.3.x |
| PDF Generation | jsPDF + jsPDF-AutoTable | 2.5.x / 3.8.x |
| Backend API | Spring Boot | 3.x (Java 17+) |
| Database | PostgreSQL | 14+ |
| Authentication | Session object in sessionStorage | — |
| Reactive State | RxJS BehaviorSubject | 7.8.x |
The authenticated user’s session data is stored in the browser’s
sessionStorage under the key bodegax as a plain JSON object — no JWT bearer tokens are issued or stored by the Angular frontend. The session is automatically cleared when the browser tab is closed, providing an additional layer of protection for shared workstations common in warehouse environments.Explore the Documentation
Quickstart
Stand up the Angular frontend and Spring Boot backend in minutes with step-by-step setup instructions.
Architecture
Understand the three-tier data flow, routing strategy, route guards, and reactive auth state management.
Sales Dispatch
Learn how administrators dispatch crate orders and how stock levels are updated in real time.
Inventory Management
Explore the Mi Bodega module — how stock is recorded, displayed, and reconciled across shifts.
Order Tracking
Follow an order from client request through admin approval to final dispatch confirmation.
Transaction History
Understand the Historial module, its role-scoped data access, and how records are structured.