# siralex999/wallet-codet architecture

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

- Interactive diagram: https://gitdiagram.com/siralex999/wallet-codet
- Repository: https://github.com/siralex999/wallet-codet

## Overview

CODET is a multi-tenant restaurant loyalty platform: restaurant owners configure reward cards and promotions, while customers enroll through a QR/link and save cards to Apple or Google Wallet. Its main runtime path runs from the web server through public enrollment and loyalty rules to persisted passes and wallet synchronization; owners use the admin panel to manage businesses and messaging. The map also preserves platform administration, plans, audit, backups, and integrations. Some subsystem implementations were not excerpted, so their links are included only where the README or source index documents them.

Main entry points: [`src/routes/admin.js`](https://github.com/siralex999/wallet-codet/blob/main/src/routes/admin.js) (Admin routes), [`server.js`](https://github.com/siralex999/wallet-codet/blob/main/server.js) (HTTP server), [`src/queue.js`](https://github.com/siralex999/wallet-codet/blob/main/src/queue.js) (Delivery queue), [`src/loyalty.js`](https://github.com/siralex999/wallet-codet/blob/main/src/loyalty.js) (Loyalty rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_server["HTTP server<br/>[server.js]"]
  node_site["Public site<br/>[site.js]"]
  node_admin_ui["Admin panel<br/>[app.js]"]
  node_admin_routes["Admin routes<br/>[admin.js]"]
  node_public_routes["Public routes<br/>[public.js]"]
  node_pwa["Wallet PWA<br/>[pwa.js]"]
end

subgraph group_loyalty["Loyalty experience"]
  node_loyalty_rules["Loyalty rules<br/>[loyalty.js]"]
  node_card_model["Card data model<br/>[model.js]"]
  node_wallet_sync["Wallet synchronization<br/>[notify.js]"]
  node_apple["Apple Wallet<br/>[apple.js]"]
  node_google["Google Wallet<br/>[google.js]"]
end

subgraph group_messaging["Messaging"]
  node_campaigns["Campaigns<br/>[campaigns.js]"]
  node_automations["Automated messages<br/>[automations.js]"]
  node_queue["Delivery queue<br/>[queue.js]"]
  node_providers["Message providers<br/>[whatsapp.js]"]
  node_webhooks["Provider webhooks<br/>[webhooks.js]"]
end

subgraph group_platform["Platform administration"]
  node_accounts["Business accounts<br/>[accounts.js]"]
  node_invites["Invitations<br/>[invites.js]"]
  node_plans["Plans and access<br/>[plans.js]"]
  node_audit["Audit trail<br/>[audit.js]"]
  node_backup["Backup and restore<br/>[backup.js]"]
  node_restore["Restore application<br/>[restore-apply.js]"]
end

subgraph group_runtime["Runtime services"]
  node_database[("SQLite database<br/>[db.js]")]
end

node_owner(("Restaurant owner"))
node_customer(("Customer"))

node_owner -->|"requests access"| node_site
node_site -->|"manages invitations"| node_invites
node_owner -->|"manages business"| node_admin_ui
node_admin_ui -->|"uses panel routes"| node_admin_routes
node_admin_routes -->|"manages accounts"| node_accounts
node_admin_routes -->|"manages invitations"| node_invites
node_admin_routes -->|"manages campaigns"| node_campaigns
node_admin_routes -->|"manages automations"| node_automations
node_admin_routes -->|"checks access"| node_plans
node_admin_routes -->|"records activity"| node_audit
node_customer -->|"enrolls by QR"| node_public_routes
node_public_routes -->|"registers customers"| node_loyalty_rules
node_loyalty_rules -->|"creates passes"| node_card_model
node_card_model -->|"reads and writes"| node_database
node_loyalty_rules -->|"synchronizes passes"| node_wallet_sync
node_wallet_sync -->|"updates cards"| node_apple
node_wallet_sync -->|"updates cards"| node_google
node_customer -->|"opens wallet link"| node_pwa
node_server -->|"routes requests"| node_site
node_server -->|"routes requests"| node_admin_routes
node_server -->|"routes requests"| node_public_routes
node_server -->|"routes requests"| node_pwa
node_server -->|"routes callbacks"| node_webhooks
node_campaigns -->|"enqueues recipients"| node_queue
node_automations -->|"enqueues messages"| node_queue
node_queue -->|"sends WhatsApp"| node_providers
node_webhooks -->|"reports delivery"| node_queue
node_campaigns -->|"checks channel limits"| node_plans
node_backup -->|"stages restore"| node_restore
node_restore -->|"applies before opening"| node_database
node_admin_routes -->|"manages backups"| node_backup

click node_server "https://github.com/siralex999/wallet-codet/blob/main/server.js"
click node_site "https://github.com/siralex999/wallet-codet/blob/main/src/routes/site.js"
click node_admin_ui "https://github.com/siralex999/wallet-codet/blob/main/public/admin/app.js"
click node_admin_routes "https://github.com/siralex999/wallet-codet/blob/main/src/routes/admin.js"
click node_public_routes "https://github.com/siralex999/wallet-codet/blob/main/src/routes/public.js"
click node_pwa "https://github.com/siralex999/wallet-codet/blob/main/src/routes/pwa.js"
click node_accounts "https://github.com/siralex999/wallet-codet/blob/main/src/accounts.js"
click node_invites "https://github.com/siralex999/wallet-codet/blob/main/src/invites.js"
click node_plans "https://github.com/siralex999/wallet-codet/blob/main/src/plans.js"
click node_audit "https://github.com/siralex999/wallet-codet/blob/main/src/audit.js"
click node_backup "https://github.com/siralex999/wallet-codet/blob/main/src/backup.js"
click node_restore "https://github.com/siralex999/wallet-codet/blob/main/src/restore-apply.js"
click node_loyalty_rules "https://github.com/siralex999/wallet-codet/blob/main/src/loyalty.js"
click node_card_model "https://github.com/siralex999/wallet-codet/blob/main/src/model.js"
click node_database "https://github.com/siralex999/wallet-codet/blob/main/src/db.js"
click node_wallet_sync "https://github.com/siralex999/wallet-codet/blob/main/src/notify.js"
click node_apple "https://github.com/siralex999/wallet-codet/blob/main/src/apple.js"
click node_google "https://github.com/siralex999/wallet-codet/blob/main/src/google.js"
click node_campaigns "https://github.com/siralex999/wallet-codet/blob/main/src/campaigns.js"
click node_automations "https://github.com/siralex999/wallet-codet/blob/main/src/automations.js"
click node_queue "https://github.com/siralex999/wallet-codet/blob/main/src/queue.js"
click node_providers "https://github.com/siralex999/wallet-codet/blob/main/src/whatsapp.js"
click node_webhooks "https://github.com/siralex999/wallet-codet/blob/main/src/routes/webhooks.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_server,node_site,node_admin_ui,node_admin_routes,node_public_routes,node_pwa toneBlue
class node_loyalty_rules,node_card_model,node_wallet_sync,node_apple,node_google toneAmber
class node_campaigns,node_automations,node_queue,node_providers,node_webhooks toneMint
class node_accounts,node_invites,node_plans,node_audit,node_backup,node_restore toneRose
class node_database,node_owner,node_customer toneIndigo
```

## Components

### Web entry

- [HTTP server](https://github.com/siralex999/wallet-codet/blob/main/server.js): `server.js`
- [Public site](https://github.com/siralex999/wallet-codet/blob/main/src/routes/site.js): `src/routes/site.js`
- [Admin panel](https://github.com/siralex999/wallet-codet/blob/main/public/admin/app.js): `public/admin/app.js`
- [Admin routes](https://github.com/siralex999/wallet-codet/blob/main/src/routes/admin.js): `src/routes/admin.js`
- [Public routes](https://github.com/siralex999/wallet-codet/blob/main/src/routes/public.js): `src/routes/public.js`
- [Wallet PWA](https://github.com/siralex999/wallet-codet/blob/main/src/routes/pwa.js): `src/routes/pwa.js`

### Loyalty experience

- [Loyalty rules](https://github.com/siralex999/wallet-codet/blob/main/src/loyalty.js): `src/loyalty.js`
- [Card data model](https://github.com/siralex999/wallet-codet/blob/main/src/model.js): `src/model.js`
- [Wallet synchronization](https://github.com/siralex999/wallet-codet/blob/main/src/notify.js): `src/notify.js`
- [Apple Wallet](https://github.com/siralex999/wallet-codet/blob/main/src/apple.js): `src/apple.js`
- [Google Wallet](https://github.com/siralex999/wallet-codet/blob/main/src/google.js): `src/google.js`

### Messaging

- [Campaigns](https://github.com/siralex999/wallet-codet/blob/main/src/campaigns.js): `src/campaigns.js`
- [Automated messages](https://github.com/siralex999/wallet-codet/blob/main/src/automations.js): `src/automations.js`
- [Delivery queue](https://github.com/siralex999/wallet-codet/blob/main/src/queue.js): `src/queue.js`
- [Message providers](https://github.com/siralex999/wallet-codet/blob/main/src/whatsapp.js): `src/whatsapp.js`
- [Provider webhooks](https://github.com/siralex999/wallet-codet/blob/main/src/routes/webhooks.js): `src/routes/webhooks.js`

### Platform administration

- [Business accounts](https://github.com/siralex999/wallet-codet/blob/main/src/accounts.js): `src/accounts.js`
- [Invitations](https://github.com/siralex999/wallet-codet/blob/main/src/invites.js): `src/invites.js`
- [Plans and access](https://github.com/siralex999/wallet-codet/blob/main/src/plans.js): `src/plans.js`
- [Audit trail](https://github.com/siralex999/wallet-codet/blob/main/src/audit.js): `src/audit.js`
- [Backup and restore](https://github.com/siralex999/wallet-codet/blob/main/src/backup.js): `src/backup.js`
- [Restore application](https://github.com/siralex999/wallet-codet/blob/main/src/restore-apply.js): `src/restore-apply.js`

### Runtime services

- [SQLite database](https://github.com/siralex999/wallet-codet/blob/main/src/db.js): `src/db.js`

### Other components

- **Restaurant owner**
- **Customer**

## Connections

- Restaurant owner → Public site: requests access
- Public site → Invitations: manages invitations (evidence: `src/routes/site.js`)
- Restaurant owner → Admin panel: manages business
- Admin panel → Admin routes: uses panel routes (evidence: `src/routes/admin.js`)
- Admin routes → Business accounts: manages accounts (evidence: `src/routes/admin.js`)
- Admin routes → Invitations: manages invitations (evidence: `src/routes/admin.js`)
- Admin routes → Campaigns: manages campaigns (evidence: `src/routes/admin.js`)
- Admin routes → Automated messages: manages automations (evidence: `src/routes/admin.js`)
- Admin routes → Plans and access: checks access (evidence: `src/routes/admin.js`)
- Admin routes → Audit trail: records activity (evidence: `src/routes/admin.js`)
- Customer → Public routes: enrolls by QR
- Public routes → Loyalty rules: registers customers (evidence: `src/routes/public.js`)
- Loyalty rules → Card data model: creates passes (evidence: `src/loyalty.js`)
- Card data model → SQLite database: reads and writes (evidence: `src/model.js`)
- Loyalty rules → Wallet synchronization: synchronizes passes (evidence: `src/loyalty.js`)
- Wallet synchronization → Apple Wallet: updates cards (evidence: `src/notify.js`)
- Wallet synchronization → Google Wallet: updates cards (evidence: `src/notify.js`)
- Customer → Wallet PWA: opens wallet link
- HTTP server → Public site: routes requests (evidence: `server.js`)
- HTTP server → Admin routes: routes requests (evidence: `server.js`)
- HTTP server → Public routes: routes requests (evidence: `server.js`)
- HTTP server → Wallet PWA: routes requests (evidence: `server.js`)
- HTTP server → Provider webhooks: routes callbacks (evidence: `server.js`)
- Campaigns → Delivery queue: enqueues recipients (evidence: `src/campaigns.js`)
- Automated messages → Delivery queue: enqueues messages (evidence: `src/automations.js`)
- Delivery queue → Message providers: sends WhatsApp (evidence: `src/queue.js`)
- Provider webhooks → Delivery queue: reports delivery (evidence: `src/routes/webhooks.js`)
- Campaigns → Plans and access: checks channel limits (evidence: `src/campaigns.js`)
- Backup and restore → Restore application: stages restore (evidence: `src/backup.js`)
- Restore application → SQLite database: applies before opening (evidence: `src/db.js`)
- Admin routes → Backup and restore: manages backups (evidence: `src/routes/admin.js`)
