IYusr – Islamic Finance Platform

Client: IYusr
Period: Nov 2024 - May 2025
URL: Not public (internal platform)
Back to Projects

IYusr is a full islamic finance platform designed with a modern Java stack. It features a Spring Boot 3.3 backend and dual Angular 19 frontends (Admin Backoffice and Customer Store). The platform provides complete management for products, orders, customers, and financial operations, with secure JWT-based authentication and role-based access control. 

IYusr is a modern, Islamic-compliant finance platform designed to facilitate Islamic financing for individuals and businesses. The system provides a secure, user-friendly portal for customers to apply for financing, submit required documents, and track application status, while giving administrators a powerful backoffice to manage workflows, approvals, and compliance.

Architecture: Microservices-oriented, with a backend API and two separate frontends (customer portal and admin panel).

Project Objectives

  • Enable secure and Islamic-compliant financing services
  • Provide a responsive customer-facing portal for applications and document submissions
  • Offer administrators a comprehensive backoffice to manage applications, clients, and workflows
  • Implement role-based access control and secure authentication
  • Facilitate document management, verification, and workflow tracking
  • Support scalable and maintainable architecture for future product expansion

Technologies Used

  • Backend: Modern Java framework (Spring Boot 3.3), PostgreSQL, Spring Data JPA, JWT authentication, OAuth2, and state management for workflows
  • Frontend: Angular 19, responsive UI with PrimeNG, Tailwind CSS, Swiper for interactive components, and dynamic forms
  • Workflow & State Management: Spring StateMachine to handle application and document status transitions
  • Document Management: Multi-file upload, validation, folder hierarchy, and verification workflows
  • DevOps & Deployment: Docker, Docker Compose, Nginx for web serving, CI/CD pipelines, and containerized database
  • API Management: RESTful endpoints with OpenAPI documentation, type-safe API clients for frontends

Main Features

Customer Portal

  • Apply for Islamic financing products
  • Upload and manage required documents (ID, proof of residence, bank statements, employment certificates, etc.)
  • Track application and document status (pending, approved, rejected)
  • Receive real-time notifications for missing or updated documents
  • Manage personal profile, address book, and finance-related data

Admin Backoffice

  • Dashboard with metrics, recent activities, and performance indicators
  • Client management with detailed profiles and status tracking
  • Product and financing options management
  • Document management: upload verification, approval/rejection workflow, folder hierarchy, bulk upload
  • Role-based user management with permissions and access control

Core Functionalities

  • Authentication & Authorization: Secure login, JWT tokens, role-based access
  • Workflow Automation: Event-driven state transitions for applications and documents
  • File Handling: Multi-file upload, validation, storage, encryption (optional), and backup
  • Reporting & Notifications: Alerts for missing documents, document expiry, or status updates

🔧 Technical Implementation

Backend:

  • REST API built with Spring Boot 3.3
  • Business logic layer, repositories, and entity mapping with JPA
  • Security configuration with JWT, OAuth2, and role-based protection
  • State machine for application and document workflows

Frontend:

  • Angular 19 for both customer and admin interfaces
  • PrimeNG and Tailwind CSS for modern, responsive design
  • Interactive components: carousels, forms, data tables, modals
  • Auto-generated TypeScript API clients from OpenAPI specification

DevOps:

  • Dockerized backend, frontend, and PostgreSQL database
  • Nginx for serving Angular apps and reverse proxy
  • CI/CD pipelines for automated testing and deployment

Security

  • Backend: JWT authentication, password encryption, CORS configuration, role-based access
  • Frontend: JWT interceptor, route guards, secure token storage, CSRF protection

Key Strengths

  • Modern, secure, and scalable architecture (Spring Boot + Angular + PostgreSQL)
  • Comprehensive document management system for client verification and compliance
  • Responsive and interactive UI using PrimeNG and Tailwind CSS
  • Type-safe API communication with auto-generated clients
  • Workflow automation for application and document state transitions
  • Containerized deployment for reproducibility and scalability

Business Domain: Islamic Finance, FinTech
Type: Full-Stack Web Application
Contribution: Backend, frontend, database design, API, workflow & document management, deployment (CI-CD)
Key Feature: Advanced client document management and verification workflow with secure upload and status tracking

Technologies

Java Spring Boot Angular PrimeNG Docker PostgreSQL Github CI/CD Odoo Swagger