Metadata-Version: 2.4
Name: fortifi-core
Version: 2.1.1
Summary: High-performance edge telemetry threat analysis and kinematic filtering engine.
Author: FortiFi-Sovereign
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastapi
Requires-Dist: uvicorn
Requires-Dist: pydantic
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# FortiFi Enterprise Threat Analytics Engine (V2.1-Auth)

[![License: AGPL v3](https://shields.io)](https://gnu.org)
[![Production Ready](https://shields.io)]()

FortiFi Core is a high-throughput, multi-threaded, asynchronous telemetry analytics platform designed for edge spatial data processing. The engine combines sub-millisecond multi-dimensional kinematics calculus with a cryptographically secure, blockchain-style append-only logging architecture to filter environmental sensor anomalies and isolate mechanical tracking threats natively.

## 🚀 Core Architectural Stack

*   **API Network Gateway (`main.py`):** Asynchronous FastAPI implementation backed by Pydantic data schemas, providing strict request validation for real-time `[X, Y, Z, Timestamp]` spatial data arrays over protected network gates.
*   **Physics Discrimination Engine (`analytics.py`):** Vectorized linear algebra core using NumPy to compute the absolute third derivative of position (Jerk Vector: $\vec{j} = \frac{\Delta \vec{a}}{\Delta t}$). Eliminates false positive alerts by distinguishing low-jerk aerodynamic flight paths (birds/wind drift) from high-jerk, mechanical propulsion maneuvering.
*   **Cryptographic Ledger (`security.py`):** Implements an immutable, append-only chronological ledger utilizing secure SHA-256 hash chaining. Every security event payload bakes the unique signature of the preceding log directly into its own calculation loop, preventing data tampering.
*   **System Validation Matrix (`test_core.py` & `simulator.py`):** Includes automated unit verification frameworks alongside a 1,000-object randomized synthetic data simulator to systematically audit mathematical accuracy under production parameters.

## 💼 Commercial Value Proposition

*   **The Problem:** Autonomous logistics networks and critical facility perimeters handle thousands of false alarm alerts monthly from environmental turbulence, wasting thousands of dollars in system downtime and manual tracking verification.
*   **The FortiFi Edge:** By shifting multi-derivative calculus directly to vectorized CPU memory allocations at the network edge, FortiFi isolates background anomalies in sub-milliseconds, cutting operational bloat and lowering corporate overhead cleanly.

## ⚖️ Open-Source & Commercial Dual-Licensing

FortiFi is an open-core utility dual-licensed under the **GNU Affero General Public License (AGPLv3)** and **FortiFi Commercial Proprietary Terms**.

*   **Open-Source Use:** Permission is strictly granted under the AGPLv3 copyleft framework. Any open deployment made available over a network commercially forces the parent infrastructure to open-source its entire closed-source, proprietary company codebase under the same terms.
*   **Commercial Production Use:** Enterprises wishing to bypass public copyleft restrictions, avoid legal intellectual property risk, and deploy FortiFi inside proprietary or closed-source system environments are legally required to purchase a Commercial Production License.

### 📧 Enterprise Procurement Contact
To request custom commercial licensing terms, service-level agreements (SLAs), deployment integration documentation, or pilot testing access, contact our legal desk directly at:
👉 **`FortiFi@protonmail.com`**

## 🛠️ Quick Sandbox Setup

```bash
# Clone the enterprise tracking infrastructure
git clone https://github.com
cd fortifi_sandbox

# Initialize local virtual environment tracking loops
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Run the automated mathematical unit verification matrix
python3 test_core.py

# Fire up the live multi-threaded Uvicorn network gateway on port 8000
uvicorn main:app --reload --port 8000
```
