discord-enterprise

module
v0.0.0-...-8acb625 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 25, 2026 License: MIT

README ΒΆ

Discord Enterprise App

License Go Gin TypeScript Next.js React Prisma PostgreSQL Discord

Complete Full-Stack Enterprise Orchestration Platform β€” Discord Bot, Web Dashboard, CLI Console, Email Suite, and Infrastructure Management

A next-generation enterprise management platform featuring a Discord bot for guild administration, a Next.js web dashboard, a Go Gin REST API, a PostgreSQL-backed email suite (IMAP/SMTP/POP3), an OPNsense-style CLI console (vaultctl), and a comprehensive infrastructure stack β€” all unified in a pnpm monorepo.

πŸš€ Quick Start β€’ πŸ“‹ What's New β€’ πŸ“Š Current Status β€’ πŸ› οΈ Tech Stack β€’ πŸ“ Architecture β€’ 🀝 Contributing

GitHub stars GitHub forks GitHub issues


🌟 What is Discord Enterprise?

Discord Enterprise is a full-stack, multi-platform orchestration platform built by Sky Genesis Enterprise. It unifies Discord guild management, web administration, API services, email infrastructure, CLI system administration, and enterprise deployment β€” all within a single monorepo.

🎯 Vision
  • πŸ€– Discord Bot β€” Slash-command driven guild management with discord.js v14
  • 🌐 Web Dashboard β€” Next.js 16 + React 19 with shadcn/ui, i18n, and Fumadocs documentation
  • βš™οΈ Go REST API β€” High-performance Gin framework backend with GORM + PostgreSQL
  • πŸ“§ Email Suite β€” Complete IMAP/SMTP/POP3 stack with OAuth (Google, Microsoft, Proton)
  • πŸ–₯️ CLI Console (vaultctl) β€” OPNsense-style interactive system management for Linux appliances
  • πŸ—οΈ Enterprise Infrastructure β€” Docker, Kubernetes, Terraform, Redis, Prometheus/Grafana
  • πŸ” Enterprise Security β€” JWT auth, OAuth, RBAC, rate limiting, audit logging, MFA
  • πŸ“š Comprehensive Docs β€” Fumadocs MDX documentation with OpenAPI specs and i18n

πŸ†• What's New

🎯 Major Features
πŸ€– Discord Bot (NEW)
  • βœ… Slash commands: about, help, ping, rules, serverinfo, status, userinfo
  • βœ… Event handling: ready, interactionCreate
  • βœ… Automatic guild command deployment
  • βœ… ESM JavaScript architecture with discord.js v14
πŸ–₯️ vaultctl CLI Console (NEW)
  • βœ… OPNsense-style interactive menu system
  • βœ… System management: status, shutdown, reboot, info
  • βœ… Service management with systemd integration
  • βœ… Network management: interfaces, IP config, ping diagnostics
  • βœ… Security: user management, SSH keys, audit logs
  • βœ… Maintenance: backup, update, cleanup, integrity checks
  • βœ… Vault integration: status, tokens, seal/unseal
  • βœ… PAM authentication and SSH integration
πŸ“§ Email Suite (NEW)
  • βœ… Full IMAP (993), SMTP (587), POP3 (995) implementation
  • βœ… Stalwart mail server integration
  • βœ… OAuth providers: Google, Microsoft, Proton
  • βœ… Complete email database schema: MailAccounts, Mailboxes, Threads, Emails, Recipients, Attachments
πŸ—οΈ Enhanced Architecture (IMPROVED)
  • βœ… pnpm monorepo with 11 workspace packages
  • βœ… Go 1.25 + Gin 1.11 backend with GORM + PostgreSQL
  • βœ… Next.js 16 + React 19 with App Router and TypeScript 6
  • βœ… Prisma 7 schema as source of truth (45+ models, 1267 lines)
  • βœ… Docker Compose with 4 services (postgres, api, bot, web)
  • βœ… 17 GitHub Actions CI/CD workflows
  • βœ… Multi-stage Docker builds + Kubernetes manifests + Terraform

πŸ“Š Current Status

βœ… Active Development: From foundation to full enterprise orchestration platform.

βœ… Currently Implemented
πŸ€– Discord Bot
  • βœ… Slash command framework with deployment scripts
  • βœ… Guild information and moderation commands
  • βœ… Event-driven architecture
  • βœ… Docker container support
