{"id":50370230,"url":"https://github.com/nutcas3/telecom-platform","last_synced_at":"2026-05-30T06:31:28.838Z","repository":{"id":357777883,"uuid":"1200636683","full_name":"nutcas3/telecom-platform","owner":"nutcas3","description":"This is a comprehensive, sovereign cellular connectivity solution that enables organizations to deploy and manage their own private 5G/LTE networks. This full-stack platform provides end-to-end capabilities from core network integration to subscriber management, charging, and developer APIs","archived":false,"fork":false,"pushed_at":"2026-05-14T07:21:47.000Z","size":1682,"stargazers_count":63,"open_issues_count":0,"forks_count":16,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-14T09:37:37.515Z","etag":null,"topics":["5g","5gcore","bss","cellular-network","charging-engine","cloud-native-engineering","ebpf","esim","golang","kubernetes","lte","message-queue","microservices","network-orchestration","network-programming","private-network","rust","telecom"],"latest_commit_sha":null,"homepage":"https://medium.com/@nut3case/c35a654a5567","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nutcas3.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-03T16:44:20.000Z","updated_at":"2026-05-14T07:21:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nutcas3/telecom-platform","commit_stats":null,"previous_names":["nutcas3/telecom-platform"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/nutcas3/telecom-platform","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nutcas3%2Ftelecom-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nutcas3%2Ftelecom-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nutcas3%2Ftelecom-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nutcas3%2Ftelecom-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nutcas3","download_url":"https://codeload.github.com/nutcas3/telecom-platform/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nutcas3%2Ftelecom-platform/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33682998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["5g","5gcore","bss","cellular-network","charging-engine","cloud-native-engineering","ebpf","esim","golang","kubernetes","lte","message-queue","microservices","network-orchestration","network-programming","private-network","rust","telecom"],"created_at":"2026-05-30T06:31:28.029Z","updated_at":"2026-05-30T06:31:28.830Z","avatar_url":"https://github.com/nutcas3.png","language":"Go","funding_links":[],"categories":["Core Network"],"sub_categories":["5G"],"readme":"# Telecom-as-a-Service (TaaS) Platform\n\n\u003e **Sovereign, Full-Stack Cellular Connectivity Platform**  \n\u003e Built with Go 1.26, Rust 1.95, TypeScript, eBPF, and 5G Core Network Technologies\n\n## Overview\n\nThe Telecom-as-a-Service (TaaS) Platform is a comprehensive, sovereign cellular connectivity solution that enables organizations to deploy and manage their own private 5G/LTE networks. This full-stack platform provides end-to-end capabilities from core network integration to subscriber management, charging, and developer APIs.\n\n### API Gateway Integration\n\nThe platform now includes **Traefik API Gateway** for centralized request routing, security, and monitoring. All services are accessible through a unified HTTPS endpoint with built-in rate limiting, authentication, and SSL termination.\n\n### What It Does\n\nThe TaaS Platform allows enterprises, telecom operators, and system integrators to:\n\n- **Deploy Private Cellular Networks**: Set up and manage private 5G/LTE networks with full control over data sovereignty and security\n- **Manage Subscribers**: Provision, authenticate, and manage cellular subscribers with role-based access control\n- **Real-time Charging**: Implement flexible credit control and billing with real-time usage monitoring\n- **Developer APIs**: Expose cellular network capabilities through REST and GraphQL APIs for custom application development\n- **Network Orchestration**: Automate network operations, scaling, and health monitoring across distributed infrastructure\n- **Service Discovery**: Enable dynamic service registration and discovery for microservices architecture\n\n### Commercial Applications\n\nThe platform is designed for various commercial use cases:\n\n**eSIM Operators (Airalo-style)**\n- Multi-carrier aggregation across 400+ global carriers\n- Real-time eSIM provisioning via GSMA ES2+ standards\n- Usage-based billing with global rate plans\n- B2B2C model for MVNO partnerships\n\n**Enterprise Private Networks**\n- Industrial IoT and manufacturing connectivity\n- Campus networks for universities and hospitals\n- Critical infrastructure communications\n- Secure data sovereignty deployments\n\n**Telecom Service Providers**\n- MVNO enablement platform\n- Network slicing as a service\n- Edge computing integration\n- 5G core network hosting\n\n### Architecture\n\nThe platform is built as a microservices architecture with the following core components:\n\n**API Gateway Layer:**\n- **Traefik API Gateway**: Centralized entry point providing SSL termination, rate limiting, authentication, and request routing\n- **Unified HTTPS Endpoint**: All services accessible via `https://api.telecom.com`\n- **Security Middleware**: JWT authentication, security headers, compression, and retry logic\n- **Monitoring Dashboard**: Real-time metrics and service health visualization\n\n**Core Network Services:**\n- **API Server**: Central BSS (Business Support System) API providing authentication, subscriber management, automation, and plugin system\n- **Carrier Connector**: ES2+ interface for eSIM profile management and carrier integration\n- **Charging Engine**: Real-time credit control, usage tracking, and billing with Redis-backed rate limiting\n- **Packet Gateway**: High-performance eBPF-based packet processing for network traffic routing and QoS enforcement\n\n**Supporting Services:**\n- **Service Discovery (Consul)**: Dynamic service registration and health checking\n- **Message Queue (RabbitMQ)**: Asynchronous event-driven communication between services\n- **Redis**: Distributed caching, rate limiting, and session management\n- **PostgreSQL**: Persistent data storage for subscribers, automations, and configuration\n- **Vault**: Secure secret management for sensitive credentials and keys\n\n**Developer Tools:**\n- **CLI**: Command-line interface for service orchestration, configuration, and health checks\n- **Web Dashboard**: Next.js-based management interface for network operations\n- **Multi-Language SDKs**: Client libraries for Go, Python, TypeScript, Kotlin, Ruby, Swift, Rust, and Elixir\n- **Kubernetes Operators**: Custom resources for deploying and managing TaaS services\n\n**Analytics \u0026 Intelligence:**\n- **Churn Analysis**: ML-powered customer churn prediction with risk scoring and retention recommendations\n- **Fraud Detection**: Real-time fraud detection for account takeover, subscription fraud, payment fraud, and SIM swap attacks\n- **Market Analytics**: Market penetration analysis, competitor tracking, and growth opportunity identification\n- **Predictive Maintenance**: Infrastructure health monitoring with failure prediction and maintenance scheduling\n- **Pricing Optimization**: Dynamic pricing strategies for revenue maximization, market share, and churn reduction\n\n### Key Features\n\n**API Gateway \u0026 Security:**\n- **Unified HTTPS Endpoint**: All services accessible via `https://api.telecom.com`\n- **Centralized Authentication**: JWT validation with rate limiting per service\n- **SSL Termination**: Automatic HTTPS with security headers enforcement\n- **Request Routing**: Intelligent routing with circuit breakers and retry logic\n\n**Sovereignty \u0026 Security:**\n- Full data sovereignty with on-premise deployment\n- End-to-end encryption for subscriber data\n- Role-based access control (RBAC) with fine-grained permissions\n- Vault-based secret management for credential security\n\n**Performance \u0026 Scalability:**\n- eBPF-accelerated packet processing for line-rate throughput\n- Redis-backed distributed rate limiting and caching\n- Horizontal scaling with Kubernetes orchestration\n- Gateway-level load balancing and connection pooling\n\n**Developer Experience:**\n- **Single API Endpoint**: Simplified client integration through gateway\n- REST and GraphQL APIs with comprehensive documentation\n- TypeScript SDK for type-safe client integration\n- Plugin system for extending platform capabilities\n- Automation framework for network operations\n\n**Operations:**\n- **Gateway Dashboard**: Real-time monitoring of all services\n- **Unified Metrics**: Prometheus integration with gateway-level insights\n- Automated scaling and service discovery\n- Centralized logging with structured logs\n- Health checks and failover automation\n\n\n**Technology Stack:**\n\n**Core Languages \u0026 Runtimes:**\n- **Go 1.26**: Core network integration, BSS API, carrier connector\n- **Rust 1.95**: eBPF packet gateway, real-time charging engine\n- **TypeScript/Next.js**: Developer dashboard and SDK\n\n**Databases:**\n- **PostgreSQL**: Primary database for subscribers, automations, plugins, and configuration\n- **Redis**: Real-time credit control, caching, and rate limiting\n- **MongoDB**: Used exclusively by free5GC 5G core network for UDR/UDM subscription data and authentication\n\n**5G Core Network:**\n- **free5GC**: Open-source 5G core network (AMF, SMF, UDM, UDR, etc.)\n\n**Infrastructure \u0026 Orchestration:**\n- **Kubernetes**: Container orchestration and deployment\n- **Helm**: Package management for Kubernetes deployments\n- **Istio**: Service mesh for traffic management and security\n- **eBPF/Aya**: High-performance packet processing in kernel space\n\n**Message Queuing \u0026 Service Discovery:**\n- **RabbitMQ**: Asynchronous message queue for event-driven communication\n- **Consul**: Service discovery, health checking, and configuration\n\n**Security \u0026 Secrets:**\n- **Vault**: Secure secret management for credentials and keys\n- **cert-manager**: Automated TLS certificate management\n\n**Monitoring \u0026 Observability:**\n- **Prometheus**: Metrics collection and alerting\n- **Grafana**: Visualization dashboards for metrics\n- **ELK Stack**: Elasticsearch, Logstash, Kibana for centralized logging\n\n### Prerequisites\n\n- **Go 1.26+**: [Download](https://go.dev/dl/)\n- **Rust 1.95+**: `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`\n- **Node.js 22+**: [Download](https://nodejs.org/)\n- **pnpm**: `npm install -g pnpm`\n- **Docker**: [Install](https://docs.docker.com/get-docker/)\n- **PostgreSQL 15+**: [Install](https://www.postgresql.org/download/)\n- **Redis**: [Install](https://redis.io/download)\n- **Kubernetes**: [Install](https://kubernetes.io/docs/tasks/tools/) (for production deployment)\n- **Helm 3+**: [Install](https://helm.sh/docs/intro/install/) (for production deployment)\n- **MongoDB 7.0+**: [Install](https://www.mongodb.com/docs/manual/installation/) (required for free5GC only)\n\n### Installation\n\n#### Quick Start with API Gateway (Recommended)\n\n```bash\n# Clone the repository\ngit clone https://github.com/nutcas3/telecom-platform.git\ncd telecom-platform\n\n# Start with API Gateway (includes all services)\n./scripts/start-gateway.sh\n\n# Add domain to hosts file\necho \"127.0.0.1 api.telecom.com\" | sudo tee -a /etc/hosts\n\n# Access services\n# API Gateway Dashboard: http://localhost:8080\n# API Documentation: https://api.telecom.com/api/v1/swagger\n# Web Dashboard: http://localhost:3000\n```\n\n#### Manual Installation\n\n```bash\n# Build all components\nmake all\n\n# Start services (requires separate terminals)\n# Terminal 1: API Server\n./dist/api-server\n\n# Terminal 2: Carrier Connector\n./dist/carrier-connector\n\n# Terminal 3: Charging Engine\n./target/release/charging-engine\n\n# Terminal 4: Web Dashboard\ncd apps/web-dashboard \u0026\u0026 pnpm dev\n```\n\n## Project Structure\n\n```\ntelecom-platform/\n|-- apps/\n|   |-- api-server/          # Go: Developer BSS API\n|   |-- carrier-connector/   # Go: eSIM ES2+ Provisioning\n|   |-- charging-engine/     # Rust: OCS Real-time Credit Control\n|   |-- packet-gateway/      # Rust: eBPF UPF Data Plane\n|   |-- web-dashboard/       # TypeScript: Next.js Frontend\n|-- sdk/\n|   |-- go/                  # Go SDK\n|   |-- python/              # Python SDK\n|   |-- typescript/          # TypeScript SDK\n|   |-- kotlin/              # Kotlin SDK\n|   |-- ruby/                # Ruby SDK\n|   |-- swift/               # Swift SDK\n|   |-- rust/                # Rust SDK\n|   |-- elixir/              # Elixir SDK\n|-- libs/\n|   |-- shared-ts-sdk/       # TypeScript: Drop-in Widget SDK\n|   |-- proto/               # Shared Protobufs\n|-- deployments/\n|   |-- kubernetes/          # K8s manifests\n|   |-- docker/              # Dockerfiles\n|-- traefik/                 # API Gateway configuration\n|   |-- traefik.yml          # Static configuration\n|   |-- dynamic/             # Dynamic middleware config\n|-- docs/                    # Architecture \u0026 API docs\n|   |-- sdk-usage.md         # Multi-language SDK documentation\n|   |-- gateway-quickstart.md # API Gateway guide\n|   |-- api-gateway.md       # Gateway implementation details\n|-- scripts/                 # Automation scripts\n|   |-- start-gateway.sh     # Gateway startup script\n|-- docker-compose.yml       # Container orchestration\n|-- Makefile                 # Master build orchestrator\n|-- Cargo.toml              # Rust workspace config\n|-- go.work                 # Go workspace config\n|-- pnpm-workspace.yaml     # TypeScript workspace config\n```\n\n## Development\n\n### Build Commands\n\n```bash\n# Build everything\nmake all\n\n# Build specific language\nmake build-go        # Go services\nmake build-rust      # Rust components\nmake build-ui        # TypeScript dashboard\n\n# Run tests\nmake test\n\n# Clean artifacts\nmake clean\n```\n\n### Working with Specific Components\n\n**Go Services:**\n```bash\ncd apps/api-server\ngo run main.go\n```\n\n**Rust Components:**\n```bash\ncd apps/charging-engine\ncargo run --release\n```\n\n**TypeScript Dashboard:**\n```bash\ncd apps/web-dashboard\npnpm dev\n```\n\n## Documentation\n\n- **[API Documentation](./docs/api-spec.yaml)**: OpenAPI 3.0 specification\n- **[SDK Documentation](./docs/sdk-usage.md)**: Multi-language SDK usage guide\n- **[Building 5G Networks](./docs/building-5g-with-taas.md)**: Complete 5G deployment guide\n- **[eSIM Operator Analysis](./docs/esim-operator-analysis.md)**: Commercial use case analysis\n- **[Gateway Quickstart](./docs/gateway-quickstart.md)**: API Gateway setup and configuration\n- **[API Gateway Guide](./docs/api-gateway.md)**: Implementation details and patterns\n- **[Architecture Guide](./docs/architecture.md)**: System design and data flows\n- **[Deployment Guide](./docs/deployment.md)**: Kubernetes and Docker setup\n\n## Testing\n\n```bash\n# Unit tests\nmake test\n\n# Go tests\ngo test ./apps/...\n\n# Rust tests\ncargo test --workspace\n\n# TypeScript tests\npnpm -r test\n```\n\n## Deployment\n\n### Docker with API Gateway (Recommended)\n\n```bash\n# Start with API Gateway\n./scripts/start-gateway.sh\n\n# Or manually\ndocker-compose up -d\n```\n\n### Docker (Legacy)\n\n```bash\nmake docker-build\ndocker-compose up -d\n```\n\n### Kubernetes\n\n```bash\nkubectl apply -f deployments/kubernetes/\n```\n\n### API Gateway Configuration\n\nThe API Gateway provides:\n\n- **Unified Endpoint**: `https://api.telecom.com`\n- **Rate Limiting**: Per-service rate limits\n- **SSL Termination**: Automatic HTTPS\n- **Authentication**: JWT validation\n- **Monitoring**: Real-time metrics dashboard\n\nFor detailed setup, see [Gateway Quickstart Guide](./docs/gateway-quickstart.md)\n\n## Platform Architecture \u0026 Components\n\n### **API Gateway Layer**\n- **Traefik API Gateway**: Centralized entry point providing SSL termination, rate limiting, authentication, and request routing\n- **Unified HTTPS Endpoint**: All services accessible via `https://api.telecom.com`\n- **Security Middleware**: JWT authentication, security headers, compression, and retry logic\n- **Monitoring Dashboard**: Real-time metrics and service health visualization\n\n### **Core Network Services**\n\n#### **API Server (Go/Gin)**\n- **Purpose**: Central BSS (Business Support System) API\n- **Features**: Authentication, subscriber management, automation, plugin system\n- **Architecture**: Microservices with Gin framework, PostgreSQL, Redis caching\n- **Key Modules**: Handlers for analytics, payments, monitoring, RBAC, websockets\n\n#### **Carrier Connector (Go/Gin)**\n- **Purpose**: ES2+ interface for eSIM profile management and carrier integration\n- **Features**: Multi-carrier aggregation, GSMA ES2+ standards compliance, real-time eSIM provisioning\n- **Architecture**: GORM for database, ES2+ client, message queue integration\n- **Key Modules**: Pricing optimization, security (fraud detection), rate plans, MVNO support\n\n#### **Charging Engine (Rust/Axum)**\n- **Purpose**: Real-time credit control, usage tracking, and billing\n- **Features**: Redis-backed rate limiting, PostgreSQL for rate plans, circuit breakers\n- **Architecture**: High-performance Rust with tokio async runtime\n- **Key Modules**: Charging handlers, authentication, monitoring, rating plans\n\n#### **Packet Gateway (Rust/eBPF)**\n- **Purpose**: High-performance packet processing for network traffic routing and QoS enforcement\n- **Features**: eBPF-accelerated packet processing for line-rate throughput\n\n### **Supporting Infrastructure**\n- **PostgreSQL**: Persistent data storage for subscribers, automations, configuration\n- **Redis**: Distributed caching, rate limiting, session management\n- **MongoDB**: Document storage for 5G core network data\n- **RabbitMQ**: Asynchronous event-driven communication\n- **Consul**: Service discovery and health checking\n- **Vault**: Secure secret management\n\n### **Frontend Applications**\n\n#### **Web Dashboard (Next.js/TypeScript)**\n- **Purpose**: Management interface for network operations\n- **Features**: Real-time dashboard, subscriber management, analytics, pricing optimization\n- **Architecture**: React components, Tailwind CSS, API integration\n- **Key Pages**: Dashboard, analytics, pricing, subscribers, system health\n\n### **SDK Ecosystem**\n\nMulti-language SDKs for developer integration:\n- **Swift**: iOS/macOS applications with async/await support\n- **Python**: Backend integration and automation\n- **TypeScript**: Web applications and Node.js backends\n- **Go**: Microservices and CLI tools\n- **Kotlin**: Android applications\n- **Rust**: High-performance systems\n- **Elixir**: Phoenix applications\n- **Ruby**: Rails integration\n\n### **Analytics \u0026 Intelligence**\n\n#### **Advanced Analytics Modules**\n1. **Churn Analysis**: ML-powered customer churn prediction with risk scoring\n2. **Fraud Detection**: Real-time fraud detection (account takeover, subscription fraud, SIM swap attacks)\n3. **Market Analytics**: Market penetration analysis, competitor tracking\n4. **Predictive Maintenance**: Infrastructure health monitoring with failure prediction\n5. **Pricing Optimization**: Dynamic pricing strategies with elasticity calculations\n\n#### **Pricing Optimization System**\n- **Strategies**: Revenue maximization, market share, profit margin, competitive positioning, churn reduction\n- **Advanced Calculations**: \n  - Dynamic elasticity based on rate plan characteristics\n  - Competitive index with seasonal market analysis\n  - ROI calculation with period-based adjustments\n- **Implementation**: Go services with mathematical modeling and bounded realistic values\n\n### **Commercial Applications**\n\n#### **eSIM Operators (Airalo-style)**\n- Multi-carrier aggregation across 400+ global carriers\n- Real-time eSIM provisioning via GSMA ES2+ standards\n- Usage-based billing with global rate plans\n- B2B2C model for MVNO partnerships\n\n#### **Enterprise Private Networks**\n- Industrial IoT and manufacturing connectivity\n- Campus networks for universities and hospitals\n- Critical infrastructure communications\n- Secure data sovereignty deployments\n\n#### **Telecom Service Providers**\n- MVNO enablement platform\n- Network slicing as a service\n- Edge computing integration\n- 5G core network hosting\n\n### **Data Flow Architecture**\n\n```\nClient Applications → Traefik Gateway → API Services → Backend Services\n                              ↓\n                        Authentication \u0026 Rate Limiting\n                              ↓\n                    Message Queue (RabbitMQ) for Async Events\n                              ↓\n              Database Layer (PostgreSQL, Redis, MongoDB)\n```\n\n### **Key Features Summary**\n\n- **Sovereignty \u0026 Security**: Full data sovereignty, end-to-end encryption, RBAC\n- **Performance**: eBPF-accelerated packet processing, Redis-backed caching\n- **Scalability**: Microservices architecture, horizontal scaling\n- **Developer Experience**: Multi-language SDKs, comprehensive documentation\n- **Enterprise Ready**: Monitoring, backup, security, compliance features\n\nThe platform represents a **complete telecom stack** for modern cellular network operations, combining carrier-grade reliability with cloud-native architecture and advanced analytics capabilities.\n\n## API Endpoints\n\n### Analytics API\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/analytics/churn/predict` | Predict churn for a profile |\n| GET | `/api/v1/analytics/churn/metrics` | Get churn metrics |\n| GET | `/api/v1/analytics/churn/at-risk` | Get at-risk customers |\n| GET | `/api/v1/analytics/market/metrics` | Get market metrics |\n| GET | `/api/v1/analytics/market/competitors` | Get competitor analysis |\n| GET | `/api/v1/analytics/market/opportunities` | Get market opportunities |\n| GET | `/api/v1/analytics/maintenance/metrics` | Get maintenance metrics |\n| GET | `/api/v1/analytics/maintenance/assets` | Get assets health |\n| GET | `/api/v1/analytics/maintenance/alerts` | Get maintenance alerts |\n| POST | `/api/v1/analytics/maintenance/predict/:asset_id` | Predict asset failure |\n| GET | `/api/v1/analytics/pricing/metrics` | Get pricing metrics |\n| POST | `/api/v1/analytics/pricing/optimize` | Optimize pricing |\n| GET | `/api/v1/analytics/pricing/elasticity` | Get price elasticity |\n\n### Security API\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/security/fraud/analyze` | Analyze transaction for fraud |\n| POST | `/api/v1/security/fraud/alerts` | Get fraud alerts |\n| PUT | `/api/v1/security/fraud/alerts/:id` | Update alert status |\n| GET | `/api/v1/security/fraud/metrics` | Get fraud metrics |\n| GET | `/api/v1/security/fraud/patterns` | Get fraud patterns |\n| POST | `/api/v1/security/simswap/verify` | Verify SIM swap |\n| GET | `/api/v1/security/simswap/history/:profile_id` | Get SIM swap history |\n\n### Currency \u0026 Billing API\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | `/api/v1/currency/convert` | Convert currency |\n| GET | `/api/v1/currency/exchange/:from/:to` | Get exchange rate |\n| GET | `/api/v1/currency/exchange/:from/:to/history` | Get exchange rate history |\n| GET | `/api/v1/currency/currencies` | List supported currencies |\n| POST | `/api/v1/currency/exchange/refresh` | Refresh exchange rates |\n| POST | `/api/v1/currency/billing` | Process billing |\n| GET | `/api/v1/currency/billing/history/:profile_id` | Get billing history |\n| GET | `/api/v1/currency/billing/summary/:profile_id` | Get billing summary |\n| POST | `/api/v1/currency/billing/refund/:transaction_id` | Process refund |\n| GET | `/api/v1/currency/billing/analytics` | Get billing analytics |\n\n## Environment Variables\n\nCreate `.env` files in each service directory:\n\n**API Server** (`apps/api-server/.env`):\n```env\nMONGODB_URI=mongodb://localhost:27017/free5gc\nREDIS_URI=redis://localhost:6379\nAPI_PORT=8000\nJWT_SECRET=your-secret-key\n```\n\n**Charging Engine** (`apps/charging-engine/.env`):\n```env\nREDIS_URI=redis://localhost:6379\nSERVER_PORT=8080\n```\n\n**Web Dashboard** (`apps/web-dashboard/.env.local`):\n```env\nNEXT_PUBLIC_API_URL=http://localhost:8000\n```\n\n## 📖 Key Resources\n\n- **free5GC**: [https://free5gc.org/](https://free5gc.org/)\n- **Aya eBPF**: [https://aya-rs.dev/](https://aya-rs.dev/)\n- **GSMA eSIM Specs**: [https://www.gsma.com/esim/](https://www.gsma.com/esim/)\n- **Go 1.26 Docs**: [https://go.dev/doc/go1.26](https://go.dev/doc/go1.26)\n- **Rust 1.95 Blog**: [https://blog.rust-lang.org/2026/06/05/Rust-1.95.0/](https://blog.rust-lang.org/2026/06/05/Rust-1.95.0/)\n- **Traefik**: [https://traefik.io/](https://traefik.io/)\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/nutcas3/telecom-platform/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/nutcas3/telecom-platform/discussions)\n- **Email**: support@yourcompany.com\n\n## Acknowledgments\n\n- **free5GC Team**: For the open-source 5G core implementation\n- **Aya Community**: For the pure-Rust eBPF framework\n- **GSMA**: For standardizing eSIM technology\n- **Go Team**: For the amazing Go 1.26 release\n- **Rust Team**: For continuous language improvements\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnutcas3%2Ftelecom-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnutcas3%2Ftelecom-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnutcas3%2Ftelecom-platform/lists"}