# ⚡ JZ BrowserX Enterprise — Technical Feature Specification & Architecture Guide

**Product Name:** JZ BrowserX Enterprise  
**Release Version:** v2.4.0 (Pro Build)  
**System Architecture:** Native PyQt6 High-Concurrency Multi-Threading + Asynchronous Chromium DevTools Protocol (CDP) + Local SQLite WAL Storage  

---

## 📌 Executive Product Summary

**JZ BrowserX Enterprise** is an industrial-grade desktop software platform designed for digital marketing agencies, e-commerce brand networks, and performance media buyers. It enables operators to manage, warm, secure, and automate hundreds of Facebook business profiles, pages, and community assets with zero fingerprint cross-contamination and maximum session longevity.

---

## 🏗️ Technical Architecture Diagram

```
┌────────────────────────────────────────────────────────────────────────┐
│                   JZ BrowserX Orchestrator Console (PyQt6)             │
│   (Thread Pool Manager • Real-time State Sync • Responsive UI Engine)  │
└──────────────────┬───────────────────────────────────┬─────────────────┘
                   │                                   │
      ┌────────────▼────────────┐        ┌─────────────▼─────────────┐
      │  2FA / MFA Security     │        │  Multi-Screen Visual NOC  │
      │  (TOTP RFC-6238 Vault)  │        │  (60fps OpenGL Viewports) │
      └────────────┬────────────┘        └─────────────┬─────────────┘
                   │                                   │
┌──────────────────▼───────────────────────────────────▼─────────────────┐
│              Direct Chromium DevTools Protocol (CDP) Engine            │
│    (Isolated UDD Sandboxes, Residential Proxy Mesh, Bézier Physics)    │
└──────────────────┬───────────────────────────────────┬─────────────────┘
                   │                                   │
      ┌────────────▼────────────┐        ┌─────────────▼─────────────┐
      │ SQLite WAL Database     │        │ Over-The-Air Update Server│
      │ (Local AES-256 Storage) │        │ (HMAC/RSA Signed Bundles) │
      └─────────────────────────┘        └───────────────────────────┘
```

---

## 📦 Comprehensive 14+ Module Breakdown

### 1. Automated 2FA & MFA Key Vault (`two_fa_settings_dialog.py`)
- **Purpose:** Eliminates manual multi-factor authentication friction across large client profile portfolios.
- **Capabilities:**
  - Automated TOTP secret seed parsing and QR code decoding.
  - Generates time-synchronized 6-digit one-time security passcodes according to RFC-6238.
  - Automatically enters 2FA codes during session challenges with zero human latency.
  - Securely archives backup recovery codes in the local encrypted database.

---

### 2. Algorithmic Feed Warming & Engagement Simulation (`warmup_feed_dialog.py`)
- **Purpose:** Establishes and maintains high algorithmic trust scores by simulating authentic human browsing patterns.
- **Capabilities:**
  - Bézier curve cursor trajectories and natural acceleration/deceleration physics.
  - Dynamic feed scrolling with randomized dwell intervals (10s–60s) to read posts.
  - Contextual post reactions (Like, Love, Care, Support).
  - Video playback watch-time pacing to establish active viewer signals.

---

### 3. Session Refresh & Cookie Keep-Alive (`session_refresh_dialog.py`)
- **Purpose:** Proactively prevents sudden session expirations and maintains live authentication states.
- **Capabilities:**
  - Silent background cookie validity verification.
  - Automated keep-alive pulses to preserve session tokens without user intervention.
  - Real-time token health indicators in the main operations dashboard.

---

### 4. Centralized Brand Page Deployment (`page_upload_settings_dialog.py`)
- **Purpose:** Automates business page provisioning and brand asset deployment.
- **Capabilities:**
  - Bulk page creation with pre-configured category metadata.
  - Automated cover banner (1920x1080) and avatar image deployment.
  - Automatic page ownership backup and admin delegation preservation.

---