🌐 Web Dashboard
  • βœ… Next.js 16 with App Router and TypeScript strict mode
  • βœ… shadcn/ui component library with 30+ Radix primitives
  • βœ… Multi-language i18n support (next-intl)
  • βœ… Authentication flow: login, register, MFA, OAuth callbacks
  • βœ… Fumadocs documentation system with MDX and OpenAPI
  • βœ… Theme system (dark/light with next-themes)
  • βœ… Responsive layout with mobile support
  • βœ… Route-based auth protection (AuthGuard, ProtectedRoute)
βš™οΈ Go REST API
  • βœ… Full REST API at /api/v1/ with 20+ resource endpoints
  • βœ… CRUD for: categories, media, pages, dossiers, services, users, API keys, webhooks, newsletters
  • βœ… Status/incident/maintenance management
  • βœ… Public endpoints: contact, newsletter, status, pages
  • βœ… JWT authentication with OAuth (Google, Microsoft, Proton)
  • βœ… Rate limiting, CORS, security headers, CSRF protection
  • βœ… Analytics, audit logging, notifications, scheduling
  • βœ… Full-text search and file attachments
  • βœ… Calendar, meetings, todos services
πŸ–₯️ vaultctl CLI Console
  • βœ… Interactive menu system with ASCII banners
  • βœ… System, service, network, security, maintenance actions
  • βœ… PAM authentication and session management
  • βœ… Systemd integration and MOTD replacement
  • βœ… Multi-stage Docker build
πŸ—„οΈ Database
  • βœ… Prisma schema with 45+ models (users, orgs, email, CMS, calendar, etc.)
  • βœ… GORM integration for Go runtime
  • βœ… User roles: USER, EDITOR, ADMIN, OWNER
  • βœ… Subscription tiers: FREE, ESSENTIAL, PREMIUM, ENTERPRISE
πŸ—οΈ Infrastructure
  • βœ… Docker Compose (dev + cloud profiles)
  • βœ… Kubernetes manifests (deployment, service, configmap, ingress)
  • βœ… Redis caching (dev, test, prod)
  • βœ… Prometheus + Grafana + Loki monitoring stack
  • βœ… Terraform for cloud deployment
  • βœ… 17 GitHub Actions workflows
  • βœ… Dependabot, CodeQL, semantic release (Changesets)
πŸ”„ In Development
  • Advanced RBAC β€” Fine-grained role-based access control
  • Plugin System β€” External action loading for vaultctl
  • Real-Time Monitoring β€” Live metrics and logs dashboard
  • Advanced Network Tools β€” Firewall and route configuration
  • Web-Based Management Console β€” GUI for vaultctl operations
  • Cluster Management β€” Multi-node orchestration
πŸ“‹ Planned Features
  • Mobile Companion App β€” React Native / Capacitor mobile client
  • Advanced Email Security β€” Spam filtering, virus scanning, encryption
  • Full Calendar & Contacts Sync β€” CalDAV/CardDAV support
  • E2E Testing Suite β€” Comprehensive Playwright and Go tests
  • Performance Optimization β€” Caching, CDN, edge deployment

πŸš€ Quick Start

πŸ“‹ Prerequisites
  • Go 1.25.0 or higher (for backend + CLI)
  • Node.js 20.0.0 or higher (for frontend + bot)
  • pnpm 9.0.0 or higher (recommended package manager)
  • PostgreSQL 16.0 or higher (for database)
  • Docker & Docker Compose (optional, for containerized deployment)
  • Make (for command shortcuts)
πŸ”§ Installation & Setup
  1. Clone the repository

    git clone https://github.com/skygenesisenterprise/discord-enterprise.git
    cd discord-enterprise
    
  2. Install dependencies

    # Install all workspace dependencies
    pnpm install
    
    # Generate Prisma client
    pnpm db:generate
    
  3. Environment setup

    cp .env.example .env
    # Edit .env with your database credentials and API keys
    
  4. Database initialization

    pnpm db:migrate
    pnpm db:seed   # Optional: seed development data
    
  5. Start development servers

    # Start all services (frontend + backend)
    pnpm dev
    
    # Or start individually:
    pnpm dev:frontend   # Next.js on port 3000
    pnpm dev:backend    # Go API on port 8080
    pnpm dev:cli        # vaultctl CLI
    
