How muhammad-wasay/framepulse works
FramePulse combines a React web client, Java REST backend, and Swing desktop client around game catalogs, performance sessions, moderated reviews, and analytics. The main user flow is authenticate, manage games, record telemetry or submit reviews, moderate pending reviews, then inspect metrics and reports. The README documents the principal capabilities; sampled source and the SOURCE INDEX support only some internal links, so unsampled implementation details are left unconnected.
Main entry points: AnalyticsSystem.java Application Controller · App.jsx Web App · MainFrame.java Swing Client · LoginDialog.java Login Dialog
Components 21
Web Client
- Web App
frontend/src/App.jsx - Workflow Pages
frontend/src/pages - API Client
frontend/src/services/api.js - Seed Data
frontend/src/data/initialData.js - Canvas Stickers
frontend/src/stickers/fun.ts
Backend Services
- REST API
src/ApiServer.java - Authentication
src/AuthService.java - Data Access
src/DatabaseHandler.java - Application Controller
src/AnalyticsSystem.java
Domain and Analytics
- Game Catalog
src/Game.java - Performance Sessions
src/PerformanceSession.java - Community Reviews
src/Review.java - Review Moderation
src/Admin.java - Analytics Engine
src/AnalyticsEngine.java - Diagnostic Reports
src/Report.java
Desktop Client
- Login Dialog
src/LoginDialog.java - Swing Client
src/MainFrame.java - Session Entry
src/LogSessionPanel.java - Review UI
src/ReviewPanel.java
Other components
- Player
- Administrator
Connections 24
- Player → Web App: uses
- Administrator → Web App: uses
- Web App → Workflow Pages: renders
frontend/src/App.jsx - Web App → API Client: calls
frontend/src/App.jsx - Web App → Seed Data: loads
frontend/src/App.jsx - Workflow Pages → Canvas Stickers: renders
frontend/src/pages/DashboardPage.jsx - API Client → REST API: synchronizes
- REST API → Application Controller: dispatches
src/ApiServer.java - Application Controller → Authentication: delegates to
src/AnalyticsSystem.java - Application Controller → Data Access: persists through
src/AnalyticsSystem.java - Application Controller → Game Catalog: manages
src/AnalyticsSystem.java - Application Controller → Performance Sessions: records
src/AnalyticsSystem.java - Application Controller → Community Reviews: submits
src/AnalyticsSystem.java - Application Controller → Review Moderation: uses
src/AnalyticsSystem.java - Analytics Engine → Game Catalog: analyzes
src/AnalyticsEngine.java - Analytics Engine → Diagnostic Reports: generates
src/AnalyticsEngine.java - Player → Login Dialog: authenticates
- Login Dialog → Authentication: verifies
- Swing Client → Login Dialog: opens
src/MainFrame.java - Swing Client → Session Entry: hosts
src/MainFrame.java - Swing Client → Review UI: hosts
src/MainFrame.java - Session Entry → Application Controller: records through
src/LogSessionPanel.java - Review UI → Application Controller: submits through
src/ReviewPanel.java - Administrator → Review Moderation: moderates