🐾 PURRPAL

🩺 AI-Powered Cat Healthcare Platform

Revolutionizing Veterinary Care Through Technology

🌐 Live Platform | 📚 API Docs | 🤖 ML Services | 🧬 Research

---

🌟 Platform Overview

PurrPal adalah platform kesehatan kucing berbasis AI yang revolutionizer, dirancang khusus untuk mengatasi tantangan akses layanan veteriner di Indonesia. Platform ini menggabungkan teknologi machine learning, web development modern, dan user experience yang intuitive untuk memberikan solusi kesehatan hewan yang comprehensive.

🎯 Problem Statement

Di Indonesia, jutaan pemilik kucing menghadapi kendala akses ke layanan veteriner berkualitas:

• 🏥 Keterbatasan Geografis: Klinik hewan hanya tersedia di kota besar
• 💰 Biaya Tinggi: Konsultasi veteriner mahal untuk masyarakat menengah ke bawah
• ⏰ Waktu Terbatas: Jam operasional klinik yang tidak fleksibel
• 📚 Kurangnya Edukasi: Minimnya informasi kesehatan hewan yang reliable
• 🚨 Deteksi Dini: Kesulitan mengenali gejala penyakit pada tahap awal

💡 Our Solution

PurrPal hadir sebagai "Dokter Hewan Digital" yang accessible 24/7, menggabungkan:

🧠 AI-Powered Diagnosis + 🌐 Modern Web Platform + 📱 Mobile-First Design
                                     ↓
              🏥 Democratized Veterinary Healthcare for Indonesia

---

🏗️ System Architecture

graph TB
    subgraph "🌐 Frontend Layer"
        FE[Next.js Application<br/>fe-purrpal.vercel.app]
    end
    
    subgraph "🚀 Backend Services"
        API[Express.js API<br/>Authentication, Stories, Modules]
        CHAT[Chatbot Service<br/>Gemini 2.0 Integration]
    end
    
    subgraph "🤖 ML Services"
        TABULAR[Tabular Service<br/>Symptom Analysis]
        VISION[Vision Service<br/>Image Recognition]
    end
    
    subgraph "🔬 Research Lab"
        RESEARCH[ML Research<br/>Model Development]
    end
    
    subgraph "💾 Data Layer"
        DB[(Supabase<br/>PostgreSQL)]
        STORAGE[Cloud Storage<br/>Images, Models]
    end
    
    FE --> API
    FE --> CHAT
    API --> TABULAR
    API --> VISION
    API --> DB
    CHAT --> DB
    RESEARCH --> TABULAR
    RESEARCH --> VISION
    STORAGE --> FE
    STORAGE --> API
    
    style FE fill:#e1f5fe
    style API fill:#f3e5f5
    style CHAT fill:#f3e5f5
    style TABULAR fill:#e8f5e8
    style VISION fill:#e8f5e8
    style RESEARCH fill:#fff3e0
    style DB fill:#fce4ec
    style STORAGE fill:#f1f8e9

Loading

🔄 Service Interaction Flow

1. 👤 User Interface → Next.js frontend provides seamless UX
2. 🔐 Authentication → Express.js API handles user management
3. 🤖 AI Consultation → Gemini-powered chatbot provides instant advice
4. 📊 Symptom Analysis → ML tabular service predicts diseases
5. 📸 Image Recognition → Computer vision analyzes cat photos
6. 🗺️ Location Services → Find nearby veterinarians
7. 📚 Education Hub → Interactive learning modules
8. 💾 Data Storage → Supabase for scalable data management

---

📁 Repository Structure