🌐 Access Points

Once running, you can access:

  • Web Dashboard: http://localhost:3000
  • API Server: http://localhost:8080
  • Health Check: http://localhost:8080/api/v1/health
  • API Documentation: http://localhost:3000/docs
  • Discord Bot: Configure via .env with your bot token
  • Discord Staff Panel: Set DISCORD_PANEL_CHANNEL_ID, then run /panel setup. The bot keeps one persistent staff control message in that channel and repairs it automatically on startup.
  • Discord Welcome Messages: Set DISCORD_RULES_CHANNEL_ID, DISCORD_WELCOME_CHANNEL_ID, DISCORD_ROLE_MEMBER_ID, and DISCORD_ROLE_AGENTS_ID. /welcome panel publishes the human verification panel in the rules channel. /welcome setup enables arrival embeds in the welcome channel; humans receive the selected member role and bots receive the agents role.
  • vaultctl CLI: pnpm cli or go run ./cmd
🐳 Docker Quick Start
# Development environment
docker compose -f docker-compose.dev.yml up -d

# Production environment
docker compose -f docker-compose.cloud.yml up -d
🎯 Available Commands
# πŸš€ Development
pnpm dev                 # Start all services (frontend + backend)
pnpm dev:frontend        # Frontend only (port 3000)
pnpm dev:backend         # Backend only (port 8080)
pnpm dev:cli             # vaultctl CLI development

# πŸ—οΈ Building
pnpm build               # Build all workspaces
pnpm start               # Start production servers

# πŸ—„οΈ Database
pnpm db:generate         # Generate Prisma client
pnpm db:migrate          # Run migrations
pnpm db:studio           # Open Prisma Studio
pnpm db:seed             # Seed development data

# πŸ”§ Code Quality
pnpm lint                # Lint all packages
pnpm typecheck           # TypeScript type checking
pnpm format              # Format code with Prettier
pnpm test                # Run all tests

# 🐳 Docker
pnpm docker:build        # Build Docker image
pnpm docker:run          # Start Docker Compose

# πŸ› οΈ CLI
pnpm cli                 # Run vaultctl CLI tool

# πŸ“¦ Release
pnpm changeset           # Manage changesets
pnpm clean               # Clean build artifacts

πŸ› οΈ Tech Stack

