How marwaneproo/perdicia works
PERDICIA is a local-workspace business intelligence platform: users upload or choose a dataset, then inspect its quality and preview, explore filtered KPIs and charts, view rule-based insights or a statistical forecast, and export results. The frontend’s page-to-API relationships and backend route dispatch are supported by the source index and routes excerpt; backend helper implementations are partly unsampled, so their internal relationships are limited to those explicitly shown or indexed.
Main entry points: routes.py API routes · App.tsx App routing · api.ts API client · DataManagement.tsx Data management
Components 22
Workspace UI
- App routing
frontend/src/App.tsx - Workspace layout
frontend/src/layouts/AppLayout.tsx - Dataset preview
frontend/src/pages/DataManagement.tsx
Dataset Ingestion
- Data management
frontend/src/pages/DataManagement.tsx - Dataset state
frontend/src/hooks/useDataset.tsx - API client
frontend/src/services/api.ts - API routes
backend/app/routes.py - Dataset registry
backend/app/database.py - Uploaded files
backend/storage
Analytics
- Profiling & KPIs
backend/app/analysis.py - Business overview
frontend/src/pages/Overview.tsx - Analytics studio
frontend/src/pages/Analytics.tsx - Chart suggestions
backend/app/visualization.py - Business insights
frontend/src/pages/Insights.tsx - Insight rules
backend/app/insights.py - Forecast view
frontend/src/pages/Forecast.tsx - Forecast baseline
backend/app/forecasting.py
Results & Plans
- Report exports
backend/app/export.py - Pricing plans
frontend/src/pages/Pricing.tsx - Plan state
frontend/src/hooks/useSubscription.tsx
Other components
- Business user
- Browser / API consumer
Connections 25
- Business user → App routing: uses workspace
frontend/src/App.tsx - App routing → Data management: routes to
frontend/src/App.tsx - App routing → Business overview: routes to
frontend/src/App.tsx - App routing → Analytics studio: routes to
frontend/src/App.tsx - App routing → Business insights: routes to
frontend/src/App.tsx - App routing → Forecast view: routes to
frontend/src/App.tsx - App routing → Pricing plans: routes to
frontend/src/App.tsx - App routing → Workspace layout: renders pages in
frontend/src/App.tsx - Data management → Dataset state: uploads or selects
frontend/src/pages/DataManagement.tsx - Dataset state → API client: requests datasets
frontend/src/hooks/useDataset.tsx - API client → API routes: calls API
- API routes → Profiling & KPIs: loads and profiles
backend/app/routes.py - API routes → Dataset registry: registers and looks up
backend/app/routes.py - API routes → Uploaded files: writes uploaded files
backend/app/routes.py - API routes → Chart suggestions: builds charts
backend/app/routes.py - API routes → Insight rules: builds insights
backend/app/routes.py - API routes → Forecast baseline: computes forecast
backend/app/routes.py - API routes → Report exports: creates exports
backend/app/routes.py - Data management → Dataset preview: shows preview
frontend/src/pages/DataManagement.tsx - Business overview → API client: requests overview data
frontend/src/pages/Overview.tsx - Analytics studio → API client: requests analysis
frontend/src/pages/Analytics.tsx - Business insights → API client: requests insights
frontend/src/pages/Insights.tsx - Forecast view → API client: requests forecast
frontend/src/pages/Forecast.tsx - Pricing plans → Plan state: chooses plan
frontend/src/pages/Pricing.tsx - Browser / API consumer → API routes: receives downloads