Testing & Local Development

flowchart TB subgraph Docker["Docker Desktop"] DDB["DynamoDB Local\n(port 8000)"] COGNITO["Cognito Local\n(port 9229)"] ADMIN["DynamoDB Admin\n(port 8001)"] MINIO["MinIO S3\n(port 9000)"] REDIS["Redis\n(port 6379)"] end subgraph Scripts["NPM Scripts"] INIT["npm run db:init\nCreate table schema"] SEED["npm run db:seed\nPopulate test data"] RESET["npm run db:reset\nInit + Seed"] CLEAN["npm run db:clean\nClear all data"] end subgraph Server["Backend Server"] API["npm run server\n(port 3000)"] end Docker --> Scripts INIT --> DDB SEED --> DDB API --> DDB API --> MINIO API --> REDIS

sequenceDiagram participant Dev as Developer participant NPM as npm run db:reset participant Init as init-dynamodb.ts participant Seed as seed-database.ts participant DDB as DynamoDB Local Dev->>NPM: Run reset command NPM->>Init: Step 1: Initialize Init->>DDB: Check if table exists alt Table exists DDB-->>Init: Table found Init-->>NPM: Skip creation else Table missing Init->>DDB: Create table DDB-->>Init: Table created end NPM->>Seed: Step 2: Seed data Seed->>DDB: Insert 40 test items Note over DDB: 6 users, 3 families,
posts, pets, etc. DDB-->>Seed: Data inserted Seed-->>Dev: Ready for testing!

flowchart TD START["API returns error"] --> Q1{"What error?"} Q1 -->|"Connection refused\nport 8000"| A1["DynamoDB not running"] A1 --> S1["docker compose up -d dynamodb"] Q1 -->|"Table not found"| A2["Table doesn't exist"] A2 --> S2["npm run db:init"] Q1 -->|"Empty response"| A3["No data seeded"] A3 --> S3["npm run db:seed"] Q1 -->|"SQLite error\nin Docker logs"| A4["Database corrupted"] A4 --> S4["docker compose up -d dynamodb --force-recreate\nnpm run db:reset"] Q1 -->|"Timeout / Hanging"| A5["Service unhealthy"] A5 --> S5["docker compose restart dynamodb\nnpm run db:reset"] S1 --> VERIFY S2 --> VERIFY S3 --> VERIFY S4 --> VERIFY S5 --> VERIFY VERIFY["Verify with:\ncurl localhost:3000/health"]