🌐 Frontend Layer
Next.js 16 + React 19.2.6 + TypeScript 6
β”œβ”€β”€ 🎨 Tailwind CSS v4 + shadcn/ui (30+ Radix primitives)
β”œβ”€β”€ 🌍 next-intl (Internationalization)
β”œβ”€β”€ πŸ“š Fumadocs (MDX Documentation + OpenAPI)
β”œβ”€β”€ πŸ” JWT + OAuth Authentication (Complete Implementation)
β”œβ”€β”€ πŸ›£οΈ Next.js App Router (Routing)
β”œβ”€β”€ 🎭 Framer Motion (Animations)
β”œβ”€β”€ πŸ“Š Recharts (Charts & Visualization)
β”œβ”€β”€ πŸ—ƒοΈ Zustand 5 (State Management)
β”œβ”€β”€ πŸ“ React Hook Form + Zod 4 (Forms & Validation)
└── πŸ”§ ESLint + Prettier + Stylelint (Code Quality)
βš™οΈ Backend Layer
Go 1.25.5 + Gin Framework 1.11
β”œβ”€β”€ πŸ—„οΈ GORM 1.31 + PostgreSQL 16 (Database Layer)
β”œβ”€β”€ πŸ” JWT + OAuth Authentication
β”œβ”€β”€ πŸ“§ IMAP/SMTP/POP3 Services (Stalwart Integration)
β”œβ”€β”€ πŸ›‘οΈ Middleware (CORS, Rate Limit, Security, CSRF)
β”œβ”€β”€ πŸ“Š Prometheus Metrics
β”œβ”€β”€ 🌐 REST API Routes (/api/v1/)
β”œβ”€β”€ πŸ” Full-Text Search
└── πŸ“‹ Structured Logging
πŸ€– Discord Bot Layer
discord.js 14.25.1 (ESM)
β”œβ”€β”€ πŸ’¬ Slash Commands (about, help, ping, rules, serverinfo, status, userinfo)
β”œβ”€β”€ πŸ”„ Event Handlers (ready, interactionCreate)
β”œβ”€β”€ πŸš€ Auto Command Deployment
└── 🐳 Docker Ready
πŸ–₯️ CLI Console Layer (vaultctl)
Go + Cobra CLI Framework
β”œβ”€β”€ 🎯 Interactive OPNsense-Style Menu System
β”œβ”€β”€ βš™οΈ System Management (status, shutdown, reboot)
β”œβ”€β”€ πŸ”§ Service Management (systemd)
β”œβ”€β”€ 🌐 Network Management (interfaces, IP, ping)
β”œβ”€β”€ πŸ”’ Security Management (users, SSH keys, audit)
β”œβ”€β”€ πŸ›‘οΈ Maintenance (backup, update, cleanup)
β”œβ”€β”€ πŸ—„οΈ Vault Integration (status, tokens, seal/unseal)
β”œβ”€β”€ πŸ”‘ PAM Authentication
└── 🐳 Multi-Stage Docker Support
πŸ—„οΈ Data Layer
PostgreSQL 16 + Prisma 7 + GORM 1.31
β”œβ”€β”€ πŸ—οΈ Prisma Schema (45+ Models, Source of Truth)
β”œβ”€β”€ πŸ” GORM Query Builder (Go Runtime ORM)
β”œβ”€β”€ πŸ”„ Auto-Migrations (Prisma + GORM)
β”œβ”€β”€ πŸ‘₯ User Models (Roles: USER, EDITOR, ADMIN, OWNER)
β”œβ”€β”€ πŸ“§ Email Stack (MailAccounts, Mailboxes, Threads, Emails)
β”œβ”€β”€ πŸ“… Calendar & Events
β”œβ”€β”€ βœ… Todos & Todo Lists
β”œβ”€β”€ πŸ“° CMS (Categories, Articles, Media, Comments)
└── πŸ“ˆ Analytics & Audit Logging
πŸ—οΈ Monorepo Infrastructure
pnpm Workspaces + Go Modules + Docker Compose
β”œβ”€β”€ πŸ“¦ app/ (Next.js Frontend - TypeScript)
β”œβ”€β”€ βš™οΈ server/ (Go Gin API)
β”œβ”€β”€ πŸ€– bot/ (Discord Bot - JavaScript/ESM)
β”œβ”€β”€ πŸ–₯️ cmd/ (vaultctl CLI - Go)
β”œβ”€β”€ πŸ—‚οΈ prisma/ (Database Schema & Migrations)
β”œβ”€β”€ πŸ› οΈ tools/ (Development Utilities)
β”œβ”€β”€ πŸ”§ services/ (Core Services - TypeScript)
β”œβ”€β”€ πŸ—ΊοΈ routers/ (API Routing)
β”œβ”€β”€ πŸ§ͺ tests/ (Test Suite)
β”œβ”€β”€ 🐳 docker/ (Docker Configuration)
β”œβ”€β”€ πŸ“¦ infrastructure/ (K8s, Terraform, Redis, Monitoring)
β”œβ”€β”€ πŸ“š assets/ (Static Assets)
└── πŸ“– example/ (Example Content)

πŸ“ Architecture

