Architecture

┌─────────────────────────────────────────────────────────┐
│                      Frontend                          │
│              Next.js 16 · Vercel                        │
│                                                         │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐             │
│  │  Pages   │  │  API     │  │  Auth    │             │
│  │  (SSR)   │  │  Routes  │  │NextAuth  │             │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘             │
│       │              │              │                   │
│  ┌────┴──────────────┴──────────────┴─────┐            │
│  │           Prisma Client                │            │
│  └────────────────┬───────────────────────┘            │
└───────────────────┼────────────────────────────────────┘
                    │
    ┌───────────────┼───────────────┐
    │               │               │
┌───┴───┐    ┌──────┴──────┐   ┌───┴────────┐
│  DB   │    │  Contract   │   │  External  │
│Postgres│    │  (Base)     │   │  Services  │
└───────┘    └─────────────┘   └────────────┘

External Services:
  Groq (AI summaries) · Relay (ETH swaps) · Azure Blob (uploads)
  Resend (emails) · GitHub API (repos, ownership)

┌─────────────────────────────────────────────────────────┐
│                     Indexer                             │
│           Node.js · Azure Container Apps                │
│                                                         │
│  Polls contract events → writes to PostgreSQL           │
│  Events: TipReceived, RepoRegistered, PayoutUpdated    │
└─────────────────────────────────────────────────────────┘

opentip/
├── frontend/          Next.js app (Vercel)
│   ├── app/           Pages, API routes, layouts
│   ├── components/    UI components (motion-enhanced)
│   ├── lib/           Utilities, auth, contract ABI
│   ├── prisma/        Schema + migrations
│   └── config/        Reown AppKit + wagmi setup
│
├── indexer/           Event indexer (Azure Container Apps)
│   ├── src/index.ts   Polling loop + event processing
│   └── prisma/        Shared schema with frontend
│
├── contracts/         Solidity smart contracts (Foundry)
│   ├── src/Opentip.sol
│   ├── script/Deploy.s.sol
│   └── test/          36 tests
│
└── package.json       npm workspaces

GitHub OAuth:                     Email/Password:
                                  
User clicks "GitHub"              User enters email + password
  → signIn("github")                → POST /api/auth/signup
  → GitHub OAuth popup                → bcrypt hash, store user
  → Callback with code              → signIn("credentials")
  → NextAuth creates session         → bcrypt compare
  → JWT stored in cookie             → JWT stored in cookie
                                  
Both flows:                       
  → JWT callback enriches token     
    with login, githubId, accessToken
  → Session callback exposes       
    user.login, user.id, etc.