How nikvis01/couchbase_hack_25 works
Project type and purpose
• This is a full-stack hackathon application that combines:
• A Python-based backend service (ML-powered inference + query APIs)
• A Next.js React dashboard (user-facing UI, auth, and data views)
• A persistent data store (Couchbase, managed via Prisma)
• Dockerized deployment (Dockerfiles in both /backend and /dashboard and docker-compose files)
File structure
Top-level directories:
• /backend:
– api_server.py, infer.py, query.py, client.py → Python modules exposing REST endpoints for inference, querying, and client helpers
– smartpylogger/ → custom logging library
– Dockerfile, docker-compose.yaml → containerization and local orchestration
– pyproject.toml, requirements.txt, setup.py → Python packaging/configuration
– tests/ → unit tests
• /dashboard:
– Next.js “app” directory → React pages and layouts for auth and dashboard
– components/, hooks/, lib/ → UI components, custom hooks (e.g., mobile detection), Prisma client, auth client, mail utilities
– prisma/schema.prisma → database schema for Couchbase
– Dockerfile, docker-compose.yaml → containerization and orchestration
– middleware.ts, next.config.ts, lint and build configs
Detailed guidance
• Beneath it, group the /dashboard containers and internal API routes in one slice; annotate Prisma interactions