Skip to content
Open sourceFull-stackInsurance

Insurceed

From quote to policy, payment to claim: a modular insurance platform

Role
Backend architecture & API
Period
2025
Status
Open source
Links
GitHub ↗
Insurceed — Visit site

By the numbers

3
user roles
25%
faster retrieval

Overview

A three-role (customer, agent, admin) insurance management platform covering offer, policy and claim workflows end to end. Rewriting the heavy relational queries improved retrieval speed by 25%.

  • Vehicle, home and health offers; automatic policy creation on approval; claims with document upload.
  • Spring Boot + JPA backend, React + TypeScript + Vite front end, JWT auth, Excel/PDF export.

01

Problem

Insurance workflows need three actors (customer, agent, admin) touching the same data with different rights. Along the offer → policy → payment → claim chain, who may do what at each step must be unambiguous.

02

Approach

A modular Spring Boot backend following SOLID: each domain (offer, policy, payment, claim, document) has its own controller/service/repository trio. JWT authentication and role-based authorization guard every endpoint.

Policy listing and reporting queries initially suffered from N+1; they were rewritten with JPQL fetch joins and projections, improving retrieval speed by 25%.

03

Architecture

  1. UI
    • React + TypeScript
    • Vite
    • Tailwind
  2. API
    • Spring Boot
    • JWT · RBAC
    • DTO / Mapper
  3. Domains
    • Teklif
    • Poliçe
    • Ödeme
    • Hasar
    • Doküman
  4. Data
    • PostgreSQL
    • JPA / Hibernate
↓ Data flows top to bottom

04

Key decisions

  1. 01

    DTO/Mapper layer and a global error contract

    Entities never reach the API directly. One error shape applies to every endpoint; the React side was written against it.

Outcome

The full flow works for all three roles: quoting, payment, automatic policy, claim filing and approval, Excel/PDF reports. The code is open source.

Related projects

  • Full-stack
    Open source

    TravelMate

    Trip planning platform with routes, activities and sharing

    A full-stack app where users create trips, add activities and locations, leave comments and share plans publicly or privately. Runs behind Nginx with Docker Compose.

    1
    command for the whole stack
    OpenAPI
    documented API
    • Java 17
    • Spring Boot
    • Spring Security
    • JWT
    • PostgreSQL
    • Next.js
    Open
    GitHub ↗
  • Full-stack
    Live

    C'esta AI

    Corporate website and product showcase of Cesta Technology

    The corporate site of C'esta AI: product pages for Cesta Lex and Cesta AIHM, blog, careers and demo-request flows. Built with Next.js, published in Turkish and English, and running on the same container infrastructure and CI/CD pipeline as the company's other products.

    2
    languages
    2
    product pages
    • Next.js
    • React
    • TypeScript
    • Docker
    • CI/CD
    Open
    Visit site ↗
  • Full-stack
    Open source

    Hastane Otomasyonu

    Java Swing hospital automation with patient and admin panels

    A Java Swing desktop app with registration, login, appointment booking and an admin panel; talks to MySQL over JDBC and builds with Maven.

    • Java
    • Swing
    • JDBC
    • MySQL
    • Maven
    Open
    GitHub ↗