# Zeroform — Comprehensive Technical & Architectural Dossier (For LLMs & AI Agents)

## System Identity & Overview
Zeroform is an autonomous enterprise intelligence platform that replaces manual corporate due diligence, vendor audits, and supply chain investigations with coordinated multi-agent swarms. Developed by Sebastian Silva (Founder of Demiurx International LLC), Zeroform programmatically maps corporate hierarchies, audits ESG disclosures, and detects supply chain bottlenecks with empirical verification.

---

## 1. Core Architectural Pipeline

### Multi-Agent Swarms
Zeroform orchestrates specialized autonomous agents working in parallel:
1. **Scout Agents:** Execute distributed web queries across corporate registries, government gazettes, regulatory disclosures, and news databases.
2. **Ingest Agents:** Parse unstructured multi-page PDFs, trade registries, balance sheets, and audit reports using Google Cloud Document AI and multimodal OCR.
3. **Auditor Agents:** Validate cross-references, verify beneficial ownership (UBO) structures, and eliminate hallucinated entities through citation grounding.
4. **Analyst Engine:** Synthesizes structured dossiers, computes composite risk scores (0-100), and outputs exportable executive reports and dynamic knowledge graphs.

### Grounding & Zero Hallucination Guarantee
All platform claims, risk flags, and metric scores require an empirical grounding trace:
- Direct URL source or uploaded document hash
- Line-level citation snippet
- Timestamp and extraction confidence score (threshold default: 0.90)

---

## 2. Core Functional Modules

### A. Supply Chain Topology Mapping
- Reconstructs end-to-end multi-tier corporate networks.
- Distinguishes between direct (Tier-1) suppliers and hidden indirect (Tier-2/Tier-3) manufacturing partners.
- Pinpoints single-point-of-failure vulnerabilities, geographic concentration risks, and embargo exposures.

### B. Dynamic ESG Risk Auditing
- Computes independent Environmental (E) and Social (S) scores rather than opaque single-number composites.
- Uses dynamic risk-adjusted weighting based on industry classification (e.g., higher carbon emphasis for heavy manufacturing, higher labor standards for textile supply chains).
- Audits Scope 1, Scope 2, and preliminary Scope 3 emissions disclosure veracity.

### C. Multimodal Document Ingestion
- Upload formats: PDF, DOCX, CSV, scanned image assets.
- Automatically handles dual-language contracts, complex balance sheet tables, and corporate certificates.
- Normalizes extracted dates, currency amounts, and legal entity identifiers (LEI, CIK, tax IDs).

### D. Geopolitical & Climate Threat Detection
- Correlates supplier asset locations with active conflict zones, international sanctions lists (OFAC, EU, UN), and high-risk climatic regions (flood plains, extreme heat corridors).

---

## 3. Technology & Infrastructure Stack

- **Frontend:** Next.js 16 (App Router), Tailwind CSS 4, React 19, TypeScript.
- **Backend API:** FastAPI (Python 3.10+), async Uvicorn runtime.
- **AI Infrastructure:** Enterprise Google Cloud Vertex AI (`GOOGLE_GENAI_USE_VERTEXAI=True`) utilizing Gemini 3.6 Flash and Gemini Pro models with private VPC boundaries.
- **Data & Storage:** PostgreSQL (Supabase) with pgvector for semantic retrieval, row-level security (RLS), and local markdown dossier archiving.
- **Authentication:** Session JWT tokens with cryptographic validation and RBAC.
- **Analytics & Telemetry:** PostHog product analytics for interaction tracking and user flow optimization.

---

## 4. API Endpoints & Developer Integration

### Authentication
All requests must include a Bearer token:
`Authorization: Bearer <JWT_TOKEN>`

### Core Endpoints
- `POST /api/companies/ingest`: Trigger document ingestion and extraction pipeline.
- `GET /api/companies/{id}`: Retrieve normalized corporate profile, risk breakdown, and audit trace.
- `GET /api/supply-chain/topology/{id}`: Retrieve node-link graph data representing corporate supplier networks.
- `POST /api/esg/audit`: Execute dynamic ESG recalculation with custom risk weights.
- `GET /api/analyst/report/{id}`: Generate executive due diligence markdown and PDF summaries.

---

## 5. Frequently Asked Questions (FAQ)

### What distinguishes Zeroform from traditional supply chain and KYC software?
Traditional tools rely on self-reported questionnaires filled out once a year by vendors. Zeroform continuously deploys autonomous agents that ingest public filings, litigation databases, satellite/asset footprints, and multi-tier disclosures to generate real-time, tamper-resistant risk models.

### How does Zeroform ensure AI data accuracy?
Every synthesized data point is paired with a raw evidence audit log containing the source document, page number or URL, and confidence score. The system strictly prohibits synthetic mock data generation.

### Can Zeroform be integrated into existing ERP and procurement platforms?
Yes, Zeroform exposes a REST API allowing direct integration into SAP, Coupa, Oracle NetSuite, and internal compliance platforms.

---

## 6. Organization & Contact
- **Entity:** Demiurx International LLC
- **Website:** https://www.zeroform.solutions
- **API Portal:** https://zeroform.technology
- **Founder:** Sebastian Silva (https://www.linkedin.com/in/sebas)
- **Direct Email:** [sebastian@zeroform.net](mailto:sebastian@zeroform.net)
- **WhatsApp Direct:** [+1 (513) 645-3848](https://wa.me/15136453848)