README - Pet Management System Using IoT

🚀 Introduction

This is a complete IoT-based Pet Management System designed to assist local authorities, veterinary clinics, and pet owners in efficiently managing and monitoring domestic animals (dogs and cats). The system combines RFID technology, ESP32-S3 microcontroller, Firebase integration, and cross-platform software (web and mobile apps).

🌟 Features

• ✔ RFID-based unique identification for each pet
• ✔ ESP32-S3 with Wi-Fi for real-time data synchronization
• ✔ Web dashboard for veterinary/admin management
• ✔ Android application for pet owners
• ✔ Real-time notification system (vaccination reminders, violations)
• ✔ Touchscreen LCD UI for device interaction
• ✔ On-device RFID read/write, warning alerts via LED and buzzer

🚧 Hardware Overview

• Main Controller: ESP32-S3-WROOM-1U
• RFID Module: MFRC522 (13.56 MHz, SPI interface)
• Display: 2.8" TFT LCD (ILI9341 + XPT2046 touchscreen)
• Alert System: Passive buzzer + RGB LED (SK6812)
• Power Source: 2500mAh 3.7V LiPo Battery

🌐 Web Application

Built using React TypeScript and Ant Design for a modern UI/UX. Features include:

• Admin login and role-based dashboard
• Pet profile management
• Vaccination tracking
• Violation reports
• Real-time status monitoring via Firestore

📱 Android App

Built with Kotlin using Android Studio:

• View pet details, health status, vaccination history
• Receive notifications (alerts, reminders)

🏛 Backend & Database

• Database: Firebase Firestore
• Sync Protocol: HTTP with real-time capabilities
• Data includes pet profile, vaccination history, violation reports, user information

🚧 Hardware Assembly

• Custom PCB (100mm x 100mm)
• Components:
  • ESP32-S3 N16R8
  • RC522 RFID Reader
  • TFT LCD Touch
  • CH340C USB-UART
  • RT9013-3.3V Regulator
  • Passive Buzzer, Buttons, LEDs

🚧 Firmware

• Developed in ESP-IDF for ESP32-S3
• Uses SPI for RFID and LCD
• GPIOs for control buttons and buzzer
• QR code generation for Wi-Fi provisioning

📊 Results

• Stable operation of RFID scanning and data sync
• Fast mode switching using BOOT/EN buttons
• Accurate and consistent UID write/read to RFID cards
• Android and Web interfaces synchronized in real time

Tom tat du an.

✅ Getting Started

1. Clone repository: git clone https://github.com/minzdat/sys_manage_dc.git
2. Hardware: Assemble PCB or use dev board (ESP32-S3 + RC522 + ILI9341 LCD)
3. Firmware: Flash firmware via ESP-IDF or Arduino IDE
4. Frontend:
   • Navigate to web/ directory
   • Run npm install && npm start
5. Mobile App:
   • Open android-app/ with Android Studio
   • Build and run on Android device

🚡 Future Improvements

• GPS tracking integration
• Centralized national management platform
• Support for more languages and offline caching
• Expand notification system (SMS, Email, Zalo)
• Enhanced data analytics and dashboards

📜 License

This project is open-source under the MIT License.

✍️ Authors

• Trương Minh Đạt
• Lê Trần Minh Tú

---

Empowering smart pet management through IoT technology.