🌊 Воден облак

Self-hosted edge hosting platform. Sovereign. Secure. Production-ready.

---

Какво е Воден облак?

Воден облак е модулна, production-ready платформа за self-hosted edge hosting. Предоставя пълен контрол над инфраструктурата, приложенията и сигурността чрез единичен оперативен панел.

Не е:

• ❌ SaaS услуга
• ❌ Public cloud
• ❌ Експериментален проект

Е:

• ✅ Private / self-hosted платформа
• ✅ Production-ready система
• ✅ Модулна архитектура (50+ модула)
• ✅ Enterprise-grade (HA, monitoring, security)

---

За кого е?

✅ Подходящо за:

• Sovereign cloud deployments - общини, държавни институции
• Корпоративни data centers - компании, които искат пълен контрол
• Edge hosting провайдъри - регионални хостинг компании
• DevOps екипи - които искат self-hosted PaaS
• Security-sensitive организации - които не могат да използват public cloud

❌ Неподходящо за:

• Потребители, които търсят managed SaaS
• Малки проекти без DevOps експертиза
• Експериментални/learning проекти
• Потребители, които искат "zero-config" решение

---

Бърз старт (MVP)

Една команда за пълен тест:

# Клонирай репозитория
git clone https://git.vi-lab.eu/orion/water-cloud.git
cd water-cloud

# Стартирай E2E тест (автоматично стартира всичко и тества flow)
make e2e

Това автоматично:

1. Стартира Docker Compose stack (Postgres, APIs, Frontend)
2. Инициализира database и service catalog
3. Тества пълен flow: Register → Login → Catalog → Order → Provisioning
4. Генерира отчет в artifacts/e2e-report.json

Очакван резултат: ✓ E2E TEST PASSED

Ръчен старт (Development):

# Стартирай platform stack
docker-compose -f core/compose/docker-compose.single-node.yml up -d

# Инициализирай platform
make setup-platform

# Стартирай User Portal Frontend
cd apps/user-portal && pnpm dev

Достъп:

• User Portal: http://localhost:3002
• User Portal API: http://localhost:8082
• Builder API: http://localhost:8081
• Container Manager: http://localhost:8080

Тестови credentials:

• Email: test@example.com
• Password: TestPassword123!

Production (Docker Swarm):

# Инициализирай Swarm
docker swarm init

# Deploy stack
docker stack deploy -c core/compose/docker-stack.swarm.yml voden-oblak

---

Как се развива?

Архитектура

Платформата е модулна система:

water-cloud/
├── core/                    # Ядро (contracts, policy, compose, docs)
├── modules/                 # 50+ модула (WAF, SSL, DNS, Billing, ...)
├── apps/                    # Frontend (Marketing, User Portal)
└── templates/               # Application templates (WordPress, ...)

Модули

Core модули:

• mod_edge_waf - BunkerWeb WAF
• mod_observability - Prometheus, Grafana, Loki
• mod_container_management - Container orchestration
• mod_ssl_automation - Let's Encrypt + Internal CA
• mod_dns_automation - DNS management
• mod_builder - Application deployment
• mod_user_portal - User management & catalog

Пълен списък: modules/MODULES_OVERVIEW.md

Разширяване

1. Добави нов модул:

   modules/mod_your_module/
   ├── api/main.py          # FastAPI endpoint
   ├── docker-compose.snippet.yml
   └── README.md
   

2. Регистрирай в Control Plane:

   • Добави в core/compose/docker-compose.single-node.yml
   • Добави в core/contracts/openapi.yaml (ако има API)

3. Документирай:

   • Създай modules/mod_your_module/README.md
   • Обнови modules/MODULES_OVERVIEW.md

Development workflow

# Тествай промени
make e2e                    # Пълен E2E тест
make e2e-clean             # Почисти тестова среда

# Провери код
pylint modules/**/*.py     # Python linting
mypy modules/**/*.py       # Type checking

# Документирай
# Обнови съответните .md файлове

---

Документация

Основна документация

• 📖 Пълна документация - Всички документи
• 🚀 Quick Start - Бърз старт
• 📊 Project Status - Статус на фазите
• 🏗️ Architecture - Архитектурни диаграми
• 🔍 Project Audit - Пълен одит (липсващи функционалности)

Операционна документация

• 📋 Platform Setup - Настройка на платформата
• 📋 Runbook - Операционни процедури (ако съществува)
• 🔄 CI/CD - Deployment процеси
• 🔒 Security - Security политики

API документация

• 📡 OpenAPI Spec - Пълен API контракт
• 📡 Events Schema - Event-driven архитектура

---

Технологичен стек

Backend:

• FastAPI (Control Plane API)
• PostgreSQL (Metadata)
• Redis (Cache/Sessions)
• NATS (Event Bus)
• Docker (Containerization)

Frontend:

• Next.js (React framework)
• TypeScript
• Tailwind CSS

Infrastructure:

• Docker Swarm (Orchestration)
• Prometheus (Metrics)
• Grafana (Visualization)
• Loki (Logs)
• BunkerWeb (WAF)

---

Статус на проекта

Всички фази са завършени! ✅

• ✅ Фаза 0 - Core Normalization
• ✅ Фаза 1 - MVP Platform Core
• ✅ Фаза 2 - HA (Docker Swarm)
• ✅ Фаза 3 - Geo-Distributed Edge
• ✅ Фаза 4 - Dashboard & USaaS
• ✅ Фаза 5 - One-Stop Hosting
• ✅ Фаза 6 - Compliance Toolkit
• ✅ Фаза 7 - SDK & Libraries

Платформата е production-ready.

---

Security

• ✅ RBAC-based access control
• ✅ Non-root контейнери
• ✅ Network policies
• ✅ Immutable audit logs
• ✅ Automated threat detection
• ✅ SSL/TLS automation
• ✅ Secrets management

Детайли: Security Whitepaper

---

Лиценз

Proprietary - Всички права запазени

---

Поддръжка

• Issues: Git Issues
• Documentation: core/docs/
• Quick Start: QUICKSTART.md

---

Благодарности

Воден облак е построен върху отворени технологии и стандарти. Благодарим на всички open-source проекти, които правят тази платформа възможна.

---

Воден облак - Self-hosted. Sovereign. Secure. 🌊