Skip to content

Godwind5/Blitz-Q

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ† Blitz-Q

Grand Prize Winner of Dankook University ZeroThon 2025 (National-Level Competition)
AI-powered Daily Stand-up Automation Platform for Maximizing Team Collaboration Efficiency

ν•œκ΅­μ–΄ README

🎯 Project Overview

"What's our team doing?" - This project started with this simple question.

This phrase comes up in every team project: "What's our team doing?" Blitz-Q was born to solve this frustration. Like Blitzcrank's Q skill in League of Legends, it's an AI-powered collaboration tool that hooks all team members' schedules and progress at once.

πŸš€ Core Values

  • Efficiency: Manual report compilation β†’ AI automated comprehensive analysis
  • Transparency: Real-time sharing of all team members' progress
  • Insights: AI-driven team status analysis and improvement suggestions

✨ Key Features

πŸ“Š Smart Report System

  • Personal Daily Reports: Input yesterday's work, today's tasks, and issues
  • AI Auto-Synthesis: AI compiles individual reports into comprehensive team reports
  • Real-time Progress Tracking: Visualization of individual/team project progress

πŸ€– AI Analysis Engine

  • Google Gemini API based intelligent analysis
  • Automatic Issue Detection: Identification of team issues and bottlenecks
  • Solution Recommendations: Specific and actionable improvement suggestions
  • Trend Analysis: Pattern recognition in team performance changes

πŸ’¬ Collaborative Communication

  • Issue-based Comment System: Team communication on specific problems
  • Personal Task Management: Checklist-based task tracking
  • Real-time Notifications: Instant sharing of important updates

🏒 Team Management

  • Easy Team Creation: One-click team creation and management
  • Invite Code System: Simple team member invitation with 12-digit codes
  • Permission Management: Role-based access control (Admin/Member)

πŸ›  Tech Stack

Backend

  • Node.js + Express.js: Robust server architecture
  • SQLite3: Lightweight database (for development/testing)
  • JWT: Secure authentication system
  • Google OAuth 2.0: Social login integration

Frontend

  • Vanilla JavaScript: Optimized performance with pure JavaScript
  • HTML5 + CSS3: Modern web standard-based UI
  • Responsive Design: Perfect usability on all devices

AI & External APIs

  • Google Gemini API: Advanced natural language processing and analysis
  • Google OAuth 2.0: Simple and secure login

DevOps & Tools

  • dotenv: Environment variable management
  • bcrypt: Password encryption
  • nodemon: Enhanced development efficiency

πŸ“‚ Project Structure

Blitz-Q/
β”œβ”€β”€ πŸ“ public/              # Frontend files
β”‚   β”œβ”€β”€ πŸ“„ index.html        # Main dashboard
β”‚   β”œβ”€β”€ πŸ“„ login.html        # Login page
β”‚   β”œβ”€β”€ πŸ“„ report.html       # Report creation page
β”‚   β”œβ”€β”€ πŸ“ css/             # Stylesheets
β”‚   β”œβ”€β”€ πŸ“ js/              # Client-side scripts
β”‚   └── πŸ“ images/          # Static image assets
β”œβ”€β”€ πŸ“ database/            # Database files
β”œβ”€β”€ πŸ“„ server.js            # Main server file (1,800+ lines)
β”œβ”€β”€ πŸ“„ auth.js              # Authentication module
β”œβ”€β”€ πŸ“„ database.js          # Database management
β”œβ”€β”€ πŸ“„ reportAnalysis.js    # AI analysis engine
β”œβ”€β”€ πŸ“„ package.json         # Dependency management
└── πŸ“„ .env.example         # Environment variable template

πŸš€ Quick Start

1. Clone and Install

git clone https://github.com/Godwind5/Blitz-Q.git
cd Blitz-Q
npm install

2. Environment Setup

Create a .env file and add the following:

# Google OAuth Configuration
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_CALLBACK_URL=http://localhost:3000/api/auth/google/callback

# JWT Security Key
JWT_SECRET=your_super_secret_jwt_key

# Gemini AI API
GEMINI_API_KEY=your_gemini_api_key

# Session Security Key  
SESSION_SECRET=your_session_secret

3. Run Server

# Development mode
npm run dev

# Production mode
npm start

4. Open in Browser

Visit http://localhost:3000 to experience Blitz-Q!

πŸ”§ API Endpoints

Authentication

  • POST /api/auth/login - Standard login
  • GET /api/auth/google - Google OAuth login
  • POST /api/auth/logout - Logout

Team Management

  • GET /api/teams - Get my teams
  • POST /api/teams - Create new team
  • GET /api/teams/:teamId/members - Get team members
  • POST /api/teams/:teamId/invite - Generate invite code
  • POST /api/teams/join - Join team with invite code

Reports

  • POST /api/reports/:teamId - Submit daily report
  • GET /api/reports/:teamId/user-latest - Get my latest report
  • GET /api/reports/:reportId/analysis - Get AI analysis results
  • GET /api/reports/team-summary/:teamId - Get team comprehensive analysis

πŸ† Award Story

Won Grand Prize among 19 teams at Dankook University ZeroThon 2025 - a national-level hackathon competition!

πŸ”— Official Event Links:

Development Process

  • Duration: March 26-29, 2025 (100 hours)
  • Team: 2 Backend, 3 Frontend developers
  • Presentation Order: 18th out of 19 teams (overcame disadvantageous position!)

Differentiating Factors

  1. Live Server Deployment: Fully integrated frontend-backend complete product
  2. AI-powered Analysis: Intelligent insights beyond simple compilation
  3. Practicality: Production-ready completion level for immediate business use

Judge Panel

Industry professionals from Toss, Naver, and financial public institutions served as judges, providing thorough validation from a practical perspective.

Presentation Highlight

"What's our team doing?"

This single phrase captured the attention of judges and audience, leaving a strong impression despite being the second-to-last presentation.

πŸ“Š Performance Metrics

  • Total Code Lines: 9,700+ lines
  • Core Server File: 1,800+ lines (server.js)
  • API Endpoints: 20+ endpoints
  • Completion Level: Full frontend-backend integration

πŸ“ Development Stories & Blogs

Check out the development process and experiences written by our team members!

πŸ‘₯ Team Introduction

An innovative collaboration tool created by Team Shinbaram.

  • Backend: Robust server architecture and AI analysis engine implementation
  • Frontend: Intuitive and responsive user interface design
  • Planning: Feature design reflecting real workplace needs

🀝 Contributing

Join us in advancing Blitz-Q!

  1. Fork this repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“ž Contact

Feel free to reach out with any questions or suggestions about the project!


⚑ Blitz-Q: Setting New Standards for Team Collaboration ⚑

Made with ❀️ by Team Shinbaram | Grand Prize Winner of Dankook University ZeroThon 2025

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors