Fizz Production Management Skill

This skill enables you to manage the Fizz lead generation application running on AWS EC2.

Architecture Overview

Fizz is a Next.js application deployed on EC2 with the following components:

• fizz-app: Main Next.js web application (port 3000)
• fizz-postgres: PostgreSQL 16 database
• fizz-redis: Redis for rate limiting and caching
• fizz-caddy: Caddy reverse proxy with automatic HTTPS
• Workers: Background job processors
  • fizz-worker-discovery: Lead discovery
  • fizz-worker-screenshots: Website screenshots
  • fizz-worker-lighthouse: Performance analysis
  • fizz-worker-vision: AI vision analysis
  • fizz-worker-sections: Section extraction
  • fizz-worker-email: Email generation
  • fizz-worker-followup: Follow-up email handling

Using the FizzAws PowerShell Module

First, import the module:

Import-Module .\FizzAws.psm1

Common Operations

Connect to the server:

Connect-FizzServer

View container status:

Get-FizzContainers
Get-FizzHealth

View logs:

Get-FizzLogs -Container app -Tail 100
Get-FizzLogs -Container worker-discovery -Follow
Watch-FizzLogs  # All containers

Debug errors:

Get-FizzErrors
Get-FizzStats

Restart containers:

Restart-FizzContainer -Container app
Invoke-FizzCompose -Action restart

Enter container shell:

Enter-FizzContainer -Container app
Enter-FizzContainer -Container postgres -Shell /bin/bash

Run commands in containers:

Invoke-FizzDocker -Container app -Command "npx prisma studio"
Invoke-FizzDocker -Container postgres -Command "psql -U fizz -d fizz"

Infrastructure Details

• Domain: fyzz.dev (Route53 managed)
• EC2: Ubuntu 22.04, t3.small
• RDS: PostgreSQL on db.t4g.micro
• Region: us-east-1
• SSH User: ubuntu

Debugging Checklist

When investigating production issues:

1. Check container health: Get-FizzHealth
2. Look for errors: Get-FizzErrors
3. Check specific container logs: Get-FizzLogs -Container <name>
4. Verify database connectivity: Test-FizzDatabase
5. Check resource usage: Get-FizzStats
6. Review recent deployments in the fizz repository

Environment Variables

The app uses these key environment variables:

• DATABASE_URL: PostgreSQL connection string
• REDIS_URL: Redis connection string
• ANTHROPIC_API_KEY: For AI features
• SERPAPI_API_KEY: For search functionality
• PAGESPEED_API_KEY: For Lighthouse analysis
• AUTH_SECRET: Authentication secret
• SMARTLEAD_API_KEY: For email campaigns