About System & Platform Architecture Module Documentation

Module Code: billing/client/about
Trigger: User Menu -> About
Dialog Component: AboutModal.tsx
Brand Purity: 100% White-Label Compliant (Ring2All Billing)

Executive Summary & Platform Identity
Technical Architecture & Component Breakdown
🎯 User Roles & Key Capabilities
Visual Interface & Screen Breakdown
Core Engine Components & Specifications
Security Governance & Tokenization Standards
System Diagnostics & Verification
Domain Glossary

1. Executive Summary & Platform Identity

The About System module provides operators, system integrators, and enterprise subscribers with an instant overview of the underlying BSS architecture powering the Ring2All Billing Customer Portal.

+-------------------------------------------------------------------------------+
|                       COMMERCIAL & OPERATIONAL IMPACT                         |
+-------------------------------------------------------------------------------+
| • Transparent Technical Pedigree: Clearly displays platform software versions|
|   and production engine specifications to technical auditors.                 |
| • Enterprise Assurance: Highlights carrier-grade PostgreSQL 17 clustering,    |
|   Fastify 5 asynchronous performance, and sub-millisecond OCS latency.        |
| • PCI-DSS Certified Standards: Documents Stripe vaulted tokenization.         |
| • Unified Brand Identity: Clean, white-label presentation under the           |
|   Ring2All Billing ecosystem.                                                 |
+-------------------------------------------------------------------------------+

2. Technical Architecture & Component Breakdown

The Customer Portal operates as a lightweight, secure satellite application interfacing with the carrier softswitch core:

 ┌────────────────────────────────────────────────────────────────────────┐
 │            Ring2All Billing Customer Portal (Client Edition v1.0.0)    │
 │            React 18 / Vite / Tailwind CSS / Zustand Store              │
 └───────────────────────────────────┬────────────────────────────────────┘
                                     │
           ┌─────────────────────────┼─────────────────────────┐
           │                         │                         │
           ▼                         ▼                         ▼
 ┌───────────────────┐     ┌───────────────────┐     ┌───────────────────┐
 │  Backend Engine   │     │ High-Perf Storage │     │  Real-Time OCS    │
 │  Fastify 5        │     │ PostgreSQL 17     │     │  Sub-millisecond  │
 │  Node.js 22 LTS   │     │ Kysely Query Bldr │     │  Pre-Auth Engine  │
 └───────────────────┘     └───────────────────┘     └───────────────────┘

3. 🎯 User Roles & Key Capabilities

Access to system specification diagnostics is available to all authenticated portal users:

User Role	Access Level	Primary Operational Capabilities
All Portal Subscribers	Specification Inspection	Verifies active software version, technical capabilities, and compliance standards.
Technical Support Engineers	Diagnostic Baseline	Confirms software release baseline during troubleshooting sessions.
Enterprise Security Auditors	Compliance Review	Verifies that storage, rating, and PCI tokenization adhere to corporate standards.

4. Visual Interface & Screen Breakdown

The modal opens smoothly from the user avatar dropdown menu:

About System Architecture & Engine Modal

Header Branding: Displays the unified Ring2All Billing icon, application title (Ring2All Billing Customer Portal), and subtitle (Carrier Telecom BSS & Self-Care Subsystem).
Software Version: Outlines active production release v1.0.0 (Client Edition).
Architecture Grid: Quad-card breakdown covering Backend Engine, Storage, Real-Time OCS, and PCI-DSS Security.
Overview Summary: Executive description of automated minute refills, CDR queries, and trunk management.

5. Core Engine Components & Specifications

1. Backend Engine

Technology: Fastify 5 running on Node.js 22 LTS.
Capabilities: Highly concurrent non-blocking I/O capable of handling over 25,000 JSON requests per second per node.

2. High-Performance Storage

Technology: PostgreSQL 17 with Kysely Type-Safe Query Builder.
Capabilities: Partitioned CDR tables, multi-tenant row-level indexing, and sub-second analytical reporting.

3. Real-Time OCS (Online Charging System)

Technology: In-memory Kamailio htable + Redis balance cache.
Capabilities: Sub-millisecond pre-call authorization and mid-call credit floor enforcement.

4. PCI-DSS Security

Technology: Stripe Tokenization & Vaulted Payment Methods.
Capabilities: SAQ-A compliance ensuring zero cardholder data touches application disks or network buffers.

6. Security Governance & Tokenization Standards

Zero Plaintext Storage: Passwords hashed with Argon2id cryptographic salt.
Secure JWT Lifecycles: Asymmetrically signed JSON Web Tokens with short expiry windows and automatic sliding refresh.
Perimeter Hardening: Protection against automated brute force and Layer 7 flooding via Fail2Ban and AI Perimeter Guard.

7. System Diagnostics & Verification

Verify Running Backend Process

# Execute on Billing Server
systemctl status ring2all-billing-api.service
curl -s http://127.0.0.1:3000/health

8. Domain Glossary

BSS (Business Support Systems): Telecom software managing billing, customer subscriptions, and rating.
Fastify: High-performance web framework for Node.js focused on minimal overhead.
Argon2id: Winner of the Password Hashing Competition (PHC) providing maximum resistance against GPU/ASIC cracking.