Phishing Awareness Game

# Phishing Awareness Game

**Interactive security awareness training with gamified phishing scenarios**

[![Python](https://img.shields.io/badge/Python-3.11+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
[![License](https://img.shields.io/badge/License-MIT-22C55E?style=for-the-badge)](LICENSE)
[![Security](https://img.shields.io/badge/Security-Focused-FF4500?style=for-the-badge)](SECURITY.md)

[![Kirov Dynamics](https://img.shields.io/badge/Part_of-Kirov_Dynamics-0EA5E9?style=for-the-badge)](https://github.com/Raphasha27/kirov-dynamics)

**Built by [Koketso Raphasha](https://github.com/Raphasha27) — Practical AI for Africa**



## Overview

Educational gamification platform that trains users to identify phishing attempts through realistic scenarios. Features progressive difficulty, scoring system, performance analytics, and detailed awareness reporting for organizations.

## Features

- **Realistic Scenarios** — Email, SMS, and website phishing simulations
- **Gamification** — Points, levels, badges, and leaderboards
- **Progressive Difficulty** — Adaptive scenarios based on user performance
- **Analytics Dashboard** — Organizational awareness metrics
- **Training Mode** — Educational explanations for each scenario
- **Reporting** — PDF/CSV export for compliance tracking


## Architecture

```mermaid
graph LR
    USER[User] --> API[FastAPI]
    API --> PROC[Processor]
    PROC --> DB[(Database)]
    API --> AUTH[Auth Layer]
    PROC --> AI[AI/ML Engine]
```

Microservices-based architecture with API Gateway, authentication layer, PostgreSQL persistence, and event-driven communication.

## Quick Start

```bash
git clone https://github.com/Raphasha27/Phishing-Awareness-Game.git
cd Phishing-Awareness-Game
pip install -r requirements.txt
python game.py
```

## Ecosystem

| Project | Description |
|---------|-------------|
| [Suspicious-URL-Checker](https://github.com/Raphasha27/Suspicious-URL-Checker) | Phishing URL detection and risk scoring |
| [Password-Analyzer](https://github.com/Raphasha27/Password-Analyzer) | Password strength analysis |
| [Insider-Threat-Detector](https://github.com/Raphasha27/Insider-Threat-Detector) | Behavioral analytics for insider threat detection |

## Product Ladder

```
GitHub (this repo)
    ↓
Portfolio → https://raphasha27.github.io/raphasha-dev-portfolio
    ↓
Contact → https://github.com/Raphasha27
```

## License

MIT — see [LICENSE](LICENSE)