---
title: "Ring2All Billing (BSS/OSS & Customer Portal) Documentation"
description: "Documentation for AI Tool Profiles"
---

> **Official Slogan (Admin):** *"Converged Telecom Rating, Invoicing & Node Orchestration"*  
> **Official Slogan (Portal):** *"Customer Self-Care & Account Management"*  
> **Brand Identity:** Amber / Gold (`#F59E0B`) *(Shared Billing Logo)* • Icon: `credit-card` • Component Code: `bss`

Welcome to the complete documentation suite for **Ring2All Billing**, encompassing both the operator-grade **Billing Admin Console** and the customer-facing **Client Self-Care Portal**.

---

## 🏛️ Two Applications, One Unified Platform

Ring2All Billing is architected as two specialized frontends backed by a shared carrier billing API and PostgreSQL database:

```
                          ┌──────────────────────────────────────┐
                          │         Ring2All Billing API         │
                          │   (Fastify 5 + Kysely + PostgreSQL)  │
                          └──────────────────┬───────────────────┘
                                             │
             ┌───────────────────────────────┴───────────────────────────────┐
             │                                                               │
             ▼                                                               ▼
 ┌──────────────────────────────────────┐       ┌──────────────────────────────────────┐
 │       Ring2All Billing Admin         │       │       Ring2All Client Portal         │
 │   • Target: Telecom Operators & NOC  │       │   • Target: End Customers & Tenants  │
 │   • Slogan: "Converged Rating &..."  │       │   • Slogan: "Customer Self-Care &..."│
 │   • Scope: Customers, Rates, Plans,  │       │   • Scope: Prepaid Wallet, Invoices, │
 │     Invoicing, Fraud, Node Config    │       │     DIDs, Plan Store, CDR History    │
 └──────────────────────────────────────┘       └──────────────────────────────────────┘
```

---

## 📚 Documentation Directory

### 1. [Billing Admin Console](admin/README.md)
* [**Customers & Accounts**](admin/customers.md): Multi-tenant account profiles, canonical IDs, and status lifecycle.
* [**Plan Catalog**](admin/catalog-plans.md): Mini-PBX, SIP Trunks, and Bundles product definition.
* [**Subscriptions Management**](admin/subscriptions.md): Active contracts, automatic prorated billing, and lifecycle.
* [**Rate Cards & LCR Costs**](admin/rates-lcr.md): Wholesale cost decks, retail sell tiers, and prefix matching.
* [**Invoicing & Payments**](admin/invoicing-payments.md): Billing cycles, PDF invoices, Stripe auto-pay, and dunning.
* [**Real-Time OCS & Live Traffic**](admin/realtime-ocs.md): Online Charging System, live session monitor, and call termination.
* [**Fraud Detection & Prevention**](admin/fraud-control.md): Velocity rules, spend thresholds, and automated lockouts.
* [**Telecom Infrastructure Nodes**](admin/telecom-nodes.md): Dynamic interconnects to Ring2All PBX and SBC nodes.

### 2. [Customer Self-Care Portal](client/README.md)
* [**Dashboard & Wallet**](client/dashboard-wallet.md): Real-time balance, credit limits, minute bundles, and top-up.
* [**Plan Store & Checkout**](client/plan-store.md): Self-service store for Mini-PBX and SIP Trunks with instant setup.
* [**Telephony & DIDs**](client/telephony-dids.md): Assigned phone numbers, forwarding destinations, and IP endpoints.
* [**Invoices & Payment Methods**](client/invoices-payments.md): Invoice history, Stripe credit cards, and PDF receipts.
* [**CDRs & Usage Analytics**](client/cdrs-usage.md): Searchable call history, duration, destination, and costs.