# kodaemeric0-afk/dontplay architecture

> Architecture diagram of the GitHub repository kodaemeric0-afk/dontplay, 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/kodaemeric0-afk/dontplay
- Repository: https://github.com/kodaemeric0-afk/dontplay

## Overview

Dontplay is a Node.js/Express account, subscription, crypto-payment, page/domain-management, and bulk-SMS platform. Its principal user workflow is to authenticate, choose or fund a plan, then create and monitor an SMS campaign; the server coordinates requests with persistent user data and the SMS subsystem. The README also documents page, domain, redirect, and template management. The main PHP page trees appear to be deployed page/template content, but their runtime wiring is not established by the excerpts, so they are represented only as a management capability. Some route details and the SMS sender implementation were not sampled.

Main entry points: [`server.js`](https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js) (Express API), [`lib/sms/index.js`](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/index.js) (SMS service entry), [`lib/sms/SMSSender.js`](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/SMSSender.js) (Campaign sender), [`lib/sms/SMSProviderManager.js`](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/SMSProviderManager.js) (Provider routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Web API"]
  node_server["Express API<br/>[server.js]"]
  node_security["Request security<br/>[security.js]"]
end

subgraph group_account["Accounts &amp; Billing"]
  node_accounts["Accounts &amp; plans<br/>[server.js]"]
  node_payments["Crypto payments<br/>[server.js]"]
  node_nowpayments["NOWPayments"]
  node_userdb[("User database<br/>[db.js]")]
end

subgraph group_management["Page Management"]
  node_pageops["Pages &amp; domains<br/>[server.js]"]
  node_redirects["Redirect management<br/>[server.js]"]
  node_templates["Template management<br/>[server.js]"]
end

subgraph group_messaging["SMS Messaging"]
  node_smsapi["SMS campaign API<br/>[server.js]"]
  node_smsentry["SMS service entry<br/>[index.js]"]
  node_phoneparser["Contact parsing<br/>[PhoneParser.js]"]
  node_variables["Message variables"]
  node_sender["Campaign sender<br/>[SMSSender.js]"]
  node_routing["Provider routing"]
  node_smsstore[("SMS campaign store<br/>[storage.js]")]
  node_providers["SMS provider adapters<br/>[ApiHttpProvider.js]"]
end

node_user(("Platform user"))

node_user -->|"uses API"| node_server
node_server -->|"validates requests"| node_security
node_server -->|"routes account requests"| node_accounts
node_accounts -->|"reads and writes"| node_userdb
node_server -->|"routes payment requests"| node_payments
node_payments -->|"creates payments"| node_nowpayments
node_payments -.->|"records transactions"| node_userdb
node_server -->|"routes page requests"| node_pageops
node_server -->|"routes redirect requests"| node_redirects
node_server -->|"manages templates"| node_templates
node_server -->|"routes campaign requests"| node_smsapi
node_smsapi -->|"uses SMS service"| node_smsentry
node_smsentry -->|"parses contacts"| node_phoneparser
node_smsentry -->|"renders variables"| node_variables
node_smsentry -->|"uses sender"| node_sender
node_smsentry -->|"uses provider manager"| node_routing
node_smsentry -->|"uses storage"| node_smsstore
node_routing -->|"detects phone region"| node_phoneparser
node_routing -->|"selects adapter"| node_providers
node_sender -.->|"dispatches messages"| node_routing
node_sender -.->|"renders campaign text"| node_variables
node_sender -.->|"persists campaign state"| node_smsstore
node_providers -.->|"sends SMS"| node_user

click node_server "https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js"
click node_security "https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/security.js"
click node_accounts "https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js"
click node_payments "https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js"
click node_userdb "https://github.com/kodaemeric0-afk/dontplay/blob/main/db.js"
click node_pageops "https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js"
click node_redirects "https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js"
click node_templates "https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js"
click node_smsapi "https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js"
click node_smsentry "https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/index.js"
click node_phoneparser "https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/PhoneParser.js"
click node_variables "https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/MessageVariableEngine.js"
click node_sender "https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/SMSSender.js"
click node_routing "https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/SMSProviderManager.js"
click node_smsstore "https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/storage.js"
click node_providers "https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/providers/ApiHttpProvider.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_security,node_user toneBlue
class node_accounts,node_payments,node_nowpayments,node_userdb toneAmber
class node_pageops,node_redirects,node_templates toneMint
class node_smsapi,node_smsentry,node_phoneparser,node_variables,node_sender,node_routing,node_smsstore,node_providers toneRose
```

## Components

### Web API

- [Express API](https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js): `server.js`
- [Request security](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/security.js): `lib/security.js`

### Accounts & Billing

- [Accounts & plans](https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js): `server.js`
- [Crypto payments](https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js): `server.js`
- **NOWPayments**
- [User database](https://github.com/kodaemeric0-afk/dontplay/blob/main/db.js): `db.js`

### Page Management

- [Pages & domains](https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js): `server.js`
- [Redirect management](https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js): `server.js`
- [Template management](https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js): `server.js`

### SMS Messaging

- [SMS campaign API](https://github.com/kodaemeric0-afk/dontplay/blob/main/server.js): `server.js`
- [SMS service entry](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/index.js): `lib/sms/index.js`
- [Contact parsing](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/PhoneParser.js): `lib/sms/PhoneParser.js`
- [Message variables](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/MessageVariableEngine.js): `lib/sms/MessageVariableEngine.js`
- [Campaign sender](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/SMSSender.js): `lib/sms/SMSSender.js`
- [Provider routing](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/SMSProviderManager.js): `lib/sms/SMSProviderManager.js`
- [SMS campaign store](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/storage.js): `lib/sms/storage.js`
- [SMS provider adapters](https://github.com/kodaemeric0-afk/dontplay/blob/main/lib/sms/providers/ApiHttpProvider.js): `lib/sms/providers/ApiHttpProvider.js`

### Other components

- **Platform user**

## Connections

- Platform user → Express API: uses API (evidence: `README.md`)
- Express API → Request security: validates requests (evidence: `server.js`)
- Express API → Accounts & plans: routes account requests (evidence: `README.md`)
- Accounts & plans → User database: reads and writes (evidence: `README.md`)
- Express API → Crypto payments: routes payment requests (evidence: `README.md`)
- Crypto payments → NOWPayments: creates payments (evidence: `README.md`)
- Crypto payments → User database: records transactions (evidence: `server.js`)
- Express API → Pages & domains: routes page requests (evidence: `README.md`)
- Express API → Redirect management: routes redirect requests (evidence: `README.md`)
- Express API → Template management: manages templates (evidence: `server.js`)
- Express API → SMS campaign API: routes campaign requests (evidence: `README.md`)
- SMS campaign API → SMS service entry: uses SMS service (evidence: `server.js`)
- SMS service entry → Contact parsing: parses contacts (evidence: `lib/sms/index.js`)
- SMS service entry → Message variables: renders variables (evidence: `lib/sms/index.js`)
- SMS service entry → Campaign sender: uses sender (evidence: `lib/sms/index.js`)
- SMS service entry → Provider routing: uses provider manager (evidence: `lib/sms/index.js`)
- SMS service entry → SMS campaign store: uses storage (evidence: `lib/sms/index.js`)
- Provider routing → Contact parsing: detects phone region (evidence: `lib/sms/SMSProviderManager.js`)
- Provider routing → SMS provider adapters: selects adapter (evidence: `lib/sms/SMSProviderManager.js`)
- Campaign sender → Provider routing: dispatches messages
- Campaign sender → Message variables: renders campaign text
- Campaign sender → SMS campaign store: persists campaign state
- SMS provider adapters → Platform user: sends SMS
