# nemona1/mikias-building-materials architecture

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

- Interactive diagram: https://gitdiagram.com/nemona1/mikias-building-materials
- Repository: https://github.com/nemona1/mikias-building-materials

## Overview

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: [`app/api/auth/login/route.js`](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/auth/login/route.js) (Auth Endpoints), [`app/api/admin/users/route.js`](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/users/route.js) (User Administration), [`lib/notifications/notification-service.js`](https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/notification-service.js) (Email & Telegram), [`lib/auth/jwt.js`](https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/jwt.js) (JWT Sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Customer Experience"]
  node_catalog["Product Catalog<br/>[page.jsx]"]
  node_product_detail["Product Details"]
  node_quote_request["Quote Request"]
  node_customer_quotes["Customer Quotes<br/>[page.jsx]"]
end

subgraph group_operations["Business Operations"]
  node_quote_operations["Quote Operations<br/>[page.jsx]"]
  node_product_management["Product Management<br/>[route.js]"]
  node_customer_management["Customer Management<br/>[route.js]"]
  node_reports["Reports &amp; Analytics<br/>[route.js]"]
end

subgraph group_identity["Identity &amp; Security"]
  node_login["Login<br/>[page.jsx]"]
  node_auth_context["Client Auth<br/>[useAuth.js]"]
  node_auth_api["Auth Endpoints<br/>[route.js]"]
  node_jwt["JWT Sessions<br/>[jwt.js]"]
  node_authorization["Permissions<br/>[permissions.js]"]
  node_two_factor["Two-Factor Auth<br/>[2fa.js]"]
  node_security["Login Security<br/>[security.js]"]
  node_security_logs["Security Audit<br/>[security-log.js]"]
end

subgraph group_administration["Administration"]
  node_admin_users["User Administration<br/>[route.js]"]
  node_admin_roles["Role Administration<br/>[route.js]"]
  node_admin_settings["System Settings<br/>[route.js]"]
end

subgraph group_platform["Shared Services"]
  node_notifications["Notification Dispatch"]
  node_notification_service["Email &amp; Telegram"]
  node_telegram["Telegram Delivery<br/>[telegram.js]"]
  node_notification_logs["Notification Logs"]
  node_settings["Settings Service<br/>[settings.js]"]
  node_database[("PostgreSQL Access<br/>[prisma.js]")]
end

node_customers(("Customers"))
node_operations_roles(("Staff &amp; Managers"))

node_customers -->|"browse"| node_catalog
node_catalog -->|"opens"| node_product_detail
node_catalog -->|"requests quote"| node_quote_request
node_customers -->|"track quotes"| node_customer_quotes
node_operations_roles -->|"process quotes"| node_quote_operations
node_operations_roles -->|"manage products"| node_product_management
node_operations_roles -->|"manage customers"| node_customer_management
node_operations_roles -->|"view analytics"| node_reports
node_customers -->|"sign in"| node_login
node_login -.->|"authenticates"| node_auth_api
node_auth_context -->|"checks identity"| node_auth_api
node_auth_api -->|"verifies tokens"| node_jwt
node_auth_api -->|"checks attempts"| node_security
node_auth_api -->|"reads settings"| node_settings
node_auth_api -->|"checks 2FA"| node_two_factor
node_auth_api -->|"records events"| node_security_logs
node_jwt -->|"reads users"| node_database
node_authorization -->|"reads permissions"| node_database
node_security_logs -->|"writes audit records"| node_database
node_admin_users -->|"verifies tokens"| node_jwt
node_admin_users -->|"checks access"| node_authorization
node_admin_users -->|"records events"| node_security_logs
node_admin_users -->|"notifies users"| node_notifications
node_notifications -->|"dispatches"| node_notification_service
node_notification_service -->|"sends Telegram"| node_telegram
node_notification_service -->|"logs delivery"| node_notification_logs
node_notification_service -->|"reads settings"| node_settings
node_settings -->|"reads and writes"| node_database
node_admin_roles -->|"verifies tokens"| node_jwt
node_admin_roles -->|"checks access"| node_authorization
node_admin_roles -->|"records events"| node_security_logs

click node_catalog "https://github.com/nemona1/mikias-building-materials/blob/main/app/products/page.jsx"
click node_product_detail "https://github.com/nemona1/mikias-building-materials/blob/main/components/products/ProductDetailModal.jsx"
click node_quote_request "https://github.com/nemona1/mikias-building-materials/blob/main/components/products/QuoteRequestModal.jsx"
click node_customer_quotes "https://github.com/nemona1/mikias-building-materials/blob/main/app/customer/my-quotes/page.jsx"
click node_quote_operations "https://github.com/nemona1/mikias-building-materials/blob/main/app/admin/quotes/page.jsx"
click node_product_management "https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/products/route.js"
click node_customer_management "https://github.com/nemona1/mikias-building-materials/blob/main/app/api/customers/route.js"
click node_reports "https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/reports/route.js"
click node_login "https://github.com/nemona1/mikias-building-materials/blob/main/app/login/page.jsx"
click node_auth_context "https://github.com/nemona1/mikias-building-materials/blob/main/hooks/useAuth.js"
click node_auth_api "https://github.com/nemona1/mikias-building-materials/blob/main/app/api/auth/login/route.js"
click node_jwt "https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/jwt.js"
click node_authorization "https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/permissions.js"
click node_two_factor "https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/2fa.js"
click node_security "https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/security.js"
click node_security_logs "https://github.com/nemona1/mikias-building-materials/blob/main/lib/security-log.js"
click node_admin_users "https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/users/route.js"
click node_admin_roles "https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/roles/route.js"
click node_admin_settings "https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/settings/route.js"
click node_notifications "https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/notification-dispatcher.js"
click node_notification_service "https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/notification-service.js"
click node_telegram "https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/telegram.js"
click node_notification_logs "https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/notification-logger.js"
click node_settings "https://github.com/nemona1/mikias-building-materials/blob/main/lib/settings.js"
click node_database "https://github.com/nemona1/mikias-building-materials/blob/main/lib/prisma.js"

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_catalog,node_product_detail,node_quote_request,node_customer_quotes toneBlue
class node_quote_operations,node_product_management,node_customer_management,node_reports toneAmber
class node_login,node_auth_context,node_auth_api,node_jwt,node_authorization,node_two_factor,node_security,node_security_logs toneMint
class node_admin_users,node_admin_roles,node_admin_settings toneRose
class node_notifications,node_notification_service,node_telegram,node_notification_logs,node_settings,node_database,node_customers,node_operations_roles toneIndigo
```

## Components

### Customer Experience

- [Product Catalog](https://github.com/nemona1/mikias-building-materials/blob/main/app/products/page.jsx): `app/products/page.jsx`
- [Product Details](https://github.com/nemona1/mikias-building-materials/blob/main/components/products/ProductDetailModal.jsx): `components/products/ProductDetailModal.jsx`
- [Quote Request](https://github.com/nemona1/mikias-building-materials/blob/main/components/products/QuoteRequestModal.jsx): `components/products/QuoteRequestModal.jsx`
- [Customer Quotes](https://github.com/nemona1/mikias-building-materials/blob/main/app/customer/my-quotes/page.jsx): `app/customer/my-quotes/page.jsx`

### Business Operations

- [Quote Operations](https://github.com/nemona1/mikias-building-materials/blob/main/app/admin/quotes/page.jsx): `app/admin/quotes/page.jsx`
- [Product Management](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/products/route.js): `app/api/admin/products/route.js`
- [Customer Management](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/customers/route.js): `app/api/customers/route.js`
- [Reports & Analytics](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/reports/route.js): `app/api/admin/reports/route.js`

### Identity & Security

- [Login](https://github.com/nemona1/mikias-building-materials/blob/main/app/login/page.jsx): `app/login/page.jsx`
- [Client Auth](https://github.com/nemona1/mikias-building-materials/blob/main/hooks/useAuth.js): `hooks/useAuth.js`
- [Auth Endpoints](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/auth/login/route.js): `app/api/auth/login/route.js`
- [JWT Sessions](https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/jwt.js): `lib/auth/jwt.js`
- [Permissions](https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/permissions.js): `lib/auth/permissions.js`
- [Two-Factor Auth](https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/2fa.js): `lib/auth/2fa.js`
- [Login Security](https://github.com/nemona1/mikias-building-materials/blob/main/lib/auth/security.js): `lib/auth/security.js`
- [Security Audit](https://github.com/nemona1/mikias-building-materials/blob/main/lib/security-log.js): `lib/security-log.js`

### Administration

- [User Administration](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/users/route.js): `app/api/admin/users/route.js`
- [Role Administration](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/roles/route.js): `app/api/admin/roles/route.js`
- [System Settings](https://github.com/nemona1/mikias-building-materials/blob/main/app/api/admin/settings/route.js): `app/api/admin/settings/route.js`

### Shared Services

- [Notification Dispatch](https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/notification-dispatcher.js): `lib/notifications/notification-dispatcher.js`
- [Email & Telegram](https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/notification-service.js): `lib/notifications/notification-service.js`
- [Telegram Delivery](https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/telegram.js): `lib/notifications/telegram.js`
- [Notification Logs](https://github.com/nemona1/mikias-building-materials/blob/main/lib/notifications/notification-logger.js): `lib/notifications/notification-logger.js`
- [Settings Service](https://github.com/nemona1/mikias-building-materials/blob/main/lib/settings.js): `lib/settings.js`
- [PostgreSQL Access](https://github.com/nemona1/mikias-building-materials/blob/main/lib/prisma.js): `lib/prisma.js`

### Other components

- **Customers**
- **Staff & Managers**

## Connections

- Customers → Product Catalog: browse
- Product Catalog → Product Details: opens (evidence: `app/products/page.jsx`)
- Product Catalog → Quote Request: requests quote (evidence: `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 (evidence: `hooks/useAuth.js`)
- Auth Endpoints → JWT Sessions: verifies tokens (evidence: `app/api/auth/login/route.js`)
- Auth Endpoints → Login Security: checks attempts (evidence: `app/api/auth/login/route.js`)
- Auth Endpoints → Settings Service: reads settings (evidence: `app/api/auth/login/route.js`)
- Auth Endpoints → Two-Factor Auth: checks 2FA (evidence: `app/api/auth/login/route.js`)
- Auth Endpoints → Security Audit: records events (evidence: `app/api/auth/login/route.js`)
- JWT Sessions → PostgreSQL Access: reads users (evidence: `lib/auth/jwt.js`)
- Permissions → PostgreSQL Access: reads permissions (evidence: `lib/auth/permissions.js`)
- Security Audit → PostgreSQL Access: writes audit records (evidence: `lib/security-log.js`)
- User Administration → JWT Sessions: verifies tokens (evidence: `app/api/admin/users/route.js`)
- User Administration → Permissions: checks access (evidence: `app/api/admin/users/route.js`)
- User Administration → Security Audit: records events (evidence: `app/api/admin/users/route.js`)
- User Administration → Notification Dispatch: notifies users (evidence: `app/api/admin/users/route.js`)
- Notification Dispatch → Email & Telegram: dispatches (evidence: `lib/notifications/notification-dispatcher.js`)
- Email & Telegram → Telegram Delivery: sends Telegram (evidence: `lib/notifications/notification-service.js`)
- Email & Telegram → Notification Logs: logs delivery (evidence: `lib/notifications/notification-service.js`)
- Email & Telegram → Settings Service: reads settings (evidence: `lib/notifications/notification-service.js`)
- Settings Service → PostgreSQL Access: reads and writes (evidence: `lib/settings.js`)
- Role Administration → JWT Sessions: verifies tokens (evidence: `app/api/admin/roles/route.js`)
- Role Administration → Permissions: checks access (evidence: `app/api/admin/roles/route.js`)
- Role Administration → Security Audit: records events (evidence: `app/api/admin/roles/route.js`)
