Skip to content

PavanAnganna90/OpsSight-DevOpsVisibilityPlatform-org

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

๐Ÿš€ OpsSight DevOps Visibility Platform

Enterprise-grade DevOps monitoring and visibility platform with real-time insights, advanced theming, and comprehensive infrastructure monitoring.

CI/CD Pipeline Security Scan Coverage License: MIT PRs Welcome

Next.js React TypeScript FastAPI Docker Kubernetes

โญ Star us on GitHub โ€ข ๐Ÿ“– Documentation โ€ข ๐Ÿ› Report Bug โ€ข ๐Ÿ’ก Request Feature โ€ข ๐Ÿ’ฌ Discord


๐Ÿ“‹ Table of Contents

๐ŸŽฏ Overview

OpsSight is a comprehensive DevOps visibility platform that provides real-time insights into CI/CD pipelines, infrastructure health, and development workflows. Built with modern technologies and best practices, OpsSight combines powerful monitoring capabilities with an advanced, accessible theme system to create a unified dashboard experience for DevOps teams.

Why OpsSight?

  • ๐Ÿ” Unified Visibility - Single pane of glass for all your DevOps metrics
  • โšก Real-time Monitoring - Live updates from CI/CD pipelines and infrastructure
  • ๐ŸŽจ Advanced Theming - 7 theme variants with WCAG 2.1 AA accessibility compliance
  • ๐Ÿš€ Production Ready - Enterprise-grade architecture with Kubernetes support
  • ๐Ÿ”’ Security First - Built with security best practices and compliance in mind
  • ๐Ÿ“ฑ Fully Responsive - Mobile-first design that works everywhere
  • ๐Ÿงฉ Extensible - Plugin architecture for custom integrations

โœจ Key Features

๐Ÿ” Core Platform Capabilities

Feature Description
๐Ÿ” GitHub OAuth Secure authentication with GitHub integration
๐Ÿ“Š Real-time Monitoring Live metrics from CI/CD pipelines and infrastructure
โ˜ธ๏ธ Kubernetes Monitoring Comprehensive cluster health and resource tracking
๐Ÿค– Ansible Tracking Monitor automation coverage and execution
๐Ÿ“ˆ Performance Analytics Detailed insights into system performance and trends
๐Ÿ”” Alert Integration Slack and webhook notifications for critical events

๐ŸŽจ Advanced Theme System

  • 7 Theme Variants: Minimal, neo-brutalist, glassmorphic, cyberpunk, editorial, accessible, dynamic
  • 4 Color Modes: Light, dark, high-contrast, and system preference
  • Contextual Themes: Default, focus, relax, and energize modes for different workflows
  • WCAG 2.1 AA Compliant: Full accessibility support with screen reader compatibility
  • Performance Optimized: Smooth transitions and efficient rendering
  • Persistent Preferences: User settings saved across sessions

๐Ÿ› ๏ธ Developer Experience

  • ๐Ÿ“š Comprehensive Documentation: Storybook integration with interactive component docs
  • ๐Ÿงช Extensive Testing: Unit, integration, and accessibility testing with >80% coverage
  • ๐Ÿ”ง TypeScript Support: Full type safety with comprehensive TSDoc comments
  • ๐ŸŽจ Design System: Consistent design tokens and reusable components
  • ๐Ÿ”„ Hot Reload: Fast development with instant feedback

๐Ÿ—๏ธ Architecture

System Architecture

graph TB
    subgraph "Frontend Layer"
        A[Next.js 15 + React 19] --> B[Tailwind CSS 4]
        A --> C[TanStack Query]
        A --> D[Storybook]
    end
    
    subgraph "Backend Layer"
        E[FastAPI] --> F[PostgreSQL]
        E --> G[Redis Cache]
        E --> H[JWT Auth]
    end
    
    subgraph "Infrastructure Layer"
        I[Kubernetes] --> J[AWS Services]
        I --> K[Prometheus]
        I --> L[Grafana]
    end
    
    subgraph "Integrations"
        M[GitHub API]
        N[Kubernetes API]
        O[Ansible]
        P[Slack Webhooks]
    end
    
    A --> E
    E --> M
    E --> N
    E --> O
    E --> P
    E --> I
    
    style A fill:#0070f3
    style E fill:#009688
    style I fill:#326ce5
Loading

Technology Stack

Frontend

  • Framework: Next.js 15 with React 19 and TypeScript 5
  • Styling: Tailwind CSS 4 with design tokens
  • State Management: React Context + TanStack Query
  • Testing: Jest + React Testing Library + Vitest + Playwright
  • Documentation: Storybook 9 with accessibility addon
  • Build Tool: Vite with Turbopack

