How nemona1/mikias-building-materials works
Mikias Building Materials is a role-based building-supplies catalog and business-management application. The customer workflow is to browse products, request and track quotes, while staff and managers process quotes and administer products and customers; administrators manage users, permissions, settings, and audit activity. Authentication and security span that workflow, with JWT sessions, optional 2FA, and security logging. The graph combines sampled call evidence and documented capabilities; several business API paths and integrations are unsampled, so their links are left unverified or omitted.
Main entry points: login/route.js Auth Endpoints · users/route.js User Administration · notification-service.js Email & Telegram · jwt.js JWT Sessions
Components 27
Customer Experience
- Product Catalog
app/products/page.jsx - Product Details
components/products/ProductDetailModal.jsx - Quote Request
components/products/QuoteRequestModal.jsx - Customer Quotes
app/customer/my-quotes/page.jsx
Business Operations
- Quote Operations
app/admin/quotes/page.jsx - Product Management
app/api/admin/products/route.js - Customer Management
app/api/customers/route.js - Reports & Analytics
app/api/admin/reports/route.js
Identity & Security
- Login
app/login/page.jsx - Client Auth
hooks/useAuth.js - Auth Endpoints
app/api/auth/login/route.js - JWT Sessions
lib/auth/jwt.js - Permissions
lib/auth/permissions.js - Two-Factor Auth
lib/auth/2fa.js - Login Security
lib/auth/security.js - Security Audit
lib/security-log.js
Administration
- User Administration
app/api/admin/users/route.js - Role Administration
app/api/admin/roles/route.js - System Settings
app/api/admin/settings/route.js
Shared Services
- Notification Dispatch
lib/notifications/notification-dispatcher.js - Email & Telegram
lib/notifications/notification-service.js - Telegram Delivery
lib/notifications/telegram.js - Notification Logs
lib/notifications/notification-logger.js - Settings Service
lib/settings.js - PostgreSQL Access
lib/prisma.js
Other components
- Customers
- Staff & Managers
Connections 31
- Customers → Product Catalog: browse
- Product Catalog → Product Details: opens
app/products/page.jsx - Product Catalog → Quote Request: requests quote
app/products/page.jsx - Customers → Customer Quotes: track quotes
- Staff & Managers → Quote Operations: process quotes
- Staff & Managers → Product Management: manage products
- Staff & Managers → Customer Management: manage customers
- Staff & Managers → Reports & Analytics: view analytics
- Customers → Login: sign in
- Login → Auth Endpoints: authenticates
- Client Auth → Auth Endpoints: checks identity
hooks/useAuth.js - Auth Endpoints → JWT Sessions: verifies tokens
app/api/auth/login/route.js - Auth Endpoints → Login Security: checks attempts
app/api/auth/login/route.js - Auth Endpoints → Settings Service: reads settings
app/api/auth/login/route.js - Auth Endpoints → Two-Factor Auth: checks 2FA
app/api/auth/login/route.js - Auth Endpoints → Security Audit: records events
app/api/auth/login/route.js - JWT Sessions → PostgreSQL Access: reads users
lib/auth/jwt.js - Permissions → PostgreSQL Access: reads permissions
lib/auth/permissions.js - Security Audit → PostgreSQL Access: writes audit records
lib/security-log.js - User Administration → JWT Sessions: verifies tokens
app/api/admin/users/route.js - User Administration → Permissions: checks access
app/api/admin/users/route.js - User Administration → Security Audit: records events
app/api/admin/users/route.js - User Administration → Notification Dispatch: notifies users
app/api/admin/users/route.js - Notification Dispatch → Email & Telegram: dispatches
lib/notifications/notification-dispatcher.js - Email & Telegram → Telegram Delivery: sends Telegram
lib/notifications/notification-service.js - Email & Telegram → Notification Logs: logs delivery
lib/notifications/notification-service.js - Email & Telegram → Settings Service: reads settings
lib/notifications/notification-service.js - Settings Service → PostgreSQL Access: reads and writes
lib/settings.js - Role Administration → JWT Sessions: verifies tokens
app/api/admin/roles/route.js - Role Administration → Permissions: checks access
app/api/admin/roles/route.js - Role Administration → Security Audit: records events
app/api/admin/roles/route.js