How yhuir/fin-ops-platform works
fin-ops-platform is a financial operations application centered on bank-to-enterprise reconciliation. Users enter through the React application and use import workflows, a reconciliation workbench, and related finance pages; backend routes expose business operations, services implement domain behavior, and PostgreSQL stores production state and business facts. Major product branches include bank transactions, invoices, OA payments, ETC, tax offsets, turnover ledgers, cost statistics, cash, and background jobs. The README documents PostgreSQL as the sole production app read/write store and OA MongoDB as read-only via an adapter. Several service and route connections are inferred from module names and documented capabilities; unsampled wiring is not expanded.
Main entry points: app Backend HTTP API · postgres_repositories PostgreSQL repositories · App.tsx React application · workbench_query_service.py Reconciliation workbench
Components 21
Client application
- React application
web/src/app/App.tsx - Import navigation
web/src/features/imports/importRoutes.ts - Page session state
web/src/contexts/pageSessionStorage.ts
Reconciliation operations
- Backend HTTP API
backend/src/fin_ops_platform/app - Data imports
backend/src/fin_ops_platform/services/import_workflow_service.py - Reconciliation workbench
backend/src/fin_ops_platform/services/workbench_query_service.py - Bank transactions
backend/src/fin_ops_platform/services/bank_details_service.py - Background jobs
backend/src/fin_ops_platform/services/background_job_service.py
Finance domains
- Input invoice usage
backend/src/fin_ops_platform/services/input_invoice_usage_canonical_query_service.py - Output collections
backend/src/fin_ops_platform/services/output_invoice_collection_canonical_query_service.py - OA pending payments
backend/src/fin_ops_platform/services/oa_pending_payment_query_service.py - ETC operations
backend/src/fin_ops_platform/services/etc_service.py - Tax offsets
backend/src/fin_ops_platform/services/tax_offset_service.py - Turnover ledger
backend/src/fin_ops_platform/services/turnover_ledger_service.py - Cost statistics
backend/src/fin_ops_platform/services/cost_statistics_query_service.py - Cash operations
backend/src/fin_ops_platform/services/cash_service.py
Persistence and integrations
- PostgreSQL repositories
backend/src/fin_ops_platform/services/postgres_repositories - PostgreSQL
- OA adapter
backend/src/fin_ops_platform/services/oa_adapter.py
Other components
- Finance user
- OA system
Connections 22
- Finance user → React application: uses
- React application → Import navigation: navigates
- React application → Page session state: persists page state
- React application → Backend HTTP API: requests operations
- Backend HTTP API → Data imports: handles imports
- Backend HTTP API → Reconciliation workbench: serves reconciliation
- Backend HTTP API → Bank transactions: serves bank details
- Backend HTTP API → Input invoice usage: serves invoice usage
- Backend HTTP API → Output collections: serves collections
- Backend HTTP API → OA pending payments: serves payment queries
- Backend HTTP API → ETC operations: serves ETC operations
- Backend HTTP API → Tax offsets: serves tax offsets
- Backend HTTP API → Turnover ledger: serves ledger
- Backend HTTP API → Cost statistics: serves statistics
- Backend HTTP API → Cash operations: serves cash operations
- Backend HTTP API → Background jobs: dispatches jobs
- Reconciliation workbench → PostgreSQL repositories: queries canonical facts
- OA pending payments → PostgreSQL repositories: loads canonical facts
- Input invoice usage → PostgreSQL repositories: loads page facts
- Output collections → PostgreSQL repositories: loads page facts
- PostgreSQL repositories → PostgreSQL: reads and writes
- OA adapter → OA system: reads OA data