# eloxbdeveloper/api-wars-project architecture

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

- Interactive diagram: https://gitdiagram.com/eloxbdeveloper/api-wars-project
- Repository: https://github.com/eloxbdeveloper/api-wars-project

## Overview

FactuLocal is a browser-based small-business sales and e-invoicing platform. The documented central workflow is invoice preparation, Factus Pay collection and payment confirmation, followed by Factus electronic issuance; sampled runtime code substantiates invoice CRUD and Factus issuance, but not the payment integration or automatic payment-detection mechanism. The graph therefore preserves those documented stages as unverified dashed links. It also shows customer/product management, credit notes, and sales analytics. Some backend routes and services are indexed but unsampled, so their connections are shown only where the README, excerpts, or source index support them.

Main entry points: [`frontend/src/router.js`](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/router.js) (Page router), [`frontend/src/services/api.js`](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/services/api.js) (HTTP API client), [`backend/src/services/invoiceService.js`](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/invoiceService.js) (Invoice service), [`backend/src/services/creditNoteService.js`](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/creditNoteService.js) (Credit-note service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_frontend["Browser app<br/>[main.js]"]
  node_router["Page router<br/>[router.js]"]
  node_invoice_ui["Invoice workflow<br/>[invoices.js]"]
  node_invoice_detail["Invoice detail<br/>[invoiceDetail.js]"]
  node_customers_ui["Customer management<br/>[customers.js]"]
  node_products_ui["Product management<br/>[products.js]"]
  node_credit_ui["Credit notes UI<br/>[creditNotes.js]"]
  node_dashboard["Sales dashboard<br/>[dashboard.js]"]
  node_api_client["HTTP API client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_api_app["Express API<br/>[app.js]"]
  node_invoice_routes["Invoice routes<br/>[invoiceRoutes.js]"]
  node_invoice_controller["Invoice controller"]
  node_credit_routes["Credit-note routes<br/>[creditNotes.js]"]
  node_credit_controller["Credit-note controller"]
end

subgraph group_domain["Business services"]
  node_invoice_service["Invoice service<br/>[invoiceService.js]"]
  node_customer_service["Customer service<br/>[customerService.js]"]
  node_product_service["Product service<br/>[productService.js]"]
  node_credit_service["Credit-note service"]
end

subgraph group_integrations["External integrations"]
  node_factus_client["Factus API client<br/>[client.js]"]
  node_factus_invoice["Factus invoice adapter<br/>[invoices.js]"]
  node_factus_credit["Factus credit-note adapter<br/>[creditNotes.js]"]
  node_factus["Factus"]
  node_factus_pay["Factus Pay"]
end

subgraph group_data["Persistence"]
  node_customer_store[("Customer records<br/>[Customer.js]")]
  node_invoice_store[("Invoice records<br/>[Invoice.js]")]
  node_product_store[("Product records<br/>[product.js]")]
  node_credit_store[("Credit-note records<br/>[CreditNote.js]")]
end

node_merchant(("Business user"))
node_payment(("Customer payment"))
node_dian["DIAN"]

node_merchant -->|"uses"| node_frontend
node_frontend -->|"starts"| node_router
node_router -->|"routes to"| node_invoice_ui
node_router -->|"routes to"| node_invoice_detail
node_router -->|"routes to"| node_customers_ui
node_router -->|"routes to"| node_products_ui
node_router -->|"routes to"| node_credit_ui
node_router -->|"routes to"| node_dashboard
node_invoice_ui -->|"requests"| node_api_client
node_invoice_detail -->|"requests"| node_api_client
node_customers_ui -->|"requests"| node_api_client
node_products_ui -->|"requests"| node_api_client
node_credit_ui -->|"requests"| node_api_client
node_dashboard -->|"requests"| node_api_client
node_api_client -->|"HTTP requests"| node_api_app
node_api_app -->|"mounts"| node_invoice_routes
node_api_app -->|"mounts"| node_credit_routes
node_invoice_routes -->|"dispatches"| node_invoice_controller
node_credit_routes -->|"dispatches"| node_credit_controller
node_invoice_controller -->|"calls"| node_invoice_service
node_credit_controller -->|"calls"| node_credit_service
node_invoice_service -->|"reads"| node_customer_store
node_invoice_service -->|"reads"| node_product_store
node_invoice_service -->|"reads and writes"| node_invoice_store
node_invoice_service -->|"transmits invoice"| node_factus_invoice
node_factus_invoice -->|"uses"| node_factus_client
node_factus_client -->|"authenticated API calls"| node_factus
node_credit_service -->|"reads"| node_invoice_store
node_credit_service -->|"reads and writes"| node_credit_store
node_credit_service -->|"requests credit note"| node_factus_credit
node_factus_credit -->|"uses"| node_factus_client
node_customer_service -->|"manages"| node_customer_store
node_product_service -->|"manages"| node_product_store
node_invoice_ui -.->|"initiates collection"| node_factus_pay
node_factus_pay -.->|"collects"| node_payment
node_payment -.->|"payment detection triggers issuance"| node_invoice_service
node_factus -.->|"electronic invoicing"| node_dian

click node_frontend "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/main.js"
click node_router "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/router.js"
click node_invoice_ui "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/invoices.js"
click node_invoice_detail "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/invoiceDetail.js"
click node_customers_ui "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/customers.js"
click node_products_ui "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/products.js"
click node_credit_ui "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/creditNotes.js"
click node_dashboard "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/dashboard.js"
click node_api_client "https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/services/api.js"
click node_api_app "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/app.js"
click node_invoice_routes "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/routes/invoiceRoutes.js"
click node_invoice_controller "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/controllers/invoicesController.js"
click node_credit_routes "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/routes/creditNotes.js"
click node_credit_controller "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/controllers/creditNotesController.js"
click node_invoice_service "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/invoiceService.js"
click node_customer_service "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/customerService.js"
click node_product_service "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/productService.js"
click node_credit_service "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/creditNoteService.js"
click node_customer_store "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/models/Customer.js"
click node_invoice_store "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/models/Invoice.js"
click node_product_store "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/models/product.js"
click node_credit_store "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/models/CreditNote.js"
click node_factus_client "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/integrations/factus/client.js"
click node_factus_invoice "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/integrations/factus/invoices.js"
click node_factus_credit "https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/integrations/factus/creditNotes.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_frontend,node_router,node_invoice_ui,node_invoice_detail,node_customers_ui,node_products_ui,node_credit_ui,node_dashboard,node_api_client,node_merchant toneBlue
class node_api_app,node_invoice_routes,node_invoice_controller,node_credit_routes,node_credit_controller toneAmber
class node_invoice_service,node_customer_service,node_product_service,node_credit_service toneMint
class node_factus_client,node_factus_invoice,node_factus_credit,node_factus,node_factus_pay toneRose
class node_customer_store,node_invoice_store,node_product_store,node_credit_store,node_payment,node_dian toneIndigo
```

## Components

### Web interface

- [Browser app](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/main.js): `frontend/src/main.js`
- [Page router](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/router.js): `frontend/src/router.js`
- [Invoice workflow](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/invoices.js): `frontend/src/pages/invoices.js`
- [Invoice detail](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/invoiceDetail.js): `frontend/src/pages/invoiceDetail.js`
- [Customer management](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/customers.js): `frontend/src/pages/customers.js`
- [Product management](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/products.js): `frontend/src/pages/products.js`
- [Credit notes UI](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/creditNotes.js): `frontend/src/pages/creditNotes.js`
- [Sales dashboard](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/pages/dashboard.js): `frontend/src/pages/dashboard.js`
- [HTTP API client](https://github.com/eloxbdeveloper/api-wars-project/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Backend API

- [Express API](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/app.js): `backend/src/app.js`
- [Invoice routes](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/routes/invoiceRoutes.js): `backend/src/routes/invoiceRoutes.js`
- [Invoice controller](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/controllers/invoicesController.js): `backend/src/controllers/invoicesController.js`
- [Credit-note routes](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/routes/creditNotes.js): `backend/src/routes/creditNotes.js`
- [Credit-note controller](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/controllers/creditNotesController.js): `backend/src/controllers/creditNotesController.js`

### Business services

- [Invoice service](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/invoiceService.js): `backend/src/services/invoiceService.js`
- [Customer service](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/customerService.js): `backend/src/services/customerService.js`
- [Product service](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/productService.js): `backend/src/services/productService.js`
- [Credit-note service](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/services/creditNoteService.js): `backend/src/services/creditNoteService.js`

### External integrations

- [Factus API client](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/integrations/factus/client.js): `backend/src/integrations/factus/client.js`
- [Factus invoice adapter](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/integrations/factus/invoices.js): `backend/src/integrations/factus/invoices.js`
- [Factus credit-note adapter](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/integrations/factus/creditNotes.js): `backend/src/integrations/factus/creditNotes.js`
- **Factus**
- **Factus Pay**

### Persistence

- [Customer records](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/models/Customer.js): `backend/src/models/Customer.js`
- [Invoice records](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/models/Invoice.js): `backend/src/models/Invoice.js`
- [Product records](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/models/product.js): `backend/src/models/product.js`
- [Credit-note records](https://github.com/eloxbdeveloper/api-wars-project/blob/main/backend/src/models/CreditNote.js): `backend/src/models/CreditNote.js`

### Other components

- **Business user**
- **Customer payment**
- **DIAN**

## Connections

- Business user → Browser app: uses (evidence: `README.md`)
- Browser app → Page router: starts (evidence: `frontend/src/main.js`)
- Page router → Invoice workflow: routes to (evidence: `frontend/src/router.js`)
- Page router → Invoice detail: routes to (evidence: `frontend/src/router.js`)
- Page router → Customer management: routes to (evidence: `frontend/src/router.js`)
- Page router → Product management: routes to (evidence: `frontend/src/router.js`)
- Page router → Credit notes UI: routes to (evidence: `frontend/src/router.js`)
- Page router → Sales dashboard: routes to (evidence: `frontend/src/router.js`)
- Invoice workflow → HTTP API client: requests (evidence: `frontend/src/pages/invoices.js`)
- Invoice detail → HTTP API client: requests (evidence: `frontend/src/pages/invoiceDetail.js`)
- Customer management → HTTP API client: requests (evidence: `frontend/src/pages/customers.js`)
- Product management → HTTP API client: requests (evidence: `frontend/src/pages/products.js`)
- Credit notes UI → HTTP API client: requests (evidence: `frontend/src/pages/creditNotes.js`)
- Sales dashboard → HTTP API client: requests (evidence: `frontend/src/pages/dashboard.js`)
- HTTP API client → Express API: HTTP requests (evidence: `README.md`)
- Express API → Invoice routes: mounts (evidence: `backend/src/app.js`)
- Express API → Credit-note routes: mounts (evidence: `backend/src/app.js`)
- Invoice routes → Invoice controller: dispatches (evidence: `backend/src/routes/invoiceRoutes.js`)
- Credit-note routes → Credit-note controller: dispatches (evidence: `backend/src/routes/creditNotes.js`)
- Invoice controller → Invoice service: calls (evidence: `backend/src/controllers/invoicesController.js`)
- Credit-note controller → Credit-note service: calls (evidence: `backend/src/controllers/creditNotesController.js`)
- Invoice service → Customer records: reads (evidence: `backend/src/services/invoiceService.js`)
- Invoice service → Product records: reads (evidence: `backend/src/services/invoiceService.js`)
- Invoice service → Invoice records: reads and writes (evidence: `backend/src/services/invoiceService.js`)
- Invoice service → Factus invoice adapter: transmits invoice (evidence: `backend/src/services/invoiceService.js`)
- Factus invoice adapter → Factus API client: uses (evidence: `backend/src/integrations/factus/invoices.js`)
- Factus API client → Factus: authenticated API calls (evidence: `backend/src/integrations/factus/client.js`)
- Credit-note service → Invoice records: reads (evidence: `backend/src/services/creditNoteService.js`)
- Credit-note service → Credit-note records: reads and writes (evidence: `backend/src/services/creditNoteService.js`)
- Credit-note service → Factus credit-note adapter: requests credit note (evidence: `backend/src/services/creditNoteService.js`)
- Factus credit-note adapter → Factus API client: uses (evidence: `backend/src/integrations/factus/creditNotes.js`)
- Customer service → Customer records: manages (evidence: `backend/src/services/customerService.js`)
- Product service → Product records: manages (evidence: `backend/src/services/productService.js`)
- Invoice workflow → Factus Pay: initiates collection (evidence: `README.md`)
- Factus Pay → Customer payment: collects (evidence: `README.md`)
- Customer payment → Invoice service: payment detection triggers issuance (evidence: `README.md`)
- Factus → DIAN: electronic invoicing (evidence: `README.md`)
