Bionik6/fayeku-web

Fayeku is a B2B invoicing & payment recovery SaaS for SMEs in Senegal. Create professional invoices, automate WhatsApp payment reminders, embed Wave mobile payment links, and track outstanding payments — built to solve late payments for West African businesses. # Fayeku Fayeku is a B2B SaaS platform for African SMEs and accounting firms, focused first on Senegal and Ivory Coast. It combines invoicing, debt collection, treasury visibility, accountant collaboration, and fiscal compliance in one Laravel application. The platform serves two product surfaces: - `Fayeku PME` for SME owners and their teams - `Fayeku Compta` for accountants and accounting firms ## Core Product Rules These are foundational business constraints in this repository: - Authentication is `phone number + password` only - OTP by SMS is required at registration only, never at login - Registration country support is limited to Senegal (`+221`) and Ivory Coast (`+225`) - Phone numbers are stored in E.164 format - Monetary amounts are stored as integer FCFA values only - Payment reminders support WhatsApp, SMS, and email - Reminder quotas apply to the total number of sends across all channels - Ivory Coast FNE compliance is live and mandatory - Senegal DGID compliance is planned and the app must stay integration-ready ## Tech Stack - Laravel 13 - PHP 8.5 target architecture - Livewire 4 - Flux UI 2 - Tailwind CSS 4 - Alpine.js 3 - Laravel Fortify - Laravel Sanctum - PostgreSQL 16 - Redis for cache - Database queue driver via PostgreSQL `jobs` table - Pest 4 for testing ## Architecture Fayeku is built as a modular monolith. Business code lives in `modules/`, not just under `app/`. Top-level module groups: - `modules/Shared`: shared models, services, interfaces, middleware, config - `modules/Auth`: registration, login, OTP verification, core account/company setup - `modules/PME`: SME-facing domains such as invoicing, clients, collection, and treasury - `modules/Compta`: accountant-facing domains such as portfolio, export, partnership, and compliance Module providers are registered in `bootstrap/providers.php`. ### Module Boundaries - Shared code belongs in `modules/Shared` - Cross-module side effects should use events - Cross-module reads should …