Backend

  • Framework: FastAPI (Python 3.11+)
  • Database: PostgreSQL with asyncpg
  • Cache: Redis
  • Authentication: GitHub OAuth + JWT
  • API Integration: GitHub API, Kubernetes API, Ansible
  • Containerization: Docker + Docker Compose

Infrastructure

  • Cloud Provider: AWS
  • Container Orchestration: Kubernetes (EKS)
  • Monitoring: Prometheus + Grafana + AlertManager
  • CI/CD: GitHub Actions
  • Infrastructure as Code: Terraform
  • Helm Charts: Production-ready Helm charts included

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+ and npm 8+
  • Docker and Docker Compose
  • Python 3.11+ (for backend development)
  • Git

Installation

  1. Clone the repository:

    git clone https://github.com/pavan-official/Devops-app-dev-cursor.git
    cd Devops-app-dev-cursor
  2. Set up environment variables:

    # Copy environment templates
    cp .env.example .env
    cp frontend/.env.local.example frontend/.env.local
    
    # Configure your GitHub OAuth app credentials
    # See docs/getting-started/setup-guide.md for detailed instructions
  3. Start with Docker Compose (Recommended):

    docker-compose up -d
  4. Or run locally:

    # Install dependencies
    npm install
    npm run setup
    
    # Start frontend development server
    cd frontend && npm run dev
    
    # In another terminal, start backend
    cd backend
    pip install -r requirements.txt
    uvicorn app.main:app --reload
  5. Access the application:

Quick Demo

Launch the complete demo environment with realistic mock data:

# Full demo with mock data (recommended)
./scripts/demo-setup.sh

# Or quick start with Docker only
./scripts/quick-demo.sh

๐Ÿ“– Full Demo Guide - Complete testing scenarios and URLs

๐ŸŽฌ Showcase

Project Status

Status: โœ… Production Ready | Version: 2.1.0 | License: MIT

OpsSight is a fully functional, production-ready DevOps visibility platform. The project demonstrates enterprise-grade architecture, comprehensive testing, and professional development practices.

Key Highlights:

  • ๐Ÿ—๏ธ Microservices Architecture - Scalable, maintainable, production-ready
  • ๐Ÿงช >80% Test Coverage - Comprehensive unit, integration, and E2E tests
  • โ™ฟ WCAG 2.1 AA Compliant - Full accessibility support
  • ๐Ÿ”’ Security-First - Security best practices throughout
  • โšก Performance Optimized - Fast, efficient, and scalable
  • ๐Ÿ“š Well-Documented - Extensive documentation for users and contributors

Key Features Showcase

๐Ÿ” Authentication & Security

  • GitHub OAuth integration
  • Role-Based Access Control (RBAC)
  • Secure JWT token handling
  • Multi-factor authentication ready

๐Ÿ“Š Real-Time Monitoring

  • Live CI/CD pipeline status
  • Real-time Kubernetes cluster metrics
  • WebSocket-based updates
  • Customizable dashboards

๐ŸŽจ Advanced Theming

  • 7 theme variants
  • 4 color modes
  • WCAG 2.1 AA compliant
  • Contextual themes

โ˜ธ๏ธ Kubernetes Integration

  • Cluster health monitoring
  • Resource utilization tracking
  • Pod and node management
  • Multi-cluster support

๐Ÿค– Automation Tracking

  • Ansible playbook monitoring
  • Automation coverage tracking
  • Success rate analytics
  • Host reliability metrics

๐Ÿ”” Alert Management

  • Slack integration
  • Webhook support
  • Alert deduplication
  • Multi-channel routing

Performance Metrics

  • API Response Time: <200ms (p95)
  • Frontend Load Time: <3s Time to Interactive
  • Lighthouse Score: >90
  • Test Coverage: >80%
  • Bundle Size: Optimized with code splitting

Production Deployment

OpsSight is deployed and running in production environments with:

  • Kubernetes orchestration
  • Multi-environment support (dev, staging, production)
  • Automated CI/CD pipelines
  • Comprehensive monitoring and alerting
  • Security scanning and compliance

๐Ÿ“– View Project Highlights - Detailed technical achievements
๐Ÿ“– View Roadmap - Future features and direction

๐Ÿ“ Project Structure

