# 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 10 to 21 business-day 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**: Kader Facilities MIS & Aetheris Power Systems.

### 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**: LLBP Corporate Advisory & GCC-Cert Kuwait.

### 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 Facilities MIS (Kuwait & Egypt)
- **Sector**: Facilities Management & Contracting
- **Challenge**: Disconnected communication across WhatsApp and paper worksheets causing delayed job sign-offs.
- **Solution**: Unified work order management platform with geofenced mobile proof of service and parts tracking.
- **Results**:
  - Same-day client job sign-off and billing export.
  - Public 5-star client review on Google highlighting milestone discipline.

### Case 5: Aetheris Power Systems (GCC & International)
- **Sector**: Industrial Energy & Equipment Contracting
- **Challenge**: Unbilled technician hours, maintenance disputes, and missing field work proof.
- **Solution**: Heavy-duty industrial maintenance portal with automated preventive schedules and digital sign-offs.
- **Results**:
  - Complete elimination of unbilled maintenance hours.
  - Instant audit verification for industrial clients.

### Case 6: LLBP Corporate Advisory (Regional GCC)
- **Sector**: Cross-Border Corporate Law & Fiduciary Services
- **Challenge**: Sensitive PDF document distribution via unencrypted email; client confusion over matter milestones.
- **Solution**: Private corporate extranet featuring encrypted document vaults and matter timeline tracking.
- **Results**:
  - 100% elimination of sensitive file distribution via email.
  - Total alignment with GCC Personal Data Protection Laws.

---

## 5. Commercial Models & Pricing Structure

- **Rapid Tactical Sprints ($650 – $950 USD)**:
  - 5 to 7 business day delivery.
  - Focuses on resolving one specific bottleneck (e.g., driver cash ledger, customer intake funnel, or certificate verification registry).
- **Core Operational OS Builds ($1,800 – $4,500+ USD)**:
  - 2 to 4 week delivery.
  - Full-featured dispatch command engine, multi-role field portal, or secure client document vault.
  - Includes database setup, custom roles, automated notifications, and staff onboarding training.
- **Warranty & Support**:
  - 30-day comprehensive post-launch defect warranty included with every delivery.
  - Optional monthly maintenance retainers ($300 – $600 USD) for database backups, security patches, edge updates, and on-call SLA support.

---

## 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