mirror of
https://github.com/andwati/telecom-platform.git
synced 2026-10-18 11:02:54 +00:00
feat: Add comprehensive CLI documentation with commands reference, configuration, and plugin system
- Add README.md with installation instructions (source, go install, binary release) - Add quick start guide with initial setup and interactive dashboard - Add global options table with help, version, verbose, no-color, format, and profile flags - Add configuration commands reference with set/get/profiles operations and options table - Add subscribers commands reference with list/show/create/update/delete operations and
This commit is contained in:
nutcas3
@@ -0,0 +1,710 @@
|
||||
# Telecom Platform CLI
|
||||
|
||||
A comprehensive command-line interface for managing the Telecom Platform, built with Go and enhanced with Bubbletea for interactive TUI features.
|
||||
|
||||
## Features
|
||||
|
||||
- **Subscriber Management**: Create, read, update, and delete subscribers
|
||||
- **Service Management**: Monitor and manage platform services
|
||||
- **Billing Operations**: Handle invoices, payments, and billing reports
|
||||
- **Configuration Management**: Manage CLI profiles and settings
|
||||
- **Monitoring**: Real-time service health and metrics
|
||||
- **Enhanced UI**: Beautiful terminal interface with colors and icons
|
||||
- **Multi-format Output**: Support for table, JSON, and CSV formats
|
||||
- **Plugin System**: Extensible architecture for custom commands
|
||||
|
||||
## Installation
|
||||
|
||||
### From Source
|
||||
```bash
|
||||
git clone https://github.com/nutcas3/telecom-platform.git
|
||||
cd telecom-platform/apps/cli
|
||||
go build -o telecom-cli main.go
|
||||
sudo mv telecom-cli /usr/local/bin/
|
||||
```
|
||||
|
||||
### Using Go Install
|
||||
```bash
|
||||
go install github.com/nutcas3/telecom-platform/apps/cli@latest
|
||||
```
|
||||
|
||||
### From Binary Release
|
||||
```bash
|
||||
# Download the latest release for your platform
|
||||
curl -L https://github.com/nutcas3/telecom-platform/releases/latest/download/telecom-cli-linux-amd64.tar.gz | tar xz
|
||||
sudo mv telecom-cli /usr/local/bin/
|
||||
```
|
||||
|
||||
## Quick Start
|
||||
|
||||
### Initial Setup
|
||||
```bash
|
||||
# Configure the CLI
|
||||
telecom-cli config set api-endpoint http://localhost:8000
|
||||
telecom-cli config set api-token your-api-token
|
||||
|
||||
# Test connection
|
||||
telecom-cli health
|
||||
|
||||
# List subscribers
|
||||
telecom-cli subscribers list
|
||||
```
|
||||
|
||||
### Interactive Dashboard
|
||||
```bash
|
||||
# Launch the interactive dashboard
|
||||
telecom-cli dashboard
|
||||
```
|
||||
|
||||
## Commands Reference
|
||||
|
||||
### Global Options
|
||||
|
||||
| Option | Short | Description |
|
||||
|--------|-------|-------------|
|
||||
| `--help` | `-h` | Show help for command |
|
||||
| `--version` | `-v` | Show version information |
|
||||
| `--verbose` | `-V` | Enable verbose output |
|
||||
| `--no-color` | | Disable colored output |
|
||||
| `--format` | `-f` | Output format (table, json, csv) |
|
||||
| `--profile` | `-p` | Use specific profile |
|
||||
|
||||
### Configuration
|
||||
|
||||
#### `config`
|
||||
Manage CLI configuration and profiles.
|
||||
|
||||
```bash
|
||||
# Show current configuration
|
||||
telecom-cli config show
|
||||
|
||||
# Set configuration values
|
||||
telecom-cli config set api-endpoint http://api.telecom.local
|
||||
telecom-cli config set api-token your-token
|
||||
telecom-cli config set timeout 30
|
||||
|
||||
# Get configuration values
|
||||
telecom-cli config get api-endpoint
|
||||
|
||||
# List all profiles
|
||||
telecom-cli config profiles list
|
||||
|
||||
# Create new profile
|
||||
telecom-cli config profiles create production
|
||||
telecom-cli config profiles set production.api-endpoint https://api.telecom.com
|
||||
|
||||
# Switch profiles
|
||||
telecom-cli config profiles use production
|
||||
|
||||
# Delete profile
|
||||
telecom-cli config profiles delete staging
|
||||
```
|
||||
|
||||
#### Configuration Options
|
||||
|
||||
| Option | Description | Default |
|
||||
|--------|-------------|---------|
|
||||
| `api-endpoint` | API server URL | `http://localhost:8000` |
|
||||
| `api-token` | Authentication token | `""` |
|
||||
| `timeout` | Request timeout in seconds | `30` |
|
||||
| `theme` | UI theme | `default` |
|
||||
| `colors` | Enable colored output | `true` |
|
||||
| `pager` | Use pager for long output | `true` |
|
||||
|
||||
### Subscribers
|
||||
|
||||
#### `subscribers`
|
||||
Manage platform subscribers.
|
||||
|
||||
```bash
|
||||
# List all subscribers
|
||||
telecom-cli subscribers list
|
||||
|
||||
# List with filters
|
||||
telecom-cli subscribers list --status active
|
||||
telecom-cli subscribers list --limit 10
|
||||
telecom-cli subscribers list --format json
|
||||
|
||||
# Show subscriber details
|
||||
telecom-cli subscribers show 123
|
||||
|
||||
# Create new subscriber
|
||||
telecom-cli subscribers create \
|
||||
--name "John Doe" \
|
||||
--email "[email protected]" \
|
||||
--phone "+1234567890"
|
||||
|
||||
# Update subscriber
|
||||
telecom-cli subscribers update 123 \
|
||||
--name "John Smith" \
|
||||
--email "[email protected]"
|
||||
|
||||
# Delete subscriber
|
||||
telecom-cli subscribers delete 123
|
||||
|
||||
# Enhanced listing with styling
|
||||
telecom-cli subscribers list --enhanced
|
||||
```
|
||||
|
||||
#### Subscriber Fields
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
|-------|------|----------|-------------|
|
||||
| `name` | string | Yes | Subscriber name |
|
||||
| `email` | string | Yes | Email address |
|
||||
| `phone` | string | Yes | Phone number |
|
||||
| `status` | string | No | Account status (active, inactive, suspended) |
|
||||
| `balance` | float | No | Current balance |
|
||||
|
||||
### Services
|
||||
|
||||
#### `services`
|
||||
Monitor and manage platform services.
|
||||
|
||||
```bash
|
||||
# List all services
|
||||
telecom-cli services list
|
||||
|
||||
# Show service details
|
||||
telecom-cli services show api-server
|
||||
|
||||
# Enhanced service monitoring
|
||||
telecom-cli services list --enhanced
|
||||
|
||||
# Service health check
|
||||
telecom-cli services health
|
||||
|
||||
# Service metrics
|
||||
telecom-cli services metrics --service api-server
|
||||
|
||||
# Restart service
|
||||
telecom-cli services restart api-server
|
||||
```
|
||||
|
||||
#### Service Status
|
||||
|
||||
| Status | Description |
|
||||
|--------|-------------|
|
||||
| `running` | Service is operational |
|
||||
| `stopped` | Service is not running |
|
||||
| `degraded` | Service is running with issues |
|
||||
| `maintenance` | Service is under maintenance |
|
||||
|
||||
### Billing
|
||||
|
||||
#### `billing`
|
||||
Manage billing operations and invoices.
|
||||
|
||||
```bash
|
||||
# List invoices
|
||||
telecom-cli billing invoices
|
||||
|
||||
# Show invoice details
|
||||
telecom-cli billing invoices show INV-001
|
||||
|
||||
# Generate invoice
|
||||
telecom-cli billing generate --subscriber 123 --amount 100.50
|
||||
|
||||
# Process payment
|
||||
telecom-cli billing pay INV-001 --method credit_card
|
||||
|
||||
# Billing reports
|
||||
telecom-cli billing reports --month 2023-12
|
||||
telecom-cli billing reports --subscriber 123 --year 2023
|
||||
|
||||
# Enhanced billing view
|
||||
telecom-cli billing invoices --enhanced
|
||||
```
|
||||
|
||||
#### Payment Methods
|
||||
|
||||
| Method | Description |
|
||||
|--------|-------------|
|
||||
| `credit_card` | Credit card payment |
|
||||
| `bank_transfer` | Bank transfer |
|
||||
| `paypal` | PayPal payment |
|
||||
| `crypto` | Cryptocurrency payment |
|
||||
|
||||
### Monitoring
|
||||
|
||||
#### `monitoring`
|
||||
Real-time monitoring and metrics.
|
||||
|
||||
```bash
|
||||
# System health
|
||||
telecom-cli monitoring health
|
||||
|
||||
# Service metrics
|
||||
telecom-cli monitoring metrics --service api-server
|
||||
|
||||
# Resource usage
|
||||
telecom-cli monitoring resources
|
||||
|
||||
# Alert status
|
||||
telecom-cli monitoring alerts
|
||||
|
||||
# Logs
|
||||
telecom-cli monitoring logs --service api-server --tail 100
|
||||
|
||||
# Real-time monitoring
|
||||
telecom-cli monitoring watch --refresh 5
|
||||
```
|
||||
|
||||
#### Metrics Categories
|
||||
|
||||
| Category | Description |
|
||||
|----------|-------------|
|
||||
| `cpu` | CPU usage percentage |
|
||||
| `memory` | Memory usage in MB |
|
||||
| `network` | Network I/O |
|
||||
| `storage` | Disk usage |
|
||||
| `requests` | HTTP request metrics |
|
||||
| `errors` | Error rates |
|
||||
|
||||
### Deployment
|
||||
|
||||
#### `deploy`
|
||||
Deploy and manage platform deployments.
|
||||
|
||||
```bash
|
||||
# Deploy to environment
|
||||
telecom-cli deploy --environment staging
|
||||
|
||||
# Check deployment status
|
||||
telecom-cli deploy status --environment staging
|
||||
|
||||
# Rollback deployment
|
||||
telecom-cli deploy rollback --environment staging --version v1.0.1
|
||||
|
||||
# List deployments
|
||||
telecom-cli deploy list
|
||||
|
||||
# Deployment history
|
||||
telecom-cli deploy history --environment production
|
||||
```
|
||||
|
||||
### Dashboard
|
||||
|
||||
#### `dashboard`
|
||||
Launch interactive TUI dashboard.
|
||||
|
||||
```bash
|
||||
# Start dashboard
|
||||
telecom-cli dashboard
|
||||
|
||||
# Dashboard with specific theme
|
||||
telecom-cli dashboard --theme dark
|
||||
|
||||
# Dashboard with auto-refresh
|
||||
telecom-cli dashboard --refresh 10
|
||||
```
|
||||
|
||||
#### Dashboard Features
|
||||
|
||||
- **Service Status**: Real-time service health
|
||||
- **Metrics Charts**: CPU, memory, and network usage
|
||||
- **Subscriber Overview**: Active subscribers and statistics
|
||||
- **Billing Summary**: Revenue and payment status
|
||||
- **Logs Viewer**: Real-time log streaming
|
||||
- **Alerts Panel**: Active alerts and notifications
|
||||
|
||||
## Output Formats
|
||||
|
||||
### Table Format (Default)
|
||||
```bash
|
||||
telecom-cli subscribers list
|
||||
```
|
||||
```
|
||||
+----+------------+-------------------+--------------+--------+
|
||||
| ID | Name | Email | Phone | Status |
|
||||
+----+------------+-------------------+--------------+--------+
|
||||
| 1 | John Doe | [email protected] | +1234567890 | active |
|
||||
| 2 | Jane Smith | [email protected] | +0987654321 | active |
|
||||
+----+------------+-------------------+--------------+--------+
|
||||
```
|
||||
|
||||
### JSON Format
|
||||
```bash
|
||||
telecom-cli subscribers list --format json
|
||||
```
|
||||
```json
|
||||
{
|
||||
"subscribers": [
|
||||
{
|
||||
"id": 1,
|
||||
"name": "John Doe",
|
||||
"email": "[email protected]",
|
||||
"phone": "+1234567890",
|
||||
"status": "active",
|
||||
"balance": 100.50
|
||||
}
|
||||
],
|
||||
"total": 1
|
||||
}
|
||||
```
|
||||
|
||||
### CSV Format
|
||||
```bash
|
||||
telecom-cli subscribers list --format csv
|
||||
```
|
||||
```csv
|
||||
id,name,email,phone,status,balance
|
||||
1,John Doe,[email protected],+1234567890,active,100.50
|
||||
```
|
||||
|
||||
## Profiles
|
||||
|
||||
### Profile Management
|
||||
|
||||
Profiles allow you to switch between different configurations (development, staging, production).
|
||||
|
||||
```bash
|
||||
# Create production profile
|
||||
telecom-cli config profiles create production
|
||||
telecom-cli config profiles set production.api-endpoint https://api.telecom.com
|
||||
telecom-cli config profiles set production.api-token prod-token
|
||||
|
||||
# Switch to production profile
|
||||
telecom-cli config profiles use production
|
||||
|
||||
# List profiles
|
||||
telecom-cli config profiles list
|
||||
```
|
||||
|
||||
### Profile Structure
|
||||
|
||||
```yaml
|
||||
production:
|
||||
api:
|
||||
endpoint: https://api.telecom.com
|
||||
token: prod-token
|
||||
timeout: 60
|
||||
ui:
|
||||
theme: dark
|
||||
colors: true
|
||||
pager: false
|
||||
logging:
|
||||
level: warn
|
||||
format: json
|
||||
```
|
||||
|
||||
## Themes
|
||||
|
||||
### Available Themes
|
||||
|
||||
| Theme | Description |
|
||||
|-------|-------------|
|
||||
| `default` | Standard terminal colors |
|
||||
| `dark` | Dark theme for better contrast |
|
||||
| `light` | Light theme for bright terminals |
|
||||
| `minimal` | Minimal styling without colors |
|
||||
|
||||
### Custom Themes
|
||||
|
||||
Create custom themes by modifying the configuration:
|
||||
|
||||
```bash
|
||||
telecom-cli config set ui.theme custom
|
||||
telecom-cli config set ui.colors.primary blue
|
||||
telecom-cli config set ui.colors.success green
|
||||
telecom-cli config set ui.colors.error red
|
||||
```
|
||||
|
||||
## Plugins
|
||||
|
||||
### Installing Plugins
|
||||
|
||||
```bash
|
||||
# Install plugin from repository
|
||||
telecom-cli plugins install telecom-cli-aws
|
||||
|
||||
# Install from local file
|
||||
telecom-cli plugins install ./custom-plugin.so
|
||||
|
||||
# List installed plugins
|
||||
telecom-cli plugins list
|
||||
|
||||
# Enable/disable plugins
|
||||
telecom-cli plugins enable aws
|
||||
telecom-cli plugins disable aws
|
||||
```
|
||||
|
||||
### Creating Plugins
|
||||
|
||||
Create custom plugins using the plugin API:
|
||||
|
||||
```go
|
||||
package main
|
||||
|
||||
import (
|
||||
"github.com/nutcas3/telecom-platform/apps/cli/internal/plugin"
|
||||
)
|
||||
|
||||
type AWSPlugin struct{}
|
||||
|
||||
func (p *AWSPlugin) Name() string {
|
||||
return "aws"
|
||||
}
|
||||
|
||||
func (p *AWSPlugin) Commands() []plugin.Command {
|
||||
return []plugin.Command{
|
||||
{
|
||||
Name: "deploy",
|
||||
Description: "Deploy to AWS",
|
||||
Handler: p.deploy,
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
func (p *AWSPlugin) deploy(args []string) error {
|
||||
// Plugin implementation
|
||||
return nil
|
||||
}
|
||||
```
|
||||
|
||||
## Environment Variables
|
||||
|
||||
| Variable | Description | Default |
|
||||
|----------|-------------|---------|
|
||||
| `TELECOM_API_ENDPOINT` | API server URL | `""` |
|
||||
| `TELECOM_API_TOKEN` | Authentication token | `""` |
|
||||
| `TELECOM_CONFIG_FILE` | Configuration file path | `~/.telecom/config.yaml` |
|
||||
| `TELECOM_NO_COLOR` | Disable colors | `false` |
|
||||
| `TELECOM_VERBOSE` | Enable verbose output | `false` |
|
||||
|
||||
## Configuration File
|
||||
|
||||
The CLI configuration is stored in `~/.telecom/config.yaml`:
|
||||
|
||||
```yaml
|
||||
profiles:
|
||||
default:
|
||||
api:
|
||||
endpoint: http://localhost:8000
|
||||
token: ""
|
||||
timeout: 30
|
||||
ui:
|
||||
theme: default
|
||||
colors: true
|
||||
pager: true
|
||||
logging:
|
||||
level: info
|
||||
format: text
|
||||
|
||||
current_profile: default
|
||||
plugins:
|
||||
enabled: []
|
||||
disabled: []
|
||||
```
|
||||
|
||||
## Examples
|
||||
|
||||
### Common Workflows
|
||||
|
||||
#### 1. Daily Operations
|
||||
```bash
|
||||
# Check system health
|
||||
telecom-cli health
|
||||
|
||||
# Review new subscribers
|
||||
telecom-cli subscribers list --status new --enhanced
|
||||
|
||||
# Check service status
|
||||
telecom-cli services list --enhanced
|
||||
|
||||
# Review billing
|
||||
telecom-cli billing invoices --unpaid
|
||||
```
|
||||
|
||||
#### 2. Troubleshooting
|
||||
```bash
|
||||
# Check service logs
|
||||
telecom-cli monitoring logs --service api-server --tail 100
|
||||
|
||||
# View metrics
|
||||
telecom-cli monitoring metrics --service api-server
|
||||
|
||||
# Check system resources
|
||||
telecom-cli monitoring resources
|
||||
```
|
||||
|
||||
#### 3. Deployment
|
||||
```bash
|
||||
# Deploy to staging
|
||||
telecom-cli deploy --environment staging
|
||||
|
||||
# Monitor deployment
|
||||
telecom-cli deploy status --environment staging
|
||||
|
||||
# Check health after deployment
|
||||
telecom-cli health --environment staging
|
||||
```
|
||||
|
||||
### Advanced Usage
|
||||
|
||||
#### Batch Operations
|
||||
```bash
|
||||
# Export subscribers to CSV
|
||||
telecom-cli subscribers list --format csv > subscribers.csv
|
||||
|
||||
# Bulk update subscribers
|
||||
while read line; do
|
||||
telecom-cli subscribers update $line
|
||||
done < updates.txt
|
||||
```
|
||||
|
||||
#### Automation Scripts
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# health-check.sh
|
||||
|
||||
# Check system health
|
||||
if ! telecom-cli health; then
|
||||
echo "System unhealthy!" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Check critical services
|
||||
services=("api-server" "charging-engine" "packet-gateway")
|
||||
for service in "${services[@]}"; do
|
||||
if ! telecom-cli services show $service | grep -q "running"; then
|
||||
echo "Service $service not running!" >&2
|
||||
exit 1
|
||||
fi
|
||||
done
|
||||
|
||||
echo "All systems healthy"
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
#### Connection Issues
|
||||
```bash
|
||||
# Check API endpoint
|
||||
telecom-cli config get api-endpoint
|
||||
|
||||
# Test connection
|
||||
telecom-cli health --verbose
|
||||
|
||||
# Check timeout settings
|
||||
telecom-cli config get timeout
|
||||
```
|
||||
|
||||
#### Authentication Issues
|
||||
```bash
|
||||
# Verify API token
|
||||
telecom-cli config get api-token
|
||||
|
||||
# Test with different token
|
||||
TELECOM_API_TOKEN=new-token telecom-cli health
|
||||
```
|
||||
|
||||
#### Performance Issues
|
||||
```bash
|
||||
# Check response times
|
||||
telecom-cli health --verbose
|
||||
|
||||
# Use JSON format for faster processing
|
||||
telecom-cli subscribers list --format json
|
||||
```
|
||||
|
||||
### Debug Mode
|
||||
|
||||
Enable debug mode for detailed troubleshooting:
|
||||
|
||||
```bash
|
||||
# Enable verbose output
|
||||
telecom-cli --verbose subscribers list
|
||||
|
||||
# Set debug log level
|
||||
telecom-cli config set logging.level debug
|
||||
|
||||
# Enable request tracing
|
||||
telecom-cli config set api.trace true
|
||||
```
|
||||
|
||||
## Contributing
|
||||
|
||||
### Development Setup
|
||||
|
||||
```bash
|
||||
# Clone repository
|
||||
git clone https://github.com/nutcas3/telecom-platform.git
|
||||
cd telecom-platform/apps/cli
|
||||
|
||||
# Install dependencies
|
||||
go mod download
|
||||
|
||||
# Run tests
|
||||
go test ./...
|
||||
|
||||
# Build development version
|
||||
go build -o telecom-cli main.go
|
||||
```
|
||||
|
||||
### Running Tests
|
||||
|
||||
```bash
|
||||
# Run all tests
|
||||
go test ./...
|
||||
|
||||
# Run integration tests
|
||||
go test ./tests/... -v
|
||||
|
||||
# Run benchmarks
|
||||
go test ./tests/... -bench=.
|
||||
|
||||
# Test coverage
|
||||
go test ./... -cover
|
||||
```
|
||||
|
||||
### Code Style
|
||||
|
||||
The project uses the standard Go formatting tools:
|
||||
|
||||
```bash
|
||||
# Format code
|
||||
go fmt ./...
|
||||
|
||||
# Run linter
|
||||
golangci-lint run
|
||||
|
||||
# Run static analysis
|
||||
go vet ./...
|
||||
```
|
||||
|
||||
## Support
|
||||
|
||||
- **Documentation**: [https://docs.telecom-platform.com](https://docs.telecom-platform.com)
|
||||
- **Issues**: [GitHub Issues](https://github.com/nutcas3/telecom-platform/issues)
|
||||
- **Discussions**: [GitHub Discussions](https://github.com/nutcas3/telecom-platform/discussions)
|
||||
- **Community**: [Discord Server](https://discord.gg/telecom-platform)
|
||||
|
||||
## License
|
||||
|
||||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
||||
|
||||
## Changelog
|
||||
|
||||
### v1.0.0 (2023-12-01)
|
||||
- Initial release
|
||||
- Core subscriber and service management
|
||||
- Enhanced UI with Bubbletea
|
||||
- Multi-format output support
|
||||
- Profile management
|
||||
- Plugin system
|
||||
- Interactive dashboard
|
||||
|
||||
### v1.1.0 (2023-12-15)
|
||||
- Added billing commands
|
||||
- Enhanced monitoring features
|
||||
- Improved error handling
|
||||
- Performance optimizations
|
||||
|
||||
### v1.2.0 (2024-01-01)
|
||||
- Added deployment commands
|
||||
- Enhanced plugin system
|
||||
- New themes and styling options
|
||||
- Better configuration management
|
||||
+246
-42
@@ -8,7 +8,7 @@ import (
|
||||
"net/http"
|
||||
"time"
|
||||
|
||||
"github.com/nutcas3/telecom-platform/apps/cli/internal/config"
|
||||
"github.com/nutcas3/telecom-platform/apps/cli/internal/types"
|
||||
)
|
||||
|
||||
// Client represents the API client for the telecom platform
|
||||
@@ -18,8 +18,11 @@ type Client struct {
|
||||
httpClient *http.Client
|
||||
}
|
||||
|
||||
// NewClient creates a new API client
|
||||
func NewClient(cfg *config.Config) *Client {
|
||||
// NewClient creates a new API client from CLI config
|
||||
func NewClient(cfg *types.CLIConfig) *Client {
|
||||
if cfg == nil {
|
||||
cfg = &types.CLIConfig{APIEndpoint: "http://localhost:8000"}
|
||||
}
|
||||
return &Client{
|
||||
baseURL: cfg.APIEndpoint,
|
||||
apiKey: cfg.APIToken,
|
||||
@@ -29,27 +32,228 @@ func NewClient(cfg *config.Config) *Client {
|
||||
}
|
||||
}
|
||||
|
||||
// doGetJSON performs a GET request and decodes JSON into out
|
||||
func (c *Client) doGetJSON(path string, out any) error {
|
||||
req, err := http.NewRequest("GET", c.baseURL+path, nil)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if c.apiKey != "" {
|
||||
req.Header.Set("Authorization", "Bearer "+c.apiKey)
|
||||
}
|
||||
req.Header.Set("Content-Type", "application/json")
|
||||
resp, err := c.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
if resp.StatusCode >= 400 {
|
||||
body, _ := io.ReadAll(resp.Body)
|
||||
return fmt.Errorf("API %s %d: %s", path, resp.StatusCode, string(body))
|
||||
}
|
||||
return json.NewDecoder(resp.Body).Decode(out)
|
||||
}
|
||||
|
||||
// doPostJSON performs a POST request with JSON body and decodes response
|
||||
func (c *Client) doPostJSON(path string, body any, out any) error {
|
||||
var buf *bytes.Buffer
|
||||
if body != nil {
|
||||
b, err := json.Marshal(body)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
buf = bytes.NewBuffer(b)
|
||||
} else {
|
||||
buf = bytes.NewBuffer(nil)
|
||||
}
|
||||
req, err := http.NewRequest("POST", c.baseURL+path, buf)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if c.apiKey != "" {
|
||||
req.Header.Set("Authorization", "Bearer "+c.apiKey)
|
||||
}
|
||||
req.Header.Set("Content-Type", "application/json")
|
||||
resp, err := c.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
if resp.StatusCode >= 400 {
|
||||
rb, _ := io.ReadAll(resp.Body)
|
||||
return fmt.Errorf("API %s %d: %s", path, resp.StatusCode, string(rb))
|
||||
}
|
||||
if out == nil {
|
||||
return nil
|
||||
}
|
||||
return json.NewDecoder(resp.Body).Decode(out)
|
||||
}
|
||||
|
||||
// doDelete performs a DELETE request
|
||||
func (c *Client) doDelete(path string) error {
|
||||
req, err := http.NewRequest("DELETE", c.baseURL+path, nil)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if c.apiKey != "" {
|
||||
req.Header.Set("Authorization", "Bearer "+c.apiKey)
|
||||
}
|
||||
resp, err := c.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
if resp.StatusCode >= 400 {
|
||||
body, _ := io.ReadAll(resp.Body)
|
||||
return fmt.Errorf("API %s %d: %s", path, resp.StatusCode, string(body))
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// SubscriberAccount holds account info
|
||||
type SubscriberAccount struct {
|
||||
IMSI string `json:"imsi"`
|
||||
Name string `json:"name"`
|
||||
Status string `json:"status"`
|
||||
Balance float64 `json:"balance"`
|
||||
}
|
||||
|
||||
// ListSubscribers retrieves subscribers
|
||||
func (c *Client) ListSubscribers() ([]SubscriberAccount, error) {
|
||||
var resp struct {
|
||||
Data []SubscriberAccount `json:"data"`
|
||||
}
|
||||
if err := c.doGetJSON("/api/v1/subscribers", &resp); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return resp.Data, nil
|
||||
}
|
||||
|
||||
// GetSubscriber retrieves a single subscriber
|
||||
func (c *Client) GetSubscriber(imsi string) (*SubscriberAccount, error) {
|
||||
var sub SubscriberAccount
|
||||
if err := c.doGetJSON("/api/v1/subscribers/"+imsi, &sub); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return &sub, nil
|
||||
}
|
||||
|
||||
// CreateSubscriber creates a subscriber
|
||||
func (c *Client) CreateSubscriber(imsi, name string) (*SubscriberAccount, error) {
|
||||
var sub SubscriberAccount
|
||||
body := map[string]string{"imsi": imsi, "name": name}
|
||||
if err := c.doPostJSON("/api/v1/subscribers", body, &sub); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return &sub, nil
|
||||
}
|
||||
|
||||
// DeleteSubscriber deletes a subscriber
|
||||
func (c *Client) DeleteSubscriber(imsi string) error {
|
||||
return c.doDelete("/api/v1/subscribers/" + imsi)
|
||||
}
|
||||
|
||||
// Service describes a platform service
|
||||
type Service struct {
|
||||
Name string `json:"name"`
|
||||
Status string `json:"status"`
|
||||
Version string `json:"version"`
|
||||
Uptime string `json:"uptime"`
|
||||
CPU float64 `json:"cpu"`
|
||||
Memory string `json:"memory"`
|
||||
}
|
||||
|
||||
// ListServices returns platform services
|
||||
func (c *Client) ListServices() ([]Service, error) {
|
||||
var resp struct {
|
||||
Data []Service `json:"data"`
|
||||
}
|
||||
if err := c.doGetJSON("/api/v1/services", &resp); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return resp.Data, nil
|
||||
}
|
||||
|
||||
// Alert represents a monitoring alert
|
||||
type Alert struct {
|
||||
ID string `json:"id"`
|
||||
Severity string `json:"severity"`
|
||||
Service string `json:"service"`
|
||||
Message string `json:"message"`
|
||||
Time time.Time `json:"time"`
|
||||
}
|
||||
|
||||
// ListAlerts returns alerts
|
||||
func (c *Client) ListAlerts() ([]Alert, error) {
|
||||
var resp struct {
|
||||
Data []Alert `json:"data"`
|
||||
}
|
||||
if err := c.doGetJSON("/api/v1/alerts", &resp); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return resp.Data, nil
|
||||
}
|
||||
|
||||
// SystemStats represents system health/metrics
|
||||
type SystemStats struct {
|
||||
ActiveSessions int `json:"active_sessions"`
|
||||
TotalAccounts int `json:"total_accounts"`
|
||||
BlockedUsers int `json:"blocked_users"`
|
||||
LowBalanceAlerts int `json:"low_balance_alerts"`
|
||||
CPUUsage float64 `json:"cpu_usage"`
|
||||
MemoryUsage float64 `json:"memory_usage"`
|
||||
Uptime string `json:"uptime"`
|
||||
}
|
||||
|
||||
// GetSystemStats retrieves system stats
|
||||
func (c *Client) GetSystemStats() (*SystemStats, error) {
|
||||
var stats SystemStats
|
||||
if err := c.doGetJSON("/api/v1/system/stats", &stats); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return &stats, nil
|
||||
}
|
||||
|
||||
// HealthStatus represents a health check result
|
||||
type HealthStatus struct {
|
||||
Service string `json:"service"`
|
||||
Status string `json:"status"`
|
||||
Uptime string `json:"uptime"`
|
||||
LastCheck time.Time `json:"last_check"`
|
||||
}
|
||||
|
||||
// GetHealth returns per-service health
|
||||
func (c *Client) GetHealth() ([]HealthStatus, error) {
|
||||
var resp struct {
|
||||
Data []HealthStatus `json:"data"`
|
||||
}
|
||||
if err := c.doGetJSON("/api/v1/health", &resp); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return resp.Data, nil
|
||||
}
|
||||
|
||||
// Invoice represents an invoice from the API
|
||||
type Invoice struct {
|
||||
ID string `json:"id"`
|
||||
SubscriberID string `json:"subscriber_id"`
|
||||
Amount float64 `json:"amount"`
|
||||
Status string `json:"status"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
DueDate time.Time `json:"due_date"`
|
||||
ID string `json:"id"`
|
||||
SubscriberID string `json:"subscriber_id"`
|
||||
Amount float64 `json:"amount"`
|
||||
Status string `json:"status"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
DueDate time.Time `json:"due_date"`
|
||||
PaidAt *time.Time `json:"paid_at,omitempty"`
|
||||
Subscriber Subscriber `json:"subscriber"`
|
||||
}
|
||||
|
||||
// Payment represents a payment from the API
|
||||
type Payment struct {
|
||||
ID string `json:"id"`
|
||||
InvoiceID string `json:"invoice_id"`
|
||||
Amount float64 `json:"amount"`
|
||||
Method string `json:"method"`
|
||||
Status string `json:"status"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
ProcessedAt *time.Time `json:"processed_at,omitempty"`
|
||||
ID string `json:"id"`
|
||||
InvoiceID string `json:"invoice_id"`
|
||||
Amount float64 `json:"amount"`
|
||||
Method string `json:"method"`
|
||||
Status string `json:"status"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
ProcessedAt *time.Time `json:"processed_at,omitempty"`
|
||||
}
|
||||
|
||||
// Subscriber represents a subscriber from the API
|
||||
@@ -65,68 +269,68 @@ type Subscriber struct {
|
||||
// GetInvoices retrieves invoices from the API
|
||||
func (c *Client) GetInvoices() ([]Invoice, error) {
|
||||
url := fmt.Sprintf("%s/api/v1/invoices", c.baseURL)
|
||||
|
||||
|
||||
req, err := http.NewRequest("GET", url, nil)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to create request: %w", err)
|
||||
}
|
||||
|
||||
|
||||
req.Header.Set("Authorization", "Bearer "+c.apiKey)
|
||||
req.Header.Set("Content-Type", "application/json")
|
||||
|
||||
|
||||
resp, err := c.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to make request: %w", err)
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
|
||||
|
||||
if resp.StatusCode != http.StatusOK {
|
||||
body, _ := io.ReadAll(resp.Body)
|
||||
return nil, fmt.Errorf("API request failed with status %d: %s", resp.StatusCode, string(body))
|
||||
}
|
||||
|
||||
|
||||
var response struct {
|
||||
Data []Invoice `json:"data"`
|
||||
}
|
||||
|
||||
|
||||
if err := json.NewDecoder(resp.Body).Decode(&response); err != nil {
|
||||
return nil, fmt.Errorf("failed to decode response: %w", err)
|
||||
}
|
||||
|
||||
|
||||
return response.Data, nil
|
||||
}
|
||||
|
||||
// GetPayments retrieves payments from the API
|
||||
func (c *Client) GetPayments() ([]Payment, error) {
|
||||
url := fmt.Sprintf("%s/api/v1/payments", c.baseURL)
|
||||
|
||||
|
||||
req, err := http.NewRequest("GET", url, nil)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to create request: %w", err)
|
||||
}
|
||||
|
||||
|
||||
req.Header.Set("Authorization", "Bearer "+c.apiKey)
|
||||
req.Header.Set("Content-Type", "application/json")
|
||||
|
||||
|
||||
resp, err := c.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to make request: %w", err)
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
|
||||
|
||||
if resp.StatusCode != http.StatusOK {
|
||||
body, _ := io.ReadAll(resp.Body)
|
||||
return nil, fmt.Errorf("API request failed with status %d: %s", resp.StatusCode, string(body))
|
||||
}
|
||||
|
||||
|
||||
var response struct {
|
||||
Data []Payment `json:"data"`
|
||||
}
|
||||
|
||||
|
||||
if err := json.NewDecoder(resp.Body).Decode(&response); err != nil {
|
||||
return nil, fmt.Errorf("failed to decode response: %w", err)
|
||||
}
|
||||
|
||||
|
||||
return response.Data, nil
|
||||
}
|
||||
|
||||
@@ -147,59 +351,59 @@ type GenerateInvoiceResponse struct {
|
||||
// GenerateInvoice generates a new invoice for a subscriber
|
||||
func (c *Client) GenerateInvoice(subscriberID string) (*GenerateInvoiceResponse, error) {
|
||||
url := fmt.Sprintf("%s/api/v1/invoices/generate", c.baseURL)
|
||||
|
||||
|
||||
request := GenerateInvoiceRequest{
|
||||
SubscriberID: subscriberID,
|
||||
}
|
||||
|
||||
|
||||
jsonData, err := json.Marshal(request)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to marshal request: %w", err)
|
||||
}
|
||||
|
||||
|
||||
req, err := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to create request: %w", err)
|
||||
}
|
||||
|
||||
|
||||
req.Header.Set("Authorization", "Bearer "+c.apiKey)
|
||||
req.Header.Set("Content-Type", "application/json")
|
||||
|
||||
|
||||
resp, err := c.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("failed to make request: %w", err)
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
|
||||
|
||||
if resp.StatusCode != http.StatusCreated {
|
||||
body, _ := io.ReadAll(resp.Body)
|
||||
return nil, fmt.Errorf("API request failed with status %d: %s", resp.StatusCode, string(body))
|
||||
}
|
||||
|
||||
|
||||
var response GenerateInvoiceResponse
|
||||
if err := json.NewDecoder(resp.Body).Decode(&response); err != nil {
|
||||
return nil, fmt.Errorf("failed to decode response: %w", err)
|
||||
}
|
||||
|
||||
|
||||
return &response, nil
|
||||
}
|
||||
|
||||
// IsConnected checks if the API server is reachable
|
||||
func (c *Client) IsConnected() bool {
|
||||
url := fmt.Sprintf("%s/health", c.baseURL)
|
||||
|
||||
|
||||
req, err := http.NewRequest("GET", url, nil)
|
||||
if err != nil {
|
||||
return false
|
||||
}
|
||||
|
||||
|
||||
req.Header.Set("Authorization", "Bearer "+c.apiKey)
|
||||
|
||||
|
||||
resp, err := c.httpClient.Do(req)
|
||||
if err != nil {
|
||||
return false
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
|
||||
|
||||
return resp.StatusCode == http.StatusOK
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user