An enterprise-grade, state-of-the-art digital banking platform designed to redefine customer interactions and back-office banking operations. Powered by a robust Symfony 6.4 LTS architecture, Aiven Cloud Databases, and advanced Artificial Intelligence, the platform provides an interactive ecosystem segmented into three dedicated workspaces: Client, Bank Agent, and Platform Administrator.
Important
This repository is a showcase portfolio. For intellectual property reasons, the source code is private. The screenshots and documentation below demonstrate the application's architecture, UI design, and advanced logic.
Interested in the code, a live demo, or a detailed walkthrough? Please contact me directly to schedule a private showcase.
The project follows a clean Separation of Concerns (SoC) model. Logic is isolated into specific spaces using Symfony Routing and Controller namespaces:
graph TD
User([HTTP Request]) --> Router{Symfony Router}
Router -->|/register | Public[Public Space]
Router -->|/client/*| ClientSpace[Client Space - ROLE_CLIENT]
Router -->|/agent/*| AgentSpace[Agent Space - ROLE_AGENT]
Router -->|/admin/*| AdminSpace[Admin Space - ROLE_ADMIN]
subgraph Services [Advanced Business Logic & AI Services]
OCR[OcrAnalyzerService]
AI[FinancementAiService]
Assistant[ClientBankAssistant]
PDF[PdfGenerator - Browsershot]
Rate[TauxExterneService - ExchangeRate]
Geo[NominatimGeocoder]
end
ClientSpace --> Services
AgentSpace --> Services
AdminSpace --> Services
Services --> DB[(Aiven Cloud MySQL)]
The relational schema of the entities is designed to support the 5 core banking business domains:
classDiagram
direction TB
class Utilisateur {
+int id_util
+string nom_u
+string prenom_u
+string email_u
+string telephone
+string adresse
+string mot_de_passe
+string role
+DateTime date_creation
+string statut_compte
+sinscrire() bool
+seConnecter() bool
+modifierProfil() void
+deconnecter() void
}
class Profile {
+int id_profile
+int id_util
+string niveau_experience
+JSON preferences
+string photo
+string bio
+creerProfile() void
+modifierProfile() void
+uploadPhoto() void
+mettreAJour() void
}
class Banque {
+int id_Bq
+string nom
+string email
+string telephone
+string adresse
+string ville
+string code_postal
+string statut
+string[] activites
+creerBanque() bool
+modifierInfos() void
+supprimerBanque() bool
}
class Agence {
+int id_Ag
+int id_Bq
+string nom
+string adresse
+string ville
+string code_postal
+string telephone
+string email
+string horaire_ouverture
+creerAgence() bool
+modifierAgence() void
+checkDisponibilite() bool
}
class Service {
+int id_service
+string nom_service
+string description
+int duree_estimee
+bool disponible
+decimal frais
+string documents_requis
+string categorie
+string priorite_defaut
+creerService() void
+modifierService() void
+getPriorite() string
}
class RendezVous {
+int id_rv
+int id_client
+int id_agent
+int id_service
+int id_agence
+DateTime date_heure
+int duree
+string statut
+string priorite
+planifier() bool
+annuler() bool
+confirmer() void
}
class DemandeFinancement {
+int id_demande
+int id_client
+int id_agent
+int id_offre
+string type_Dmd
+DateTime date_depot
+string statut
+decimal montant
+soumettre() bool
+traiter() void
+approuver() void
+refuser() bool
}
class Document {
+int id_doc
+int id_demande
+string nom_fichier
+string type_document
+string chemin_stockage
+string statut_verification
+uploader() bool
+verifier() bool
+extraireTexte() string
}
class Offre {
+int id_offre
+int id_banque
+string nom
+string description
+Date date_debut
+Date date_fin
+float taux_interet
+decimal montant_max
+decimal montant_min
+publier() bool
+retirer() void
+calculerMensualite() decimal
}
class Condition {
+int id_condition
+int id_offre
+float taux_special
+decimal montant_seuil
+int duree_max
+ajouterCondition() void
+modifierCondition() void
+verifierEligibilite() bool
}
Utilisateur "1" *-- "1" Profile : possède
Banque "1" *-- "*" Agence : possède
Banque "1" *-- "*" Offre : propose
Banque "1" *-- "*" Service : offre
Offre "1" *-- "*" Condition : a
RendezVous "*" --> "1" Utilisateur : avec (client/agent)
RendezVous "*" --> "1" Service : pour
RendezVous "*" --> "1" Agence : à
DemandeFinancement "*" --> "1" Utilisateur : de (client)
DemandeFinancement "*" --> "1" Offre : concerne
DemandeFinancement "1" *-- "*" Document : contient
The system's core capabilities are divided into five operational modules, each containing advanced business rules and intelligent automations:
Manages account registration, role-based onboarding, and security filters.
- Hybrid Spam Protection (reCAPTCHA v2/v3): Integrates an intelligent verification loop. Form submissions default to reCAPTCHA v3 (background scoring). If the score falls below a threshold (
0.3) indicating potential bot behavior, the page dynamically injects a fallback reCAPTCHA v2 checkbox verification. - Voice-Assisted Registration (NLP Parser): Allows users to register using unstructured text or voice-to-text dictation. An AI pipeline (
google/flan-t5-largeon Hugging Face orllama-3.1-8b-instantvia Groq) extracts names, emails, and phone numbers. It handles spelling vocalizations (e.g., converting "arrobase" to@and "point" to.). A native PHP regular expression parser is integrated as a fail-safe backup. - Agent Credentials Validation workflow: Bank agents register with custom credentials, select branches, and provide corporate data. Their accounts are initialized as
pendingand restricted from the agent workspace until a Platform Administrator manually reviews and approves the application. - Extended Dynamic Profiles (1-to-1 Association): Stores user experience level, financial preferences, and bio info, which are used to personalize offer recommendations.
An automated document checking and credit scoring pipeline that processes loan applications.
- Dual-Engine OCR Analysis (
ocr.space): When a client uploads supporting documents (CNI, salary slip, utility bill), the system calls the OCR API in French (fre). A custom cleanup engine corrects typical OCR errors (e.g., correcting number typos likeoooto000, stripping currency symbols, and processing numbers with commas). - Document Completeness Engine: Automatically validates that the uploaded documents match the requirements for the selected loan type (e.g., Crédit Auto requires CNI, salary slip, vehicle quote, and utility bill).
- Cross-Document Coherence Analysis: Compares OCR-extracted data against database records:
- CNI: Validates the Tunisian National Identity Card format (exactly 8 digits) and verifies the cardholder's name.
- Salary Slip: Extracted net and gross incomes are verified, and the date is checked to ensure the document is under 3 months old (
\DateTimedelta comparison). - Utility Bill: Extracts address text and validates residency keywords.
- Document Scoring System (Out of 100): Points are allocated as follows:
- 30 pts: Complete set of required documents.
- 30 pts: OCR validation success.
- 20 pts: Extraction of essential fields (CNI card number, net income, slip date, utility address).
- 20 pts: Internal coherence check.
- Explainable AI (XAI) Justification: Uses Groq's LLM (
llama-3.1-8b-instant) to analyze the score sheet and generate a structured, professional decision summary (Auto-Approve, Request Correction, or Auto-Reject) limited to four lines. It explains the exact reasons for the decision and recommends next steps. - AI Summary Tool: Converts complex, multi-page financial descriptions into bulleted summaries for bank agents to read.
- AI Audit PDF Export: Generates printable PDF summaries of the AI scoring process and history using Dompdf or Browsershot.
A simulation tool that matches clients with active banking promotions and calculates payments.
- Multi-Tier Interest Rates: Supports fixed, variable, and mixed rate simulations:
- Fixed: Standard constant monthly payments.
- Variable: Simulates dynamic interest rate adjustments over time (e.g., +0.3% after month 24, and a maximum decrease of 0.2% after month 60).
- Mixed: Combines a 5-year fixed rate phase with a variable rate phase.
- Amortization Schedule Generator: Computes monthly principal and interest breakdowns, along with the remaining balance for the first 12 months.
- TAEG Calculator: Computes the Annual Percentage Rate based on monthly payments and loan terms.
- Live Exchange-Rate Adjusted Interest Rates: Fetches live currency exchange rates (EUR→USD via ExchangeRate API, USD→EUR via exchangerate.host) using cached Symfony HttpClient requests (TTL 1 hr) and dynamically adjusts interest rates based on currency changes.
- Ollama Credit Chatbot: A guided chatbot using a local Ollama model (
mistralorllama3.2) that queries credit type, duration, age, and rate, validates inputs (custom funny messages for ages or invalid months), finds the best matching bank offer, or calculates the nearest matching alternative (heuristics gap formula) recommending specific changes (e.g., "increase duration to XX months", "decrease amount to YY TND"). - Automated Email Notifications: Automatically emails HTML alerts (
TemplatedEmail) to all clients of the associated bank when a new offer is published. - One-Click Duplication: Allows bank agents to duplicate existing offers and terms to quickly deploy updated deals.
Maintains the catalog of services provided by each branch.
- Dynamic Search & Filtering: Offers AJAX-driven searches by keywords and categories.
- Real-time Status Toggle: Uses an AJAX route (
/toggle-status/{id}) to activate or deactivate services on the fly without refreshing the page.
Connects clients with banking agents while optimizing branch resource allocation.
- Smart Counter (Guichet) Allocation: Checks for timeslot overlaps among existing appointments at a branch (
StartA < EndB AND EndA > StartB) and automatically assigns the client to an available counter. - Secure QR Code Tickets: Generates a PNG QR Code containing the ticket reference, client name, timeslot, and counter number.
- ICS Calendar Export: Generates standard
.icscalendar files so clients can import their appointments directly into Google Calendar, Outlook, or Apple Calendar. - Visio-Conference Integration: Scans service categories and descriptions for remote keywords (e.g.,
en ligne,visio,video,distance). If detected, it creates a Jitsi Meet video room (https://meet.jit.si/beeline-rdv-{rdvId}-{clientId}) and embeds the link in the confirmation email. - Agent CRM Copilot Chatbot: An AI chatbot for agents powered by Gemini 2.5 Flash. It reads active appointments, interprets natural language commands (e.g., "Cancel appointment for client X", "Confirm appointment Y"), executes database state updates, and replies in Markdown-formatted HTML.
The application is split into three workspaces, styled with modern CSS layouts:
- Interactive dashboard displaying active accounts, finances, and upcoming appointments.
- AI Credit Simulator Chatbot with live offers matching.
- Appointment booking module with PDF tickets and ICS calendar downloads.
- Loan application wizard with document uploads and OCR checking.
- AI decision history panel.
- CRM dashboard showing branch statistics and today's calendar.
- Interactive calendar (FullCalendar integration) synced via a JSON API.
- AI Copilot interface to manage appointments through text commands.
- Service catalog editor with AJAX status controls.
- Financing dashboard with stacked bar charts.
- Loan request overview with AI summaries.
- Offers manager with one-click duplication and automated email notifications.
- System dashboard showing user distributions, active branches, and service stats.
- Chart.js analytics of platform transactions and appointments.
- User account panel supporting approvals, rejections, blocking, and unblocking.
- Agent application queue.
- Global list of banking offers, services, and loan requests.
🎯 Live screenshots from the production-ready platform — three full workspaces in action.
🔑 Login — Multi-Provider OAuth (Google · GitHub · Facebook) |
📝 Smart Registration — reCAPTCHA v2/v3 Protected |
🎙️ Voice-Assisted Onboarding — NLP Registration Parsing |
📧 Email Activation & Account Verification Flow |
🏠 Client Dashboard — Accounts, Finances & Upcoming Appointments |
🏦 Banking Offers Catalog — Filtered, Sorted & Interactive |
🤖 AI Credit Simulator (Ollama · Mistral · Llama 3.2) |
💡 Live Offer Matching & Credit Recommendations |
📋 Multi-Step Loan Application Wizard |
🔍 Document Upload + AI OCR Verification (Groq Vision) |
🧠 Explainable AI Credit Decision — Score + Justification |
📜 AI Decision History — Full Audit Trail |
📅 Intelligent Booking — Smart Counter (Guichet) Allocation |
🎫 QR Code Ticket Generation + ICS Calendar Export |
📹 Auto Jitsi Visio-Conference Room for Remote Appointments |
🗓️ My Appointments — Download PDF, Cancel & Modify |
🏢 Agent CRM Dashboard — Branch Stats & Today's Calendar |
📆 FullCalendar Integration — Real-Time Appointment Sync |
🤖 Gemini 2.5 Flash CRM Copilot — NLP Appointment Control |
💰 Smart service — With help and ai maintenace |
🏷️ Offers CRUD — One-Click Duplication & Email Notifications |
📈 External Interest Rate Sync — Live Market Data Integration |
🛡️ Admin Overview — User Distribution & Platform Metrics |
📊 AI-Generated Analytics Report (Chart.js + Gemini Insights) |
👥 User Management — Approve · Block · Reject · Role Assignment |
📋 Agent Application Queue — Review & Onboard Banking Agents |
📌 And more features inside... The source code is private. For a full demo, deep-dive walkthrough, or collaboration request — please use the contact details below.
- Core Framework: Symfony 6.4 LTS (with Twig & AssetMapper)
- PHP Version: PHP >= 8.1
- Database: MySQL / PostgreSQL hosted on the Aiven Cloud Platform
- PDF Engine: Dompdf & Spatie Browsershot (Headless Chrome via Node.js)
- QR Engine: Endroid QR Code 6
- Security: Hybrid reCAPTCHA v2/v3, Symfony Security Bundle
- Social Auth: KnpUniversity OAuth2 Client (Google, GitHub, Facebook)
- Caching: Symfony Cache Interface (Redis/Filesystem)
- Pagination: KNP Paginator
- AI Models:
- Gemini 2.5 Flash: CRM Copilot, Branch Checklists, Admin Analytics
- Groq Llama-3.1-8b-instant: Explainable AI credit scoring, OCR verification, NLP registration parsing
- Ollama (Mistral / Llama 3.2): Credit Chatbot
- Hugging Face (flan-t5-large): NLP Registration Parsing
This project showcases next-generation digital banking features built with modern web technologies.
- Developer: Mehdi Mejri
- Email: [email protected]
- LinkedIn: www.linkedin.com/in/mehdi-mejri
Feel free to reach out for project inquiries, collaborations, or code reviews.
Made with ❤️ by Mejri Mehdi