===================================================================
  ____       _  _____ ____  ___ ____ _____         ___  ____ ___ _   _ _____ 
 |  _ \     / \|_   _|  _ \|_ _/ ___|_   _|      / _ \/ ___|_ _| \ | |_   _|
 | |_) |   / _ \ | | | |_) || | |     | |  ____ | | | \___ \| ||  \| | | |  
 |  __/   / ___ \| | |  _ < | | |___  | | |____|| |_| |___) | || |\  | | |  
 |_|     /_/   \_\_| |_| \_\___\____| |_|        \___/|____/___|_| \_| |_|  
===================================================================
                        PATRICT-OSINT v2.2.0
===================================================================

📌 Daftar Isi

• Tentang PATRICT-OSINT
• Domain Penyelidikan & Modul Intelijen
  • 1. Phone Intelligence
  • 2. Web & Infrastructure Reconnaissance
  • 3. Media & File Forensics
• Arsitektur & Struktur Proyek
• Persyaratan Sistem
• Panduan Instalasi
• Cara Penggunaan
• Konfigurasi Sistem
• Format Output & Laporan
• Dokumentasi & Panduan Komunitas
• Disclaimer & Etika

📖 Tentang PATRICT-OSINT

PATRICT-OSINT adalah framework intelijen sumber terbuka (Open Source Intelligence) dan forensik digital generasi baru berbasis Python dengan arsitektur Modular Monorepo. Dirancang untuk penyelidik keamanan siber, analis ancaman (threat intelligence), dan peneliti forensik digital untuk melakukan pengumpulan intelijen otomatis dan terstruktur pada 3 domain utama: Telekomunikasi (Nomor Telepon), Infrastruktur Web, dan Forensik Media/Gambar.

Framework ini mengadopsi sistem Plugin Loader Dinamis (PluginLoader) yang secara otomatis memuat modul sesuai tipe domain penyelidikan, serta menghasilkan visualisasi relasi interaktif (Interactive Network Graph) dan dashboard laporan bertema gelap (Dark Mode) yang disesuaikan untuk masing-masing domain.

⚡ Domain Penyelidikan & Modul Intelijen

PATRICT-OSINT mendukung 3 domain penyelidikan mandiri:

1. 📞 Phone Intelligence

Modul reconnaissance nomor telepon internasional (ITU-T E.164) untuk mengungkap jejak pemilik, operator, dan sebaran akun media sosial:

2. 🌐 Web & Infrastructure Reconnaissance

Modul investigasi mendalam terhadap aplikasi web dan server target:

3. 🖼️ Media & File Forensics

Modul analisis forensik berkas gambar/media (JPG, PNG, JPEG, GIF, WebP, PDF):

📂 Arsitektur & Struktur Proyek

PATRICT-OSINT/
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md          # Formulir laporan bug & error
│   │   ├── feature_request.md     # Formulir usulan fitur baru
│   │   └── config.yml             # Konfigurasi antarmuka issue GitHub
│   └── workflows/
│       ├── package.yml            # CI/CD otomatisasi build & pre-release
│       └── python-publish.yml     # Workflow publikasi PyPI
├── config/
│   ├── config.example.yaml        # Template konfigurasi sistem
│   └── config.yaml                # Konfigurasi aktif (timeout, proxy, toggles)
├── core/
│   ├── async_client.py            # HTTP Client Asinkron berbasis aiohttp
│   ├── base_module.py             # Kelas abstrak dasar BaseModule (target_type)
│   ├── config_manager.py          # Manager konfigurasi & environment variable
│   └── plugin_loader.py           # Dynamic discovery multi-domain module loader
├── data/
│   └── social_signatures.json     # Database pola & URL signature platform sosmed
├── modules/                       # Direktori modul-modul OSINT
│   ├── caller_id_osint.py         # [Phone]
│   ├── dorking_osint.py           # [Phone]
│   ├── email_osint.py             # [Phone]
│   ├── file_forensics.py          # [File/Media Forensics]
│   ├── location_osint.py          # [Phone]
│   ├── network_osint.py           # [Phone]
│   ├── phone_osint.py             # [Phone]
│   ├── social_osint.py            # [Phone]
│   ├── web_history.py             # [Phone]
│   ├── web_osint.py               # [Web Intelligence]
│   └── whatsapp_osint.py          # [Phone]
├── reports/                       # Modul pelaporan
│   ├── report_generator.py        # Generator laporan adaptif per domain
│   └── templates/
│       ├── report_dark.html       # Dashboard HTML Phone Recon & Relationship Graph
│       ├── report_web.html        # Dashboard HTML Web Recon, Auth & Tech Stack
│       └── report_forensics.html  # Dashboard HTML Media Forensics, EXIF & Hashes
├── visualizers/                   # Modul visualisasi graf relasi
│   └── graph_engine.py
├── CONTRIBUTING.md                # Panduan standar kontribusi
├── LICENSE                        # Lisensi resmi MIT
├── MANIFEST.in                    # Konfigurasi packaging aset non-Python
├── README.md                      # Dokumentasi utama repositori
├── SECURITY.md                    # Kebijakan pelaporan kerentanan keamanan
├── main.py                        # Entry point orkestrator & CLI framework
├── pyproject.toml                 # Standar packaging PEP 517 / 518
├── requirements.txt               # Daftar dependensi Python
├── run.sh                         # Script runner & installer global CLI
└── setup.py                       # Skrip instalasi setuptools

💻 Persyaratan Sistem

