How fliotta/puppysignal works
Main Components Identification
The system consists of three main components:
• Backend (FastAPI-based REST API)
• Mobile Application (React Native)
• Web Application (Found Page)
• Database (SQL-based, indicated by Alembic migrations)
Detailed Architecture Breakdown
A. Backend Layer:
• Authentication Service (auth.py)
• Pet Management Service (pet.py)
• Notification Service (notification.py)
• Profile Management (profile.py)
• QR Code Scanning Service (scan.py)
• Data Service (data.py)
B. Database Layer:
• Database with main entities:
• Users
• Pets
• Locations
• Notifications
• FCM Tokens
• Breeds/Species
C. Mobile Application Layer:
• React Native app with main features:
• Authentication Views
• Pet Management
• Profile Management
• Location Tracking
• Push Notifications
D. Web Application Layer:
• Found Page component for QR code scanning
┌─────────────────────────────────────────────┐
• Client Layer │
• ┐ ┌─────────────────────┐│
• Mobile App │ │ Web App ││
• (React Native) │ │ (Found Page) ││
• ┘ └─────────────────────┘│
• ↕ ↕ │
┌─────────────────────────────────────────────┐
• API Layer │
• ┤
• FastAPI Backend │
• ┌─────────┐ ┌─────────┐ ┌──────────┐ │
• Auth │ │ Pets │ │ Notif. │ │
• ┘ └─────────┘ └──────────┘ │
• ┘
• ↕
┌─────────────────────────────────────────────┐
• Database Layer │
• ┘
Important Flows to Highlight
• QR Code scanning flow
• Push notification flow
• Authentication flow
• Location tracking flow
Additional Elements
• External service integrations (Firebase Cloud Messaging)
• Security layers (authentication/authorization)
Technical Details
• REST API endpoints grouping
• Database relationships
• Mobile app navigation structure
• Environment configurations