How hmooodyy/flussra works
Flussra is a payroll-management application with a React/TypeScript client and FastAPI/PostgreSQL backend. Users authenticate, manage workforce and payroll policy, create and calculate payroll periods, submit them for manager review, and inspect payroll results. The graph separates policy setup, operational payroll, review, and supporting administration. Frontend routing, selected service calls, and application router registration are evidenced by excerpts or the source index; unsampled capabilities are represented at their exact subsystem paths, with uncertain internal links omitted.
Main entry points: main.py FastAPI application · App.tsx React application · ReviewPage.tsx Review workspace · payroll Payroll workspace
Components 19
Web client
- React application
frontend/src/App.tsx - Payroll workspace
frontend/src/pages/payroll - Setup workspace
frontend/src/pages/settings/payroll - Review workspace
frontend/src/pages/ReviewPage.tsx - API clients
frontend/src/lib/apiClient.ts
API and access
- FastAPI application
backend/app/main.py - Authentication
backend/app/auth/security.py - Branch permissions
backend/app/core/service.py
Workforce and setup
- Workforce records
backend/app/workforce/service.py - Payroll policy setup
backend/app/payroll_setup/payroll_policy.py - Company settings
backend/app/settings/service.py
Payroll lifecycle
- Payroll periods
backend/app/payroll/period_lifecycle.py - Payroll calculation
backend/app/payroll/period_calculation.py
Review and administration
- Manager review
backend/app/review/service.py - Users and roles
backend/app/admin/service.py - Dashboard
backend/app/dashboard/service.py - Transfer requests
backend/app/transfer/service.py - Pay-item workflows
backend/app/cdpi/service.py
Other components
- Payroll user
Connections 22
- Payroll user → React application: uses
README.md - React application → Payroll workspace: routes to
frontend/src/App.tsx - React application → Setup workspace: routes to
frontend/src/App.tsx - React application → Review workspace: routes to
frontend/src/App.tsx - Payroll workspace → API clients: calls
- Review workspace → API clients: calls
frontend/src/pages/ReviewPage.tsx - FastAPI application → Authentication: registers routes
backend/app/main.py - FastAPI application → Payroll periods: registers routes
backend/app/main.py - FastAPI application → Payroll policy setup: registers routes
backend/app/main.py - FastAPI application → Manager review: registers routes
backend/app/main.py - FastAPI application → Company settings: registers routes
backend/app/main.py - FastAPI application → Users and roles: registers routes
backend/app/main.py - FastAPI application → Dashboard: registers routes
backend/app/main.py - FastAPI application → Transfer requests: registers routes
backend/app/main.py - FastAPI application → Workforce records: registers routes
backend/app/main.py - FastAPI application → Pay-item workflows: registers routes
backend/app/main.py - Payroll periods → Payroll calculation: uses calculation
backend/app/payroll/period_lifecycle.py - Review workspace → Manager review: loads snapshot and decides
- Payroll policy setup → Payroll workspace: provides policy
- API clients → FastAPI application: sends requests
- Workforce records → Payroll calculation: supplies workforce data
- Branch permissions → Workforce records: checks access
backend/app/workforce/service.py