PURRPAL/
├── 🌐 frontend/                    # Next.js Web Application
│   ├── 📱 Modern React UI with TypeScript
│   ├── 🎨 shadcn/ui + Tailwind CSS design system
│   ├── 🔐 JWT authentication & user management
│   ├── 🤖 AI chat interface & symptom checker
│   ├── 🗺️ Google Maps veterinary finder
│   ├── 📚 Educational content platform
│   └── 📖 README.md → Detailed frontend documentation
│
├── 🚀 backend/                     # Express.js API Server
│   ├── 🔌 RESTful API endpoints
│   ├── 🔐 Authentication & authorization
│   ├── 📊 Database models & migrations
│   ├── 🤖 Gemini AI chatbot integration
│   ├── 📍 Location services
│   ├── 📝 Content management system
│   └── 📖 README.md → Complete backend guide
│
├── 🤖 ml-services/                 # FastAPI ML Microservices
│   ├── 📊 tabular-services/        # Symptom-based prediction
│   │   ├── 🌳 Random Forest classifier
│   │   ├── 📋 Clinical feature engineering
│   │   └── 🏥 Disease prediction API
│   ├── 📸 vision-service/          # Image-based diagnosis
│   │   ├── 🧠 CNN model (MobileNetV2)
│   │   ├── 🖼️ Skin disease detection
│   │   └── 📱 Mobile-optimized inference
│   └── 📖 README.md → ML services documentation
│
├── 🔬 ml-research/                 # Research & Development
│   ├── 📸 image-recognition-engine/
│   │   ├── 📓 Jupyter research notebooks
│   │   ├── 🤖 Model training & evaluation
│   │   └── 📊 6 cat skin diseases dataset
│   ├── 📊 tabular-analytics-engine/
│   │   ├── 📈 Statistical analysis notebooks
│   │   ├── 🌳 Random Forest development
│   │   └── 🏥 6 systematic diseases classification
│   └── 📖 README.md → Research methodology & findings
│
├── 💬 chatbot/                     # Dedicated Chatbot Service
│   ├── 🧠 Google Vertex AI integration
│   ├── 💬 Gemini 2.0 conversational AI
│   ├── 🏥 Veterinary-specific prompts
│   └── 📖 README.md → Chatbot implementation guide
│
└── 📚 README.md                    # This comprehensive overview

---

🚀 Quick Start Guide

📋 System Requirements

# Required Software
Node.js >= 18.0.0
Python >= 3.8.0
pnpm >= 8.0.0 (recommended)
Docker >= 20.0.0 (optional)
Git >= 2.0.0

# Recommended Development Tools
Visual Studio Code
Google Chrome DevTools
Postman/Insomnia (API testing)

⚡ One-Command Setup

# Clone the repository
git clone https://github.com/Hidayattt24/PURRPAL.git
cd PURRPAL

# Option 1: Development Setup (Recommended)
./scripts/dev-setup.sh  # Coming soon!

# Option 2: Manual Setup (Current)
# See individual README files for detailed instructions

🔧 Manual Development Setup

1️⃣ Frontend Setup

cd frontend
pnpm install
cp .env.example .env.local
pnpm dev
# 🌐 http://localhost:3000

👉 Complete Frontend Guide

2️⃣ Backend Setup

cd backend
npm install
cp .env.example .env
npm run dev
# 🚀 http://localhost:5000

👉 Complete Backend Guide

3️⃣ ML Services Setup

# Tabular Service
cd ml-services/tabular-services
pip install -r requirements.txt
uvicorn app:app --reload --port 8001

# Vision Service
cd ml-services/vision-service
pip install -r requirements.txt
uvicorn app:app --reload --port 8002

👉 Complete ML Services Guide

4️⃣ Research Environment

cd ml-research
pip install jupyter pandas scikit-learn tensorflow
jupyter notebook

👉 Complete Research Guide

---

🌐 Live Deployments

🔴 Production Services

Service	URL	Status	Performance
🌐 Frontend	fe-purrpal.vercel.app	🟢 Live	Lighthouse 95+
🚀 Backend API	purrpal-backend-...run.app	🟢 Live	<200ms avg
📊 Tabular ML	purrpal-ml-tabular-...run.app	🟢 Live	87.3% accuracy
📸 Vision ML	purrpal-ml-vision-...run.app	🟢 Live	85.2% accuracy

📊 API Documentation

• 🌐 Interactive API Docs: /docs
• 📊 Tabular ML Docs: /docs
• 📸 Vision ML Docs: /docs

---

🎯 Key Features

🤖 AI-Powered Healthcare

// Complete AI Pipeline
AI Features:
├── 🧠 Symptom Analysis (87.3% accuracy)
│   ├── 25+ clinical features
│   ├── 6 common cat diseases
│   └── Real-time predictions
├── 📸 Image Recognition (85.2% accuracy)
│   ├── 6 skin disease detection
│   ├── Mobile-optimized CNN
│   └── <50ms inference time
└── 💬 Conversational AI (Gemini 2.0)
    ├── 24/7 availability
    ├── Veterinary expertise
    └── Indonesian language support

