Skip to content

redzeptech/Pusat-Forensics

Repository files navigation

Python Forensic Turkey MIT

Ethics & Law

⚖️ Etik ve Yasal Uyarı | Ethics & Legal Notice

Bu proje Adli Bilişim Uzmanları ve Öğrencileri için geliştirilmiştir. Eğitim, araştırma ve yasal soruşturmalarda kullanım amacı taşır. Kötü niyetli kullanım, izinsiz veri erişimi veya gizlilik ihlali kesinlikle reddedilir. Kullanımdan önce LEGAL.md dosyasını okumanız önerilir.

This project is developed for Digital Forensics Experts and Students. It is intended for educational, research, and legal investigation purposes. Malicious use, unauthorized data access, or privacy violations are strictly rejected. Please read LEGAL.md before use.


PUSAT Forensics

██████╗ ██╗   ██╗███████╗ █████╗ ████████╗
██╔══██╗██║   ██║██╔════╝██╔══██╗╚══██╔══╝
██████╔╝██║   ██║███████╗███████║   ██║   
██╔═══╝ ██║   ██║╚════██║██╔══██║   ██║   
██║     ╚██████╔╝███████║██║  ██║   ██║   
╚═╝      ╚═════╝ ╚══════╝╚═╝  ╚═╝   ╚═╝   
   ███████╗ ██████╗ ██████╗ ███████╗███╗   ██╗███████╗██╗ ██████╗███████╗
   ██╔════╝██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝██║██╔════╝██╔════╝
   █████╗  ██║   ██║██████╔╝█████╗  ██╔██╗ ██║███████╗██║██║     ███████╗
   ██╔══╝  ██║   ██║██╔══██╗██╔══╝  ██║╚██╗██║╚════██║██║██║     ╚════██║
   ██║     ╚██████╔╝██║  ██║███████╗██║ ╚████║███████║██║╚██████╗███████║
   ╚═╝      ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═══╝╚══════╝╚═╝ ╚═════╝╚══════╝

🛡️ Dijital İzlerin Türk Muhafızı
The Turkish Guardian of Digital Traces

Features Installation Roadmap Contributing


🎯 Neden Pusat? | Why Pusat?

Pusat-Forensics, Türkiye odaklı adli bilişim ihtiyaçları için tasarlanmış, tek ekrandan yönetilebilen bir analiz platformudur. Projenin nasıl çalıştığını özetleyen özellik listesi:

Pusat-Forensics is a single-screen forensic analysis platform designed for Turkey-focused digital forensics needs. Feature list summarizing how the project works:

Özellik Açıklama
🔍 Akıllı Metin Analizi (NLP) WhatsApp, Telegram vb. mesajlaşma dökümlerinde kişi, yer, zaman, IBAN ve şüpheli kelime tespiti. Türkçe NER (Spacy) + KVKK maskeleme.
🗺️ HTS Görselleştirme Operatör baz istasyonu kayıtlarını interaktif haritaya dönüştürme. Şüpheli rotası, PolyLine ve marker desteği.
📁 Artifact Toplayıcı Sistem bilgisi, ağ bağlantıları, çalışan süreçler, USB geçmişi. Rapor artifacts/system_scan.txt olarak kaydedilir.
📄 Rapor Üretici NLP, HTS ve Artifact sonuçlarını tek PDF'de birleştirir. Türkiye Cumhuriyeti Adli Bilişim Standartlarına Uygun Ön İnceleme Raporu formatı.
🔒 KVKK/GDPR Uyumlu Hassas veri maskeleme, audit trail, yasal onay mekanizması. LEGAL.md ile sorumluluk reddi.
Tek Tıkla Başlat pusat.bat (Windows) ve pusat.sh (Linux) ile venv kurulumu + bağımlılık yükleme + çalıştırma.

📋 Hakkında | About

Pusat-Forensics, dijital adli bilişim alanında profesyonel araçlar sunan açık kaynaklı bir projedir. Dijital delillerin toplanması, analizi ve raporlanması süreçlerinde güvenilir ve şeffaf çözümler sunmayı hedefler.

Pusat-Forensics is an open-source project that provides professional tools in the field of digital forensics. It aims to offer reliable and transparent solutions for the collection, analysis, and reporting of digital evidence.


✨ Özellikler | Features

Özellik Feature Durum
🔍 Akıllı Metin Analizi (NLP) Smart Text Analysis (NLP) ✅ Mevcut
🗺️ HTS Görselleştirme HTS Visualization ✅ Mevcut
📁 Artifact Toplayıcı Artifact Collector ✅ Mevcut
📄 Rapor Üretici (PDF) Report Generator (PDF) ✅ Mevcut
🔒 KVKK/GDPR Uyumluluk Data Masking & Audit Trail ✅ Mevcut
🔐 Hash & Doğrulama Hash & Verification 🚧 Planlanıyor
📊 Zaman Çizelgesi Analizi Timeline Analysis 🚧 Planlanıyor
🌐 Web Artifact Analizi Web Artifact Analysis 🚧 Planlanıyor

⚙️ Kurulum | Installation

Gereksinimler | Requirements

  • Python 3.10+
  • pip veya uv

Adımlar | Steps

# 1. Depoyu klonlayın | Clone the repository
git clone https://github.com/YOUR_USERNAME/Pusat-Forensics.git
cd Pusat-Forensics

# 2. Sanal ortam oluşturun | Create virtual environment
python -m venv venv

# 3. Sanal ortamı etkinleştirin | Activate virtual environment
# Windows:
venv\Scripts\activate
# Linux/macOS:
source venv/bin/activate

# 4. Bağımlılıkları yükleyin | Install dependencies
pip install -r requirements.txt

# 5. Uygulamayı çalıştırın | Run the application
python main.py

# Veya tek tıkla başlat | Or one-click launch
# Windows: pusat.bat
# Linux/macOS: chmod +x pusat.sh && ./pusat.sh

🗺️ Yol Haritası | Roadmap

  • v0.1.0 — Temel altyapı ve hash doğrulama modülü
  • v0.2.0 — Dosya sistemi analizi
  • v0.3.0 — Zaman çizelgesi oluşturucu
  • v0.4.0 — Web tarayıcı artifact analizi
  • v1.0.0 — İlk kararlı sürüm ve dokümantasyon

🤝 Katkıda Bulunma | Contributing

Katkılarınızı bekliyoruz! 🎯

We welcome your contributions!

  1. Fork edin | Fork the repo
  2. Branch oluşturun | Create your branch (git checkout -b feature/amazing-feature)
  3. Commit yapın | Commit your changes (git commit -m 'feat: Add amazing feature')
  4. Push edin | Push to the branch (git push origin feature/amazing-feature)
  5. Pull Request açın | Open a Pull Request

Katkı Kuralları | Contribution Guidelines

  • 🔬 Adli bilişim standartlarına uygunluk
  • 📝 Net ve anlaşılır kod dokümantasyonu
  • ✅ Test coverage'ı koruma

📜 Lisans | License

Bu proje MIT Lisansı altında lisanslanmıştır.

This project is licensed under the MIT License.


🇹🇷 Türkiye'den Dijital Adalet İçin
For Digital Justice from Turkey

License Python Forensics

About

Pusat; HTS analizi, NLP tabanlı suç tespiti ve sistem izi takibi yapan milli adli bilişim aracıdır.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors