An interactive onboarding simulation system designed for Julius Baer, a decision-based game interface. This project helps users understand client interaction scenarios and decision-making processes in a private banking context.

🔍 Features

Interactive client scenario simulations
AI-powered decision recommendations
Real-time scoring and feedback
Progress tracking
Document processing capabilities
Comprehensive validation system

🎯 Project Overview

The Julius Baer Onboarding Simulation is a full-stack application that:

Simulates real-world client interaction scenarios
Provides AI-powered decision recommendations
Tracks user performance and learning progress
Offers an intuitive and engaging user interface

🏗️ Architecture

Backend (Python/Flask)

RESTful API endpoints for game management
Integration with Julius Baer's API
AI advisor for decision recommendations
Game state management and scoring system
OCR capabilities for document processing

Frontend (Alpine.js & Bootsrap)

Modern, responsive user interface
Interactive game flow
Real-time decision feedback
Score tracking and progress visualization

✅ Prerequisites

Install the following system dependencies:

Python 3.12
pip
virtualenv
Node.js (v16+)
npm
tesseract-ocr

🔧 Installation Steps

1. Install Python 3.11+ and Required Tools

For Ubuntu 22.04+

sudo apt update
sudo apt install python3.11 python3.11-venv python3.11-dev

2. Install Tesseract OCR

sudo apt install tesseract-ocr

3. Install Node.js and npm

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

🚀 Project Setup

Clone the repository

git clone https://github.com/NoeBerdoz/julius_baer_onboarding
cd julius_baer_onboarding

Set up the Python virtual environment

python3.12 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

Install frontend dependencies

cd frontend
npm install
cd ..

📁 Project Structure

julius_baer_onboarding/
├── app.py                 # Main Flask application
├── config.py             # Configuration settings
├── requirements.txt      # Python dependencies
├── frontend/            # Frontend application
├── services/            # Backend services
├── dto/                 # Data Transfer Objects
├── validation/          # Validation logic
├── utils/              # Utility functions
├── game_files/         # Game-related files
└── tests/              # Test suite

🧪 Development Workflow

Start the backend server

source .venv/bin/activate
python app.py

Start the frontend development server

cd frontend
npm run dev