CloudOps Platform

A modular CloudOps dashboard featuring Azure, AWS, Kubernetes, Docker, CI/CD, monitoring, cost insights, and AI assistance.

---

📖 Overview

• ✅ Client and server test suites are passing
• 🔒 Integration test coverage includes auth login, refresh, and protected route access
• 🛠️ README includes dependency upgrade guidance and local dev workflows

🚀 Tech Stack

💻 Frontend

• ⚛️ React (UI Library)
• 📘 TypeScript (Language)
• ⚡ Vite (Build Tool)
• 🎨 Tailwind CSS (Styling)

⚙️ Backend

• 🟢 Node.js & 🚂 Express (Server)
• 🐘 PostgreSQL (Database)
• 💎 Prisma (ORM)
• 🔑 JWT (Authentication)

🐋 DevOps & Cloud

• 🐳 Docker & Docker Compose (Containerization)
• ☸️ Kubernetes (Orchestration)
• 🏗️ Terraform (Infrastructure as Code)
• 🐙 GitHub Actions (CI/CD pipelines)

🔌 Integrations (APIs)

• ☁️ AWS, Azure, Google Cloud Platform
• 🤖 OpenAI
• 📊 Grafana & Prometheus

📂 Project Layout

• 📁 client/ - React + TypeScript frontend
• 📁 server/ - Node.js + Express backend
• 📁 docker/ - Production and development container definitions
• 📁 kubernetes/ - Kubernetes manifests and examples
• 📁 terraform/ - Infrastructure scaffolding and templates
• 📁 .github/workflows/ - CI/CD automation

⚡ Quick Start

1️⃣ Install Dependencies

cd client && npm install
cd server && npm install

2️⃣ Run the Backend

cd server && npm run dev

3️⃣ Run the Frontend

cd client && npm run dev

4️⃣ Open the App

• 🌐 Frontend: http://localhost:5173
• 🔌 Backend: http://localhost:4000

🐳 Local Docker Development

Use the existing docker-compose.override.yml for local development with mounted source code.

Start the stack:

docker compose up --build

Stop the stack:

docker compose down --remove-orphans

🧪 Testing

🖥️ Server Tests

• Run: cd server && npm test
• Watch mode: cd server && npm run test:watch

📱 Client Tests

• Run: cd client && npm test
• Watch mode: cd client && npm run test:watch

🏭 Production Build

💻 Local Production Build

1. Build frontend: cd client && npm install && npm run build
2. Build backend: cd server && npm install && npm run build
3. Run backend: cd server && npm start

🚢 Docker Production

1. Copy example env file: cp server/.env.example server/.env
2. Build and start: docker compose --env-file server/.env -f docker-compose.prod.yml up --build
3. Verify health: http://localhost:4000/api/health
4. Stop and clean up: docker compose -f docker-compose.prod.yml down --remove-orphans

🔐 Required Environment Variables

Ensure the following variables are set in your .env file:

• 🗄️ DATABASE_URL
• 🔑 JWT_SECRET
• 🌍 CORS_ORIGIN
• 🐙 GITHUB_REPOSITORY (optional)
• 🪙 GITHUB_TOKEN (optional)

🧩 Project Modules

• 📊 Dashboard
• 🛡️ Authentication
• 👥 User Management
• 🟦 Azure Resource Manager
• 🟧 AWS Resource Manager
• ☸️ Kubernetes Dashboard
• 🐳 Docker Manager
• 🔄 CI/CD Pipeline
• 📈 Monitoring
• 💰 Cloud Cost Optimizer
• 🏗️ Infrastructure Generator
• 🤖 AI DevOps Assistant
• 🔔 Notifications
• ⚙️ Admin Panel

📝 Changelog

• v0.1.0 - Added local dev and production guides, stable client and server test coverage, and dependency upgrade guidance.
• v0.1.1 - Added auth flow integration test and README status badges.

💡 Notes

• 🔄 docker-compose.override.yml is included for local development and automatically enables mounted source code for fast iterations.
• 🏥 The backend exposes a health endpoint at /api/health.
• 🏗️ The app is designed for local development with a separate frontend and backend stack.