πŸ—οΈ Monorepo Structure
discord-enterprise/
β”œβ”€β”€ app/                        # Next.js 16 Frontend (TypeScript)
β”‚   β”œβ”€β”€ app/                   # App Router pages
β”‚   β”‚   β”œβ”€β”€ (auth)/           # Authentication pages
β”‚   β”‚   β”œβ”€β”€ (docs)/           # Fumadocs documentation
β”‚   β”‚   β”œβ”€β”€ (platform)/       # Dashboard & platform UI
β”‚   β”‚   └── api/              # API route handlers
β”‚   β”œβ”€β”€ components/           # React components
β”‚   β”‚   β”œβ”€β”€ ui/              # shadcn/ui primitives
β”‚   β”‚   └── ...              # Feature components
β”‚   β”œβ”€β”€ contexts/            # React contexts (auth, locale, consent)
β”‚   β”œβ”€β”€ hooks/               # Custom React hooks
β”‚   β”œβ”€β”€ lib/                 # Utility functions
β”‚   └── styles/              # Tailwind CSS styles
β”œβ”€β”€ server/                    # Go Gin API Backend
β”‚   β”œβ”€β”€ api/
β”‚   β”‚   └── v1/              # API route handlers
β”‚   β”‚       β”œβ”€β”€ categories/  # CRUD resources
β”‚   β”‚       β”œβ”€β”€ users/       # User management
β”‚   β”‚       β”œβ”€β”€ media/       # Media management
β”‚   β”‚       └── ...          # 20+ resource handlers
β”‚   β”œβ”€β”€ middleware/          # Gin middleware
β”‚   β”œβ”€β”€ models/              # GORM models & interfaces
β”‚   β”œβ”€β”€ services/            # Business logic
β”‚   β”‚   β”œβ”€β”€ imap/           # IMAP service
β”‚   β”‚   β”œβ”€β”€ smtp/           # SMTP service
β”‚   β”‚   β”œβ”€β”€ pop3/           # POP3 service
β”‚   β”‚   β”œβ”€β”€ oauth/          # OAuth providers
β”‚   β”‚   β”œβ”€β”€ calendar/       # Calendar service
β”‚   β”‚   └── ...             # Other services
β”‚   └── routes/              # Route definitions
β”œβ”€β”€ bot/                       # Discord Bot (JavaScript/ESM)
β”‚   β”œβ”€β”€ commands/            # Slash command definitions
β”‚   β”œβ”€β”€ events/              # Event handlers
β”‚   └── deploy-commands.js   # Command deployment script
β”œβ”€β”€ cmd/                       # vaultctl CLI Console (Go)
β”‚   β”œβ”€β”€ actions/             # Command actions
β”‚   β”œβ”€β”€ banners/             # ASCII art banners
β”‚   β”œβ”€β”€ menus/               # Interactive menu system
β”‚   └── main.go             # Entry point
β”œβ”€β”€ prisma/                    # Database Schema
β”‚   └── schema.prisma        # 45+ models, 1267 lines
β”œβ”€β”€ infrastructure/            # Infrastructure-as-Code
β”‚   β”œβ”€β”€ docker/              # Docker Compose configs
β”‚   β”œβ”€β”€ k8s/                 # Kubernetes manifests
β”‚   β”œβ”€β”€ redis/               # Redis configuration
β”‚   β”œβ”€β”€ monitoring/          # Prometheus/Grafana/Loki
β”‚   └── terraform/           # Terraform scripts
β”œβ”€β”€ docker/                    # Docker support
β”œβ”€β”€ .github/                   # GitHub configuration
β”‚   └── workflows/           # 17 CI/CD pipelines
└── package.json              # pnpm workspace root
πŸ”„ Data Flow Architecture
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Next.js App     β”‚     β”‚  Go Gin API      β”‚     β”‚  PostgreSQL 16  β”‚
β”‚  (Frontend)      │◄───►│  (Backend)       │◄───►│  (Database)     β”‚
β”‚  Port 3000       β”‚     β”‚  Port 8080       β”‚     β”‚  Port 5432      β”‚
β”‚  TypeScript 6    β”‚     β”‚  Go 1.25         β”‚     β”‚                  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
         β”‚                       β”‚                        β”‚
         β–Ό                       β–Ό                        β–Ό
   shadcn/ui UI           REST API /api/v1/         Prisma Schema
   i18n (next-intl)       JWT Auth + OAuth          45+ Models
   Fumadocs Docs          IMAP/SMTP/POP3            GORM ORM
   Zustand State          Calendar/Todos             Auto-migrations
         β”‚                       β”‚
         β–Ό                       β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Discord Bot     β”‚     β”‚  vaultctl CLI    β”‚
β”‚  discord.js 14   β”‚     β”‚  Go + Cobra      β”‚
β”‚  Slash Commands  β”‚     β”‚  System Console  β”‚
β”‚  Guild Admin     β”‚     β”‚  OPNsense-Style  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ—ΊοΈ Development Roadmap

