How doyelg/fulbitogm works
FulbitoGM is a football-match management product with web and mobile clients, shared Firebase-backed services, and a read-only MCP server for Claude. The main user workflow spans tournament and player management, match preparation and recording, then match history and statistics; related capabilities include awards, comments, video clips, and notifications. Arrows reflect the sampled source index, excerpts, or README. Many feature implementations were not sampled, so their internal calls are not expanded.
Main entry points: app Web App · tournaments.ts Firebase Client Services · matchClient.tsx Match Preparation · tools Read-only Tools
Components 26
Web and Mobile
- Web App
apps/web/src/app - Mobile App
apps/mobile/app - Player Management
apps/web/src/app/players/playersClient.tsx - Statistics
apps/web/src/app/statistics/statisticsClient.tsx - Home and Leaderboards
apps/web/src/components/home - Awards
apps/web/src/app/awards/awardsClient.tsx
Match Lifecycle
- Match Preparation
apps/web/src/app/match/matchClient.tsx - Match Forms
apps/web/src/app/match/draftForm.tsx - Match History
apps/web/src/app/history/historyClient.tsx
Tournament Community
- Tournament Management
apps/web/src/app/tournaments/tournamentsClient.tsx - Tournament Details
apps/web/src/app/tournaments/[id]/tournamentDetailClient.tsx - Members and Requests
apps/web/src/app/tournaments/[id]/members - Comments and Messaging
apps/web/src/store/useTournamentDetailStore.ts - Video Clips
apps/web/src/components/videoClips
Shared Services
- Court Addresses
apps/web/src/components/addresses/AddressManagerModal.tsx - Match Image API
apps/web/src/app/api/match-image/route.tsx - Firebase Client Services
packages/firebase/src/tournaments.ts - Domain Types
packages/types/src/match.ts - Domain Utilities
packages/utils/src/match.ts
MCP Access
- MCP Server
apps/mcp/src/index.ts - Read-only Tools
apps/mcp/src/tools - MCP Firebase Session
apps/mcp/src/firebase.ts - Tool Results
apps/mcp/src/tool-result.ts
Other components
- Players and Managers
- Firebase
- Claude MCP Client
Connections 32
- Players and Managers → Web App: uses
README.md - Players and Managers → Mobile App: uses
README.md - Web App → Player Management: manages players
apps/web/src/app/players/playersClient.tsx - Web App → Match Preparation: prepares matches
apps/web/src/app/match/matchClient.tsx - Match Preparation → Match Forms: uses form
apps/web/src/app/match/matchClient.tsx - Web App → Match History: views history
apps/web/src/app/history/historyClient.tsx - Web App → Statistics: views statistics
apps/web/src/app/statistics/statisticsClient.tsx - Web App → Home and Leaderboards: views dashboard
- Web App → Awards: views awards
apps/web/src/app/awards/awardsClient.tsx - Web App → Tournament Management: manages tournaments
apps/web/src/app/tournaments/tournamentsClient.tsx - Web App → Tournament Details: views details
apps/web/src/app/tournaments/[id]/tournamentDetailClient.tsx - Web App → Members and Requests: manages members
- Web App → Comments and Messaging: manages comments
apps/web/src/store/useTournamentDetailStore.ts - Web App → Video Clips: views clips
- Web App → Court Addresses: manages courts
apps/web/src/components/addresses/AddressManagerModal.tsx - Web App → Match Image API: requests image
apps/web/src/app/api/match-image/route.tsx - Match Preparation → Domain Utilities: balances teams
apps/web/src/app/match/matchClient.tsx - Match History → Domain Utilities: parses dates
apps/web/src/app/history/historyClient.tsx - Statistics → Domain Utilities: uses calculations
apps/web/src/app/statistics/statisticsClient.tsx - Awards → Domain Utilities: calculates awards
apps/web/src/app/awards/awardsClient.tsx - Match Preparation → Domain Types: uses match types
apps/web/src/app/match/matchClient.tsx - Match History → Domain Types: uses match types
apps/web/src/app/history/historyClient.tsx - Tournament Management → Firebase Client Services: loads drafts
apps/web/src/app/tournaments/tournamentsClient.tsx - Comments and Messaging → Firebase Client Services: reads and writes
apps/web/src/store/useTournamentDetailStore.ts - Firebase Client Services → Firebase: persists data
- Mobile App → Firebase Client Services: uses shared services
- Claude MCP Client → MCP Server: sends tool requests
README.md - MCP Server → Read-only Tools: dispatches tools
- Read-only Tools → MCP Firebase Session: authenticates session
apps/mcp/src/tools/stats.ts - Read-only Tools → Tool Results: formats results
apps/mcp/src/tools/stats.ts - MCP Firebase Session → Firebase Client Services: signs in
apps/mcp/src/firebase.ts - Read-only Tools → Firebase Client Services: queries data
apps/mcp/src/tools/stats.ts