How migypractice/financial-management-system-core works
This is the Transaction Core of a financial management system: external systems ingest transactions, the rule-based risk service evaluates them, authorized staff approve or reject them, and approvals post to the ledger with an audit trail. The React SPA exposes that workflow alongside dashboard, simulator, and audit views. The README documents several connections not visible in sampled excerpts; those are cited to it. Other finance modules are placeholders, not implemented product subsystems.
Main entry points: App.tsx SPA navigation · TransactionController.php Approval API · api.php API routes · IntegrationController.php Integration intake
Components 24
Ingestion and Risk
- Integration intake
backend-laravel/app/Http/Controllers/API/Integration/IntegrationController.php - Rule-based risk engine
backend-laravel/app/Services/AIService/AIService.php - Transaction records
- AI audit logs
Approval and Ledger
- Transaction model
backend-laravel/app/Models/Transaction.php - Approval API
backend-laravel/app/Http/Controllers/API/Dashboard/TransactionController.php - Maker-checker policy
backend-laravel/app/Policies/TransactionPolicy.php - Posting service
backend-laravel/app/Services/FinancialService/FinancialService.php - Journal entries
backend-laravel/app/Models/JournalEntry.php - Ledger API
backend-laravel/app/Http/Controllers/API/Dashboard/GeneralLedgerController.php - Audit-log API
backend-laravel/app/Http/Controllers/API/Dashboard/AuditLogController.php
API and Identity
- Authentication API
backend-laravel/app/Http/Controllers/API/AuthController.php - User and roles
backend-laravel/app/Models/User.php - API routes
backend-laravel/routes/api.php
React Console
- SPA navigation
frontend-react/src/App.tsx - Session context
frontend-react/src/context/AuthContext.tsx - API client
frontend-react/src/services/apiClient.ts - Approvals view
frontend-react/src/pages/Approvals/ApprovalsPage.tsx - Ledger view
frontend-react/src/pages/GeneralLedger/GeneralLedgerPage.tsx - Audit trail view
frontend-react/src/pages/AuditLog/AuditLogPage.tsx - Dashboard view
frontend-react/src/pages/Dashboard/DashboardPage.tsx - Transaction simulator
frontend-react/src/pages/Simulator/SimulatorPage.tsx - Other finance placeholders
frontend-react/src/pages
Other components
- External subsystem
Connections 31
- External subsystem → Integration intake: submits transactions
README.md - Integration intake → Rule-based risk engine: evaluates transaction
backend-laravel/app/Http/Controllers/API/Integration/IntegrationController.php - Integration intake → Transaction records: checks and persists
backend-laravel/app/Http/Controllers/API/Integration/IntegrationController.php - Integration intake → AI audit logs: writes evaluation
backend-laravel/app/Http/Controllers/API/Integration/IntegrationController.php - Rule-based risk engine → Transaction model: evaluates model
backend-laravel/app/Services/AIService/AIService.php - Approval API → Transaction model: lists transactions
backend-laravel/app/Http/Controllers/API/Dashboard/TransactionController.php - Approval API → Maker-checker policy: authorizes action
backend-laravel/app/Http/Controllers/API/Dashboard/TransactionController.php - Approval API → Posting service: delegates approve or reject
backend-laravel/app/Http/Controllers/API/Dashboard/TransactionController.php - Posting service → Journal entries: posts journal entry
README.md - Posting service → Transaction model: updates posting status
README.md - Ledger API → Journal entries: queries posted entries
backend-laravel/app/Http/Controllers/API/Dashboard/GeneralLedgerController.php - Audit-log API → AI audit logs: queries evaluations
README.md - Authentication API → User and roles: authenticates user
backend-laravel/app/Http/Controllers/API/AuthController.php - API routes → Integration intake: routes requests
backend-laravel/routes/api.php - API routes → Approval API: routes requests
backend-laravel/routes/api.php - API routes → Ledger API: routes requests
backend-laravel/routes/api.php - API routes → Audit-log API: routes requests
backend-laravel/routes/api.php - API routes → Authentication API: routes requests
backend-laravel/routes/api.php - SPA navigation → Session context: checks session
frontend-react/src/App.tsx - SPA navigation → Approvals view: renders route
frontend-react/src/App.tsx - SPA navigation → Ledger view: renders route
frontend-react/src/App.tsx - SPA navigation → Audit trail view: renders route
frontend-react/src/App.tsx - SPA navigation → Dashboard view: renders route
frontend-react/src/App.tsx - SPA navigation → Transaction simulator: renders route
frontend-react/src/App.tsx - SPA navigation → Other finance placeholders: renders placeholder routes
frontend-react/src/App.tsx - Approvals view → API client: requests API
frontend-react/src/pages/Approvals/ApprovalsPage.tsx - Ledger view → API client: requests API
frontend-react/src/pages/GeneralLedger/GeneralLedgerPage.tsx - API client → Approval API: calls approval endpoints
- API client → Ledger API: calls ledger endpoint
- Dashboard view → Approval API: fetches transactions
README.md - Audit trail view → Audit-log API: fetches audit trail
README.md