Files

247 lines
9.9 KiB
Markdown

# Ghaymah Cloud: V1 vs V2 — Comprehensive Comparison
> Generated: 2026-10-22
> Based on hands-on testing of both platform versions
---
## Quick Comparison Matrix
| Aspect | V1 (Console) | V2 (Deploy) | Winner |
|--------|:-----------:|:-----------:|:------:|
| Dashboard | console.cumin.dev | deploy.ghaymah.systems | V2 |
| CLI Tool | ❌ None | ✅ `gy` CLI | V2 |
| Managed Databases | ❌ | ✅ PostgreSQL | V2 |
| Object Storage | ❌ | ✅ S3 Buckets | V2 |
| AI Integration | ❌ | ✅ LiteLLM | V2 |
| Templates | ❌ | ✅ 22 Templates | V2 |
| Documentation | ❌ Limited | ✅ Full Docs Site | V2 |
| Service Mesh | ✅ CoreDNS | ✅ CoreDNS | Tie |
| Security Headers | ❓ Unknown | ❌ Missing | Neither |
| GraphQL API | ✅ 49 MCP tools | ✅ 41 Mutations | Tie |
---
## 1. Architecture Comparison
### V1 Architecture
```
console.cumin.dev (React SPA)
└── api.cumin.dev (MCP/REST Backend, 49 tools)
└── graphql.ghaymah.systems (Hasura GraphQL)
└── PostgreSQL (internal)
└── Kubernetes Cluster
├── CoreDNS (10.43.0.10:53)
├── Per-project namespaces
└── Kaniko/BuildKit (container builds)
```
### V2 Architecture
```
deploy.ghaymah.systems (React 19 SPA, Vite)
├── auth.ghaymah.systems (Hasura Auth, JWT)
├── graphql.ghaymah.systems (Hasura GraphQL)
│ ├── 15 Queries, 41 Mutations, 22 Subscriptions
│ └── WebSocket streaming for real-time updates
├── genai.ghaymah.systems (LiteLLM AI Gateway)
├── status.ghaymah.systems (Status Page)
├── logs.ghaymah.systems (Centralized Logging)
├── registry.ghaymah.systems (Container Registry)
├── cliv2.ghaymah.systems (CLI Distribution)
├── docs.ghaymah.cloud (Documentation, Starlight/Astro)
└── Kubernetes Cluster
├── CoreDNS (service discovery)
├── Helm Charts (ghaymah-project, ghaymah-app)
├── S3-compatible Object Storage
├── Managed PostgreSQL
└── App hosting on *.hosted.cumin.dev
```
---
## 2. Feature-by-Feature Comparison
### Core Features
| Feature | V1 | V2 | Notes |
|---------|:--:|:--:|-------|
| Container Apps | ✅ | ✅ | V2 adds friendly name-based management |
| Static Apps | ❌ | ✅ | **NEW** — Dedicated static site hosting |
| Projects | ✅ | ✅ | Both use Helm chart `ghaymah-project` |
| Public URL | ✅ | ✅ | V1: `*.hosted.ghaymah.systems`, V2: `*.hosted.cumin.dev` |
| Custom Domains | ❌ | ❌ | Neither supports custom domains |
| Environment Vars | ✅ | ✅ | V2 adds `is_secret` and `file_path` options |
| Resource Tiers | t1 only | t1-t7 | V2 has 7 tiers |
| App Instances | 1 | 1+ | V2 supports scaling |
| Health Checks | ❌ | ✅ | **NEW** — Port-level health monitoring |
| App Tags | ❌ | ✅ | **NEW** — Key/value metadata |
### Managed Services (All New in V2)
| Service | V1 | V2 | Details |
|---------|:--:|:--:|---------|
| **S3 Storage** | ❌ | ✅ | Managed buckets, scoped access keys, key rotation |
| **Persistent Volumes** | ❌ | ✅ | Disk that survives restarts, mountable into apps |
| **Managed PostgreSQL** | ❌ | ✅ | Production DB with connection URL |
| **Secrets** | ❌ | ✅ | Encrypted, write-only key-value store |
| **Pull Secrets** | ❌ | ✅ | Private registry credentials |
### Developer Experience
| Feature | V1 | V2 | Notes |
|---------|:--:|:--:|-------|
| CLI Tool | ❌ | ✅ `gy` | Auto stack detection, one-command deploy |
| Tunnels | ❌ | ✅ | Expose localhost to internet |
| JSON Output | ❌ | ✅ | `--json` flag on every CLI command |
| Friendly Names | ❌ UUID-based | ✅ `my-api` | No more memorizing UUIDs |
| Live Config Updates | ❌ Redeploy needed | ✅ `gy config` | Change env/ports without redeploy |
| App Logs (API) | ❌ | ✅ `appLogs` | Programmatic log access |
| Documentation | ❌ | ✅ Full site | docs.ghaymah.cloud (Starlight/Astro) |
### AI & Automation
| Feature | V1 | V2 | Notes |
|---------|:--:|:--:|-------|
| GenAI Gateway | ❌ | ✅ LiteLLM | Multi-model AI access with budget controls |
| AI Assistant | ❌ | ✅ `/assistant` | Built-in chat AI in dashboard |
| Store Templates | ❌ | ✅ 22 templates | One-click deploy for popular apps |
| Workflow Automation | ❌ | ✅ n8n template | Available via store |
| Monitoring | ❌ | ✅ Grafana template | Available via store |
### Platform & Business
| Feature | V1 | V2 | Notes |
|---------|:--:|:--:|-------|
| Teams | ❌ | ✅ | Multi-user collaboration |
| Billing | ❌ | ✅ | Payment management, plan upgrades |
| User Plans | ❌ | ✅ | Free plan: 5 max resources, 1 active app |
| Status Page | ❌ | ✅ | Public service status monitoring |
| Integrations | ❌ | ✅ | Third-party service integrations |
---
## 3. API Comparison
### V1 API (MCP/REST — 49 Tools)
```
api.cumin.dev
├── REST endpoints
└── GraphQL (graphql.ghaymah.systems)
└── insert_ghaymah_cloud_resources_one (main method)
```
### V2 API (GraphQL — 41 Mutations)
```
graphql.ghaymah.systems/v1/graphql
├── Queries (15): resource, store, plan, genai queries
├── Mutations (41): CRUD for apps, static, postgres, s3, volumes, secrets
└── Subscriptions (22): Real-time streams for all resources
```
### Key API Differences
| Aspect | V1 | V2 |
|--------|-----|-----|
| **Resource Model** | `name, image, port, protocol, subdomain` fields | `chart_name, chart_version, values (JSON blob)` |
| **App Creation** | `insert_ghaymah_cloud_resources_one` only | `createApp` mutation with typed `CreateAppInput` |
| **Data Model** | Flat fields per resource | JSON `values` blob (flexible schema) |
| **Subscriptions** | None | WebSocket subscriptions on all tables |
| **Auth** | Token-based (custom) | JWT (Hasura Auth, HS256, 900s expiry) |
| **Pagination** | Not visible | Hasura-standard `limit/offset/order_by` |
---
## 4. Networking Comparison
| Aspect | V1 | V2 |
|--------|-----|-----|
| **Internal DNS** | CoreDNS (10.43.0.10:53) | CoreDNS (Kubernetes cluster) |
| **Service Discovery** | `<name>.<namespace>.svc.cluster.local` | Same K8s DNS pattern |
| **Public Domain** | `*.hosted.ghaymah.systems` | `*.hosted.cumin.dev` ⚠️ |
| **Protocol Support** | HTTP, TCP (Redis RESP verified) | HTTP, TCP |
| **TLS** | Yes (Let's Encrypt) | Yes (Let's Encrypt) |
| **Backend Isolation** | HTTP 404 from public (partial) | Via Hasura RLS + K8s network policies |
| **Raw TCP** | Verified (Redis RESP protocol) | Port-level health checks available |
> ⚠️ **Key Finding**: V2 apps are hosted on `cumin.dev` domain instead of `ghaymah.systems`, revealing the underlying infrastructure change.
---
## 5. Security Comparison
| Security Aspect | V1 | V2 |
|----------------|:--:|:--:|
| **Auth Method** | Custom token | JWT (HS256, Hasura Auth) |
| **Token Expiry** | Unknown | 900s (15 min) ✅ |
| **IDOR Protection** | Partial (cross-project lateral movement found) | ✅ Row-level security (Hasura RLS) |
| **SQL Injection** | Not tested | ✅ Parameterized queries |
| **Cross-User Access** | ⚠️ Lateral movement possible | ✅ Blocked by user_id RLS |
| **Rate Limiting (Auth)** | Not tested | ✅ 429 enforced |
| **Rate Limiting (API)** | Not detected | ⚠️ Not detected |
| **CORS** | Not tested | Not fully tested |
| **GraphQL Introspection** | N/A | ⚠️ Fully exposed (148 types) |
| **Security Headers** | Not tested | ❌ All 5 missing |
| **Billing Enforcement** | Not tested | ✅ Server-side enforced |
### V1 Security Issues Found (Previous Testing)
1. Cross-project lateral movement between tenants
2. Backend services accessible from public (HTTP 404 but reachable)
3. Raw TCP Redis protocol accessible within mesh
### V2 Security Improvements
1. ✅ Hasura Row-Level Security prevents cross-user access
2. ✅ Auth rate limiting (429 on rapid requests)
3. ✅ Billing enforcement prevents free plan abuse
4. ⚠️ Still needs: security headers, introspection restriction, API rate limiting
---
## 6. Store Templates (New in V2)
V2 introduces a **marketplace** of 22 one-click deployable applications:
| Category | Templates |
|----------|-----------|
| **Development** | Code Server, WordPress, Memos, DocuSeal, Twenty CRM |
| **Database** | PostgreSQL, MariaDB, ChromaDB, Valkey, PgBouncer, MeiliBridge, Hasura GraphQL, Metabase |
| **Automation** | n8n, Uptime Kuma |
| **Monitoring** | Grafana |
| **Productivity** | IT Tools, Mini QR, Stirling PDF |
| **Web** | Basic Nginx, WordPress Light |
| **Tools** | MCP Demo |
Each template supports:
- Variable substitution (resource tiers, passwords, etc.)
- Multi-resource deployment (app + volume + database)
- Auto-provisioning of dependent resources
---
## 7. Summary & Verdict
### V2 Improvements Over V1
1. **22+ new managed services** (S3, PostgreSQL, Volumes, Secrets, etc.)
2. **CLI-first workflow** with `gy` tool (auto stack detection)
3. **AI integration** (LiteLLM gateway + AI assistant)
4. **One-click templates** (22 apps in the Store)
5. **Better security** (Hasura RLS, auth rate limiting, billing enforcement)
6. **Real-time updates** (WebSocket subscriptions)
7. **Full documentation** (docs.ghaymah.cloud)
8. **Teams & billing** (multi-user, plan management)
9. **Developer experience** (friendly names, live config, tunnels)
10. **Status monitoring** (public status page)
### Preserved from V1
1. Kubernetes-based orchestration
2. CoreDNS internal service mesh
3. Helm chart resource model (ghaymah-project, ghaymah-app)
4. Container registry per user
5. Hasura GraphQL as data layer
### Areas Still Needing Attention
1. Missing security headers (5/5 absent)
2. GraphQL introspection exposed in production
3. API rate limiting not detected on GraphQL endpoint
4. Resource counter bug (`current_resources: -14`)
5. No custom domain support for deployed apps
---
*Comparison generated from hands-on testing of both V1 and V2 platforms*
*Date: 2026-10-22*