🌐 Modern Web Platform

// Full-Stack Excellence
Platform Features:
├── 🎨 Premium UI/UX
│   ├── Next.js 15 + TypeScript
│   ├── shadcn/ui design system
│   └── Mobile-first responsive
├── 🔐 Enterprise Security
│   ├── JWT authentication
│   ├── Protected routes
│   └── Secure data handling
├── 📱 Progressive Web App
│   ├── Offline capability
│   ├── Push notifications
│   └── App-like experience
└── 🚀 High Performance
    ├── 95+ Lighthouse score
    ├── Auto-scaling deployment
    └── Global CDN distribution

📚 Comprehensive Education

// Learning Management System
Education Features:
├── 📖 Interactive Modules
│   ├── Cat health & nutrition
│   ├── Disease prevention
│   └── Emergency procedures
├── 🎯 Progress Tracking
│   ├── Learning achievements
│   ├── Completion certificates
│   └── Personalized recommendations
└── 🌐 Community Platform
    ├── Story sharing
    ├── Expert Q&A
    └── Peer support network

---

💻 Technology Stack

🎨 Frontend Technologies

🚀 Backend Technologies

🤖 AI/ML Technologies

☁️ Cloud & DevOps

---

🏆 Project Achievements

📊 Technical Metrics

Performance Benchmarks:
├── 🌐 Frontend Performance
│   ├── Lighthouse Score: 95+/100
│   ├── First Contentful Paint: <1.2s
│   ├── Time to Interactive: <3.0s
│   └── Bundle Size: <500KB gzipped
├── 🚀 Backend Performance
│   ├── API Response Time: <200ms avg
│   ├── Uptime: 99.9% SLA
│   ├── Concurrent Users: 1000+
│   └── Request Throughput: 1000+ RPM
├── 🤖 AI Model Accuracy
│   ├── Tabular Model: 87.3% accuracy
│   ├── Vision Model: 85.2% accuracy
│   ├── Inference Time: <100ms
│   └── Model Size: <20MB combined
└── 🔒 Security Standards
    ├── OWASP Compliance: A+ rating
    ├── JWT Token Security: ✅
    ├── API Rate Limiting: ✅
    └── Data Encryption: ✅

🎯 Business Impact

• 👥 Target Users: 10M+ cat owners in Indonesia
• 🏥 Healthcare Access: 24/7 AI-powered consultation
• 💰 Cost Reduction: 80% cheaper than traditional vet visits
• 📍 Geographic Coverage: Nationwide accessibility
• 📚 Education Impact: Comprehensive pet health knowledge
• 🌍 Social Impact: Improved animal welfare across Indonesia

---

🚀 Getting Started

🔥 For Developers

1. 📖 Read the Documentation

   • Frontend README - Next.js application setup
   • Backend README - Express.js API development
   • ML Services README - FastAPI ML deployment
   • Research README - Model development guide

2. ⚡ Quick Development Setup

   # Clone repository
   git clone https://github.com/Hidayattt24/PURRPAL.git
   
   # Choose your focus area
   cd PURRPAL/frontend    # For UI/UX development
   cd PURRPAL/backend     # For API development
   cd PURRPAL/ml-services # For ML integration
   cd PURRPAL/ml-research # For AI research

3. 🔧 Environment Configuration

   • Copy .env.example to .env in each service
   • Configure API keys and database connections
   • Follow service-specific README instructions

👥 For Product Managers

• 🌐 Live Demo: fe-purrpal.vercel.app
• 📊 Analytics Dashboard: Available in production
• 📈 Performance Metrics: Real-time monitoring enabled
• 🎯 User Feedback: Integrated feedback system

🔬 For Researchers

• 📓 Research Notebooks: ml-research/
• 📊 Dataset Information: Clinical veterinary data
• 🧠 Model Architecture: CNN + Random Forest ensemble
• 📈 Benchmark Results: 85%+ accuracy across models

🏥 For Veterinarians

