ibukunoluwa-james/solvo

Solvo: pan-African payroll, tax automation, and emergency credit in a single dashboard. Built for Build the Future · Kora. # Solvo > One payroll engine. Every African employee paid correctly, compliantly, and instantly. Solvo is a compliance-first global payroll platform for international companies hiring across Africa. It bundles multi-currency salary disbursement, automated local tax compliance, and on-demand emergency credit into a single dashboard — built on Kora's payout infrastructure. --- ## What Solvo does - **Global bulk payroll** — disburse salaries simultaneously across 10+ African markets via Kora's bulk payout engine, bypassing correspondent banking delays. - **Automated tax compliance** — localized PAYE, pension, and statutory deductions calculated and remitted to each jurisdiction's revenue authority, on time. - **Emergency advance credit** — low-risk, employer-backed salary advances issued instantly to workers facing unexpected shortfalls. - **Unified dashboard** — one interface for HR/finance teams to manage headcount, pay runs, compliance, and advance approvals. --- ## Repository structure This is a two-app monorepo: a FastAPI backend and a Next.js dashboard, with shared docs and design assets at the root. ``` solvo/ ├── backend/ FastAPI service (Python 3.11+) │ ├── app/ │ │ ├── main.py App factory, CORS, lifespan, router wiring │ │ ├── config.py pydantic-settings — env, Kora keys, JWT │ │ ├── database.py Async SQLAlchemy engine + session │ │ ├── dependencies.py FastAPI dependency injection helpers │ │ ├── models/ SQLAlchemy ORM (company, user, employee, │ │ │ payroll, advance, tax_remittance) │ │ ├── schemas/ Pydantic request/response models │ │ ├── routers/ auth, companies, employees, payroll, │ │ │ advances, compliance, webhooks │ │ └── services/ Business logic — payroll_service, │ │ advance_service, tax_engine, kora_service │ ├── alembic/ Database migrations …