How sbogh/digital-stethoscope works
Project Type and Purpose
• This is a full-stack IoT system (“ScopeFace: Digital Stethoscope”) comprising three main deliverables:
a. Hardware firmware for a XIAO ESP32-S3 (audio capture + Firebase upload)
b. A cloud backend (FastAPI + Firestore) for user management and auxiliary routes
c. A native iOS app (SwiftUI + Firebase Auth/Firestore/Storage) for end-user interaction and playback
File Structure Analysis
• Top level:
• backend/ (Python FastAPI service)
• digital-stethoscope/ (Swift Xcode project for the iOS app)
• hardware/ (Arduino .ino firmware + modular drivers)
• Patterns:
• iOS follows MVVM (Views, Controllers, Models)
• Backend uses REST routes (main.py → user_routes.py) and auth_utils.py for JWT or token logic
• Hardware is modularized into individual .ino modules (WiFi, Firebase upload, audio buffer, etc.)
• Cloud/native config:
• Firebase SDK integration in iOS (Auth, Firestore, Storage)
• Firestore used both by hardware (via REST or Firebase C++ SDK) and by FastAPI via a Python wrapper
• No local database—Firebase is the central datastore.
Key README Insights
• Frontend: SwiftUI + Firebase packages installed via SPM; uses Info.plist and GoogleService-Info.plist
• Backend: FastAPI with uvicorn, exposes REST endpoints for “main” app
• Hardware: Arduino IDE + PSRAM, connects to WiFi and Firebase using device libraries