### 5. Profile Identity & Asset Customizer (`profile_update_dialog.py`)
- **Purpose:** Harmonizes brand ambassador identities with localized assets.
- **Capabilities:**
  - Demographic name assignment and bio description synchronization.
  - Automated ingestion of avatar images from local media stock directories (`data/media/avatars`).
  - Account integrity validation and status badge assignment (`Live / Verified`).

---

### 6. CRM Contact Hygiene & Address Book Purge (`remove_contacts_dialog.py`)
- **Purpose:** Enforces strict privacy standards and cleanses social graphs.
- **Capabilities:**
  - Batch address book synchronization removal.
  - Prevents non-relevant contacts from skewing algorithmic reach.
  - Full compliance with GDPR Article 17 "Right to be Forgotten" standards.

---

### 7. Automated Email Binding & IMAP Sync (`mail_verification_dialog.py`)
- **Purpose:** Connects secondary enterprise recovery emails and confirms verification links.
- **Capabilities:**
  - Integration with custom IMAP mailboxes and webmail APIs.
  - Automatic OTP verification extraction and confirmation submission.
  - Stock email pool management (`ready_stock_mails.txt`).

---

### 8. Checkpoint Resolution & Security Shield (`cp_bypass_dialog.py`, `verify_novery_dialog.py`)
- **Purpose:** Handles transient security checkpoints and identity confirmation requests.
- **Capabilities:**
  - Automated detection of verification challenge screens.
  - Dynamic submission of security confirmation codes.
  - Automatic quarantine and cleanup of failed profile instances.

---

### 9. Targeted Friend & Social Graph Manager (`add_friend_dialog.py`)
- **Purpose:** Builds authentic social authority by establishing targeted network connections.
- **Capabilities:**
  - Traversal of suggested connections within specific industry niches.
  - Auto-confirmation of incoming connection requests.
  - Daily action quota limiters to prevent rate-limit triggers.

---

### 10. Community & Group Fleet Manager (`group_manager_dialog.py`)
- **Purpose:** Orchestrates multi-account participation in niche interest groups.
- **Capabilities:**
  - Keyword-based group discovery and automated join requests.
  - Automated submission of onboarding questionnaire answers.
  - Centralized group membership roster logging.

---

### 11. Automated Account Provisioning & Registration (`register_tab.py`, `reg_worker.py`)
- **Purpose:** End-to-end account provisioning pipeline for enterprise agencies.
- **Capabilities:**
  - Integration with multi-provider SMS/OTP gateways (5SIM, SMSBower, Hero SMS, PVA Pins).
  - High-entropy password generation.
  - Atomic persistence to SQLite WAL database only after reaching verified live state.

---

### 12. Profile Snapshot & State Archiver (`backup_profile`)
- **Purpose:** Disaster recovery and easy cross-workstation migration.
- **Capabilities:**
  - Exports complete session cookies, 2FA seeds, and profile metadata.
  - AES-256 encrypted local package backups.
  - One-click restore onto new workstations.

---

### 13. Mission Control Multi-Screen NOC Visualizer (`screen_viewer.py`)
- **Purpose:** Real-time visual monitoring across all background worker threads.
- **Capabilities:**
  - High-FPS OpenGL multi-window tile grid streaming active browser viewports.
  - Interactive mouse and keyboard pass-through for manual overrides.
  - Live thread status badges, runtime timers, and memory usage indicators.

---

### 14. Hardware-Locked Licensing & Cloud Auto-Updates (`license_manager.py`, `admin_publisher.py`)
- **Purpose:** Enterprise digital rights management and zero-downtime software delivery.
- **Capabilities:**
  - Machine fingerprinting (CPU ID, Motherboard UUID, MAC hashing).
  - Asymmetric cryptographic digital signature validation.
  - Automated over-the-air delta updates via dedicated Node.js release server.
  - Dedicated admin publishing utility (`admin_publisher.py`) for generating release manifests and cryptographically signed patch archives.