• 🤖 AI Validation: Models reviewed by certified veterinarians
• 📚 Content Review: All educational content expert-verified
• 🔄 Feedback Loop: Continuous improvement with professional input
• 🌐 Partnership Program: Collaboration opportunities available

---

🤝 Contributing

We welcome contributions from developers, researchers, veterinarians, and cat enthusiasts! 🐱

📋 Contribution Areas

// Ways to Contribute
Contribution Types:
├── 💻 Code Development
│   ├── Frontend features & UI improvements
│   ├── Backend API enhancements
│   ├── ML model optimizations
│   └── Bug fixes & performance improvements
├── 🔬 Research & Data Science
│   ├── Model accuracy improvements
│   ├── New disease classifications
│   ├── Data augmentation techniques
│   └── Research paper collaborations
├── 📚 Content & Documentation
│   ├── Educational content creation
│   ├── API documentation
│   ├── Tutorial development
│   └── Translation efforts
├── 🏥 Medical Expertise
│   ├── Content validation
│   ├── Model accuracy review
│   ├── Clinical feedback
│   └── Best practices guidance
└── 🎨 Design & UX
    ├── UI/UX improvements
    ├── Mobile experience
    ├── Accessibility enhancements
    └── User research

🚀 Getting Started with Contributions

1. 🍴 Fork the Repository

   git clone https://github.com/your-username/PURRPAL.git

2. 🌿 Create Feature Branch

   git checkout -b feature/amazing-feature

3. 📝 Make Changes

   • Follow coding standards in each service
   • Add tests for new features
   • Update documentation

4. 🔍 Test Thoroughly

   # Frontend testing
   cd frontend && pnpm test
   
   # Backend testing
   cd backend && npm test
   
   # ML service testing
   cd ml-services && python -m pytest

5. 📤 Submit Pull Request

   • Detailed description of changes
   • Link to related issues
   • Screenshots for UI changes

📖 Development Guidelines

• 🎯 Code Quality: Follow ESLint, Prettier, and TypeScript standards
• 🧪 Testing: Maintain 80%+ test coverage
• 📚 Documentation: Update README files for significant changes
• 🔒 Security: Follow OWASP guidelines
• ♿ Accessibility: Ensure WCAG 2.1 AA compliance
• 📱 Mobile-First: Test on multiple devices

---

👥 Team & Acknowledgments

🏆 Core Development Team

Role	Name	Expertise	Responsibilities	GitHub
🎯 Project Lead	Ganang Setyo Hadi	Full-Stack Leadership + AI Integration + Chatbot Development	• Strategic project planning & execution • Backend architecture & API development • AI chatbot integration (Vertex AI Gemini) • ML services integration & deployment • Team coordination & technical leadership	@notsuperganang
🌐 Frontend Lead	Hidayat Nur Hakim	Frontend Development + UI Implementation	• Next.js application development • Component architecture & state management • UI design implementation • Frontend performance optimization	@Hidayattt24
🧠 ML Engineer	Agil Mughni	Computer Vision + Deep Learning	• CNN model development & training • Image recognition for cat disease detection • Vision service API implementation • Model optimization for production	@Findney
🧠 ML Engineer	Muhammad Khalid Alghifari	Data Science + Statistical ML	• Symptom analysis model development • Random Forest classifier implementation • Feature engineering & data preprocessing • Tabular ML service optimization	@khalidalghifarii
🎨 UI/UX Designer	Muhammad Ridho	User Experience + Frontend Development	• User interface design & prototyping • User experience research & testing • Design system development • Frontend component implementation	@mridho24

🎭 Team Expertise Matrix

Team Member	Frontend	Backend	AI/ML	UI/UX	Project Management
Ganang Setyo Hadi	⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐	⭐⭐⭐⭐⭐
Hidayat Nur Hakim	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐	⭐⭐⭐⭐	⭐⭐⭐
Agil Mughni	⭐⭐	⭐⭐	⭐⭐⭐⭐⭐	⭐⭐	⭐⭐
Muhammad Khalid	⭐⭐	⭐⭐	⭐⭐⭐⭐⭐	⭐⭐	⭐⭐
Muhammad Ridho	⭐⭐⭐⭐	⭐⭐	⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐

🚀 Team Contributions Highlights

