137 lines
4.5 KiB
Markdown
137 lines
4.5 KiB
Markdown
---
|
||
name: projekt-planung
|
||
description: "Neues Webprojekt konzipieren: Domain, Landingpage, Konzept-Markdown, PDF-Export, iterative Verfeinerung mit User"
|
||
version: 1.0.0
|
||
author: Agent A
|
||
platforms: [linux]
|
||
---
|
||
|
||
# Projekt-Planung — Vom Brainstorming zur Landingpage
|
||
|
||
Workflow für neue Webprojekte auf dem netcup VPS: Konzept im Chat entwickeln, als Markdown speichern, Landingpage aufsetzen, bei Bedarf PDF generieren.
|
||
|
||
---
|
||
|
||
## Schritt 1: Brainstorming IM CHAT
|
||
|
||
- **Alles direkt im Telegram-Chat besprechen** — nicht in Dateien verstecken
|
||
- User gibt Ideen, ich strukturiere und mache Gegenvorschläge
|
||
- Architektur-Skizzen als ASCII-Art im Chat
|
||
- Tabellen für Vergleiche (z.B. Tech-Stack-Entscheidungen)
|
||
- User-Feedback sofort einarbeiten
|
||
|
||
---
|
||
|
||
## Schritt 2: Konzept-Dokument
|
||
|
||
Sobald die Richtung klar ist: `/root/<projekt>-konzept.md` anlegen mit:
|
||
|
||
```markdown
|
||
# Projektname
|
||
|
||
> Domain, Preis, Repo, Stand
|
||
|
||
## Vision
|
||
## Datenquellen / Architektur
|
||
## Tech-Stack
|
||
## Features
|
||
## Roadmap (Phasen)
|
||
## Offene Punkte (Checkliste mit [ ] und [x])
|
||
```
|
||
|
||
---
|
||
|
||
## Schritt 3: Landingpage aufsetzen
|
||
|
||
```bash
|
||
mkdir -p /var/www/<domain>/html
|
||
chown -R www-data:www-data /var/www/<domain>
|
||
|
||
# nginx VHost
|
||
cat > /etc/nginx/sites-available/<domain> << 'EOF'
|
||
server {
|
||
server_name <domain>;
|
||
root /var/www/<domain>/html;
|
||
index index.html;
|
||
location / { try_files $uri $uri/ =404; }
|
||
listen 80;
|
||
}
|
||
EOF
|
||
ln -sf /etc/nginx/sites-available/<domain> /etc/nginx/sites-enabled/
|
||
nginx -t && systemctl reload nginx
|
||
|
||
# SSL
|
||
certbot --nginx -d <domain> --non-interactive --agree-tos --email admin@<hauptdomain> --redirect
|
||
```
|
||
|
||
**Landingpage-Inhalt:** Projektname, Slogan, Kern-Features (Grid), Roadmap, Footer mit Links zu verwandten Projekten.
|
||
|
||
**Stil:** Dark-Theme, grüne Akzente (#10b981), responsive, auf Deutsch.
|
||
|
||
---
|
||
|
||
## Schritt 4: PDF bei Bedarf
|
||
|
||
User will manchmal PDF zum Mitnehmen. **PDF ist BONUS, nicht Ersatz für Chat-Inhalt.**
|
||
|
||
```bash
|
||
wkhtmltopdf /tmp/<projekt>.html /tmp/<Projekt>_Konzept.pdf
|
||
```
|
||
|
||
- HTML aus Markdown generieren mit deutschem CSS
|
||
- Als MEDIA:/pfad senden
|
||
- Vorher IMMER den Inhalt im Chat präsentieren
|
||
|
||
---
|
||
|
||
## Schritt 5: Iteratives Verfeinern
|
||
|
||
- User-Feedback → Konzept-Markdown patchen → PDF neu generieren
|
||
- Version hochzählen (v1, v2, v3...)
|
||
- Offene Punkte als Checkliste pflegen (`[x]` wenn erledigt)
|
||
- Tech-Entscheidungen mit Pro/Contra-Tabelle dokumentieren
|
||
|
||
---
|
||
|
||
## Redesign bestehender Website (Live-Prototyp-Workflow, 2026-08-04)
|
||
|
||
Wenn ein User eine bestehende Live-Site „langweilig" findet und ein neues Look & Feel will:
|
||
|
||
1. **Aktuelle Site zuerst ansehen** (curl auf die URL, vhost ansehen) — verstehen, was JETZT da ist, bevor man irgendwas ändert.
|
||
2. **3–4 klar unterschiedliche Design-Richtungen im Chat anbieten** (je ein Name + kurzes Look-&-Feel + Wirkung), z.B.:
|
||
- Glassmorphism/Frost (Milk-Glass, Blur, sanfte Farbverläufe)
|
||
- Arcade/Retro-Pixel (CRT, Pixel-Font, LCD-Score)
|
||
- Minimal/Swiss (riesige Typografie, 2 Farben)
|
||
- Upgrade des aktuellen Stils (gleiche Richtung, aber Lebendigkeit)
|
||
Nutzer wählt **eine** — nicht alle gleichzeitig umsetzen.
|
||
3. **Vor dem Übernehmen des Originals sichern:**
|
||
```bash
|
||
cp /var/www/<site>/html/index.html /var/www/<site>/html/index-original.html.bak
|
||
```
|
||
⚠️ **Pitfall (Grundregel „nicht destruktiv"):** NIE ohne Backup über die laufende `index.html` schreiben. Backup zuerst, Prototyp danach.
|
||
4. **Spiel-/App-Logik unangetastet lassen, nur CSS + Farben tauschen.** Welche Richtung auch gewählt wird — das JS (Engine, KI, Score) 1:1 übernehmen, damit der Prototyp voll funktioniert.
|
||
5. **Live deployen auf `/var/www`, danach echt verifizieren:** `curl` (HTTP 200) + **Browser öffnen und klicken** (ein Feld → KI antwortet) statt nur auf Curl zu vertrauen. Nach write_file `chown www-data:www-data` + `chmod 644` nicht vergessen (sonst 403).
|
||
6. Wenn dabei ein SSL-Zert-Mismatch auffällt → siehe `web-hosting-deployment`-Skill (ERR_CERT_COMMON_NAME_INVALID / eigenes Subdomain-Zert).
|
||
|
||
---
|
||
|
||
## Häufige User-Präferenzen
|
||
|
||
| Präferenz | Umsetzung |
|
||
|-----------|-----------|
|
||
| Alles auf Deutsch | Prompt, UI, Doku — nie Englisch |
|
||
| Keine Rohdaten im Chat | Terminal-Outputs verarbeiten, nicht roh zeigen |
|
||
| PDF nur als Bonus | Erst Chat-Inhalt, dann Datei |
|
||
| Keine „Premium"-Features | 100% kostenlos erwähnen |
|
||
| Dark-Theme für Landingpages | #0a0a14 Hintergrund, grüne Akzente |
|
||
|
||
---
|
||
|
||
## Verzeichnisse auf dem VPS
|
||
|
||
```
|
||
/var/www/<domain>/html/ — Landingpage
|
||
/root/<projekt>-konzept.md — Konzept-Dokument
|
||
/etc/nginx/sites-available/<domain> — nginx VHost
|
||
```
|