sasa-membership/QUICKSTART.md

Quick Start Guide

Starting the System

# Start all services
docker compose up -d

# Watch the logs until services are ready
docker compose logs -f

Wait until you see "Application startup complete", then press Ctrl+C.

Access the API:

• API: http://localhost:8050/api/v1
• Docs: http://localhost:8050/docs

Set APP_PORT in .env / .env.example to change 8050. For Square payment form testing, use HTTPS at https://localhost:8443. Set APP_TLS_PORT in .env / .env.example to change 8443. TLS certs are auto-generated by the gateway container on first start.

Testing the API

1. Register a new user

curl -X POST "http://localhost:8050/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "test@example.com",
    "password": "testpass123",
    "first_name": "Test",
    "last_name": "User"
  }'

2. Login

curl -X POST "http://localhost:8050/api/v1/auth/login-json" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "test@example.com",
    "password": "testpass123"
  }'

Save the access_token from the response.

3. Get your profile

curl -X GET "http://localhost:8050/api/v1/users/me" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

4. List membership tiers

curl -X GET "http://localhost:8050/api/v1/tiers/"

Docker Compose Commands

# Start services
docker compose up -d

# Stop services
docker compose down

# View logs (all services)
docker compose logs -f

# View logs (specific service)
docker compose logs -f backend

# Restart services
docker compose restart

# Rebuild after code changes
docker compose up -d --build

# Check status
docker compose ps

# Tail gateway logs
docker compose logs -f gateway

Default Admin Access

• Email: admin@swanseaairport.org
• Password: admin123

⚠️ Change this password immediately!

Common Tasks

Create a membership tier (admin)

1. Login as admin
2. Use the token in the Authorization header
3. POST to /api/v1/tiers/

Record a manual payment (admin)

1. Login as admin
2. POST to /api/v1/payments/manual-payment

View all users (admin)

1. Login as admin
2. GET /api/v1/users/

Troubleshooting

Check service status

docker compose ps

View all logs

docker compose logs -f

View backend logs only

docker compose logs -f backend

Restart everything

docker compose restart

Clean start (removes all data)

docker compose down -v
docker compose up -d

Next Steps

1. Update .env with your Square and SMTP2GO credentials
2. Change the default admin password
3. Create additional admin users
4. Configure membership tiers as needed
5. Test payment processing
6. Customize email templates (coming soon)