// Key Achievements by Team Member
Team Contributions:
├── 🎯 **Ganang Setyo Hadi** (Project Lead)
│   ├── ⚡ Backend API architecture (50+ endpoints)
│   ├── 🤖 AI service integration pipeline
│   ├── ☁️ Google Cloud deployment setup
│   └── 📊 Project management & team coordination
├── 🌐 **Hidayat Nur Hakim** (Frontend Lead)
│   ├── ⚛️ Next.js 15 application development
│   ├── 🎨 shadcn/ui component implementation
│   ├── 📱 Mobile-responsive design system
│   └── ⚡ Performance optimization (95+ Lighthouse)
├── 🧠 **Agil Mughni** (Vision ML Engineer)
│   ├── 📸 CNN model for skin disease detection
│   ├── 🔬 Computer vision research & development
│   ├── ⚡ FastAPI vision service deployment
│   └── 📊 85.2% model accuracy achievement
├── 🧠 **Muhammad Khalid Alghifari** (Tabular ML Engineer)
│   ├── 🌳 Random Forest symptom classifier
│   ├── 📊 Feature engineering & data preprocessing
│   ├── ⚡ Tabular ML service implementation
│   └── 🎯 87.3% prediction accuracy
└── 🎨 **Muhammad Ridho** (UI/UX Designer)
    ├── 🎨 Complete UI/UX design system
    ├── 📱 Mobile-first design approach
    ├── ♿ Accessibility-focused interfaces
    └── 🌟 User experience optimization

🙏 Special Thanks

• 🏛️ DBS Foundation: Coding Camp program sponsor
• 🎓 Mentor Team: Technical guidance and project direction
• 🏥 Veterinary Partners: Medical expertise and content validation
• ☁️ Google Cloud: AI/ML infrastructure support
• 🌐 Vercel Team: Frontend hosting and deployment
• 🐱 Cat Community: User feedback and real-world testing

🌟 Open Source Contributions

This project builds upon the amazing work of the open source community:

• ⚛️ React Team: Next.js framework
• 🎨 shadcn: UI component library
• 🧠 Google: TensorFlow and Vertex AI
• 🔬 Scikit-learn: Machine learning library
• 🎭 Framer: Motion animation library
• 🌊 Tailwind CSS: Utility-first CSS framework

---

📞 Support & Contact

🆘 Getting Help

• 📧 General Inquiries:support@purrpal.id
• 💻 Technical Support: support@purrpal.id
• 🔬 Research Collaboration: support@purrpal.id
• 🏥 Veterinary Partnership: support@purrpal.id

🌐 Community & Social

• 🐙 GitHub: PURRPAL Repository
• 💬 Discord: Join Community
• 📱 WhatsApp:+62-853-3857-3726

📚 Resources

• 📖 Documentation: GitHub Wiki
• 🎥 Video Tutorials: YouTube Playlist
• 📝 Blog: Medium @PurrPal
• 📊 Changelog: Release Notes

---

📄 License

This project is licensed under the MIT License - see the LICENSE here

MIT License - Open Source Freedom
├── ✅ Commercial use
├── ✅ Modification
├── ✅ Distribution
├── ✅ Private use
└── ❌ Liability & Warranty

---

🔮 Future Roadmap

🚀 Short-term Goals (Q1-Q2 2025)

• 📱 Mobile App Development (React Native)
• 🌍 Multi-language Support (English, Bahasa Indonesia)
• 💬 Real-time Chat (WebSocket integration)
• 📊 Advanced Analytics (User behavior insights)
• 🔔 Push Notifications (Health reminders, alerts)

🌟 Long-term Vision (2025-2026)

• 🧬 Genetic Analysis Integration
• 🏥 Telemedicine Platform (Video consultations)
• 🌐 Regional Expansion (Southeast Asia)
• 📱 IoT Integration (Smart pet monitoring)
• 🤖 Advanced AI Models (Multi-modal fusion)

---

🐾 Join the Revolution

PurrPal is more than just a platform - it's a movement to democratize veterinary care and improve the lives of millions of cats across Indonesia.

🌟 Ready to Make a Difference?

---

🏆 Built with ❤️ for Cat Lovers in Indonesia 🇮🇩

PurrPal Team | DBS Foundation Coding Camp 2024

Making veterinary care accessible, one paw at a time 🐾