What is MyWarranties?

MyWarranties is a comprehensive warranty management system that helps customers track product warranties and communicate with suppliers through an interactive claim system.

Problem Statement

Managing product warranties is challenging:

• Lost receipts - Paper receipts fade or get lost
• Forgotten warranties - Hard to remember when warranties expire
• Complex claims - Difficult to communicate with suppliers
• No tracking - No central place to manage all warranties

Solution

MyWarranties provides:

For Customers

• 📱 Digital Warranty Tracking - Store all warranties in one place
• 🔔 Expiration Alerts - Get notified before warranties expire
• 💬 Easy Claims - Interactive claim system with messaging
• 📸 Receipt OCR - AI-powered receipt scanning
• 📧 Email Integration - Reply to claims via email

For Suppliers

• 📊 Claim Management - Handle customer claims efficiently
• 💬 Direct Communication - Chat with customers about claims
• 📧 Email Notifications - Respond via email
• 🏷️ Brand Recognition - Build customer trust

Key Features

1. Product Management

Track products with:

• Purchase date and location
• Warranty period
• Receipt photos
• Product photos
• Automatic expiration calculation

2. Warranty Claims

Interactive claims with:

• Real-time messaging
• Photo attachments
• Email integration
• Status tracking (open, in progress, resolved, closed)
• Automatic supplier assignment

3. Notifications

Multiple notification channels:

• Push notifications (mobile)
• Email notifications
• Real-time updates (Mercure)
• Warranty expiration alerts

4. AI-Powered Features

• Receipt OCR - Extract purchase date, store, price from receipts
• Smart categorization - Automatic product categorization
• Date detection - Intelligent date parsing

Technical Overview

Architecture

MyWarranties uses a modern, scalable architecture:

┌─────────────────────────────────────────────────────┐
│                   Mobile App                         │
│            (iOS / Android / Web)                     │
└─────────────┬───────────────────────────────────────┘
              │
              │ HTTPS / REST API
              │
┌─────────────▼───────────────────────────────────────┐
│              Symfony Backend (PHP 8.3)               │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐          │
│  │  Auth    │  │  Claims  │  │  Email   │          │
│  │  (JWT)   │  │  System  │  │  (Resend)│          │
│  └──────────┘  └──────────┘  └──────────┘          │
└─────────────┬───────────────────────────────────────┘
              │
    ┌─────────┼─────────┬──────────────┬────────────┐
    │         │         │              │            │
┌───▼───┐ ┌──▼───┐ ┌───▼────┐  ┌──────▼──────┐ ┌──▼────┐
│ MySQL │ │Resend│ │Firebase│  │  Mercure    │ │Claude │
│  DB   │ │Email │ │  Push  │  │  Realtime   │ │  AI   │
└───────┘ └──────┘ └────────┘  └─────────────┘ └───────┘

Technology Stack

Layer	Technology
Framework	Symfony 8.0
Language	PHP 8.3+
Database	MySQL 8.0 / PostgreSQL 13+
Authentication	JWT (Lexik Bundle)
API Docs	OpenAPI / Swagger
Email	Resend API
Push Notifications	Firebase Cloud Messaging
Real-time	Mercure (Server-Sent Events)
AI/ML	Claude AI (Anthropic)
Testing	PHPUnit 12.5
Deployment	Docker + Kubernetes

Security Features

• 🔐 JWT Authentication - Secure token-based auth
• 🛡️ Role-Based Access Control - Customer, Supplier, Admin roles
• 🔒 Password Hashing - Bcrypt with salt
• ✅ CSRF Protection - Token validation
• 🔑 Webhook Signatures - HMAC-SHA256 verification
• 🕒 Timestamp Validation - Replay attack prevention
• 🚫 SQL Injection Prevention - Doctrine ORM
• 📝 Input Validation - Strict validation on all inputs

Use Cases

Personal Use

• Track home appliance warranties
• Manage electronics warranties
• Store receipts digitally
• Get expiration reminders

Business Use

• Track equipment warranties
• Manage fleet warranties
• Streamline claim processes
• Reduce warranty costs

Supplier Integration

• Handle customer claims
• Improve customer service
• Track warranty performance
• Reduce support costs

API-First Design

MyWarranties is built API-first:

• RESTful API - Standard HTTP methods
• JSON Responses - Consistent format
• OpenAPI Documentation - Interactive API docs
• Versioned - Backward compatible
• Rate Limited - Fair usage
• Paginated - Efficient data transfer

Scalability

Designed to scale:

• Horizontal Scaling - Add more servers
• Database Replication - Read replicas
• CDN Integration - Fast asset delivery
• Caching - Redis/Memcached support
• Queue System - Background job processing
• Load Balancing - Distribute traffic

Open Source

MyWarranties is open-source:

• MIT License - Use freely
• GitHub - Source code available
• Community - Contributions welcome
• Documented - Comprehensive docs
• Tested - 40+ tests

Next Steps

Ready to get started?

• Getting Started Guide - Set up the backend
• API Reference - Explore the API
• CLI Commands - Learn console commands
• Email Integration - Configure email features