opsight-devops-platform/
โ”œโ”€โ”€ frontend/                    # Next.js React application
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ components/         # Reusable UI components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ ui/            # Core UI components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ auth/          # Authentication components
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ dashboard/     # Dashboard-specific components
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ charts/        # Data visualization components
โ”‚   โ”‚   โ”œโ”€โ”€ pages/             # Next.js pages
โ”‚   โ”‚   โ”œโ”€โ”€ hooks/             # Custom React hooks
โ”‚   โ”‚   โ”œโ”€โ”€ contexts/          # React contexts (Auth, Theme, Settings)
โ”‚   โ”‚   โ”œโ”€โ”€ utils/             # Helper functions and utilities
โ”‚   โ”‚   โ”œโ”€โ”€ types/             # TypeScript type definitions
โ”‚   โ”‚   โ””โ”€โ”€ styles/            # Global styles and theme tokens
โ”‚   โ”œโ”€โ”€ stories/               # Storybook stories
โ”‚   โ””โ”€โ”€ tests/                 # Test files
โ”œโ”€โ”€ backend/                    # FastAPI Python application
โ”‚   โ”œโ”€โ”€ app/
โ”‚   โ”‚   โ”œโ”€โ”€ api/               # API routes and endpoints
โ”‚   โ”‚   โ”œโ”€โ”€ core/              # Core configuration and settings
โ”‚   โ”‚   โ”œโ”€โ”€ models/            # Database models
โ”‚   โ”‚   โ”œโ”€โ”€ services/          # Business logic and external integrations
โ”‚   โ”‚   โ””โ”€โ”€ tests/             # Backend test files
โ”‚   โ””โ”€โ”€ requirements.txt       # Python dependencies
โ”œโ”€โ”€ api-module/                 # Shared API client module
โ”œโ”€โ”€ infrastructure/            # Terraform and deployment configs
โ”œโ”€โ”€ k8s/                       # Kubernetes manifests
โ”œโ”€โ”€ helm/                      # Helm charts
โ”œโ”€โ”€ monitoring/                # Prometheus, Grafana configurations
โ”œโ”€โ”€ docs/                      # Additional documentation
โ”œโ”€โ”€ scripts/                   # Utility scripts
โ””โ”€โ”€ docker-compose.yml         # Local development environment

๐Ÿงช Development

Available Scripts

Frontend

cd frontend

# Development
npm run dev              # Start development server
npm run build           # Build for production
npm run start           # Start production server

# Testing
npm run test            # Run Jest tests
npm run test:watch      # Run tests in watch mode
npm run test:coverage   # Generate coverage report
npm run test:e2e        # Run Playwright E2E tests

# Code Quality
npm run lint            # Run ESLint
npm run lint:fix        # Fix ESLint issues
npm run format          # Format with Prettier
npm run type-check      # TypeScript type checking
npm run validate        # Run all quality checks

# Documentation
npm run storybook       # Start Storybook
npm run build-storybook # Build Storybook

Backend

cd backend

# Development
uvicorn app.main:app --reload    # Start development server
python -m pytest                # Run tests
python -m pytest --cov          # Run tests with coverage

# Code Quality
black .                          # Format code
isort .                          # Sort imports
flake8 .                        # Lint code
mypy .                          # Type checking

Testing Strategy

  • Unit Tests: Jest + React Testing Library for components
  • Integration Tests: API endpoint testing with FastAPI TestClient
  • E2E Tests: Playwright for end-to-end testing
  • Accessibility Tests: Automated a11y testing with axe-core
  • Visual Tests: Storybook visual regression testing
  • Performance Tests: Lighthouse CI for performance monitoring

Code Quality

  • TypeScript: Full type safety with strict mode enabled
  • ESLint: Comprehensive linting with React and accessibility rules
  • Prettier: Consistent code formatting
  • Husky: Pre-commit hooks for quality gates
  • TSDoc: Comprehensive documentation for all TypeScript code

๐Ÿ“š Documentation

๐Ÿ“‹ Project Status

Current Version: 2.1.0
Status: โœ… Production Ready
Maintenance: Active Development

Version Support

Version Status Support Until
2.1.x โœ… Active TBD
2.0.x โœ… Supported TBD
1.x.x โš ๏ธ Maintenance 2025-06-30

Development Status

  • โœ… Core Features: Complete and stable
  • โœ… Documentation: Comprehensive and up-to-date
  • โœ… Testing: >80% coverage with comprehensive test suite
  • โœ… Security: Regular audits and updates
  • ๐Ÿ”„ New Features: Active development (see Roadmap)

Community

  • ๐ŸŒŸ Stars: Growing community
  • ๐Ÿด Forks: Active contributors
  • ๐Ÿ› Issues: Responsive maintenance
  • ๐Ÿ’ฌ Discussions: Active community engagement

๐Ÿค Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, improving documentation, or helping with translations, your contributions make OpsSight better for everyone.

Quick Start for Contributors

  1. โญ Star the repository to show your support
  2. ๐Ÿด Fork the repository and clone your fork
  3. ๐Ÿ“– Read our Contributing Guide for detailed guidelines
  4. ๐Ÿท๏ธ Check Good First Issues for beginner-friendly tasks
  5. ๐Ÿ’ฌ Join our Discord to discuss ideas and get help

