mirror of
https://github.com/andwati/telecom-platform.git
synced 2026-11-18 01:35:14 +00:00
feat: Add Quick Start Guide for platform setup and deployment
- Add comprehensive quick start documentation with step-by-step instructions - Include prerequisites, installation, and service startup commands - Add service architecture diagram showing component relationships - Include common commands for development and operations - Add troubleshooting section for common issues (port conflicts, permissions, service failures) - Provide service access URLs for web dashboard, API server, and charging engine
This commit is contained in:
@@ -0,0 +1,121 @@
|
|||||||
|
# Quick Start Guide
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
This guide will help you get the Telecom-as-a-Service platform running in minutes.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- Docker & Docker Compose
|
||||||
|
- Make command
|
||||||
|
- Terminal access
|
||||||
|
|
||||||
|
## 1. Initial Setup
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Clone the repository (if not already done)
|
||||||
|
git clone https://github.com/nutcas3/telecom-platform.git
|
||||||
|
cd telecom-platform
|
||||||
|
|
||||||
|
# Install dependencies
|
||||||
|
make install-deps
|
||||||
|
```
|
||||||
|
|
||||||
|
## 2. Start Core Services
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Start databases and core services
|
||||||
|
docker-compose up -d mongodb redis
|
||||||
|
|
||||||
|
# Start free5GC core network
|
||||||
|
make free5gc-start
|
||||||
|
|
||||||
|
# Start application services
|
||||||
|
docker-compose up -d api-server charging-engine carrier-connector
|
||||||
|
```
|
||||||
|
|
||||||
|
## 3. Start Development Server
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Start web dashboard
|
||||||
|
make dev-ui
|
||||||
|
```
|
||||||
|
|
||||||
|
## 4. Verify Deployment
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Check all services status
|
||||||
|
make verify
|
||||||
|
|
||||||
|
# Test free5GC configuration
|
||||||
|
make free5gc-test
|
||||||
|
```
|
||||||
|
|
||||||
|
## 5. Access Services
|
||||||
|
|
||||||
|
- **Web Dashboard**: http://localhost:3000
|
||||||
|
- **API Server**: http://localhost:8000
|
||||||
|
- **Charging Engine**: http://localhost:8080
|
||||||
|
|
||||||
|
## 6. Common Commands
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# View free5GC logs
|
||||||
|
make free5gc-logs
|
||||||
|
|
||||||
|
# Stop all services
|
||||||
|
docker-compose down
|
||||||
|
|
||||||
|
# Rebuild services
|
||||||
|
make docker-build
|
||||||
|
|
||||||
|
# Clean everything
|
||||||
|
make clean
|
||||||
|
```
|
||||||
|
|
||||||
|
## Service Architecture
|
||||||
|
|
||||||
|
```
|
||||||
|
Internet
|
||||||
|
|
|
||||||
|
[Web Dashboard] - [API Server] - [Carrier Connector]
|
||||||
|
| | |
|
||||||
|
| [Charging Engine] |
|
||||||
|
| | |
|
||||||
|
+-----------[free5GC Core]-----+
|
||||||
|
|
|
||||||
|
[MongoDB] [Redis]
|
||||||
|
```
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Services Not Starting
|
||||||
|
```bash
|
||||||
|
# Check logs
|
||||||
|
docker-compose logs [service-name]
|
||||||
|
|
||||||
|
# Restart specific service
|
||||||
|
docker-compose restart [service-name]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Port Conflicts
|
||||||
|
Ensure ports 3000, 8000, 8080, 27017, 6379 are available.
|
||||||
|
|
||||||
|
### Permission Issues
|
||||||
|
```bash
|
||||||
|
# Fix script permissions
|
||||||
|
chmod +x scripts/*.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## Next Steps
|
||||||
|
|
||||||
|
1. Explore the API documentation at `/docs/API.md`
|
||||||
|
2. Configure your first subscriber in the web dashboard
|
||||||
|
3. Test the charging engine with sample data
|
||||||
|
4. Deploy to Kubernetes using the provided manifests
|
||||||
|
|
||||||
|
## Support
|
||||||
|
|
||||||
|
- Check `make help` for all available commands
|
||||||
|
- Review `docs/DEPLOYMENT.md` for production deployment
|
||||||
|
- Check `todos.md` for development roadmap
|
||||||
Reference in New Issue
Block a user