How cids08/financial-management works
This is a finance-management application: staff use a web UI to manage accounting and operational records, then view dashboards, reports, forecasts, and AI-generated guidance. The frontend calls a Laravel API, which exposes domain controllers and services backed by persistent financial records. Forecasting and AI are distinct stages: Laravel can delegate forecasting to a Python ARIMA service, while advisor and recommendation integrations can use an AI microservice or other configured engines. File uploads use private object storage. The README is absent and most controllers are unsampled, so links beyond the documented calls are intentionally conservative.
Main entry points: Api Domain controllers · Models Finance records · RecommendationEngine.php Recommendation engine · AiAdvisorService.php Advisor chat
Components 20
Web client
- Finance UI
finance-frontend/src/App.jsx - API client
finance-frontend/src/utils/api.js
Finance API
- API routes
finance-backend/routes/api.php - Domain controllers
finance-backend/app/Http/Controllers/Api - Access controls
finance-backend/app/Http/Middleware - Finance services
finance-backend/app/Services - Dashboards and reports
finance-backend/app/Services/ReportService.php
Forecasting and AI
- Forecast engine
finance-backend/app/Services/Forecasting/PythonArimaForecastEngine.php - Forecast API
finance-forecasting/app/main.py - ARIMA model
finance-forecasting/app/services/arima_service.py - Recommendations
finance-backend/app/Jobs/GenerateAiRecommendations.php - Recommendation engine
finance-backend/app/Contracts/RecommendationEngine.php - Advisor chat
finance-backend/app/Services/AiAdvisorService.php - Advisor engine
finance-backend/app/Contracts/AdvisorEngine.php - AI microservice
finance-aiservice/main.py
Persistence and files
- Finance records
finance-backend/app/Models - File storage
finance-backend/app/Support/FileStorage.php
Other components
- Finance staff
- Private object store
- OpenAI-compatible API
Connections 22
- Finance staff → Finance UI: uses
- Finance UI → API client: requests
- API client → API routes: calls
- API routes → Domain controllers: dispatches
- Domain controllers → Access controls: checks access
- Domain controllers → Finance services: invokes
- Domain controllers → Dashboards and reports: requests reports
- Finance services → Finance records: reads and writes
- Dashboards and reports → Finance records: queries
- Domain controllers → File storage: stores files
- File storage → Private object store: writes and signs URLs
- Domain controllers → Forecast engine: requests forecasts
- Forecast engine → Forecast API: posts forecast data
- Forecast API → ARIMA model: runs model
- Recommendations → Recommendation engine: generates guidance
- Recommendation engine → Finance records: reads forecasts
- Domain controllers → Advisor chat: handles chat
- Advisor chat → Advisor engine: requests reply
- Advisor engine → AI microservice: calls remotely
- AI microservice → OpenAI-compatible API: requests completion
- Recommendation engine → AI microservice: optional remote call
- Advisor chat → Finance records: loads conversations