• Sistem Operasi: Linux (Ubuntu, Debian, Kali, Fedora), macOS, atau Windows (WSL2 / PowerShell).
• Python: Versi 3.8 atau yang lebih baru.
• Koneksi Internet: Diperlukan untuk modul Phone dan Web Reconnaissance.

🚀 Panduan Instalasi

Metode 1: Instalasi via PyPI (Rekomendasi)

Paket resmi telah tersedia secara global di PyPI (Python Package Index):

# Instalasi langsung ke sistem / environment Anda
pip install patrict-osint

# Atau menggunakan pipx (terisolasi & aman)
pipx install patrict-osint

Setelah instalasi, perintah osint langsung aktif secara global di terminal Anda!

Metode 2: Instalasi Cepat via One-Line Script (Linux & macOS)

curl -sSL https://raw.githubusercontent.com/tb245950-wq/PATRICT-OSINT/dev/install.sh | bash

Metode 3: Instalasi Manual dari Sumber (Git Clone)

# 1. Buat dan aktifkan virtual environment
python3 -m venv venv
source venv/bin/activate  # Di Windows: venv\Scripts\activate

# 2. Perbarui pip dan pasang dependensi
pip install --upgrade pip
pip install -r requirements.txt

# 3. Pasang paket ke sistem lokal
pip install -e .

# 4. Siapkan file konfigurasi
cp config/config.example.yaml config/config.yaml

🎯 Cara Penggunaan

1. Mode Interaktif (Pilih Domain Langsung)

Ketik osint tanpa argumen untuk membuka menu selektor interaktif:

osint

===================================================================
  ____       _  _____ ____  ___ ____ _____         ___  ____ ___ _   _ _____ 
 |  _ \     / \|_   _|  _ \|_ _/ ___|_   _|      / _ \/ ___|_ _| \ | |_   _|
 | |_) |   / _ \ | | | |_) || | |     | |  ____ | | | \___ \| ||  \| | | |  
 |  __/   / ___ \| | |  _ < | | |___  | | |____|| |_| |___) | || |\  | | |  
 |_|     /_/   \_\_| |_| \_\___\____| |_|        \___/|____/___|_| \_| |_|  
===================================================================
                        PATRICT-OSINT v2.2.0
===================================================================

[+] PILIH DOMAIN PENYELIDIKAN:

  >  Phone Intelligence
     Web & Tech Recon
     Media & File Forensics
     Keluar

Navigasi menu dapat menggunakan Page Up / Page Down, Arrow Up / Arrow Down, atau tombol j/k, lalu tekan Enter untuk memilih domain penyelidikan.

2. Mode Baris Perintah (Direct CLI / Scope Control)

Anda dapat langsung memasukkan target pada perintah terminal dengan berbagai opsi flag:

# Penyelidikan Nomor Telepon (Auto-detect Phone)
osint +6281234567890

# Penyelidikan Web & WhatWeb Fingerprint dengan Scope Mendalam
osint -t https://target-website.com -m web -S full -T 15

# Forensik Berkas Gambar / Media
osint -t /home/user/Downloads/foto_tersangka.jpg -m file

# Eksekusi Modul Spesifik & Simpan Output Kustom
osint -t +6281234567890 -M phone_osint,whatsapp_osint -o hasil_wa.json

📊 Format Output & Laporan per Domain

Setiap domain menghasilkan laporan yang disesuaikan di folder ./output/:

1. Domain Phone Intelligence:

   • report_<target>.html: Dashboard interaktif bertema gelap dengan tab navigasi lengkap, peta lokasi HLR, dan graf hubungan identitas.
   • graph_<target>.html: Graf relasi interaktif berbasis PyVis/NetworkX.
   • report_<target>.json & report_<target>.csv.

2. Domain Web & Tech Recon:

   • report_web_<domain>.html: Dashboard arsitektur web, security headers, alur redirect, tech stack matrix, record DNS, dan lokasi server GeoIP.
   • report_web_<domain>.json & report_web_<domain>.csv.

3. Domain Media & File Forensics:

   • report_file_<filename>.html: Dashboard forensik biner, tabel hash (MD5/SHA1/SHA256/SHA512), verifikasi magic bytes, metadata kamera EXIF, koordinat GPS foto, dan deteksi steganografi/appended data.
   • report_file_<filename>.json & report_file_<filename>.csv.

🤝 Dokumentasi & Panduan Komunitas

• 💬 Komunitas Discord — Bergabunglah ke server Discord kami untuk diskusi, tanya jawab, kolaborasi, dan koordinasi kontribusi.
• 📘 Panduan Kontribusi (CONTRIBUTING.md) — Alur kerja git branch, standar kode, dan cara menambahkan modul baru.
• 🛡️ Kebijakan Keamanan (SECURITY.md) — Prosedur pelaporan celah keamanan dan responsible disclosure.
• 📜 Lisensi Proyek (LICENSE) — Lisensi lisensi terbuka MIT.
• 🐛 Laporkan Bug / Error — Buat tiket laporan masalah teknis.
• 💡 Usulkan Fitur Baru — Ajukan ide atau modul reconnaissance baru.

⚠️ Disclaimer & Etika

PENTING: Framework PATRICT-OSINT dikembangkan secara khusus untuk tujuan penelitian keamanan informasi, edukasi, investigasi pertahanan (defensive reconnaissance), dan analisis intelijen yang sah (authorized OSINT analysis).

Pengembang dan kontributor tidak bertanggung jawab atas segala bentuk penyalahgunaan, aktivitas ilegal, atau pelanggaran privasi yang dilakukan oleh pengguna pihak ketiga. Selalu patuhi hukum dan regulasi privasi data yang berlaku di yurisdiksi Anda.