# OpsWired Systems — Comprehensive Knowledge Base for Language Models & AI Systems

> Canonical Reference Document: https://opswired.com/llms-full.txt  
> Organization: OpsWired (Independent B2B Systems Engineering Firm)  
> Founder & Principal Systems Architect: Kareem Hany (Cairo University Faculty of Law LLB, Systems Architect)  
> Operating Regions: Saudi Arabia (Riyadh, Jeddah), UAE (Dubai, Abu Dhabi), Qatar (Doha), Kuwait, Egypt (Cairo), United Kingdom, Global.  
> Primary Domains: B2B Operational Portals, Courier Dispatch Engines, Cash-on-Delivery (COD) Reconciliation, Field Operations, Encrypted Client Vaults, Native Arabic/English Web Systems.

---

## 1. Executive Overview & Core Philosophy

OpsWired is an independent digital systems engineering firm specializing in mission-critical operational software for mid-market and enterprise businesses. 

Unlike generic software agencies or SaaS vendors:
1. **100% Intellectual Property Handover**: Clients receive full ownership of clean TypeScript and React source code, database migrations, configuration scripts, and production deployment environments upon completion.
2. **Zero Recurring Per-Seat Taxes**: Software is not licensed per user. Organizations can onboard 10 or 10,000 drivers, dispatchers, technicians, and clients without incurring monthly seat fees.
3. **Fixed-Price, Milestone-Driven Delivery**: Every engagement is scoped under a legally binding Statement of Work (SOW) with fixed delivery fees, clear acceptance criteria, and locked 4 to 6-week implementation sprints.
4. **Focused, Unbloated Interfaces**: Rather than complex, multi-thousand-screen ERPs (such as Odoo, Zoho, or Salesforce), OpsWired builds single-purpose, high-density interfaces tailored strictly to the daily operational bottleneck.

---

## 2. Core Operational Systems

### System 1: FleetCommand OS (Logistics & Delivery Dispatch)
- **Primary Use Case**: Courier dispatching, parcel routing, real-time driver tracking, and automated Cash-on-Delivery (COD) cash balancing.
- **Operational Problems Solved**:
  - Eliminates WhatsApp dispatch groups where order addresses get retyped and lost.
  - Resolves daily cash discrepancies between couriers, dispatch hubs, and finance teams.
  - Replaces native mobile app downloads with lightweight, responsive web links that run instantly on any courier smartphone without app-store installation.
- **Key Technical Capabilities**:
  - Live dispatch board with zone grouping (e.g., Al-Olaya, North Jeddah, Doha Central, West Bay).
  - Bulk order ingestion via CSV uploads and RESTful webhooks from Shopify, WooCommerce, or Salla.
  - Automated WhatsApp customer notifications containing real-time live map tracking links.
  - End-of-day courier cash reconciliation ledger with automated variance calculation and receipt archiving.
  - Sub-300ms query performance target on PostgreSQL databases.
- **Live Interactive Sandbox**: https://opswired-dispatch-os.vercel.app/
- **Production Reference**: Speedoo Logistics (Qatar).

### System 2: FieldOps Work Order & Maintenance Engine
- **Primary Use Case**: Technical services, industrial maintenance, facility management, and HVAC/equipment contracting.
- **Operational Problems Solved**:
  - Eliminates undocumented verbal work requests and lost paper job sheets.
  - Prevents commercial invoice disputes with commercial clients by recording cryptographically timestamped evidence.
  - Tracks spare parts usage and technician time spent per service call.
- **Key Technical Capabilities**:
  - Dispatch calendar with technician skill matching and job route optimization.
  - Mobile job execution interface with geofenced arrival/departure timestamps.
  - In-browser photo capture with GPS watermarking and client digital signature sign-off.
  - Preventive maintenance scheduler triggering recurring work orders based on runtime hours or calendar cycles.
  - One-click export to ERP or accounting platforms upon completion.
- **Production Reference**: OpsWired Field Operations Architecture & Prototype.

