drizzle-orm

This is a monorepo containing multiple phases of the Todo application evolution:

• ✅ Phase I: Console App (Complete)
• 🚧 Phase II: Full-Stack Web Application (In Progress)
• ⏳ Phase III: AI Chatbot with MCP Server
• ⏳ Phase IV: Local Kubernetes Deployment
• ⏳ Phase V: Advanced Cloud Deployment

Phase 1 - Console App (Completed)

```bash

cd phase-1

uv venv

source .venv/bin/activate # Windows: .venv/Scripts/activate

uv sync

python3 src/main.py

```

Phase 2 - Full-Stack Web App (In Progress)

#### Frontend (Next.js)

```bash

cd frontend

npm install

npm run dev

# Opens on http://localhost:3000

```

#### Backend (FastAPI)

```bash

cd backend

uv venv

source .venv/bin/activate

uv sync

uvicorn main:app --reload

# Opens on http://localhost:8000

```

```

Hackathon II/

├── phase-1/ # ✅ Phase I: Python Console App (Complete)

│ ├── src/ # Source code

│ ├── tests/ # Unit tests

│ └── README.md # Phase 1 documentation

│

├── frontend/ # 🚧 Phase II: Next.js Frontend (In Progress)

│ ├── app/ # Next.js App Router pages

│ ├── components/ # React components

│ ├── lib/ # API client and utilities

│ └── CLAUDE.md # Frontend development guidelines

│

├── backend/ # 🚧 Phase II: FastAPI Backend (In Progress)

│ ├── routes/ # API endpoints

│ ├── models.py # Database models

│ ├── middleware/ # Authentication middleware

│ └── CLAUDE.md # Backend development guidelines

│

├── specs/ # Centralized Specifications

│ ├── overview.md # Project overview

│ ├── architecture.md # System architecture

│ ├── features/ # Feature specifications

│ ├── api/ # API specifications

│ ├── database/ # Database schemas

│ └── ui/ # UI specifications

│

├── history/ # Prompt History Records & ADRs

│ ├── prompts/ # Development history

│ └── adr/ # Architectural Decision Records

│

├── .specify/ # Spec-Kit Plus templates and scripts

│ ├── memory/

│ │ └── constitution.md # Project principles

│ └── templates/ # Spec templates

│

├── CLAUDE.md # Root development guidelines

└── README.md # This file

```

Phase I: Console App ✅

• Language: Python 3.13+
• Package Manager: UV
• UI: Rich (colorful CLI) + Inquirer (interactive menus)
• Storage: JSON file persistence

Phase II: Full-Stack Web App 🚧

• Frontend: Next.js 16+ (App Router), TypeScript, Tailwind CSS
• Backend: FastAPI, Python 3.13+
• Database: Neon Serverless PostgreSQL
• ORM: SQLModel
• Authentication: Better Auth with JWT tokens
• Deployment: Vercel (frontend) + Hugging Face (backend)

Phase III: AI Chatbot ⏳

• UI: OpenAI ChatKit
• AI Framework: OpenAI Agents SDK
• MCP Server: Official MCP SDK
• Database: Neon PostgreSQL (with conversations & messages)

Phase IV: Local Kubernetes ⏳

• Containerization: Docker with Docker AI (Gordon)
• Orchestration: Kubernetes (Minikube)
• Package Manager: Helm Charts
• AIOps: kubectl-ai, kagent

Phase V: Cloud Deployment ⏳

• Cloud Provider: DigitalOcean Kubernetes (DOKS)
• Messaging: Kafka on Redpanda Cloud
• Runtime: Dapr
• CI/CD: GitHub Actions

Phase I (Complete) ✅

• Add,