customer-installer/QUICK_START.md

🚀 BotKonzept - Quick Start Guide

In 5 Schritten zur funktionierenden Registrierung

---

✅ Voraussetzungen

• n8n läuft auf https://n8n.userman.de
• PostgreSQL/Supabase Datenbank verfügbar
• PVE20 Proxmox Server erreichbar
• SMTP-Server oder Amazon SES konfiguriert

---

📋 Schritt 1: Datenbank einrichten (5 Minuten)

# Auf Ihrem PostgreSQL/Supabase Server
psql -U postgres -d botkonzept < sql/botkonzept_schema.sql

Oder in Supabase Dashboard:

1. SQL Editor öffnen
2. Inhalt von sql/botkonzept_schema.sql kopieren
3. Ausführen

Prüfen:

SELECT table_name FROM information_schema.tables 
WHERE table_schema = 'public';

Sollte zeigen: customers, instances, emails_sent, subscriptions, payments, usage_stats, audit_log

---

🔑 Schritt 2: n8n Credentials erstellen (10 Minuten)

2.1 PostgreSQL Credential

1. n8n → Credentials → New Credential
2. Typ: Postgres
3. Name: Supabase Local
4. Konfiguration:

   Host: localhost (oder Ihr Supabase Host)
   Port: 5432
   Database: botkonzept
   User: postgres
   Password: [Ihr Passwort]
   SSL: Enabled (für Supabase)
   

5. Test → Save

2.2 SSH Credential

SSH Key generieren (falls noch nicht vorhanden):

ssh-keygen -t ed25519 -C "n8n@botkonzept" -f ~/.ssh/n8n_pve20
ssh-copy-id -i ~/.ssh/n8n_pve20.pub root@192.168.45.20

In n8n:

1. Credentials → New Credential
2. Typ: SSH (Private Key)
3. Name: PVE20
4. Konfiguration:

   Host: 192.168.45.20
   Port: 22
   Username: root
   Private Key: [Inhalt von ~/.ssh/n8n_pve20]
   

5. Save

2.3 SMTP Credential

Option A: Amazon SES

1. Credentials → New Credential
2. Typ: SMTP
3. Name: Postfix SES
4. Konfiguration:

   Host: email-smtp.eu-central-1.amazonaws.com
   Port: 587
   User: [SMTP Username]
   Password: [SMTP Password]
   From Email: noreply@botkonzept.de
   

5. Save

Option B: Gmail (für Tests)

Host: smtp.gmail.com
Port: 587
User: your-email@gmail.com
Password: [App-spezifisches Passwort]
From Email: your-email@gmail.com

---

📥 Schritt 3: Workflows importieren (5 Minuten)

3.1 Customer Registration Workflow

1. n8n → "+" → Import from File
2. Datei wählen: BotKonzept-Customer-Registration-Workflow.json
3. Import
4. Workflow öffnen
5. Jeden Node prüfen und Credentials zuweisen:
   • "Create Customer in DB" → Supabase Local
   • "Create Customer Instance" → PVE20
   • "Save Instance to DB" → Supabase Local
   • "Send Welcome Email" → Postfix SES
   • "Log Email Sent" → Supabase Local
6. Save
7. Activate (Toggle oben rechts)

3.2 Trial Management Workflow

1. Import: BotKonzept-Trial-Management-Workflow.json
2. Credentials zuweisen
3. Save → Activate

---

🧪 Schritt 4: Testen (10 Minuten)

4.1 Webhook-URL kopieren

1. Workflow "Customer Registration" öffnen
2. Node "Registration Webhook" klicken
3. Production URL kopieren
   • Sollte sein: https://n8n.userman.de/webhook/botkonzept-registration

4.2 Frontend aktualisieren

# customer-frontend/js/main.js
const CONFIG = {
    WEBHOOK_URL: 'https://n8n.userman.de/webhook/botkonzept-registration',
    // ...
};

4.3 Test mit curl

curl -X POST https://n8n.userman.de/webhook/botkonzept-registration \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Max",
    "lastName": "Test",
    "email": "max.test@example.com",
    "company": "Test GmbH"
  }'

Erwartete Antwort:

{
  "success": true,
  "message": "Registrierung erfolgreich!",
  "customerId": "...",
  "instanceUrl": "https://sb-XXXXX.userman.de"
}

4.4 Prüfen

Datenbank:

SELECT * FROM customers ORDER BY created_at DESC LIMIT 1;
SELECT * FROM instances ORDER BY created_at DESC LIMIT 1;

PVE20:

pct list | grep sb-

E-Mail:

• Prüfen Sie Ihren Posteingang (max.test@example.com)

---

🌐 Schritt 5: Frontend deployen (5 Minuten)

Option A: Lokaler Test

cd customer-frontend
python3 -m http.server 8000

Öffnen: http://localhost:8000

Option B: Nginx

# Auf Ihrem Webserver
cp -r customer-frontend /var/www/botkonzept.de

# Nginx Config
cat > /etc/nginx/sites-available/botkonzept.de <<'EOF'
server {
    listen 80;
    server_name botkonzept.de www.botkonzept.de;
    root /var/www/botkonzept.de;
    index index.html;
    
    location / {
        try_files $uri $uri/ =404;
    }
}
EOF

ln -s /etc/nginx/sites-available/botkonzept.de /etc/nginx/sites-enabled/
nginx -t
systemctl reload nginx

Option C: Vercel/Netlify

cd customer-frontend

# Vercel
vercel deploy

# Netlify
netlify deploy

---

✅ Fertig!

Ihre Registrierung ist jetzt live! 🎉

Nächste Schritte:

1. SSL-Zertifikat für botkonzept.de einrichten
2. DNS-Records konfigurieren (SPF, DKIM, DMARC)
3. Amazon SES aus Sandbox-Modus holen
4. Monitoring einrichten
5. Backup-Strategie planen

---

🆘 Probleme?

Häufigste Fehler:

1. "Credential not found" → Prüfen Sie ob alle 3 Credentials erstellt sind

2. "SSH connection failed" → Prüfen Sie SSH Key: ssh root@192.168.45.20

3. "Table does not exist" → Führen Sie das Schema erneut aus

4. "Email not sent" → Prüfen Sie SMTP-Credentials und Absender-Verifizierung

Detaillierte Hilfe:

• Setup-Guide: REGISTRATION_SETUP_GUIDE.md
• Troubleshooting: REGISTRATION_TROUBLESHOOTING.md

---

📊 Monitoring

n8n Executions

n8n → Sidebar → Executions
Filter: "Failed" oder "Running"

Datenbank

-- Registrierungen heute
SELECT COUNT(*) FROM customers 
WHERE DATE(created_at) = CURRENT_DATE;

-- Aktive Trials
SELECT COUNT(*) FROM customers 
WHERE status = 'trial';

-- Letzte 5 Registrierungen
SELECT email, first_name, last_name, created_at 
FROM customers 
ORDER BY created_at DESC 
LIMIT 5;

Logs

# n8n
docker logs -f n8n

# install.sh
tail -f /root/customer-installer/logs/install_*.log

# E-Mail (Postfix)
journalctl -u postfix -f

---

🎯 Checkliste

• Datenbank-Schema erstellt
• 3 Credentials in n8n angelegt
• 2 Workflows importiert und aktiviert
• Test-Registrierung erfolgreich
• E-Mail erhalten
• LXC-Container erstellt
• Frontend deployed
• DNS konfiguriert
• SSL-Zertifikat installiert

---

Geschätzte Gesamtzeit: 35 Minuten

Support: support@botkonzept.de

Version: 1.0.0
Datum: 26.01.2025