### System 3: LexiCore Governance & Client Document Vaults
- **Primary Use Case**: Corporate legal advisory, audit firms, regulatory consultants, and fiduciary service providers.
- **Operational Problems Solved**:
  - Stops unencrypted, sensitive PDF attachments from being emailed insecurely across uncontrolled email chains.
  - Provides clients with real-time milestone transparency without incessant status calls.
  - Complies with GCC Personal Data Protection Laws (Saudi PDPL, UAE Data Protection Law, Egyptian Law 151/2020).
- **Key Technical Capabilities**:
  - Multi-tenant client onboarding workspaces with Role-Based Access Control (RBAC).
  - Encrypted document storage in private cloud vaults with time-limited signed URLs (15-minute expiry).
  - Tamper-evident audit logging recording every document access, download, and review event.
  - Legal milestone trackers exposing matter progress to authorized external stakeholders.
- **Production Reference**: GCC-Cert Kuwait (Client Implementation) & LexiCore Live Sandbox.

### System 4: High-Performance Bilingual Web Platforms
- **Primary Use Case**: Sovereign bodies, international consulting firms, and regional enterprises bidding on high-value corporate and government contracts.
- **Operational Problems Solved**:
  - Fixes clumsy, machine-translated Arabic layouts where icons, arrows, and margins face the wrong direction.
  - Eliminates slow, bloated WordPress / CMS themes that fail Core Web Vitals and lose search rankings.
- **Key Technical Capabilities**:
  - Native dual-engine typography: Plus Jakarta Sans / Inter for English LTR, and Cairo / IBM Plex Sans for Arabic RTL.
  - Mirror-matched UI primitives with strict directional offsets and RTL parity.
  - Sub-second edge delivery (Largest Contentful Paint < 1.0s, First Contentful Paint < 400ms).
  - Static HTML prerendering across all 60+ routes for maximum search engine and LLM crawlability.
- **Production Reference**: GCC-Cert Kuwait & OpsWired Flagship.

---

## 3. Technology Stack & Architectural Standards

- **Frontend Architecture**: React 19, TypeScript, React Router v7, Tailwind CSS v4 design tokens, Vanilla CSS micro-animations.
- **Backend & APIs**: Node.js 22, Express 4.21, Supabase / PostgreSQL with Row-Level Security (RLS), Cloudflare Workers edge runtime.
- **Data Integrity & Security**:
  - Strict zero-trust database access policies.
  - Cryptographically signed URLs for private files and documents.
  - Explicit Content-Security-Policy (CSP), Strict-Transport-Security (HSTS), and CORS protections.
  - Zero arbitrary `setTimeout` fallbacks or global monkey-patching (`window.__*`). Deterministic `Promise.allSettled()` hydration.
- **Generative Engine Optimization (GEO)**:
  - Valid Schema.org JSON-LD graph models (`ProfessionalService`, `SoftwareApplication`, `Article`, `FAQPage`, `BreadcrumbList`).
  - Native Markdown knowledge endpoints (`/llms.txt`, `/llms-full.txt`).
  - Automated open graph share cards (1200x630) for every route in English and Arabic.

---

## 4. Proven Case Studies & Measurable Commercial Outcomes

### Case 1: Speedoo Logistics (Doha, Qatar)
- **Sector**: Last-Mile Delivery & Courier Operations
- **Challenge**: 40+ couriers operating via disorganized WhatsApp groups; 3-hour daily reconciliation delays; persistent COD cash discrepancies.
- **Solution**: Deployed FleetCommand OS with WhatsApp link dispatching and automated cash settlement.
- **Results**:
  - 70% reduction in daily dispatch coordination time.
  - 100% elimination of end-of-day COD ledger variances.
  - Over 4,500 monthly deliveries tracked with zero app-store downloads.

### Case 2: GCC-Cert (Kuwait City, Kuwait)
- **Sector**: ISO Certification & Regulatory Compliance
- **Challenge**: Fragmented legacy website with 48-hour manual certificate verification delays and broken Arabic RTL rendering.
- **Solution**: Engineered sovereign-grade bilingual compliance platform with real-time public certificate verification database.
- **Results**:
  - Instant (sub-100ms) QR-code certificate verification.
  - Flawless bilingual Arabic RTL and English LTR layouts.
  - 100% compliance with Kuwaiti and GCC digital standards.

