AWS database architecture

Serverless contractor CRM powered by DynamoDB.

A screenshot-ready view of the zero-cost hackathon stack: Vercel hosts the Next.js app, API routes use AWS SDK v3, and Amazon DynamoDB stores lead and activity records with a single-table design.

User

Contractor / business owner

Vercel Hosted Next.js App

Frontend and backend deployed together

Next.js Server Actions / API Routes

Lead operations and scoring logic

AWS SDK v3

Typed DynamoDB client

Amazon DynamoDB

tradeflow-leads table

Single-table DynamoDB design

RecordPKSK
LeadTENANT#demoLEAD#<leadId>
ActivityTENANT#demoACTIVITY#<timestamp>#<activityId>

Why this wins the zero stack

Serverless deployment on Vercel

Amazon DynamoDB on-demand billing and free-tier friendly traffic

Tenant partition key ready for future multi-tenant SaaS

Lead records and activity records in one table

No paid APIs, no authentication, no external services

Local mock mode keeps the demo usable before AWS credentials are configured