🎯 Phase 1: Foundation (βœ… Complete)
  • βœ… Monorepo Setup β€” pnpm workspaces + Go modules
  • βœ… Next.js Frontend β€” App Router, shadcn/ui, i18n
  • βœ… Go Gin API β€” Full REST framework with middleware
  • βœ… Database Schema β€” Prisma + GORM, 45+ models
  • βœ… Authentication β€” JWT + OAuth (Google, Microsoft, Proton)
  • βœ… Docker Setup β€” Multi-container orchestration
  • βœ… CI/CD Pipeline β€” 17 GitHub Actions workflows
πŸš€ Phase 2: Core Features (βœ… Complete)
  • βœ… Discord Bot β€” Slash commands, events, guild management
  • βœ… vaultctl CLI β€” OPNsense-style interactive system console
  • βœ… Email Suite β€” IMAP/SMTP/POP3 with Stalwart integration
  • βœ… Documentation β€” Fumadocs MDX with OpenAPI specs
  • βœ… Infrastructure β€” K8s, Terraform, Redis, Monitoring
  • βœ… API Resource CRUD β€” 20+ endpoints with full admin
βš™οΈ Phase 3: Enhancement (πŸ”„ In Progress)
  • πŸ”„ Advanced RBAC β€” Fine-grained permission system
  • πŸ”„ Plugin System β€” Extensible action loading for vaultctl
  • πŸ”„ Real-Time Monitoring β€” Live metrics dashboard
  • πŸ”„ Web Console β€” GUI for vaultctl system management
  • πŸ”„ Testing Suite β€” Comprehensive Playwright + Go tests
🌟 Phase 4: Enterprise (πŸ“‹ Planned)
  • πŸ“‹ Mobile App β€” React Native / Capacitor companion
  • πŸ“‹ Email Security β€” Spam filtering, virus scanning, encryption
  • πŸ“‹ CalDAV/CardDAV β€” Calendar and contacts sync
  • πŸ“‹ Cluster Management β€” Multi-node orchestration
  • πŸ“‹ Performance Optimization β€” CDN, edge, caching

πŸ’» Development

πŸ“‹ Development Workflow
# New developer setup
pnpm install && pnpm db:generate && pnpm db:migrate

# Daily development
pnpm dev                 # Start working on both frontend + backend
pnpm dev:frontend        # Frontend-only development
pnpm dev:backend         # Backend-only development
pnpm dev:cli             # CLI development

# Code quality
pnpm lint                # Check code quality
pnpm lint:fix            # Auto-fix linting issues
pnpm typecheck           # Verify TypeScript types
pnpm format              # Format code with Prettier

# Database changes
pnpm db:generate         # Generate Prisma client after schema changes
pnpm db:migrate          # Apply new migrations
pnpm db:studio           # Browse database in Prisma Studio

# Before committing
pnpm format && pnpm lint && pnpm typecheck

# Testing
pnpm test                # Run all tests
pnpm test:e2e            # Run Playwright E2E tests
🎯 Docker Commands
# Development environment
docker compose -f docker-compose.dev.yml up -d

# Production environment
docker compose -f docker-compose.cloud.yml up -d

# View logs
docker compose logs -f

# Rebuild specific service
docker compose build api
πŸ“‹ Development Guidelines
  • pnpm Workspaces β€” Use workspace-specific dependencies
  • TypeScript Strict Mode β€” All frontend code must pass strict checks
  • Go Conventions β€” Follow standard Go project layout
  • Conventional Commits β€” Standardized commit messages
  • Prisma Source of Truth β€” Schema changes start in Prisma
  • API Design β€” RESTful endpoints with /api/v1/ prefix
  • Component Patterns β€” shadcn/ui conventions for React components
  • Security First β€” Validate all inputs, implement proper auth
  • Error Handling β€” Comprehensive error handling and logging

🀝 Contributing

We're looking for contributors to help build this comprehensive enterprise orchestration platform! Whether you're experienced with Go, TypeScript, Discord bots, CLI tools, email protocols, or DevOps, there's a place for you.

🎯 How to Get Started
  1. Fork the repository and create a feature branch
  2. Check the issues for tasks that need help
  3. Join discussions about architecture and features
  4. Start small β€” Documentation, tests, or minor features
  5. Follow our code standards and commit guidelines