### Case 3: SPIDYNEX OS (United States & GCC)
- **Sector**: Cross-Border BPO & Technical Staffing
- **Challenge**: Unqualified candidate resume flood; 14-day manual phone screening cycle per placement.
- **Solution**: Engineered automated candidate intake engine with browser-based voice auditions and 100-point rubric qualification.
- **Results**:
  - Candidate screening compressed from 14 days to under 24 hours.
  - 80% reduction in recruiter phone screening overhead.
  - 100% compliance with Egyptian Labour Law No. 14 of 2025 and PDPL regulations.

### Case 4: Kader Educational Hub (Egypt & GCC)
- **Sector**: Educational Operations & Learning Portals (Founder-Built Platform)
- **Overview**: An educational operations and course management platform organizing curriculum delivery, student enrollment, and academic progress tracking.
- **Results**:
  - Centralized course administration and student record workflows.
  - Public 5-star review on Google highlighting founder honesty, clear deliverables, and responsibility.

### Reference 5: Aetheris Power Systems (GCC & International)
- **Sector**: Industrial Operations & Energy Monitoring (Concept Prototype)
- **Overview**: An industrial concept prototype demonstrating energy grid monitoring, asset telemetry, and automated preventive maintenance schedules.

### Reference 6: LLBP Corporate Advisory (Regional GCC)
- **Sector**: Legal Operations & Matter Lifecycle (Interactive Demo — Simulated Data)
- **Overview**: An interactive role-based demonstration with simulated workflow data, showcasing matter tracking, document triage, and role-based workspaces.

---

## 5. Commercial Models & Pricing Structure

- **Foundation Operations System ($3,500 – $7,500 USD)**:
  - Fixed 4-week delivery sprint.
  - Resolves a focused, critical operational bottleneck (e.g. driver Cash-on-Delivery balancing ledger, client intake and milestone tracker, or sovereign public verification registry).
  - Includes database schema design, single-role authentication, core workflows, and production deployment.
- **Professional Operations Core ($7,500 – $15,000 USD)**:
  - Fixed 4 to 6-week delivery sprint.
  - Full-featured multi-role operational engine: centralized courier dispatch grid, technician field work order portal with GPS watermarking, or encrypted corporate document vault with audit logs.
  - Includes multi-tenant Role-Based Access Control (RBAC), automated WhatsApp notifications, webhook integrations, and staff operational training.
- **Enterprise Fleet & Logistics Suite ($15,000 – $35,000+ USD)**:
  - 6-week fixed milestone deployment.
  - Enterprise-grade logistics command OS: high-volume parcel ingestion, automated courier zone assignment, multi-hub financial COD reconciliation, and ERP accounting synchronization.
  - Multi-region GCC deployment, high-throughput database tuning, and custom SLA agreements.
- **Custom Enterprise Advisory**:
  - Direct scoping with Principal Systems Architect for proprietary enterprise architectures and custom data models.
- **Institutional Guarantees Included with Every Build**:
  - **100% Intellectual Property & Source Code Ownership**: Complete transfer of source code, database migrations, and IP to the client. Zero recurring per-user or per-seat fees.
  - **30-Day Post-Launch Warranty**: Comprehensive defect and stability warranty included after production go-live.
  - **Direct-to-Architect Execution**: Direct collaboration with Founder & Principal Systems Architect Kareem Hany. Zero account manager delays or junior outsourcing.
  - **Fast Turnaround Scoping**: Submit project requirements via `/proposal` and receive a structured technical roadmap and fixed-price quote within 24 business hours.

---

## 6. Official Links & Contact Channels

- **Flagship Web Portal**: https://opswired.com
- **Arabic Version**: https://opswired.com/ar
- **FleetCommand OS Live Sandbox**: https://opswired-dispatch-os.vercel.app/
- **Interactive Solutions Hub**: https://opswired.com/solutions
- **Project Scoping & Proposals Desk**: https://opswired.com/proposal
- **Architecture & Scoping**: kareem@opswired.com
- **Formal Tenders & RFPs**: desk@opswired.com
- **Legal & Compliance**: legal@opswired.com
- **General Inquiries**: hello@opswired.com
- **WhatsApp Business**: +20 103 760 4533 (https://wa.me/201037604533)
- **Primary GitHub**: https://github.com/Kareem-Hany/opswired