🛡️ 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
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