Risk Management & Underwriting Platform

A modern underwriting platform for property risk assessment with geospatial visualization and risk scoring.

Architecture

• Frontend: React 18 + TypeScript + React-Leaflet
• Backend: Python FastAPI + SQLAlchemy
• Database: PostgreSQL 15 + PostGIS
• Infrastructure: Docker + Docker Compose

Getting Started

Prerequisites

• Docker & Docker Compose
• Node.js 18+ (for frontend development)
• Python 3.11+ (for backend development)

Quick Start

1. Start the database and backend:

docker-compose up -d

2. Start the frontend development server:

cd frontend
npm install
npm run dev

3. Access the application:

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/docs

Project Structure

risk-platform/
├── frontend/          # React TypeScript frontend
│   └── src/
│       ├── components/  # Reusable UI components
│       ├── pages/       # Page components
│       ├── api/         # API client
│       ├── types/       # TypeScript types
│       └── stores/      # State management
│
├── backend/           # FastAPI backend
│   ├── app/
│   │   ├── models/      # SQLAlchemy models
│   │   ├── schemas/     # Pydantic schemas
│   │   ├── api/         # API routes
│   │   └── services/    # Business logic
│   ├── scripts/         # Utility scripts
│   └── data/            # Test data
│
└── docker-compose.yml

Development

Backend Development

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload

Frontend Development

cd frontend
npm install
npm run dev

Database Migrations

cd backend
alembic upgrade head

Features (v1 MVP)

Submission / Underwriter SOV View

• Upload SOV spreadsheet (CSV/Excel)
• Geocode addresses with confidence indicators
• Interactive map visualization with Leaflet
• Building attribute enrichment
• Risk scoring per location (flood, fire, wind)
• Submission-level aggregation and summary

Testing

Backend Tests

cd backend
pytest

Frontend Tests

cd frontend
npm test

License

Proprietary