# jeferls/inbox_messages architecture

> Architecture diagram of the GitHub repository jeferls/inbox_messages, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jeferls/inbox_messages
- Repository: https://github.com/jeferls/inbox_messages

## Overview

Inbox Messages is a local development tool: its main workflow accepts email submissions, stores and lists them for inspection, and rewrites claim links to a local claim page. Its broader product surface provides integration mocks and operational panels for greenn-local, including receivables, payment testing, identity verification, WhatsApp, and webhook forwarding. The graph preserves documented capabilities, but several panel implementations were not sampled; those subsystem nodes use supported directory paths and their internal wiring is omitted where evidence is unavailable.

Main entry points: [`src/app.js`](https://github.com/jeferls/inbox_messages/blob/main/src/app.js) (HTTP application), [`src/routes/emails.routes.js`](https://github.com/jeferls/inbox_messages/blob/main/src/routes/emails.routes.js) (Email endpoints), [`src/controllers/receivables.controller.js`](https://github.com/jeferls/inbox_messages/blob/main/src/controllers/receivables.controller.js) (Receivables), [`src/db/index.js`](https://github.com/jeferls/inbox_messages/blob/main/src/db/index.js) (SQLite data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inbox["Inbox and claims"]
  node_email_api["Email endpoints<br/>[emails.routes.js]"]
  node_email_handlers["Email handlers"]
  node_claim_rewrite["Claim URL rewrite<br/>[urlRewrite.js]"]
  node_claim_ui["Claim page<br/>[App.vue]"]
  node_claim_api["Claim API client<br/>[api.js]"]
  node_claims["Claim endpoints"]
end

subgraph group_operations["Operational panels"]
  node_receivables["Receivables"]
  node_receivable_logic["Receivable units"]
  node_payment_test["Payment tester"]
  node_product_catalog["Product catalog"]
  node_docker_ops["Container controls<br/>[docker.service.js]"]
  node_qrcode["QR code and offers<br/>[qrcode.routes.js]"]
end

subgraph group_mocks["Integration mocks"]
  node_idwall["IdWall mock"]
  node_idwall_regression["IdWall regression"]
  node_worldpay["Worldpay mock"]
  node_whs_forward["Webhook forwarding"]
  node_whatsapp_mock["WhatsApp mock<br/>[wa-mock.service.js]"]
  node_konduto["Konduto integration"]
  node_transfeera["Transfeera integration"]
end

subgraph group_runtime["Application runtime"]
  node_express_app["HTTP application<br/>[app.js]"]
  node_sqlite[("SQLite data<br/>[index.js]")]
  node_greenn_db[("Greenn database<br/>[greenn-db.js]")]
end

node_user(("Local user"))
node_api_client(("Email sender"))

node_user -->|"uses panels"| node_express_app
node_api_client -->|"submits email"| node_express_app
node_express_app -->|"mounts routes"| node_email_api
node_express_app -->|"initializes"| node_sqlite
node_email_api -->|"routes requests"| node_email_handlers
node_email_api -->|"stores and reads"| node_sqlite
node_email_api -->|"rewrites links"| node_claim_rewrite
node_user -->|"opens claim link"| node_claim_ui
node_claim_ui -->|"calls"| node_claim_api
node_express_app -->|"mounts routes"| node_receivables
node_receivables -->|"reads and writes"| node_sqlite
node_receivables -->|"adjusts units"| node_receivable_logic
node_express_app -->|"mounts mock routes"| node_idwall
node_idwall_regression -->|"drives scenarios"| node_idwall
node_idwall_regression -->|"executes commands"| node_docker_ops
node_express_app -->|"mounts mock routes"| node_worldpay
node_express_app -->|"starts forwarding"| node_whs_forward
node_express_app -->|"mounts tester routes"| node_payment_test
node_payment_test -->|"loads catalog"| node_product_catalog
node_express_app -->|"mounts routes"| node_qrcode
node_qrcode -->|"queries offers"| node_greenn_db
node_express_app -->|"mounts mock routes"| node_whatsapp_mock
node_express_app -->|"mounts routes"| node_konduto
node_express_app -->|"mounts routes"| node_transfeera

click node_express_app "https://github.com/jeferls/inbox_messages/blob/main/src/app.js"
click node_email_api "https://github.com/jeferls/inbox_messages/blob/main/src/routes/emails.routes.js"
click node_email_handlers "https://github.com/jeferls/inbox_messages/blob/main/src/controllers/emails.controller.js"
click node_sqlite "https://github.com/jeferls/inbox_messages/blob/main/src/db/index.js"
click node_claim_rewrite "https://github.com/jeferls/inbox_messages/blob/main/src/utils/urlRewrite.js"
click node_claim_ui "https://github.com/jeferls/inbox_messages/blob/main/claim-page/src/App.vue"
click node_claim_api "https://github.com/jeferls/inbox_messages/blob/main/claim-page/src/api.js"
click node_claims "https://github.com/jeferls/inbox_messages/blob/main/src/controllers/claims.controller.js"
click node_receivables "https://github.com/jeferls/inbox_messages/blob/main/src/controllers/receivables.controller.js"
click node_receivable_logic "https://github.com/jeferls/inbox_messages/blob/main/src/services/receivable-units.service.js"
click node_payment_test "https://github.com/jeferls/inbox_messages/blob/main/src/services/payment-tester.service.js"
click node_product_catalog "https://github.com/jeferls/inbox_messages/blob/main/src/services/product-catalog.service.js"
click node_idwall "https://github.com/jeferls/inbox_messages/blob/main/src/services/idwall-mock.service.js"
click node_idwall_regression "https://github.com/jeferls/inbox_messages/blob/main/src/services/idwall-regression.service.js"
click node_worldpay "https://github.com/jeferls/inbox_messages/blob/main/src/controllers/worldpay-mock.controller.js"
click node_whs_forward "https://github.com/jeferls/inbox_messages/blob/main/src/services/whs-forward.service.js"
click node_whatsapp_mock "https://github.com/jeferls/inbox_messages/blob/main/src/services/wa-mock.service.js"
click node_konduto "https://github.com/jeferls/inbox_messages/blob/main/src/controllers/konduto.controller.js"
click node_transfeera "https://github.com/jeferls/inbox_messages/blob/main/src/controllers/transfeera.controller.js"
click node_docker_ops "https://github.com/jeferls/inbox_messages/blob/main/src/services/docker.service.js"
click node_qrcode "https://github.com/jeferls/inbox_messages/blob/main/src/routes/qrcode.routes.js"
click node_greenn_db "https://github.com/jeferls/inbox_messages/blob/main/src/services/greenn-db.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_email_api,node_email_handlers,node_claim_rewrite,node_claim_ui,node_claim_api,node_claims,node_user toneBlue
class node_receivables,node_receivable_logic,node_payment_test,node_product_catalog,node_docker_ops,node_qrcode toneAmber
class node_idwall,node_idwall_regression,node_worldpay,node_whs_forward,node_whatsapp_mock,node_konduto,node_transfeera toneMint
class node_express_app,node_sqlite,node_greenn_db toneRose
class node_api_client toneIndigo
```

## Components

### Inbox and claims

- [Email endpoints](https://github.com/jeferls/inbox_messages/blob/main/src/routes/emails.routes.js): `src/routes/emails.routes.js`
- [Email handlers](https://github.com/jeferls/inbox_messages/blob/main/src/controllers/emails.controller.js): `src/controllers/emails.controller.js`
- [Claim URL rewrite](https://github.com/jeferls/inbox_messages/blob/main/src/utils/urlRewrite.js): `src/utils/urlRewrite.js`
- [Claim page](https://github.com/jeferls/inbox_messages/blob/main/claim-page/src/App.vue): `claim-page/src/App.vue`
- [Claim API client](https://github.com/jeferls/inbox_messages/blob/main/claim-page/src/api.js): `claim-page/src/api.js`
- [Claim endpoints](https://github.com/jeferls/inbox_messages/blob/main/src/controllers/claims.controller.js): `src/controllers/claims.controller.js`

### Operational panels

- [Receivables](https://github.com/jeferls/inbox_messages/blob/main/src/controllers/receivables.controller.js): `src/controllers/receivables.controller.js`
- [Receivable units](https://github.com/jeferls/inbox_messages/blob/main/src/services/receivable-units.service.js): `src/services/receivable-units.service.js`
- [Payment tester](https://github.com/jeferls/inbox_messages/blob/main/src/services/payment-tester.service.js): `src/services/payment-tester.service.js`
- [Product catalog](https://github.com/jeferls/inbox_messages/blob/main/src/services/product-catalog.service.js): `src/services/product-catalog.service.js`
- [Container controls](https://github.com/jeferls/inbox_messages/blob/main/src/services/docker.service.js): `src/services/docker.service.js`
- [QR code and offers](https://github.com/jeferls/inbox_messages/blob/main/src/routes/qrcode.routes.js): `src/routes/qrcode.routes.js`

### Integration mocks

- [IdWall mock](https://github.com/jeferls/inbox_messages/blob/main/src/services/idwall-mock.service.js): `src/services/idwall-mock.service.js`
- [IdWall regression](https://github.com/jeferls/inbox_messages/blob/main/src/services/idwall-regression.service.js): `src/services/idwall-regression.service.js`
- [Worldpay mock](https://github.com/jeferls/inbox_messages/blob/main/src/controllers/worldpay-mock.controller.js): `src/controllers/worldpay-mock.controller.js`
- [Webhook forwarding](https://github.com/jeferls/inbox_messages/blob/main/src/services/whs-forward.service.js): `src/services/whs-forward.service.js`
- [WhatsApp mock](https://github.com/jeferls/inbox_messages/blob/main/src/services/wa-mock.service.js): `src/services/wa-mock.service.js`
- [Konduto integration](https://github.com/jeferls/inbox_messages/blob/main/src/controllers/konduto.controller.js): `src/controllers/konduto.controller.js`
- [Transfeera integration](https://github.com/jeferls/inbox_messages/blob/main/src/controllers/transfeera.controller.js): `src/controllers/transfeera.controller.js`

### Application runtime

- [HTTP application](https://github.com/jeferls/inbox_messages/blob/main/src/app.js): `src/app.js`
- [SQLite data](https://github.com/jeferls/inbox_messages/blob/main/src/db/index.js): `src/db/index.js`
- [Greenn database](https://github.com/jeferls/inbox_messages/blob/main/src/services/greenn-db.js): `src/services/greenn-db.js`

### Other components

- **Local user**
- **Email sender**

## Connections

- Local user → HTTP application: uses panels (evidence: `README.md`)
- Email sender → HTTP application: submits email (evidence: `README.md`)
- HTTP application → Email endpoints: mounts routes (evidence: `src/app.js`)
- HTTP application → SQLite data: initializes (evidence: `src/app.js`)
- Email endpoints → Email handlers: routes requests (evidence: `src/routes/emails.routes.js`)
- Email endpoints → SQLite data: stores and reads (evidence: `src/routes/emails.routes.js`)
- Email endpoints → Claim URL rewrite: rewrites links (evidence: `src/routes/emails.routes.js`)
- Local user → Claim page: opens claim link (evidence: `README.md`)
- Claim page → Claim API client: calls (evidence: `claim-page/src/App.vue`)
- HTTP application → Receivables: mounts routes (evidence: `src/app.js`)
- Receivables → SQLite data: reads and writes (evidence: `src/controllers/receivables.controller.js`)
- Receivables → Receivable units: adjusts units (evidence: `src/controllers/receivables.controller.js`)
- HTTP application → IdWall mock: mounts mock routes (evidence: `src/app.js`)
- IdWall regression → IdWall mock: drives scenarios (evidence: `src/services/idwall-regression.service.js`)
- IdWall regression → Container controls: executes commands (evidence: `src/services/idwall-regression.service.js`)
- HTTP application → Worldpay mock: mounts mock routes (evidence: `src/app.js`)
- HTTP application → Webhook forwarding: starts forwarding (evidence: `src/app.js`)
- HTTP application → Payment tester: mounts tester routes (evidence: `src/app.js`)
- Payment tester → Product catalog: loads catalog (evidence: `src/controllers/payment-tester.controller.js`)
- HTTP application → QR code and offers: mounts routes (evidence: `src/app.js`)
- QR code and offers → Greenn database: queries offers (evidence: `src/routes/qrcode.routes.js`)
- HTTP application → WhatsApp mock: mounts mock routes (evidence: `src/app.js`)
- HTTP application → Konduto integration: mounts routes (evidence: `src/app.js`)
- HTTP application → Transfeera integration: mounts routes (evidence: `src/app.js`)
