About InsightX
Technical specifications and architecture details behind the Cricket Analytics Studio
Platform Vision
IPL InsightX is an advanced AI-powered cricket analytics studio that turns raw, ball-by-ball delivery log sheets and match scoreboards into actionable, tactical summaries. By ingestion of standardized sports statistics layouts, coaches, players, and analysts can query pitch boundaries behaviors, death-overs run rates, batter strike-rate scatter plots, and toss bias distributions, backed by an interactive co-pilot assistant.
Frontend Client Spec
- React & Next.js 15: Modular pages architecture utilizing the Next.js App Router for layout scoping.
- Tailwind CSS v4: Premium neon glassmorphic overlays, custom stadium background mesh, and scrollbars.
- Recharts: Responsive, client-side SVG graphing of 9 sports visualizations with hydration checks.
- Framer Motion: Micro-animations and bouncy state transitions.
Backend Server Spec
- Node.js & Express: REST API routing for authentication, metadata lists, filters, and charts providers.
- In-Memory CSV Engine: Ball-by-ball parsing using
csv-parser, caching records into indexed memory grids. - JWT Authentication: Session security protecting CSV upload endpoints via Express middlewares.
- PDFKit Reporting: High-fidelity PDF compiling converting scope metrics directly into downloadable document streams.
Full-Stack Flow Architecture
The diagram below outlines the communication cycle between the frontend dashboard view, Express authentication services, in-memory statistics resolvers, and document creation engines:
+-------------------------------------------------------------+
| React/Next.js Client |
| - Filter selections (Season, Team, Player, Venue) |
| - Interactive SVG Charts (Recharts) & AI Chat Co-Pilot |
+------------------------------+------------------------------+
|
GET API Requests (with JWT)
v
+-------------------------------------------------------------+
| Express.js Web Server |
| - CORS filters, logging and request body parsers |
| - JWT authorization checking middlewares |
+---------+--------------------------+------------------+-----+
| | |
Auth & Metadata Ingestion Files Query Filter
v v v
+-------------------+ +-----------------+ +-----------------+
| JSON Local DB | | Multer Ingest | | Analytics Eng |
| - User profiles | | - Save CSVs | | - In-Memory |
| - File upload | | - Check headers| | Data Caches |
| metadata log | | - Reload cache | | - Filter logic |
+-------------------+ +-----------------+ +--------+--------+
|
PDF Generator
v
+-----------------+
| PDFKit Stream |
| - A4 Cover |
| - Metrics grid |
+-----------------+Frequently Asked Questions
Q: How do I upload my own IPL datasets?A: First, authenticate an account using the "Access Studio" button in the navigation header. Then, navigate to the Deep Analytics page and click on the "Dataset Upload" tab to upload your CSV files.
Q: What column layout should my CSV files follow?A: The Matches CSV must contain columns:
id, season, team1, team2, winner, and venue. The Deliveries CSV must contain: match_id, inning, batting_team, bowling_team, over, ball, batter, bowler, and total_runs.