How gegs-12358/ferreteria works
FERREMAS is a multi-service hardware e-commerce platform. The main user journey runs from the Django web interface through catalog browsing and cart/checkout to order and payment services; authentication and role-based operations support the customer and staff workflows. The README documents additional capabilities including stock reduction, Stripe and bank-transfer payments, currency conversion, user administration, and role-specific order states. Source excerpts confirm several service-layer calls; cross-service links and unsampled feature links are based on README documentation.
Main entry points: ferremas_app/views.py Web application · AuthController.java Auth API · pedidos/views.py Order API · pagos_app/views.py Payment processing
Components 19
Web experience
- Web application
fronted/ferremas_app/views.py - Cart and checkout
fronted/ferremas_app/static/js/carrito.js - Catalog interface
fronted/ferremas_app/static/js/productos.js - User administration
fronted/ferremas_app/static/js/crud_usuarios.js - Currency conversion
fronted/ferremas_app/static/js/moneda.js
Identity and access
- Auth API
auth/src/main/java/com/ferremas/auth/controller/AuthController.java - User service
auth/src/main/java/com/ferremas/auth/service/UsuarioService.java - Users and roles
auth/src/main/java/com/ferremas/auth/model/Usuario.java - JWT security
auth/src/main/java/com/ferremas/auth/security/JwtUtil.java
Product catalog
- Product API
productos/src/main/java/com/ferremas/productos/controller/ProductoController.java - Product catalog store
productos/src/main/java/com/ferremas/productos/model/Producto.java
Order operations
- Order API
pedidos_ms/pedidos/views.py - Order records
pedidos_ms/pedidos/models.py - Order serialization
pedidos_ms/pedidos/serializers.py
Payments and currency
- Payment processing
pagos/pagos_app/views.py - Payment records
pagos/pagos_app/models.py
Other components
- Shopper and staff
- Stripe Checkout
- Central Bank currency API
Connections 20
- Shopper and staff → Web application: uses
- Web application → Auth API: consumes auth
- Web application → Product API: consumes catalog
- Web application → Order API: consumes orders
- Web application → Payment processing: consumes payments
- Cart and checkout → Web application: supports checkout
- Catalog interface → Web application: supports browsing
- User administration → Web application: supports administration
- Currency conversion → Central Bank currency API: fetches rates
- Auth API → User service: registers and authenticates
auth/src/main/java/com/ferremas/auth/controller/AuthController.java - Auth API → JWT security: creates and validates
auth/src/main/java/com/ferremas/auth/controller/AuthController.java - Auth API → Users and roles: reads and updates
auth/src/main/java/com/ferremas/auth/controller/AuthController.java - User service → Users and roles: persists users
auth/src/main/java/com/ferremas/auth/service/UsuarioService.java - Product API → Product catalog store: reads and writes
productos/src/main/java/com/ferremas/productos/controller/ProductoController.java - Order API → Order serialization: serializes orders
pedidos_ms/pedidos/views.py - Order API → Order records: reads and updates
pedidos_ms/pedidos/views.py - Order serialization → Order records: serializes records
pedidos_ms/pedidos/serializers.py - Payment processing → Payment records: records payments
pagos/pagos_app/views.py - Payment processing → Stripe Checkout: offers card checkout
- Order API → Product API: reduces stock