⏲️ Pomodify

Your Smart Productivity Companion

---

Transform your productivity with AI-powered focus sessions, smart tracking, and seamless organization

Pomodify is a customizable Pomodoro productivity tracker designed to help users focus with flexible timers, activity grouping, and comprehensive progress tracking.

---

Developed by the PUPT-DIT 3 G-Cache Team

---

🚀 What We're Building

🎯 Focus Sessions	📊 Progress Tracking	🏷️ Activity Groups	🔐 Secure Accounts
Customizable focus sessions	Track & review progress	Organize by context	Your data, protected
⏱️ Flexible timers	📈 Smart analytics	🏷️ Easy categorization	🔒 JWT security

---

📚 Table of Contents

• 🎯 Quick Start
• 🚀 Features
• ⚙️ Tech Stack
• 🎨 Design System
• 📁 Project Structure
• 🎯Development
• 🧑‍💻 Contributors
• 🤖 AI-Powered Features

---

🎯 Quick Start

Pomodify Live

Badge	E mail	Password
1️⃣	hann000345@gmail.com	Pomodify@123
2️⃣	simonejake@gmail.com	Pomodify@123
3️⃣	ivandelumen@gmail.com	Pomodify@123
4️⃣	danielvictorioso@gmail.com	Pomodify@123
5️⃣	geraldkasan163@gmail.com	Pomodify@123

---

🚀 Features

Feature	Description	Tech
⏱️ Customizable Timers	Flexible work/break sessions tailored to your needs	Angular + RxJS
🔐 User Authentication	Secure accounts with JWT & Spring Security	Spring Boot + JWT
🎭 Activity Grouping	Organize sessions by category for better context	PostgreSQL + JPA
📊 Session Tracking	Log notes, view reports, and monitor progress	Angular Material
📱 Responsive Design	Seamless experience on web & mobile devices	SCSS + Angular
🤖 AI Insights	Smart suggestions and productivity analytics	Custom AI Integration
📲 Progressive Web App	Install as app and push notifications	PWA + Service Workers

🎯 Feature Highlights

🍅 Pomodoro Timer
├── ⏰ Custom work/break intervals
├── 🔔 Smart notifications
├── ⏸️ Pause & resume functionality
└── 📈 Session completion tracking

📊 Analytics Dashboard  
├── 📅 Daily/weekly/monthly views
├── 🎯 Goal setting & tracking
├── 📋 Detailed session logs
└── 🏆 Achievement system

🤖 AI Features
├── ▶️ Session suggestions
├── 📝 Smart note-taking
├── 🎓 Learning blueprints
└── 🔍 Pattern recognition

---

🛠️ Tech Stack

Frontend Stack

Backend Stack

DevOps & Tools

📋 Detailed Tech Breakdown

Frontend

• Framework: Angular (v20.3)
• Styling: SCSS (component-scoped)
• UI Library: Angular Material
• Testing: Playwright (E2E), Karma + Jasmine (unit)
• API Communication: RxJS, HttpClient

Backend

• Framework: Spring Boot 3
• Documentation: OpenAPI (Swagger)
• Utilities: Lombok, MapStruct
• Persistence: JPA/Hibernate

Data & Infrastructure

• Database: PostgreSQL
• Migrations: Flyway
• Authentication: JWT + Spring Security
• External APIs: Google Calendar
• Deployment: Docker, GitHub Actions CI/CD

---

📁 Project Structure

project-root/
├── pomodify-frontend/        # Angular app (SCSS styling)
│   ├── src/app/             # Components, services, pages
│   ├── e2e/                 # Playwright tests
│   └── package.json
├── pomodify-backend/         # Spring Boot app
│   ├── src/main/java/       # Application logic
│   ├── src/test/java/       # Unit tests
│   └── pom.xml
├── document/                 # API docs, diagrams, guides
├── deploy-documentation/     # CI/CD & deployment guides
└── README.md

---

🔧 Development

🌿 Branch Types & Naming

Type	Purpose	Convention
main	Production-ready code	main
staging	Pre-production testing	staging
feature	New features	feature/descriptive-name
bugfix	Bug fixes	bugfix/issue-description
docs	Documentation	docs/what-changed

✅ Best Practices

• ✔️ Create branches from main for any work
• ✔️ Use descriptive branch names
• ✔️ Commit frequently with clear messages
• ✔️ Keep one feature per branch
• ✔️ Submit a PR and request review before merging

---

📜 Code Guidelines

• 🎯 Style: Follow language-specific guides (Angular, Java, etc.)
• 📝 Readability: Write clear, self-documenting code
• 💬 Comments: Add them where logic isn't immediately obvious
• 🏷️ Naming: Use meaningful variable and function names
• 🧪 Testing: Aim for good test coverage

---

🧑‍💻 Contributors

👤 Name	🎯 Role	🔗 Links
Hannah Lorainne Genandoy	Project Manager / Developer
Daniel Victorioso	Technical Lead / Developer
Simone Jake Reyes	UI/UX / Developer
Ivan Delumen	UI/UX / Developer
Gerald Mamasalanang	DevOps/ Developer

---

🤖 AI-Powered Features

Pomodify includes intelligent AI features to enhance productivity:

• 🎯 Session Suggestions — Context-aware next-step recommendations for your activities
• 🧠 Smart Blueprints — AI-generated study/learning plans with beginner & intermediate levels
• 📝 Session Notes — AI-backed suggestions to help you summarize and reflect on work

---

📚 Documentation

For detailed guides and technical docs, explore:

• API Docs: pomodify-backend/api-docs
• Architecture & Diagrams: document/
• CI/CD & Deployment: deploy-documentation/
• Developer Guide: document/

---