HiTech Insurance Platform
Welcome to the central developer documentation, systems architecture manual, and technical reference for the HiTech Insurance Web Platform (veridex-hitech-web-application).
HiTech Insurance (hitechinsurance.ai) is an enterprise-grade digital insurance brokerage platform, customer self-service portal, administrative control center, and multi-channel partner integration hub. The platform distributes personal, commercial, and specialized insurance coverage across Texas and the United States.
Core Capabilities & Features
- 20 Tailored Insurance Lines: Personal auto, homeowners, life, commercial trucking, workers' compensation, cross-border Mexico auto, and specialized freight logistics.
- Lite Web Experience Platform (
/l/*): Sub-second, low-bandwidth parallel experience engineered for rural transit corridors, weigh stations, and DOT roadside inspections with a 98% payload reduction (under 180 KB). - Voice-Based Hands-Free Browsing: Assistive AI audio assistant adhering to FMCSA/DOT hands-on-wheel safety with 60 FPS canvas audio visualizer, intent matching, and one-tap emergency agent dispatch.
- Accessible Legal Audio Player & Neural TTS (
/api/tts): ADA Title III compliance player with 20+ regional neural accents across 11 dialects, LRU memory caching, and client-side speech synthesis fallback. - Resilient Multi-Channel Lead Ingestion: Captures leads via public dynamic forms, autosaved drafts with customer resumption, HMAC-SHA256 authenticated partner APIs, and inbound social ad webhooks (Meta, Google Ads, TikTok).
- Downstream CRM Integration: Real-time forwarder with Basic Auth to the HTI CRM (Zoho/Falcon-backed), failure capture into MongoDB (
CrmFailedLead), and one-click manual retry queues. - Customer Lifecycle Portal (
/dashboard): Authenticated customer portal with profile management, interactive avatar cropping, incomplete quote resumption, submission audit history, and a Refer & Earn rewards dashboard. - Administrative Control Center (
/admin): 20 operational tabs covering leads, visitor telemetry, live journey analytics, Tiptap blog CMS, bilingual FAQs, mass email campaigns, social microsite management, CRM retries, quarantine management, and event marketing. - Embeddable Partner Widget Suite: Zero-leakage Shadow DOM badge (
widget.js), responsive iframe route (/embed/widget), and native 60 FPS Flutter Dart widget.
Documentation Navigation Guide
| Domain | Description | Key Modules |
|---|---|---|
| Architecture & Design | High-level system design, runtime tenets, tech stack, and env vars. | Next.js 15, React 19, TypeScript 5, Tailwind v4 |
| Lite Platform & Voice AI | High-performance /l/* routes, hands-free voice navigation, and accessible neural audio player. | <ExperienceToggle>, Web Speech API, msedge-tts v2.1.1 |
| Database & 40 Models Catalog | MongoDB object modeling, Mongoose caching, and 40 schema catalogs. | User, Lead, HtiLead, CrmFailedLead, VisitorJourney |
| Lead Ingestion Pipelines | Inbound lead lifecycles, draft autosave, HMAC API, webhooks, and CRM sync. | HMAC-SHA256, Meta Graph v25.0, Zoho/Falcon CRM |
| Security & Bot Defense | Hybrid reCAPTCHA v2/v3, Quarantine Manager, rate limiting, and NextAuth RBAC. | Sliding-window limiter, JWT tokens, RBAC roles |
| i18n & SEO Architecture | Bilingual routing (EN/ES), next-intl catalogs, 301 apex canonical redirects. | 34 JSON dictionaries, JSON-LD schemas |
| Content Management (CMS) | Tiptap headless WYSIWYG editor, reader analytics, bilingual FAQs. | Dynamic FAQs, SEO slugs, article read times |
| Field Marketing & QR Events | Event campaigns, licensed agent attribution, /e/:slug short URLs. | Dynamic QR codes, convention lead capture |
| Visitor Telemetry & Analytics | Live presence heartbeats, visitor journeys, and domestic/global analytics. | geoip-lite, privacy-first session aggregation |
| Partner Widget Suite | Shadow DOM widget, iframe embed, and Flutter Dart SDK. | Shadow DOM, deep linking, partner UTM tracking |
| Email & Communications | Azure Functions email dispatch, bulk campaigns, reusable templates, signatures. | Streamed signatures (/api/signatures/[id]), batch delays |
| 20 Insurance Lines Catalog | Deep-dive into all 20 personal, commercial, and specialized lines. | Coverage specs, slug maps, benefit cards |
| Portals Walkthrough | Customer Dashboard, 20-Tab Admin Control Center, and Social Portal configurations. | 20 admin tabs, avatar cropping, draft resumption |
| API Reference | Swagger/OpenAPI specifications and RESTful endpoint reference. | 39 REST endpoints, Password-gated OpenAPI 3.0 spec |
| DevOps & Azure Deployment | Local workflow, seeding scripts, Docker standalone builds, and Azure CI/CD. | Azure Web App staging slots, multi-stage Docker |
| Development Standards | Architectural conventions, Server Actions patterns, Zod validation, and Mongoose defensive compilation. | Server vs Client boundaries, error envelopes |
| Testing & Quality Assurance | Static verification, operational test scripts, manual harnesses, and automated testing roadmap. | Rate limiter testing, health checks, Vitest/Playwright roadmap |
| Coverage Audit & Maintenance | Exhaustive 100% source-to-doc coverage matrix and ongoing maintenance runbook. | Model audits, endpoint audits, synchronization protocols |