How premieroctet/digestclub works
Main System Components
a) Client Layer:
• Next.js Frontend (App Router architecture)
• Public-facing pages (/app/(app))
• Admin interface (/app/(admin))
• Authentication pages
b) API Layer:
• REST API endpoints (/pages/api)
• Authentication endpoints
• Team management endpoints
• Bookmark management endpoints
• Digest management endpoints
c) Integration Layer:
• Slack integration
• Twitter/Typefully integration
• Email service integration
• OpenAI integration (for AI features)
d) Data Layer:
• PostgreSQL database (via Prisma ORM)
• Prisma schema and migrations
Relationship Flows
a) External Integrations:
• Slack → API Layer (webhooks for link collection)
• Email Service → API Layer (newsletter distribution)
• Twitter → API Layer (thread publishing)
b) Internal Flows:
• Client → API Layer (REST calls)
• API Layer → Database (Prisma queries)
• API Layer → Integration Layer (third-party services)
Key Components to Highlight
a) Core Features:
• Bookmarking system
• Digest creation/management
• Team collaboration
• Newsletter distribution
b) Supporting Services:
• Authentication (NextAuth.js)
• File storage
• API rate limiting
• OpenGraph preview generation
Technical Details
Annotations for:
• Next.js 13+ with App Router
• Prisma ORM with PostgreSQL
• TailwindCSS for styling
• TypeScript implementation
• Docker containerization
Specific Implementation Notes
Architectural patterns:
• Server Components vs Client Components
• API Routes structure
• Database schema relationships
• Authentication flow
• Webhook handling