BSS/OSS Rust Ecosystem

🌍 A high-performance, memory-safe BSS/OSS ecosystem in Rust, fully compliant with TM Forum Open APIs (TMF). Built for telecom operators who need interoperability, safety, and performance.

What is BSS/OSS?

BSS (Business Support Systems) and OSS (Operations Support Systems) are critical software platforms for telecommunications companies. They handle:

• BSS: Customer management, billing, product catalogs, orders
• OSS: Service provisioning, network inventory, service activation, resource management

This project provides a complete, production-ready implementation of TM Forum's standardized APIs, enabling seamless integration between different telecom systems.

Features

✅ 17 TM Forum APIs Implemented:

• Phase 1 (Product Domain): TMF620 (Catalog), TMF622 (Ordering), TMF637 (Inventory)
• Phase 2 (Customer Domain): TMF629 (Customer), TMF678 (Billing), TMF679 (Usage), TMF688 (Appointment)
• Phase 3 (Service Lifecycle): TMF641 (Service Order), TMF638 (Service Inventory), TMF640 (Service Activation), TMF702 (Resource Activation)
• Phase 4 (Resource Domain): TMF639 (Resource Inventory), TMF645 (Resource Order)
• Phase 5 (Revenue Management): TMF635 (Usage), TMF668 (Party Role)
• Phase 6 (Security, Party & Identity): TMF632 (Party), TMF669 (Identity & Credential)

✅ Production-Ready Features:

• PostgreSQL database integration via sqlx
• JWT authentication for secure API access
• Auto-generated OpenAPI/Swagger documentation
• Async/await support with Actix Web
• Type-safe Rust implementation
• Docker Compose setup included

✅ Memory Safety: Rust's compile-time guarantees prevent common bugs that could lead to billing errors or security vulnerabilities.

Quick Start

Prerequisites

• Rust 1.70 or later
• PostgreSQL 15+ (or use Docker Compose)
• Docker and Docker Compose (optional)

Installation

# Clone the repository
git clone https://github.com/rabbittrix/BSS-OSS-Rust-Ecosystem.git
cd BSS-OSS-Rust-Ecosystem

# Start PostgreSQL and the application
docker-compose up -d

# Or run manually
cargo run --release --bin bss-oss-rust

Usage Example

// The server automatically starts with all TMF APIs enabled
// Access Swagger UI at: http://localhost:8080/swagger-ui/

// Example: Create a product catalog
curl -X POST http://localhost:8080/tmf-api/productCatalogManagement/v4/catalog \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "5G Services Catalog",
    "description": "Catalog for 5G service offerings",
    "version": "1.0.0",
    "lifecycle_status": "ACTIVE"
  }'

Architecture

This is a Cargo workspace with modular crates:

bss-oss-rust/
├── crates/
│   ├── tmf-apis/          # Individual TMF API implementations
│   │   ├── core/          # Shared models and error types
│   │   ├── tmf620_catalog/
│   │   ├── tmf622_ordering/
│   │   └── ... (17 total APIs)
│   ├── server/            # Main application server
│   ├── pcm-engine/        # Product Catalog Engine
│   └── utils/             # Common utilities
└── migrations/            # Database schema migrations

Available APIs

All APIs follow TM Forum Open API standards and are accessible via REST:

Documentation

• Swagger UI: http://localhost:8080/swagger-ui/ (when server is running)
• Full Documentation: See README.md for complete setup and usage guide
• TM Forum Standards: TM Forum Open APIs

Why Rust?

• Memory Safety: No null pointer dereferences, buffer overflows, or data races
• Performance: Comparable to C/C++ with zero-cost abstractions
• Concurrency: Built-in async/await for high-throughput APIs
• Type Safety: Catch errors at compile-time, not runtime
• Ecosystem: Growing ecosystem with excellent tooling (Cargo, Clippy, Rustfmt)

Contributing

Contributions are welcome! This project aims to be a community-driven implementation of TM Forum standards.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Roberto de Souza - rabbittrix@hotmail.com

Acknowledgments

• TM Forum for the Open API standards
• The Rust community for excellent tools and libraries
• All contributors who help improve this project

Built with ❤️ in Rust for the telecom industry