How mahmoudjd/mjd-footballscout works
MJD Football Scout is a cross-platform football scouting and recruitment workspace. Scouts discover and inspect players, compare candidates, organize watchlists and scouting reports, then plan squads and advance recruitment decisions. The Next.js and Expo clients use a shared Express API; the API persists user and scouting data in MongoDB and can collect player data from public sources. The graph preserves README-documented premium and account capabilities, but sampled evidence for internal wiring is limited, so uncertain connections are omitted.
Main entry points: page.tsx Web workspace · player.model.ts Player database · index.ts Express REST API · shadow-teams.controller.ts Shadow teams
Components 20
Scout clients
- Web workspace
web-app/src/app/page.tsx - Mobile workspace
mobile-app/src/apiServices.ts
Accounts and security
- Authentication
server/src/modules/auth/auth.router.ts - User accounts
server/src/modules/auth/user.model.ts - Email notifications
server/src/modules/notifications/email.service.ts
Player intelligence
- Player database
server/src/modules/players/player.model.ts - Player discovery
server/src/modules/players/players.controller.ts - Filters and similarity
server/src/modules/players/player-query.controller.ts - Public-source extraction
server/src/scraper/scrapingData.ts - Scouting reports
server/src/modules/players/scouting.controller.ts
Recruitment planning
- Watchlists
server/src/modules/watchlists/watchlists.controller.ts - Shadow teams
server/src/modules/shadow-teams/shadow-teams.controller.ts - Formation planning
server/src/modules/shadow-teams/shadow-team-formations.ts - Squad analytics
server/src/modules/shadow-teams/shadow-team-analytics.ts - Recruitment workspace
server/src/modules/recruitment/recruitment.controller.ts
API and persistence
- Express REST API
server/src/index.ts - MongoDB
- Public player sources
- Stripe premium
Other components
- Scout
Connections 23
- Scout → Web workspace: uses
README.md - Scout → Mobile workspace: uses
README.md - Web workspace → Express REST API: requests
README.md - Mobile workspace → Express REST API: requests
README.md - Express REST API → MongoDB: persists data
README.md - Express REST API → Public player sources: collects data
README.md - Express REST API → Stripe premium: billing integration
README.md - Authentication → User accounts: reads and writes
server/src/modules/auth/auth.router.ts - Authentication → Email notifications: sends notices
server/src/modules/auth/auth.router.ts - Player discovery → Player database: reads and writes
server/src/modules/players/players.controller.ts - Player discovery → Public-source extraction: extracts players
server/src/modules/players/players.controller.ts - Filters and similarity → Player discovery: uses price parsing
server/src/modules/players/player-query.controller.ts - Filters and similarity → Player database: queries players
- Scouting reports → Player database: records reports
- Watchlists → Player database: loads players
server/src/modules/watchlists/watchlists.controller.ts - Shadow teams → Player database: loads players
server/src/modules/shadow-teams/shadow-teams.controller.ts - Shadow teams → Formation planning: gets slots
server/src/modules/shadow-teams/shadow-teams.controller.ts - Shadow teams → Squad analytics: analyzes squad
server/src/modules/shadow-teams/shadow-teams.controller.ts - Recruitment workspace → Player database: checks players
server/src/modules/recruitment/recruitment.controller.ts - Web workspace → Watchlists: shortlists
- Web workspace → Scouting reports: evaluates players
- Web workspace → Shadow teams: plans squads
- Web workspace → Recruitment workspace: manages pipeline