# rnldlcn/francos-perfume-frontend architecture

> Architecture diagram of the GitHub repository rnldlcn/francos-perfume-frontend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rnldlcn/francos-perfume-frontend
- Repository: https://github.com/rnldlcn/francos-perfume-frontend

## Overview

This is a React frontend for perfume-shop operations, with role-aware login and a dashboard plus a cashier point of sale. The main user flow is login, route to an authorized workspace, then use feature pages to manage sales or operational records. Requests and deliveries have distinct create, review, dispatch, and confirmation stages; POS has product selection, cart, discount, and payment stages. Feature hooks and services form the internal data-access layer. Connections are limited to routes and imports visible in the supplied excerpts or SOURCE INDEX; other feature branches are shown without speculative wiring.

Main entry points: [`src/App.jsx`](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/App.jsx) (Route and role gate), [`src/pages/PointOfSalePage.jsx`](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/PointOfSalePage.jsx) (POS workspace), [`src/hooks/request_hooks/useRequest.js`](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/request_hooks/useRequest.js) (Request state), [`src/hooks/delivery_hooks/useDelivery.js`](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/delivery_hooks/useDelivery.js) (Delivery state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and access"]
  node_app["Route and role gate<br/>[App.jsx]"]
  node_login["Login page<br/>[LoginPage.jsx]"]
  node_loginhook["Login flow<br/>[useLogin.js]"]
  node_auth["Auth context<br/>[AuthProvider.jsx]"]
  node_dashboard["Dashboard shell"]
end

subgraph group_sales["Point of sale"]
  node_pospage["POS workspace"]
  node_cart["Cart state<br/>[useCart.js]"]
  node_checkout["Checkout state<br/>[useCheckout.js]"]
  node_posdata["POS product data<br/>[usePointOfSale.js]"]
  node_posui["POS dialogs and controls"]
end

subgraph group_operations["Branch operations"]
  node_requests["Transfer requests"]
  node_requesthook["Request state<br/>[useRequest.js]"]
  node_deliveries["Delivery review and receipt"]
  node_deliveryhook["Delivery state<br/>[useDelivery.js]"]
  node_accounts["Account management"]
  node_inventory["Inventory management<br/>[InventoryPage.jsx]"]
  node_products["Product catalog<br/>[ProductsPage.jsx]"]
  node_discounts["Discount management<br/>[DiscountPage.jsx]"]
  node_archives["Archives<br/>[ArchivesPage.jsx]"]
  node_audit["Audit logs<br/>[AuditLogPage.jsx]"]
  node_forecast["Forecasting<br/>[ForecastPage.jsx]"]
  node_transactions["Transactions and reports"]
  node_barcode["Barcode tools<br/>[BarcodePage.jsx]"]
  node_barcodehook["Barcode workflow<br/>[useBarcode.js]"]
end

subgraph group_data["Feature data access"]
  node_requestservice["Request API service<br/>[RequestService.js]"]
  node_deliveryservice["Delivery API service<br/>[DeliveryService.js]"]
  node_barcodeservice["Barcode service<br/>[BarcodeService.js]"]
  node_apiclient["HTTP client<br/>[apiClient.js]"]
  node_filter["Filter state<br/>[useFilter.js]"]
  node_formatting["Formatting helpers"]
end

node_user(("Staff user"))

node_user -->|"opens app"| node_app
node_app -->|"routes to"| node_login
node_login -->|"uses"| node_loginhook
node_loginhook -->|"sets session"| node_auth
node_app -->|"checks roles"| node_auth
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_pospage
node_pospage -->|"renders"| node_posui
node_pospage -->|"uses"| node_cart
node_pospage -->|"uses"| node_checkout
node_pospage -->|"loads products"| node_posdata
node_app -->|"routes to"| node_requests
node_requests -->|"uses"| node_requesthook
node_requests -->|"loads details"| node_requesthook
node_requesthook -->|"fetches records"| node_requestservice
node_requesthook -->|"uses filters"| node_filter
node_requesthook -->|"builds options"| node_formatting
node_app -->|"routes to"| node_deliveries
node_deliveries -->|"loads details"| node_deliveryhook
node_deliveries -->|"confirms receipt"| node_deliveryhook
node_deliveryhook -->|"fetches records"| node_deliveryservice
node_deliveryhook -->|"uses filters"| node_filter
node_deliveryhook -->|"builds options"| node_formatting
node_barcode -->|"uses workflow"| node_barcodehook
node_barcodehook -->|"requests barcode actions"| node_barcodeservice
node_barcodeservice -->|"loads products"| node_apiclient

click node_app "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/App.jsx"
click node_login "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/LoginPage.jsx"
click node_loginhook "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/useLogin.js"
click node_auth "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/auth/AuthProvider.jsx"
click node_dashboard "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/layouts/DashboardLayout.jsx"
click node_pospage "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/PointOfSalePage.jsx"
click node_cart "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/point_of_sale_hooks/useCart.js"
click node_checkout "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/point_of_sale_hooks/useCheckout.js"
click node_posdata "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/point_of_sale_hooks/usePointOfSale.js"
click node_posui "https://github.com/rnldlcn/francos-perfume-frontend/tree/main/src/components/features/point_of_sale_components"
click node_requests "https://github.com/rnldlcn/francos-perfume-frontend/tree/main/src/components/features/request_components"
click node_requesthook "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/request_hooks/useRequest.js"
click node_requestservice "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/services/RequestService.js"
click node_deliveries "https://github.com/rnldlcn/francos-perfume-frontend/tree/main/src/components/features/delivery_components"
click node_deliveryhook "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/delivery_hooks/useDelivery.js"
click node_deliveryservice "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/services/DeliveryService.js"
click node_accounts "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/ManageAccountsPage.jsx"
click node_inventory "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/InventoryPage.jsx"
click node_products "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/ProductsPage.jsx"
click node_discounts "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/DiscountPage.jsx"
click node_archives "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/ArchivesPage.jsx"
click node_audit "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/AuditLogPage.jsx"
click node_forecast "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/ForecastPage.jsx"
click node_transactions "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/TransactionsPage.jsx"
click node_barcode "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/BarcodePage.jsx"
click node_barcodehook "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/product_hooks/useBarcode.js"
click node_barcodeservice "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/services/BarcodeService.js"
click node_apiclient "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/services/apiClient.js"
click node_filter "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/useFilter.js"
click node_formatting "https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/utils/formattingUtils.jsx"

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_app,node_login,node_loginhook,node_auth,node_dashboard,node_user toneBlue
class node_pospage,node_cart,node_checkout,node_posdata,node_posui toneAmber
class node_requests,node_requesthook,node_deliveries,node_deliveryhook,node_accounts,node_inventory,node_products,node_discounts,node_archives,node_audit,node_forecast,node_transactions,node_barcode,node_barcodehook toneMint
class node_requestservice,node_deliveryservice,node_barcodeservice,node_apiclient,node_filter,node_formatting toneRose
```

## Components

### App and access

- [Route and role gate](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/App.jsx): `src/App.jsx`
- [Login page](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/LoginPage.jsx): `src/pages/LoginPage.jsx`
- [Login flow](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/useLogin.js): `src/hooks/useLogin.js`
- [Auth context](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/auth/AuthProvider.jsx): `src/auth/AuthProvider.jsx`
- [Dashboard shell](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/layouts/DashboardLayout.jsx): `src/layouts/DashboardLayout.jsx`

### Point of sale

- [POS workspace](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/PointOfSalePage.jsx): `src/pages/PointOfSalePage.jsx`
- [Cart state](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/point_of_sale_hooks/useCart.js): `src/hooks/point_of_sale_hooks/useCart.js`
- [Checkout state](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/point_of_sale_hooks/useCheckout.js): `src/hooks/point_of_sale_hooks/useCheckout.js`
- [POS product data](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/point_of_sale_hooks/usePointOfSale.js): `src/hooks/point_of_sale_hooks/usePointOfSale.js`
- [POS dialogs and controls](https://github.com/rnldlcn/francos-perfume-frontend/tree/main/src/components/features/point_of_sale_components): `src/components/features/point_of_sale_components`

### Branch operations

- [Transfer requests](https://github.com/rnldlcn/francos-perfume-frontend/tree/main/src/components/features/request_components): `src/components/features/request_components`
- [Request state](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/request_hooks/useRequest.js): `src/hooks/request_hooks/useRequest.js`
- [Delivery review and receipt](https://github.com/rnldlcn/francos-perfume-frontend/tree/main/src/components/features/delivery_components): `src/components/features/delivery_components`
- [Delivery state](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/delivery_hooks/useDelivery.js): `src/hooks/delivery_hooks/useDelivery.js`
- [Account management](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/ManageAccountsPage.jsx): `src/pages/dashboard/ManageAccountsPage.jsx`
- [Inventory management](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/InventoryPage.jsx): `src/pages/dashboard/InventoryPage.jsx`
- [Product catalog](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/ProductsPage.jsx): `src/pages/dashboard/ProductsPage.jsx`
- [Discount management](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/DiscountPage.jsx): `src/pages/dashboard/DiscountPage.jsx`
- [Archives](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/ArchivesPage.jsx): `src/pages/dashboard/ArchivesPage.jsx`
- [Audit logs](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/AuditLogPage.jsx): `src/pages/dashboard/AuditLogPage.jsx`
- [Forecasting](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/ForecastPage.jsx): `src/pages/dashboard/ForecastPage.jsx`
- [Transactions and reports](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/TransactionsPage.jsx): `src/pages/dashboard/TransactionsPage.jsx`
- [Barcode tools](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/pages/dashboard/BarcodePage.jsx): `src/pages/dashboard/BarcodePage.jsx`
- [Barcode workflow](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/product_hooks/useBarcode.js): `src/hooks/product_hooks/useBarcode.js`

### Feature data access

- [Request API service](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/services/RequestService.js): `src/services/RequestService.js`
- [Delivery API service](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/services/DeliveryService.js): `src/services/DeliveryService.js`
- [Barcode service](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/services/BarcodeService.js): `src/services/BarcodeService.js`
- [HTTP client](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/services/apiClient.js): `src/services/apiClient.js`
- [Filter state](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/hooks/useFilter.js): `src/hooks/useFilter.js`
- [Formatting helpers](https://github.com/rnldlcn/francos-perfume-frontend/blob/main/src/utils/formattingUtils.jsx): `src/utils/formattingUtils.jsx`

### Other components

- **Staff user**

## Connections

- Staff user → Route and role gate: opens app (evidence: `src/App.jsx`)
- Route and role gate → Login page: routes to (evidence: `src/App.jsx`)
- Login page → Login flow: uses (evidence: `src/pages/LoginPage.jsx`)
- Login flow → Auth context: sets session (evidence: `src/hooks/useLogin.js`)
- Route and role gate → Auth context: checks roles (evidence: `src/App.jsx`)
- Route and role gate → Dashboard shell: routes to (evidence: `src/App.jsx`)
- Route and role gate → POS workspace: routes to (evidence: `src/App.jsx`)
- POS workspace → POS dialogs and controls: renders (evidence: `src/pages/PointOfSalePage.jsx`)
- POS workspace → Cart state: uses (evidence: `src/pages/PointOfSalePage.jsx`)
- POS workspace → Checkout state: uses (evidence: `src/pages/PointOfSalePage.jsx`)
- POS workspace → POS product data: loads products (evidence: `src/pages/PointOfSalePage.jsx`)
- Route and role gate → Transfer requests: routes to (evidence: `src/App.jsx`)
- Transfer requests → Request state: uses (evidence: `src/components/features/request_components/CreateTransferRequestPage.jsx`)
- Transfer requests → Request state: loads details (evidence: `src/components/features/request_components/RequestDetailsPage.jsx`)
- Request state → Request API service: fetches records (evidence: `src/hooks/request_hooks/useRequest.js`)
- Request state → Filter state: uses filters (evidence: `src/hooks/request_hooks/useRequest.js`)
- Request state → Formatting helpers: builds options (evidence: `src/hooks/request_hooks/useRequest.js`)
- Route and role gate → Delivery review and receipt: routes to (evidence: `src/App.jsx`)
- Delivery review and receipt → Delivery state: loads details (evidence: `src/components/features/delivery_components/DeliveryDetailsPage.jsx`)
- Delivery review and receipt → Delivery state: confirms receipt (evidence: `src/components/features/delivery_components/DeliveryConfirmationPage.jsx`)
- Delivery state → Delivery API service: fetches records (evidence: `src/hooks/delivery_hooks/useDelivery.js`)
- Delivery state → Filter state: uses filters (evidence: `src/hooks/delivery_hooks/useDelivery.js`)
- Delivery state → Formatting helpers: builds options (evidence: `src/hooks/delivery_hooks/useDelivery.js`)
- Barcode tools → Barcode workflow: uses workflow (evidence: `src/hooks/product_hooks/useBarcode.js`)
- Barcode workflow → Barcode service: requests barcode actions (evidence: `src/hooks/product_hooks/useBarcode.js`)
- Barcode service → HTTP client: loads products (evidence: `src/services/BarcodeService.js`)
