How prince-24cs072/dataxpert works
Project Type & Purpose
• Full-stack web application for AI-powered business data analytics and management.
• Frontend: vanilla JavaScript + Chart.js UI pages.
• Backend: Python Flask REST API with modular AI, authentication, and database layers.
• Database: Supabase (PostgreSQL).
• External services: Google OAuth, Supabase.
Key Components
a. Frontend Layer
• HTML/CSS/JS pages (index.html, dashboard.html, analysis.html)
• Chart.js visualizations
• OAuth & JWT client logic (auth.js, config.js)
• HTTP calls to backend API
b. Backend Layer (Flask app.py)
• Auth Service (backend/auth/auth_service.py): login, JWT issuance
• AI Modules (backend/ai/*): NLP processor, anomaly detector, analysis engine
• Database Client (backend/database/supabase_client.py)
• REST Controllers (app.py routes)
c. Database Layer
• Supabase (tables: users, teams, team_members, business_data, chats, analysis_results)
d. External Services
• Google OAuth 2.0
• Supabase
• (Optional) Email service for future notifications
Relationships & Data Flows
• User interacts with UI → HTTP request to Flask API
• Auth flow: Frontend → /auth endpoints → JWT → secured API calls
• Data operations: Backend → Supabase client → PostgreSQL
• AI analysis: Backend receives chat message → NLP & anomaly modules → stores results in analysis_results → Frontend polls/fetches results
• Google OAuth: Frontend & Backend endpoints ↔ Google identity servers
Architectural Patterns & Principles
• Layered architecture: Presentation (frontend), Business Logic (Flask + AI modules), Data Access (Supabase client), Database
• Modular design: Separate packages for auth, ai, database
• Stateless REST API with JWT security
• Externalize configuration via .env