A lightweight, high-performance web application for efficient team collaboration and streamlined project management.
- About
- Features
- Tech Stack
- Database Schema
- Project Structure
- Getting Started
- API Endpoints
- Deployment
- Contributors
TeamFlow bridges the gap between overly simplistic tools like Trello and complex enterprise solutions like Jira. It focuses on core functionalities β authentication, team hierarchies, and visual task tracking β to ensure productivity without unnecessary overhead.
Built as a Database Systems Mini Project, this application demonstrates practical implementation of relational database concepts including normalization (3NF), referential integrity through foreign key constraints, and cascading operations.
| Feature | Description |
|---|---|
| π Secure Authentication | JWT-based token auth with bcrypt password hashing |
| π₯ Role-Based Teams | Create teams with admin and member roles |
| π Project Management | Organize tasks into projects within teams |
| β Task Tracking | Tasks with descriptions, priorities, deadlines, and assignees |
| π Kanban Board | Visual three-column board (To Do β In Progress β Done) |
| π Advanced Filtering | Search and filter tasks by status, assignee, or priority |
| π¨ Modern UI | Clean, responsive interface with smooth animations |
|
|
The schema is normalized to Third Normal Form (3NF) with foreign key constraints and cascading operations for referential integrity.
ββββββββββββββββ ββββββββββββββββ ββββββββββββββββ
β Users β β Teams β β Projects β
ββββββββββββββββ€ ββββββββββββββββ€ ββββββββββββββββ€
β User_ID (PK) ββββ β Team_ID (PK) ββββ βProject_ID(PK)β
β User_Name β β β Team_Name β β β Title β
β Email_ID(UQ) β β β Creator_ID ββββ β Team_ID (FK) β
β Password β β ββββββββββββββββ β β Handled_By β
ββββββββββββββββ β β β Deadline β
β ββββββββββββββββ β ββββββββββββββββ
β β Membership β β β
β ββββββββββββββββ€ β ββββββββββββββββ
βββββΆβ User_ID (FK) β β β Tasks β
β β Team_ID (FK) ββββ€ ββββββββββββββββ€
β β Is_Admin β β β Task_ID (PK) β
β ββββββββββββββββ β β Task_Desc β
β β β Deadline β
β ββββββββββββββββ β β Part_Of (FK) β
β β Status β β βAssigned_To β
β ββββββββββββββββ€ β βStatus_ID(FK) β
β βStatus_ID(PK) ββββ ββββββββββββββββ
β β Status_Name β
β ββββββββββββββββ
β
ββββ (Referenced by Teams.Creator_ID,
Tasks.Assigned_To, Membership.User_ID)
DBS-Mini-Project/
βββ client/ # Frontend (React + Vite)
β βββ src/
β β βββ components/ # Reusable UI components
β β β βββ Navbar.jsx
β β β βββ TaskCard.jsx
β β β βββ TeamCard.jsx
β β βββ pages/ # Application pages
β β β βββ Dashboard.jsx
β β β βββ Login.jsx
β β β βββ Register.jsx
β β β βββ Teams.jsx
β β β βββ TeamDetail.jsx
β β β βββ Project.jsx
β β βββ services/ # API client configuration
β β βββ store/ # Redux state management
β β βββ hooks/ # Custom React hooks
β β βββ utils/ # Utility functions
β βββ vercel.json # Vercel SPA routing config
β βββ vite.config.js
β
βββ server/ # Backend (Node.js + Express)
β βββ src/
β β βββ config/ # Environment configuration
β β βββ controllers/ # Request handlers
β β βββ db/ # Database connection pool
β β βββ middleware/ # Auth middleware (JWT)
β β βββ migrations/ # SQL schema (init.sql)
β β βββ models/ # Data access layer
β β βββ routes/ # API route definitions
β β βββ server.js # Entry point
β βββ vercel.json # Vercel serverless config
β
βββ README.md
- Node.js v14+
- MySQL Server 8.0+
- npm or yarn
git clone https://github.com/pking-hecs/DBS-Mini-Project.git
cd DBS-Mini-Project# Log into MySQL and import the schema
sudo mysql -u root < server/src/migrations/init.sqlThis creates the dbsMP database with all required tables and sample data.
cd server
npm installCreate a .env file in the server/ directory:
DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_mysql_password
DB_NAME=dbsMP
DB_PORT=3306
JWT_SECRET=your_secret_key_hereStart the server:
npm run devcd client
npm install
npm run devOpen http://localhost:5173 in your browser.
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/auth/signup |
Register a new user |
POST |
/api/auth/login |
Login & receive JWT token |
GET |
/api/auth/me |
Get current user profile |
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/teams |
List all teams for user |
POST |
/api/teams |
Create a new team |
GET |
/api/teams/:id |
Get team details |
PATCH |
/api/teams/:id |
Update team |
DELETE |
/api/teams/:id |
Delete team |
POST |
/api/teams/:id/members |
Add team member |
PATCH |
/api/teams/:id/members/:userId |
Update member role |
DELETE |
/api/teams/:id/members/:userId |
Remove member |
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/projects?teamId= |
List projects for a team |
POST |
/api/projects |
Create a project |
GET |
/api/projects/:id |
Get project details |
PUT |
/api/projects/:id |
Update project |
DELETE |
/api/projects/:id |
Delete project |
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/tasks |
List tasks (with filters) |
POST |
/api/tasks |
Create a task |
GET |
/api/tasks/:id |
Get task details |
PUT |
/api/tasks/:id |
Update task |
DELETE |
/api/tasks/:id |
Delete task |
The application is live and deployed on Vercel with Aiven MySQL as the cloud database.
| Service | Link |
|---|---|
| π Frontend | dbs-mini-project-zr8l.vercel.app |
| βοΈ Backend API Health | dbs-mini-project-xi.vercel.app/api/health |
Backend Project:
| Variable | Description |
|---|---|
DB_HOST |
Aiven MySQL hostname |
DB_PORT |
Aiven MySQL port |
DB_USER |
Database username |
DB_PASSWORD |
Database password |
DB_NAME |
Database name |
JWT_SECRET |
Secret key for JWT tokens |
CLIENT_URL |
Frontend URL (or *) |
Frontend Project:
| Variable | Description |
|---|---|
VITE_API_URL |
Backend deployment URL |
| Aditya Gayan | Ayush Ashutosh Jena | Naseh Ameen Sayrawala | Tarun P |
Built with β€οΈ as a Database Systems Mini Project