Ways to Contribute

  • ๐Ÿ› Report Bugs: Use our bug report template
  • โœจ Request Features: Use our feature request template
  • ๐Ÿ“ Improve Documentation: Help make our docs even better
  • ๐Ÿงช Add Tests: Increase test coverage and reliability
  • ๐ŸŒ Translations: Help make OpsSight accessible globally
  • ๐ŸŽจ UI/UX: Improve the user experience and design

Code Standards

  • Follow TypeScript best practices with strict mode
  • Write comprehensive tests (aim for >80% coverage)
  • Ensure accessibility compliance (WCAG 2.1 AA)
  • Document all public APIs with TSDoc comments
  • Follow the established file structure and naming conventions
  • Use Conventional Commits for commit messages

๐Ÿ”’ Security

We take security seriously. Please review our Security Policy before reporting security vulnerabilities.

โš ๏ธ Please do not report security vulnerabilities through public GitHub issues.

Instead, please report them via:

๐Ÿ† Contributors

Thanks to all our amazing contributors! ๐ŸŽ‰

Contributors

๐Ÿ’ฌ Community & Support

๐Ÿ†˜ Getting Help

๐ŸŒ Community Channels

  • Discord: Real-time chat and support
  • GitHub Discussions: Longer-form discussions and Q&A
  • Twitter: @OpsSightDev - Updates and announcements
  • LinkedIn: OpsSight Platform - Professional updates

๐Ÿ”” Stay Updated

  • โญ Star this repository to get notifications
  • ๐Ÿ‘€ Watch releases for new version notifications
  • ๐Ÿ“ง Subscribe to our newsletter at opssight.dev/newsletter
  • ๐Ÿฆ Follow us on Twitter @OpsSightDev

๐Ÿ“Š Project Stats

GitHub stars GitHub forks GitHub watchers

GitHub issues GitHub pull requests GitHub last commit GitHub contributors

โญ Star History

Star History Chart

๐Ÿ”— Related Projects

Check out these related projects in the DevOps ecosystem:

  • Backstage - Open platform for building developer portals
  • Grafana - Open source analytics & monitoring solution
  • Prometheus - Monitoring system & time series database
  • ArgoCD - Declarative GitOps continuous delivery tool
  • Tekton - Cloud native solution for building CI/CD systems

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


๐Ÿ† Project Highlights

OpsSight demonstrates enterprise-grade software development with:

  • Full-Stack Expertise: Modern frontend (React/Next.js) and backend (FastAPI/Python)
  • DevOps Mastery: Kubernetes, Docker, CI/CD, Infrastructure as Code
  • Quality Focus: Comprehensive testing, code quality, and documentation
  • Security Awareness: Security-first approach with best practices
  • Accessibility: WCAG 2.1 AA compliance throughout
  • Production Ready: Deployed and running in production environments

๐Ÿ“– View Detailed Project Highlights - Technical achievements and skills demonstrated


๐Ÿ—บ๏ธ Roadmap

Interested in what's coming next? Check out our Roadmap to see planned features and improvements.

Current Focus:

  • Enhanced multi-cloud support
  • Advanced analytics & ML
  • Improved developer experience
  • Enterprise features

๐Ÿ‘ฅ Authors & Contributors

See AUTHORS.md for a complete list of contributors.

Special Thanks:

  • All contributors who have helped improve OpsSight
  • The open-source community for inspiration and tools
  • Early adopters and beta testers for valuable feedback
MIT License

Copyright (c) 2025 OpsSight DevOps Platform

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

๐Ÿ™ Acknowledgments

We extend our gratitude to the amazing open-source community and the following projects that make OpsSight possible:

๐Ÿ—๏ธ Core Technologies

  • Next.js - The React framework for production
  • React - A JavaScript library for building user interfaces
  • TypeScript - Typed JavaScript at any scale
  • FastAPI - Modern, fast web framework for Python
  • PostgreSQL - Advanced open source database
  • Redis - In-memory data structure store

๐ŸŽจ UI & Design

๐Ÿงช Testing & Quality

๐Ÿ”ง DevOps & Infrastructure

๐ŸŒŸ Special Thanks

  • Contributors: All the amazing people who contribute code, documentation, and ideas
  • Community: Our Discord community for feedback and support
  • Beta Testers: Early adopters who help us improve the platform
  • Open Source: The entire open-source ecosystem that makes projects like this possible

๐Ÿš€ Ready to get started?

๐Ÿ“– Read the Docs โ€ข ๐ŸŽฎ Try the Demo โ€ข ๐Ÿ’ฌ Join Discord โ€ข ๐Ÿฆ Follow on Twitter

Made with โค๏ธ by the OpsSight team and contributors

โญ Star us on GitHub โ€” it motivates us a lot!

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors 2

  •  
  •