guibean/sistema-fullstack

Sistema Full Stack Next.js

Wann verwenden

Verwenden Sie diese Skill für Login, Registrierung, Dashboard, benutzerspezifische Daten, Upload, Abrechnung oder eine eigene API. Für Landingpages und institutionelle Websites verwenden Sie die Skill site-estatico.

Ein Projekt erstellen

git clone https://github.com/guibean/nextjs-fullstack-template.git <slug>
cd <slug>
pnpm install
cp .env.example .env

Generieren Sie BETTER_AUTH_SECRET mit openssl rand -base64 48, konfigurieren Sie DATABASE_URL und führen Sie aus:

pnpm db:migrate
pnpm dev

Implementierungsreihenfolge

1. Modellieren Sie Daten, Beziehungen, Berechtigungen und Bedrohungen.
2. Ändern Sie src/db/schema.ts und führen Sie pnpm db:generate aus.
3. Wenden Sie Migrationen mit pnpm db:migrate an.
4. Konfigurieren Sie die Umgebungsvariablen in src/env.ts; verwenden Sie keine Fallbacks außerhalb von SKIP_ENV_VALIDATION.
5. Implementieren Sie Authentifizierung und Autorisierung auf dem Server.
6. Validieren Sie alle Eingaben serverseitig mit Zod.
7. Fügen Sie Rate-Limiting, Logs, Backups und Observability hinzu.
8. Bauen Sie erst dann die Dashboard-Oberfläche.

Sicherheitsregeln

• Setzen Sie niemals DATABASE_URL, BETTER_AUTH_SECRET, RESEND_API_KEY oder TURNSTILE_SECRET_KEY offen.
• Verwenden Sie auth.api.getSession({ headers: await headers() }) in geschützten Serverkomponenten.
• Schützen Sie auch Route Handler und Server Actions.
• Verlassen Sie sich nicht auf clientseitige Validierung.
• Verwenden Sie output: "export" nicht, wenn Authentifizierung, Datenbank oder Mutationen vorhanden sind.
• Aktivieren Sie in der Produktion E-Mail-Verifizierung, Rate-Limiting und Passwort-Wiederherstellung.

Deployment auf der VPS

• Bauen Sie mit pnpm build; das Ausgabeverzeichnis ist .next/standalone.
• Ein Multi-Stage-Dockerfile ist enthalten.
• Wenden Sie Migrationen an, bevor Sie die Version wechseln.
• Verwenden Sie HTTPS, Reverse Proxy und einen verwalteten Prozess.
• Erstellen Sie ein Backup der PostgreSQL-Datenbank, bevor Sie destruktive Migrationen durchführen.

Checkliste

• env validiert
• Migrationen angewendet
• Login, Logout und Sitzung getestet
• Geschützte Route leitet ohne Sitzung weiter
• Geschützte API lehnt Anfragen ohne Sitzung ab
• Formular mit doppelter Validierung
• pnpm lint, pnpm typecheck, pnpm build
• Lighthouse ≥ 95 auf öffentlichen Seiten
• Backups und Rate-Limiting definiert