Skip to content
Supersonic: An AI-Assisted Project Planner

Supersonic: An AI-Assisted Project Planner

Supersonic is a group project from the Solutions Development course at IE University. Teams upload a project plan as a CSV or Excel file, manage its tasks through an API, and ask an AI assistant for a summary of project health and for schedule fixes.

FastAPIPostgreSQLSQLAlchemyJWTDockerLLM Integration

21

API endpoints

7

route groups

2

containers in the deployment

Problem

Understanding the challenge and user needs

Project plans live in spreadsheets, email threads, and disconnected tools. Tasks, priorities, and deadlines change by hand, nobody analyzes schedule risk, and ad hoc tools carry no user accounts or access control.

Approach

Strategy and methods used to address the problem

One import route reads a spreadsheet and creates the project with its full task list. Five data models (user, project, task, tag, and message) persist through async SQLAlchemy on PostgreSQL. JSON Web Tokens with bcrypt-hashed passwords protect every route that reads or changes data, and a pluggable client sends project context to the language model.

The stack, layer by layer

LayerTechnologyRole
APIFastAPI and UvicornAsync routing and request handling
DatabasePostgreSQL 16 through SQLAlchemy 2.0 and asyncpgUsers, projects, tasks, tags, and messages
SecurityJSON Web Tokens and bcryptLogin and protected routes
Importpandas and openpyxlReads CSV and Excel project plans
DeploymentDocker ComposeBackend and database containers

Final Solution

The final design and outcome

Version 1.0 exposes 21 endpoints across seven route groups and runs as two Docker containers, the API and the database, with a health check gating startup. Two AI routes return a structured summary with a health score and blockers, and a prioritized list of schedule suggestions. The presentation shows that version, built on Google Gemini; the repository holds the later version, which adds a Flet desktop app and uses Anthropic Claude as the assistant.

Impact & Validation

Results, learnings, and outcomes

Supersonic turns a static spreadsheet into a queryable project: one upload produces a secured, documented API over the plan, and the assistant reads the same data the team does.

Presentation

The deck, slide by slide

Title slide: Supersonic, AI-Assisted Project Planner. IE University, Group Project, Solutions Development. A production-grade REST API platform: import project plans from Excel & CSV, manage tasks and milestones, and leverage Google Gemini AI for intelligent risk analysis, project summaries, and scheduling optimisation. Project profile: Supersonic v1.0; Group Project (~40% grade); Python 3.12; FastAPI 0.115 + Uvicorn; SQLAlchemy 2.0 (async); asyncpg 0.30; PostgreSQL 16-alpine; JWT HS256 + passlib[bcrypt]; Google Gemini 1.5 Pro; pandas 2.2 + openpyxl; Docker Compose (2 svcs); GitHub (feature branch flow).

Slide 1 of 7