Fraud & Scam Reporting Platform

A secure, GDPR-compliant Django platform for reporting and tracking fraud and scams in the Bulgarian internet space.

Features

• User Management: Role-based access (Normal Users, Moderators, Administrators)
• Report System: Submit and track scam/fraud reports
• OSINT Integration: Automated intelligence gathering for verification
• Moderation System: Queue-based moderation workflow
• Analytics Dashboard: Statistics and insights
• GDPR Compliance: Data request handling and consent management
• Security: Multi-factor authentication, activity logging, security events

Project Structure

fraud_platform/
├── accounts/          # User management
├── reports/           # Scam/fraud reports
├── osint/             # OSINT integration
├── moderation/        # Moderation system
├── analytics/         # Analytics and statistics
├── legal/             # Legal compliance tools
└── fraud_platform/    # Project settings

Installation

1. Clone the repository (if applicable)

2. Create virtual environment:

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Set up environment variables:

cp .env.example .env
# Edit .env with your configuration

5. Set up PostgreSQL database:

# Create database
createdb fraud_platform_db

# Or using psql:
psql -U postgres
CREATE DATABASE fraud_platform_db;

6. Run migrations:

python manage.py makemigrations
python manage.py migrate

7. Create superuser:

python manage.py createsuperuser

8. Run development server:

python manage.py runserver

Configuration

Database

Update .env with your PostgreSQL credentials:

DB_NAME=fraud_platform_db
DB_USER=postgres
DB_PASSWORD=your-password
DB_HOST=localhost
DB_PORT=5432

Email

Configure email settings in .env for production:

EMAIL_HOST=smtp.example.com
EMAIL_PORT=587
EMAIL_USE_TLS=True
EMAIL_HOST_USER=your-email@example.com
EMAIL_HOST_PASSWORD=your-password

Apps Overview

Accounts

• User registration and authentication
• Profile management
• Activity logging
• Failed login tracking

Reports

• Scam report submission
• Report listing and search
• Report verification
• Tag management

OSINT

• Background task processing
• OSINT data collection
• Result storage and analysis
• Service configuration

Moderation

• Moderation queue
• Report approval/rejection
• Moderation actions logging
• Automated rules

Analytics

• Report statistics
• User statistics
• OSINT statistics
• Dashboard views

Legal

• GDPR data requests
• Consent management
• Privacy policy
• Terms of service

Security Features

• Strong password requirements (12+ characters)
• Multi-factor authentication (MFA) for admins/moderators
• Session security (HTTP-only, Secure cookies)
• CSRF protection
• XSS prevention
• SQL injection prevention
• Activity logging
• Security event tracking
• Rate limiting (to be configured)

Development

Running Tests

python manage.py test

Creating Migrations

python manage.py makemigrations
python manage.py migrate

Creating Superuser

python manage.py createsuperuser

Production Deployment

1. Set DJANGO_ENV=production in environment
2. Set DEBUG=False in .env
3. Configure proper ALLOWED_HOSTS
4. Set up SSL certificates
5. Configure production database
6. Set up static file serving
7. Configure email backend
8. Set up monitoring and logging

License

[Your License Here]

Support

For issues and questions, please contact [your contact information].