🛡️ S.O.S - Safe or Scam

Phishing simulation-based security education platform

📌 About

An interactive web platform where users experience realistic phishing scenarios generated automatically from real-world phishing intelligence, helping them recognize and respond to phishing attacks.

🏗️ Tech Stack

Service	Tech
Backend	Java 21, Spring Boot 3, PostgreSQL
Game Engine	Python, FastAPI, MongoDB
AI Pipeline	Python, FastAPI, MongoDB, Gemini API
Frontend	React 18, TypeScript, axios, Tailwind CSS, Vite
Infra	Docker, Nginx, RabbitMQ, Redis

📁 Project Structure

safe-or-scam/
├── apps/
│   ├── backend/        # Spring Boot + PostgreSQL (user, auth, stats)
│   ├── game-engine/    # FastAPI + MongoDB (scenario gameplay)
│   ├── ai-pipeline/    # FastAPI (automated scenario generation)
│   └── frontend/       # React
├── infra/
│   ├── docker-compose.yml
│   └── nginx/
└── docs/
    └── api-spec/

🚀 Getting Started

Coming soon

👥 Team

Coming soon

📋 Conventions

• Conventions