# 🚀 Quick Start Guide

## Leggyakoribb használati esetek

### 1️⃣ Cal.com self-hosted telepítés VPS-re

**Agentek sorrendje:**
1. `vps-deployment-agent` - VPS előkészítés (Docker, Node.js)
2. `calendar-scheduling-agent` - Cal.com telepítés
3. `nginx-ssl-agent` - SSL + reverse proxy
4. `email-server-agent` (opcionális) - Email notifikációk

**Parancsok:**
```bash
# VPS setup
ssh root@your-server-ip
# Használd a vps-deployment-agent system-prompt.md-t

# Cal.com telepítés
# Használd a calendar-scheduling-agent system-prompt.md-t

# SSL setup
# Használd a nginx-ssl-agent-et
```

---

### 2️⃣ React + Node.js Full-stack app deployment

**Agentek sorrendje:**
1. `vps-deployment-agent` - VPS alapok
2. `docker-deployment-agent` - Docker Compose stack
3. `fullstack-deployment-agent` - Teljes deployment
4. `cicd-automation-agent` - GitHub Actions CI/CD

**Folyamat:**
```bash
# 1. Develop lokálban
react-dev-agent + nodejs-backend-agent

# 2. Dockerizálás
docker-deployment-agent

# 3. VPS telepítés
fullstack-deployment-agent

# 4. CI/CD
cicd-automation-agent
```

---

### 3️⃣ Email szerver + API integráció

**Agentek sorrendje:**
1. `vps-deployment-agent` - VPS setup
2. `email-server-agent` - Postal telepítés
3. `nodejs-backend-agent` - API integráció
4. `nginx-ssl-agent` - SSL

**Use case:**
- Transactional emails (registration, password reset)
- Newsletter rendszer
- SendGrid alternatíva (költségcsökkentés)

---

### 4️⃣ Self-hosted alternatívák Google-hoz

| Google szolgáltatás | Self-hosted alternatíva | Agent |
|---------------------|------------------------|--------|
| Google Calendar | Cal.com | `calendar-scheduling-agent` |
| Gmail (sending) | Postal | `email-server-agent` |
| Firebase Auth | Supabase | `supabase-setup-agent` |
| Firestore | Supabase (PostgreSQL) | `database-setup` + `supabase-setup-agent` |
| Google Forms | Custom React forms | `react-dev-agent` |

---

## Agent kombináció példák

### Teljes self-hosted startup stack

```
vps-deployment-agent          → VPS előkészítés
├── docker-deployment-agent   → Containerization
├── fullstack-deployment-agent → React + Node.js app
├── database-setup-agent      → PostgreSQL
├── email-server-agent        → Postal email
├── calendar-scheduling-agent → Cal.com
├── cms-setup-agent           → Strapi CMS
└── monitoring-agent          → Prometheus + Grafana
```

### E-commerce platform

```
react-dev-agent               → Frontend (product catalog, cart)
nodejs-backend-agent          → Backend API
database-setup-agent          → PostgreSQL
api-integration-agent         → Stripe payments
email-server-agent            → Order confirmations
fullstack-deployment-agent    → Production deployment
```

### SaaS Dashboard

```
react-dev-agent               → Dashboard UI
nodejs-backend-agent          → REST API
supabase-setup-agent          → Database + Auth + Realtime
monitoring-agent              → Analytics
cicd-automation-agent         → Auto deployment
```

---

## Költségek (self-hosted vs cloud)

### Cal.com
- **Self-hosted:** $5-10/hó VPS = Unlimited users
- **Cloud (cal.com):** $12-29/user/month

### Email (Postal)
- **Self-hosted:** $5-10/hó VPS = Unlimited emails
- **SendGrid:** $15-80/hó (100k emails)

### Database (PostgreSQL)
- **Self-hosted:** $0 (VPS-en belül)
- **Supabase Cloud:** $25/hó (Database)

### Total stack költség
- **Self-hosted:** ~$10-20/hó (1 VPS)
- **Cloud services:** $100-300/hó

---

## VPS ajánlások

| Provider | Ár/hó | Specs | Ajánlott? |
|----------|-------|-------|-----------|
| Hetzner | €4.5 | 2 vCPU, 4GB RAM | ✅ Legjobb ár/érték |
| DigitalOcean | $12 | 2 vCPU, 4GB RAM | ✅ Egyszerű UI |
| Linode | $12 | 2 vCPU, 4GB RAM | ✅ Megbízható |
| Vultr | $12 | 2 vCPU, 4GB RAM | ✅ Jó network |
| Contabo | €5 | 4 vCPU, 8GB RAM | ⚠️ Változó teljesítmény |

**Minimum követelmények:**
- 2 vCPU
- 4GB RAM
- 50GB SSD
- Ubuntu 22.04 LTS

---

## Hasznos parancsok

### Docker
```bash
docker-compose up -d          # Start services
docker-compose down           # Stop services
docker-compose logs -f        # View logs
docker-compose ps             # Check status
docker-compose restart <svc>  # Restart service
```

### Nginx
```bash
sudo nginx -t                 # Test config
sudo systemctl reload nginx   # Reload config
sudo systemctl status nginx   # Check status
```

### SSL (Certbot)
```bash
certbot certificates          # List certificates
certbot renew --dry-run       # Test renewal
```

### Database (PostgreSQL)
```bash
docker-compose exec postgres psql -U username -d dbname
\dt                           # List tables
\q                            # Exit
```

---

## Troubleshooting

### Port már használatban
```bash
sudo lsof -i :80             # Check what's using port 80
sudo systemctl stop apache2  # Stop Apache if running
```

### Docker container nem indul
```bash
docker-compose logs <service-name>
docker-compose down -v        # Remove volumes (CAREFUL!)
docker-compose up -d
```

### SSL certificate hiba
```bash
# Check if port 80 is accessible
curl http://yourdomain.com/.well-known/acme-challenge/test

# Retry certificate
docker-compose run --rm certbot certonly --webroot ...
```

---

## Következő lépések

1. **Válassz projektet** (Cal.com, Full-stack app, Email szerver)
2. **Válassz VPS-t** (Hetzner ajánlott)
3. **Kövesd az agent promptokat** lépésről lépésre
4. **Tesztelj** minden lépés után
5. **Állíts be monitoringot** (UptimeRobot minimum)
6. **Backup stratégia** (cron job daily backup)

---

## Segítség kérés

Ha elakadtál, használd a megfelelő agent system prompt-ját és kérdezz konkrétan:

```
Használd a vps-deployment-agent-et:
"A Docker telepítése közben ezt a hibát kaptam: [hiba üzenet]"

Használd a fullstack-deployment-agent-et:
"A backend nem éri el a PostgreSQL-t, hibaüzenet: connection refused"
```

Minden agent a leggyakoribb hibákra is tartalmaz megoldásokat!