How anilkumara9/quill-ai-chat-with-pdf- works
Project type and purpose
• This is a full-stack, AI-driven document processing and collaboration system (“Quill”) built with Next.js 14 (frontend + API routes) and supplemented by a Python microservice (in the demo.py/ folder) for AI/document logic.
• The README confirms features like document processing, AI integrations (GPT-3.5/Google AI), secure sharing, and real-time collaboration.
File structure
• Top-level:
• src/app/… – Next.js App Router (pages, API routes)
• src/components/…, src/lib/…, src/hooks/… – React UI and utility layers
• prisma/ – database schema and migrations
• demo.py/ – standalone Python service with modules for AI, auth, config, DB, document logic
• Root config files: next.config.js, tsconfig.json, tailwind.config.*, package.json
• API organization: under src/app/api you see domain-driven routes (documents, chat, categories, sync-user, webhooks).
• The Python service (demo.py/) uses its own database.py, ai_service.py, and a main.py entrypoint—indicating a microservice style alongside the Next.js monolith.
README insights
• Tech stack: Next.js, TypeScript, Prisma ORM, Clerk auth, React Query, Tailwind, Radix UI, Google AI.
• Browser / Client (React UI)
• Next.js Frontend (SSR/SSG pages, client-side components)
• Next.js API (App Router endpoints under src/app/api)
• Python microservice (demo.py)
• Database (PostgreSQL/MySQL via Prisma)
• Authentication service (Clerk)
• External AI provider (Google AI / OpenAI GPT-3.5)
• Optional: File storage or object store if used (S3, etc.)
• Browser → Next.js Frontend (HTTP/HTTPS)
• Frontend ↔ Next.js API (fetch/React Query calls)
• Next.js API → Prisma → Database (SQL queries)
• Next.js API → Clerk (for auth via middleware or API calls)
• Next.js API → Python microservice (HTTP/gRPC) for heavy AI/document workflows
• Next.js API & Python microservice → External AI (Google/OpenAI)
• Python microservice → Database (for document versioning, user mapping)
c. Architectural patterns/design principles:
• Monorepo with polyglot services (Node + Python)
• Domain-driven API routing (documents, chat, categories)
• Microservice for AI-heavy processing (separation of concerns)
• Prisma ORM for DB abstraction
• Middleware for auth (Clerk) and rate-limiting
d. Key technologies:
• Next.js 14 (App Router, API routes)
• TypeScript, React Query, Tailwind, Radix UI
• Prisma (schema.prisma, migrations)
• Clerk (auth middleware)
• Python service (FastAPI/Flask implied) modules: ai_service.py, document_service.py, database.py
• Google AI / OpenAI GPT endpoints