# adithyapi4/network-provisioning-system architecture

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

- Interactive diagram: https://gitdiagram.com/adithyapi4/network-provisioning-system
- Repository: https://github.com/adithyapi4/network-provisioning-system

## Overview

AirConnect is a console-based telecom connection request and provisioning simulator. Customers submit KYC details for new-number or port-in requests; requests receive a CRN, pass the applicable checks, and require card payment before provisioning. Provisioners authenticate, review requests, and provision or reject them; customers can track status by CRN. The sampled code also loads and saves requests in an encrypted, key-checked local file. The README describes some workflow details not visible in the excerpts; links based only on those descriptions are cited to the README.

Main entry points: [`main.cpp`](https://github.com/adithyapi4/network-provisioning-system/blob/main/main.cpp) (Console Workflow), [`misc_functions.cpp`](https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp) (Payment Selection), [`Customer.cpp`](https://github.com/adithyapi4/network-provisioning-system/blob/main/Customer.cpp) (KYC and Email OTP), [`Mobile.cpp`](https://github.com/adithyapi4/network-provisioning-system/blob/main/Mobile.cpp) (Request Status and CRN)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_request["Request Intake"]
  node_customer_kyc["KYC and Email OTP<br/>[Customer.cpp]"]
  node_request_checks["Request and Port Checks<br/>[Mobile.cpp]"]
  node_request_helpers["Request Intake Helpers<br/>[misc_functions.cpp]"]
end

subgraph group_operations["Provisioning Operations"]
  node_console["Console Workflow<br/>[main.cpp]"]
  node_provisioner_auth["Provisioner Authentication<br/>[misc_functions.cpp]"]
  node_activation["Provision and Activation<br/>[misc_functions.cpp]"]
  node_request_state["Request Status and CRN<br/>[Mobile.cpp]"]
end

subgraph group_payment["Payment"]
  node_payment_flow["Payment Selection<br/>[misc_functions.cpp]"]
  node_payment_api["Payment Interface<br/>[Payment.h]"]
  node_card_payment["Card Validation<br/>[Card.cpp]"]
end

subgraph group_persistence["Persistence"]
  node_request_store[("Encrypted Request File<br/>[misc_functions.cpp]")]
end

node_customer_actor(("Customer"))
node_provisioner_actor(("Provisioner"))

node_customer_actor -->|"submits request"| node_console
node_console -->|"collects KYC"| node_customer_kyc
node_customer_kyc -->|"provides details"| node_request_helpers
node_request_helpers -->|"creates request"| node_request_checks
node_request_checks -->|"inherits customer"| node_customer_kyc
node_console -->|"selects request type"| node_request_helpers
node_console -->|"starts payment"| node_payment_flow
node_payment_flow -->|"creates payment"| node_payment_api
node_payment_flow -->|"selects card"| node_card_payment
node_card_payment -->|"implements"| node_payment_api
node_console -->|"tracks CRN"| node_request_state
node_provisioner_actor -->|"reviews requests"| node_console
node_console -.->|"checks credentials"| node_provisioner_auth
node_console -->|"provisions request"| node_activation
node_activation -->|"sets activation state"| node_request_state
node_console -->|"loads and saves"| node_request_store
node_request_store -->|"restores requests"| node_request_state

click node_console "https://github.com/adithyapi4/network-provisioning-system/blob/main/main.cpp"
click node_customer_kyc "https://github.com/adithyapi4/network-provisioning-system/blob/main/Customer.cpp"
click node_request_checks "https://github.com/adithyapi4/network-provisioning-system/blob/main/Mobile.cpp"
click node_request_helpers "https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp"
click node_payment_flow "https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp"
click node_payment_api "https://github.com/adithyapi4/network-provisioning-system/blob/main/Payment.h"
click node_card_payment "https://github.com/adithyapi4/network-provisioning-system/blob/main/Card.cpp"
click node_provisioner_auth "https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp"
click node_activation "https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp"
click node_request_state "https://github.com/adithyapi4/network-provisioning-system/blob/main/Mobile.cpp"
click node_request_store "https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp"

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_customer_kyc,node_request_checks,node_request_helpers toneBlue
class node_console,node_provisioner_auth,node_activation,node_request_state toneAmber
class node_payment_flow,node_payment_api,node_card_payment toneMint
class node_request_store toneRose
class node_customer_actor,node_provisioner_actor toneIndigo
```

## Components

### Request Intake

- [KYC and Email OTP](https://github.com/adithyapi4/network-provisioning-system/blob/main/Customer.cpp): `Customer.cpp`
- [Request and Port Checks](https://github.com/adithyapi4/network-provisioning-system/blob/main/Mobile.cpp): `Mobile.cpp`
- [Request Intake Helpers](https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp): `misc_functions.cpp`

### Provisioning Operations

- [Console Workflow](https://github.com/adithyapi4/network-provisioning-system/blob/main/main.cpp): `main.cpp`
- [Provisioner Authentication](https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp): `misc_functions.cpp`
- [Provision and Activation](https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp): `misc_functions.cpp`
- [Request Status and CRN](https://github.com/adithyapi4/network-provisioning-system/blob/main/Mobile.cpp): `Mobile.cpp`

### Payment

- [Payment Selection](https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp): `misc_functions.cpp`
- [Payment Interface](https://github.com/adithyapi4/network-provisioning-system/blob/main/Payment.h): `Payment.h`
- [Card Validation](https://github.com/adithyapi4/network-provisioning-system/blob/main/Card.cpp): `Card.cpp`

### Persistence

- [Encrypted Request File](https://github.com/adithyapi4/network-provisioning-system/blob/main/misc_functions.cpp): `misc_functions.cpp`

### Other components

- **Customer**
- **Provisioner**

## Connections

- Customer → Console Workflow: submits request (evidence: `README.md`)
- Console Workflow → KYC and Email OTP: collects KYC
- KYC and Email OTP → Request Intake Helpers: provides details (evidence: `misc_functions.cpp`)
- Request Intake Helpers → Request and Port Checks: creates request (evidence: `misc_functions.cpp`)
- Request and Port Checks → KYC and Email OTP: inherits customer (evidence: `Mobile.cpp`)
- Console Workflow → Request Intake Helpers: selects request type (evidence: `main.cpp`)
- Console Workflow → Payment Selection: starts payment (evidence: `main.cpp`)
- Payment Selection → Payment Interface: creates payment (evidence: `misc_functions.cpp`)
- Payment Selection → Card Validation: selects card (evidence: `misc_functions.cpp`)
- Card Validation → Payment Interface: implements (evidence: `Card.cpp`)
- Console Workflow → Request Status and CRN: tracks CRN (evidence: `main.cpp`)
- Provisioner → Console Workflow: reviews requests (evidence: `README.md`)
- Console Workflow → Provisioner Authentication: checks credentials
- Console Workflow → Provision and Activation: provisions request (evidence: `main.cpp`)
- Provision and Activation → Request Status and CRN: sets activation state (evidence: `misc_functions.cpp`)
- Console Workflow → Encrypted Request File: loads and saves (evidence: `main.cpp`)
- Encrypted Request File → Request Status and CRN: restores requests (evidence: `misc_functions.cpp`)