πŸ—οΈ Areas Needing Help
  • Go Backend β€” API endpoints, email services, middleware, security
  • TypeScript Frontend β€” React components, UI/UX, dashboard, docs
  • Discord Bot β€” New commands, moderation features, event handling
  • vaultctl CLI β€” System actions, plugins, network tools
  • Email Protocols β€” IMAP, SMTP, POP3 implementation
  • Database β€” Schema design, migrations, optimization
  • DevOps β€” Docker, K8s, Terraform, CI/CD
  • Security β€” Authentication, encryption, penetration testing
  • Documentation β€” API docs, user guides, tutorials

πŸ“ž Support & Community

πŸ’¬ Get Help
πŸ› Reporting Issues

When reporting bugs, please include:

  • Clear description of the problem
  • Steps to reproduce
  • Environment information (Go version, Node.js version, OS)
  • Error logs or screenshots
  • Expected vs actual behavior

πŸ“Š Project Status

Component Status Technology Notes
Web Dashboard βœ… Working Next.js 16 + React 19 + TypeScript 6 shadcn/ui, i18n, Fumadocs
Go REST API βœ… Working Gin 1.11 + GORM 1.31 20+ resource endpoints
Discord Bot βœ… Working discord.js 14 Slash commands, guild admin
vaultctl CLI βœ… Working Go + Cobra OPNsense-style console
Database Schema βœ… Working Prisma 7 + PostgreSQL 16 45+ models, 1267 lines
Email Suite βœ… Working IMAP/SMTP/POP3 + Stalwart OAuth: Google, Microsoft, Proton
Authentication βœ… Working JWT + OAuth Login, register, MFA
Docker Deployment βœ… Working Multi-stage + Compose Dev + cloud profiles
Kubernetes βœ… Working Manifests + Terraform Deployment, service, ingress
Monitoring βœ… Working Prometheus + Grafana + Loki Full observability stack
CI/CD βœ… Working GitHub Actions 17 workflows
Calendar & Todos βœ… Working Server services Full CRUD
CMS βœ… Working Categories, Articles, Media Full content management
Webhooks & API Keys βœ… Working CRUD + admin Rate limited
Advanced RBAC πŸ”„ In Progress Go/TS Fine-grained permissions
Plugin System πŸ”„ In Progress Go External action loading
Real-Time Monitoring πŸ”„ In Progress WebSocket Live metrics dashboard
Mobile App πŸ“‹ Planned Capacitor iOS/Android companion
Testing Suite πŸ“‹ Planned Playwright + Go E2E + unit tests

πŸ† Sponsors & Partners

Development led by Sky Genesis Enterprise

We're looking for sponsors and partners to help accelerate development of this open-source enterprise orchestration platform.

🀝 Become a Sponsor


πŸ“„ License

This project is licensed under the MIT License β€” see the LICENSE file for details.

MIT License

Copyright (c) 2025 Sky Genesis Enterprise

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

  • Sky Genesis Enterprise β€” Project leadership and vision
  • Go Community β€” High-performance programming language and ecosystem
  • Gin Framework β€” Lightweight HTTP web framework
  • GORM Team β€” Modern Go database library
  • Next.js Team β€” Excellent React framework
  • React Team β€” Modern UI library
  • shadcn/ui β€” Beautiful component library
  • Prisma Team β€” Next-generation ORM
  • discord.js Team β€” Powerful Discord API framework
  • Cobra CLI β€” Go framework for CLI applications
  • Tailwind CSS β€” Utility-first CSS framework
  • Radix UI β€” Accessible UI primitives
  • Fumadocs β€” Documentation framework
  • PostgreSQL Team β€” World's most advanced open-source database
  • Docker Team β€” Container platform and tools
  • Kubernetes Community β€” Container orchestration
  • Prometheus & Grafana Teams β€” Monitoring and observability
  • Terraform Team β€” Infrastructure as code
  • pnpm β€” Fast, disk space efficient package manager
  • Open Source Community β€” Tools, libraries, and inspiration

πŸš€ Join Us in Building the Future of Enterprise Infrastructure Management!

⭐ Star This Repo β€’ πŸ› Report Issues β€’ πŸ’‘ Start a Discussion


πŸ”§ Full-Stack Enterprise Orchestration β€” Discord Bot, Web Dashboard, CLI Console, Email Suite, and Infrastructure Management

Made with ❀️ by the Sky Genesis Enterprise team

Building an enterprise-grade orchestration platform with complete tooling for modern infrastructure management

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL