⚡ TaskFlow Enterprise — High-Performance Project Management System

TaskFlow Enterprise is an industrial-grade, ultra-fast project management system engineered with C++17 (Drogon Framework), Neon Serverless PostgreSQL, and a modern Glassmorphic Single Page Application (SPA). Built for maximum speed, security, and scalability, it combines Jira/Trello-style workflows with sub-5ms API latency and AI-powered task automation.

---

🌐 Live Production Deployment

• 🌐 Production Web Application: https://taskflow-cpp-app-295200560470.asia-southeast1.run.app
• 🟢 Production Health Check: https://taskflow-cpp-app-295200560470.asia-southeast1.run.app/health

---

🌟 Key Architecture & Features

⚡ Ultra-Fast C++ Backend Engine

• Drogon Framework (C++17): Built on an asynchronous, non-blocking epoll I/O event loop for sub-5ms API response latency and minimal memory footprint.
• JWT Security & SHA-256 Hashing: Multi-tenant workspace data isolation and token-based authentication middleware (JwtFilter.cc).

☁️ Cloud & Database Infrastructure

• Neon Serverless PostgreSQL: Native Drogon DB Client connection pooler with sslmode=require and auto-scaling serverless branching.
• Google Cloud Run Containerization: Multi-stage Dockerfile optimizing runtime binaries into compressed containers deployed to Google Cloud Run.

📊 5 Interactive Navigation View Modes

1. Kanban Board: Drag-and-drop status column organization (TO DO, IN PROGRESS, DONE).
2. Jira Backlog View: Active sprint planning with Story Points allocation and item reordering.
3. Gantt Chart Roadmap Timeline: Q3 product engineering milestones and progress bars.
4. Calendar Schedule View: Interactive 31-day date schedule grid with HTML5 Drag-and-Drop task rescheduling.
5. Spreadsheet Table View: Compact high-density grid for quick row updates.

🤖 AI Assistant Copilot Engine

• Gemini AI Integration: Embedded Copilot widget (gemini-2.5-flash-openai) converting natural language prompts into structured task breakdowns, sub-task checklists, and Story Points estimations.

---

🛠️ Technology Stack

Layer	Technology	Benefits & Key Features
Core Engine	Modern C++ (C++17)	Maximum memory efficiency & raw CPU throughput
Web Framework	Drogon Framework	Async non-blocking HTTP controller event loop
Cloud Database	Neon PostgreSQL	Serverless PostgreSQL pooler with SSL connection
Cloud Platform	Google Cloud Run	Auto-scaling managed container hosting
Build System	CMake 3.15+	Cross-platform build orchestration
Frontend SPA	Vanilla HTML5 + CSS3 + ES6 JS	Glassmorphic dark mode interface served directly by Drogon

---

📁 Repository Directory Structure

.
├── CMakeLists.txt # CMake C++ build orchestration
├── Dockerfile # Multi-stage production container build
├── docker-compose.yml # Containerized local environment configuration
├── .env.example # Environment variables template
├── .gitignore # Git exclusion rules
├── config/
│ └── config.json # Drogon JSON configuration & DB connection pooler
├── src/
│ ├── main.cc # Application entry point
│ ├── controllers/
│ │ ├── HealthController.cc # System health check endpoint (/health)
│ │ ├── UserController.cc # Auth & user registration REST API
│ │ ├── TaskController.cc # Tasks CRUD & status transition API
│ │ ├── SubtaskController.cc# Sub-tasks checklist API
│ │ └── CommentController.cc# Activity stream & discussion API
│ └── middleware/
│ ├── CorsFilter.cc # Cross-Origin Resource Sharing (CORS) filter
│ └── JwtFilter.cc # JSON Web Token authentication filter
└── public/ # Static SPA frontend assets (Served directly by Drogon)
├── index.html # Corporate Company Profile & Workspace Portal UI
├── style.css # Glassmorphic dark theme tokens & components
└── app.js # Single Page Application controller & REST API client

---

🚀 Quickstart & Local Setup

Option 1: Docker Compose (Recommended & Zero Config)

# Clone repository
git clone https://github.com/username/taskflow-cpp.git
cd taskflow-cpp
# Build and start container service
docker-compose up --build

Once running, access the local service at:

• 🌐 Web Portal: http://localhost:8085
• 🟢 API Health: http://localhost:8085/health

---

Option 2: Native C++ Build (Requires CMake & Drogon Framework)

# Create build directory
mkdir build &&cd build
# Configure CMake build
cmake .. -DCMAKE_BUILD_TYPE=Release
# Compile C++ binary
make -j$(nproc)# Run server
./taskflow

---

📡 REST API Reference

🔓 Authentication Endpoints

• POST /api/v1/auth/register — Register a new database account
• POST /api/v1/auth/login — Authenticate user and issue JWT token

🔐 Workspace & Task Management (JWT Protected)

• GET /api/v1/tasks — Retrieve all workspace issues
• POST /api/v1/tasks — Create a new issue (+ AI breakdown support)
• GET /api/v1/tasks/{id} — Retrieve detailed task properties
• PUT /api/v1/tasks/{id} — Update task status, assignee, or priority
• DELETE /api/v1/tasks/{id} — Delete a task

---

🗄️ Database Schema (Neon PostgreSQL)

CREATETABLEIF NOT EXISTS users (
id SERIALPRIMARY KEY,
username VARCHAR(50) UNIQUE NOT NULL,
password_hash VARCHAR(255) NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATETABLEIF NOT EXISTS tasks (
id SERIALPRIMARY KEY,
user_id INTREFERENCES users(id) ON DELETE CASCADE,
title VARCHAR(255) NOT NULL,
description TEXT,
status VARCHAR(20) DEFAULT 'pending',
priority VARCHAR(10) DEFAULT 'medium',
points INT DEFAULT 3,
label VARCHAR(50) DEFAULT 'Backend',
due_date TIMESTAMP,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

---

📄 License

Distributed under the MIT License. See LICENSE for details.