Hackathon Project Phases Template for the AutoSage App project.

Hackathon Project Phases Template

Project Title:
AutoSage App Using Gemini Flash

Team Name:
Team XYZ

Team Members:
●​ Shanawaz
●​ Anwar
●​ Mohammad
●​ XYZ

Phase-1: Brainstorming & Ideation

Objective:

Develop an AI-powered vehicle expert tool using Gemini Flash to help users compare and
analyze vehicle specifications, reviews, and eco-friendly options.

Key Points:

1.​ Problem Statement:​

○​ Many users struggle to find reliable, up-to-date information about two-wheelers

and four-wheelers before making a purchase decision.
○​ Users also need guidance on vehicle maintenance and eco-friendly vehicle
choices.
 2.​ Proposed Solution:​

○​ An AI-powered application using Gemini Flash to provide real-time vehicle

specifications, reviews, and comparisons.
○​ The app offers maintenance tips and eco-friendly vehicle insights based on
user preferences.
3.​ Target Users:​

○​ Vehicle buyers looking for specifications and comparisons.

○​ Vehicle owners needing seasonal maintenance tips.
○​ Eco-conscious consumers searching for hybrid and electric vehicle options.
4.​ Expected Outcome:​

○​ A functional AI-powered vehicle information app that provides insights based

on real-time data and user queries.

Phase-2: Requirement Analysis

Objective:

Define the technical and functional requirements for the AutoSage App.

Key Points:

1.​ Technical Requirements:​

○​ Programming Language: Python

○​ Backend: Google Gemini Flash API
○​ Frontend: Streamlit Web Framework
○​ Database: Not required initially (API-based queries)
2.​ Functional Requirements:​

○​ Ability to fetch vehicle details using Gemini Flash API.

○​ Display specifications, reviews, and comparisons in an intuitive UI.
○​ Provide real-time vehicle maintenance tips based on seasons.
○​ Allow users to search eco-friendly vehicles based on emissions and incentives.
3.​ Constraints & Challenges:​

○​ Ensuring real-time updates from Gemini API.

○​ Handling API rate limits and optimizing API calls.
○​ Providing a smooth UI experience with Streamlit.
Phase-3: Project Design
Objective:

Develop the architecture and user flow of the application.

Key Points:

1.​ System Architecture:​

○​ User enters vehicle-related query via UI.

○​ Query is processed using Google Gemini API.
○​ AI model fetches and processes the data.
○​ The frontend displays vehicle details, reviews, and comparisons.
2.​ User Flow:​

○​ Step 1: User enters a query (e.g., "Best motorcycles under ₹1 lakh").

○​ Step 2: The backend calls the Gemini Flash API to retrieve vehicle data.
○​ Step 3: The app processes the data and displays results in an easy-to-read
format.
3.​ UI/UX Considerations:​

○​ Minimalist, user-friendly interface for seamless navigation.

○​ Filters for price, mileage, and features.
○​ Dark & light mode for better user experience.
Phase-4: Project Planning (Agile Methodologies)
Objective:

Break down development tasks for efficient completion.

Expected
Sprint Task Priority Duration Deadline Assigned To Dependencies Outcome
Google API Key, API connection

🔴 High
Environment Setup 6 hours End of Day Python, Streamlit established &
Sprint 1 & API Integration (Day 1) 1 Shanawaz setup working
Frontend UI 🟡 2 hours End of Day API response Basic UI with input
Sprint 1 Development Medium (Day 1) 1 Member 2 format finalized fields

🔴 High
Vehicle Search & 3 hours API response, UI Search functionality
Sprint 2 Comparison (Day 2) Mid-Day 2 anwar elements ready with filters

🔴 High
Error Handling & 1.5 hours API logs, UI Improved API
Sprint 2 Debugging (Day 2) Mid-Day 2 Member 1&4 inputs stability

🟡
Responsive UI,
Testing & UI 1.5 hours API response, UI better user
Sprint 3 Enhancements Medium (Day 2) Mid-Day 2 mohammad layout completed experience

🟢 Low
Final Presentation 1 hour End of Day Working Demo-ready
Sprint 3 & Deployment (Day 2) 2 Entire Team prototype project

Sprint Planning with Priorities

Sprint 1 – Setup & Integration (Day 1)

🔴 High Priority) Set up the environment & install dependencies.​

🔴 High Priority) Integrate Google Gemini API.​
(

🟡 Medium Priority) Build a basic UI with input fields.

(
(

Sprint 2 – Core Features & Debugging (Day 2)

🔴 High Priority) Implement search & comparison functionalities.​

🔴 High Priority) Debug API issues & handle errors in queries.
(
(

Sprint 3 – Testing, Enhancements & Submission (Day 2)

🟡 Medium Priority) Test API responses, refine UI, & fix UI bugs.​
🟢 Low Priority) Final demo preparation & deployment.
(
(
Phase-5: Project Development
Objective:

Implement core features of the AutoSage App.

Key Points:

1.​ Technology Stack Used:​

○​ Frontend: Streamlit
○​ Backend: Google Gemini Flash API
○​ Programming Language: Python
2.​ Development Process:​

○​ Implement API key authentication and Gemini API integration.

○​ Develop vehicle comparison and maintenance tips logic.
○​ Optimize search queries for performance and relevance.
3.​ Challenges & Fixes:​

○​ Challenge: Delayed API response times.​

Fix: Implement caching to store frequently queried results.
○​ Challenge: Limited API calls per minute.​
Fix: Optimize queries to fetch only necessary data.

Phase-6: Functional & Performance Testing

Objective:

Ensure that the AutoSage App works as expected.

Test
Case ID Category Test Scenario Expected Outcome Status Tester

✅ Passed
Functional Query "Best budget cars Relevant budget cars shanwa
TC-001 Testing under ₹10 lakh" should be displayed. z
Query "Motorcycle

✅ Passed
Functional maintenance tips for Seasonal tips should
TC-002 Testing winter" be provided. anwar
 Performance API response time under API should return ⚠ Needs
TC-003 Testing 500ms results quickly. Optimization Tester 3

✅ Fixed
Bug Fixes & Fixed incorrect API Data accuracy should Develop
TC-004 Improvements responses. be improved. er
Final Ensure UI is responsive UI should work on ❌ Failed - UI
TC-005 Validation across devices. mobile & desktop. broken on mobile Tester 2

🚀 Deployed
Deployment Host the app using App should be
TC-006 Testing Streamlit Sharing accessible online. DevOps

Final Submission
1.​ Project Report Based on the templates
2.​ Demo Video (3-5 Minutes)
3.​ GitHub/Code Repository Link
4.​ Presentation