OpsMastery.v5

OpsMastery.v5 is a modular, production-ready platform for real-time chat, video/audio calling (WebRTC), and RESTful business operations. It is built in Go, uses JWT authentication, and is designed for easy integration with modern frontends (e.g., Next.js).

Project Structure

OpsMastery.v5/
├── cmd/
│   ├── api/                # Main REST API server (users, tickets, auth, etc.)
│   ├── chat-service/       # Real-time chat microservice (WebSocket)
│   └── webrtc-service/     # WebRTC signaling microservice (WebSocket)
├── internal/
│   ├── chat_service/       # Chat logic
│   ├── webrtc_service/     # WebRTC signaling logic
│   ├── handlers/           # REST API handlers
│   ├── models/             # Data models
│   ├── database/           # DB connection and migrations
│   ├── middleware/         # JWT and role middleware
│   ├── server/             # REST API server setup
│   └── utils/              # Utility functions (JWT, email, etc.)
├── docker-compose.yml      # Multi-service orchestration
├── Dockerfile*             # Dockerfiles for each service
├── go.mod, go.sum          # Go module files
└── README.md

Services Overview

1. REST API (cmd/api)

• Handles authentication, user management, tickets, and other business logic.
• JWT-secured endpoints.
• Integrates with PostgreSQL.

2. Chat Service (cmd/chat-service)

• Real-time chat via WebSocket.
• JWT authentication for all connections.
• Broadcasts messages to all connected clients.
• Persists chat messages in the database.

3. WebRTC Signaling Service (cmd/webrtc-service)

• Handles signaling for video/audio calls (SDP/ICE exchange).
• JWT authentication for all connections.
• Designed for integration with WebRTC clients (e.g., browser, mobile).

Frontend Integration

• Designed to be consumed by any modern frontend (e.g., Next.js).
• REST API: Use fetch/axios with JWT in cookies or headers.
• Chat/WebRTC: Connect via WebSocket with JWT as a query param.

Getting Started

Prerequisites

• Go >= 1.20
• Docker
• Node.js (for frontend, optional)

Clone the Repository

git clone https://github.com/gibbyDev/OpsMastery.v5.git
cd OpsMastery.v5

Running with Docker Compose

docker compose up --build

• This will start the REST API, chat service, WebRTC signaling service, and PostgreSQL database.
• Services are exposed on:
  • REST API: http://localhost:8080
  • Chat: ws://localhost:5000/ws
  • WebRTC: ws://localhost:4000/ws

Running Locally (without Docker)

1. Start PostgreSQL (see docker-compose.yml for env vars).
2. Run each service in a separate terminal:

   go run cmd/api/main.go
   go run cmd/chat-service/main.go
   go run cmd/webrtc-service/main.go
   

Environment Variables

• See .env.example or docker-compose.yml for required variables (DB connection, JWT secret, etc.).

Development & Testing

• All code is in Go, organized for easy extension.
• Unit and integration tests are in internal/*/tests.
• Frontend integration examples available upon request.

Contributing

Pull requests and issues are welcome! Please open an issue for major changes.

License

MIT

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

MakeFile

Run build make command with tests

make all

Build the application

make build

Run the application

make run

Create DB container

make docker-run

Run API locally with live reload while only starting Postgres in Docker:

make dev-local

Shutdown DB Container

make docker-down

Stop only the Postgres container:

make db-down

DB Integrations Test:

make itest

Live reload the application:

make watch

Run the test suite:

make test

Clean up binary from the last build:

make clean