How zoron015-gif/tinkerpro-sports works
TinkerPro Sports is a Flutter marketplace for sports and fitness venues, with customer booking and engagement features plus merchant business management. The main workflow is venue discovery followed by booking and booking management; customers can also save venues, review, message, and receive match notifications, while merchants manage listings, bookings, and news. The Flutter feature modules and several API clients were not excerpted, so their internal calls are not inferred; the app-to-API and Firebase relationships are documented in the README.
Main entry points: server.js Express API · main.dart Flutter app · all_venues_page.dart Venue discovery · db.js Database access
Components 24
Customer app
- Venue discovery
lib/all_venues_page.dart - Venue booking
lib/reserve_dashboard.dart - My bookings
lib/customer_bookings_page.dart - Saved venues
lib/saved_items.dart - Reviews
lib/reviews.dart - Messaging
lib/messages_dashboard.dart - Venue news
lib/news_feed.dart - Match alerts
lib/booking_notifications.dart
Merchant app
- Merchant dashboard
lib/merchant_dashboard.dart - Business listings
lib/merchant_add_page.dart - Booking management
lib/merchant_dashboard.dart - News posts
lib/merchant_news_cards_section.dart
API backend
- Express API
backend/src/server.js - Data normalization
backend/src/normalizers.js - Business details
backend/src/business_details.js - Request limits
backend/src/rate_limit.js - Email delivery
backend/src/mailer.js - Database access
backend/src/db.js
Shared services
- Flutter app
lib/main.dart - Sign-in
lib/auth_api.dart - MySQL
database/sports.sql - Firebase sign-in
Other components
- Customer
- Merchant
Connections 19
- Customer → Venue discovery: finds venues
README.md - Venue discovery → Venue booking: proceeds to book
- Customer → My bookings: manages bookings
README.md - Customer → Saved venues: saves venues
README.md - Customer → Reviews: reviews venues
README.md - Customer → Messaging: messages
README.md - Customer → Venue news: views venue news
README.md - Customer → Match alerts: sets match alerts
README.md - Merchant → Business listings: manages profiles
README.md - Merchant → Booking management: manages bookings
README.md - Merchant → News posts: manages news
README.md - Flutter app → Express API: uses API
README.md - Flutter app → Firebase sign-in: uses sign-in
README.md - Express API → Database access: queries via
backend/src/server.js - Express API → Data normalization: uses
backend/src/server.js - Express API → Business details: uses
backend/src/server.js - Express API → Request limits: applies limits
backend/src/server.js - Express API → Email delivery: sends mail via
backend/src/server.js - Database access → MySQL: accesses