EVO-TODO: The Evolutionary Task Manager

EVO-TODO is a multi-phase software engineering project designed to demonstrate the evolution of an application from a simple terminal-based script to a sophisticated, production-grade full-stack platform.

🚀 The Roadmap (5 Phases)

This project is structured into five distinct architectural phases. Currently, we have completed Phase IV and Phase V is planned.

• Phase I: The In-Memory CLI
  • Robust Python CLI with in-memory state.
  • Features: Priority levels, tags, recurrence, and overdue tracking.
• Phase II: Decoupled Full-Stack Architecture
  • Transition to a modern Web UI and REST API.
  • Backend CRUD & Database integrated; Frontend core UI complete.
• Phase III: AI Chatbot & MCP Integration
  • AI Assistant integration using OpenAI SDK and MCP.
• Phase IV: Containerization & Orchestration
  • Dockerfiles and Helm charts for Kubernetes deployment.
• Phase V: Global Scale & Mobile Integration (Planned)
  • Cloud-native deployment and cross-platform mobile support.

---

🛠 Tech Stack

Phase I (CLI)

• Language: Python 3.10+
• Key Modules: datetime, uuid, enum
• Architecture: Clean separation between TaskManager logic and CLI presentation.

Phase II (Web)

• Frontend: Next.js 15 (App Router), TypeScript, Tailwind CSS, Framer Motion (Animations).
• Backend: FastAPI (Python), SQLAlchemy ORM.
• Database: PostgreSQL (Hosted on Neon DB).
• Icons: Lucide React.

---

🏃‍♂️ Getting Started

📟 Phase I: Python CLI

1. Navigate to the src/ directory.
2. Run the application:

   python main.py

🌐 Phase II: Full-Stack Web App

1. Backend (FastAPI)

1. Navigate to src/backend/.
2. Install dependencies:

   pip install -r requirements.txt

3. Set up your .env file with your DATABASE_URL.
4. Run the server:

   uvicorn main:app --reload

2. Frontend (Next.js)

1. Navigate to frontend/.
2. Install dependencies:

   npm install

3. Run the development server:

   npm run dev

4. Open http://localhost:3000 in your browser.

---

📈 Current Progress (Phase IV Completed)

• FastAPI REST Endpoints (CRUD)
• Neon DB PostgreSQL Integration
• Modern Cinematic UI with Next.js
• AI Chatbot Integration via MCP & OpenAI SDK
• Containerization with Docker & Helm for Kubernetes
• Phase 5: Mobile App & Global Scale (Next Step)

---

📄 License

This project is for educational purposes as part of an evolutionary coding journey.