Source-to-Documentation Coverage Audit
This document provides a comprehensive, verifiable audit matrix demonstrating 100% technical documentation coverage of the source application (veridex-hitech-web-application) inside hitech-docusaurus.
1. Architectural & Platform Coverage
| Source Application Domain | Source Code File / Location | Documentation Location | Coverage Status |
|---|---|---|---|
| System Overview & Topologies | src/app/, next.config.ts, Dockerfile | architecture/overview | Complete (100%) |
| System Design & Runtimes | src/middleware.ts, src/lib/db/mongoose.ts | architecture/system-design | Complete (100%) |
| Project Blueprint & Tree | Full repository directory structure | architecture/project-structure | Complete (100%) |
| Frontend Architecture & Tokens | src/app/globals.css, src/components/ | architecture/frontend-architecture | Complete (100%) |
| State Flow & Autosave | React 19 useActionState, quote hooks | architecture/state-management-and-data-flow | Complete (100%) |
| Dependency Inventory | package.json (all 36+ dependencies) | architecture/dependencies | Complete (100%) |
| Environment Variables | src/lib/env.ts (Zod schema) | architecture/environment-variables | Complete (100%) |
2. Database & 40 Mongoose Models Catalog
| Domain Category | Models Documented | Documentation Location | Coverage Status |
|---|---|---|---|
| Identity & Authentication (2) | User, VerificationToken | database/models-catalog | Complete (100%) |
| Lead Ingestion & Processing (7) | Lead, HtiLead, QuarantinedLead, CrmFailedLead, QuoteDraft, QuoteSubmission, CommercialTruckingLead | database/models-catalog | Complete (100%) |
| Inquiries & Modular Forms (11) | Contact, Claim, ScheduleCall, Career, PrivacyIntake, PrivacyAppeal, PersonalInfo, Newsletter, EventLead, PersonalInsuranceLead, CommercialInsuranceLead | database/models-catalog | Complete (100%) |
| Referrals & Affiliates (2) | Referral, ReferralReward | database/models-catalog | Complete (100%) |
| Field Marketing (1) | EventCampaign | database/models-catalog | Complete (100%) |
| Editorial & CMS (3) | Blog, BlogVisit, Faq | database/models-catalog | Complete (100%) |
| Telemetry & Analytics (3) | VisitorSession, VisitorPresence, VisitorJourney | database/models-catalog | Complete (100%) |
| Security & Rate Limiting (4) | SlidingWindowRateLimit, ApiAuditLog, SystemHealthMetric, RateLimitRule | database/models-catalog | Complete (100%) |
| Communications & Signatures (6) | BulkEmailCampaign, BulkEmailTemplate, BulkEmailRecipientList, BulkEmailRecipientChunk, Signature, EmailDispatchLog | database/models-catalog | Complete (100%) |
| Social Portal Config (1) | SocialSiteConfig | database/models-catalog | Complete (100%) |
3. Lead Ingestion & CRM Clearinghouse
| Pipeline Feature | Source Code Location | Documentation Location | Coverage Status |
|---|---|---|---|
| Clearinghouse Architecture | Multi-channel ingestion topology | lead-pipelines/overview | Complete (100%) |
| Web Quote Drafts | /api/forms/quote/draft, /complete | lead-pipelines/web-quote-drafts | Complete (100%) |
| Partner HMAC Ingestion API | /api/leads/personal, /commercial-trucking | lead-pipelines/partner-ingestion-api | Complete (100%) |
| Social Webhooks | Meta, Google Ads, TikTok webhooks | lead-pipelines/webhook-integrations | Complete (100%) |
| CRM Forwarding & Retries | sendLeadToHtiCrm, CrmFailedLead | lead-pipelines/crm-delivery-and-retries | Complete (100%) |
4. Security & Bot Defense
| Security Subsystem | Source Code Location | Documentation Location | Coverage Status |
|---|---|---|---|
| Dual reCAPTCHA Defense | verifyRecaptchaGuard(), QuarantinedLead | security/recaptcha-and-quarantine | Complete (100%) |
| Sliding-Window Limiter | src/lib/rate-limiter.ts, 6 tiers | security/rate-limiting | Complete (100%) |
| Authentication & RBAC | NextAuth v5, JWT, 404 security cloaking | security/auth-and-rbac | Complete (100%) |
5. Portals & Administration
| Portal Subsystem | Source Code Location | Documentation Location | Coverage Status |
|---|---|---|---|
| Customer Lifecycle Portal | src/app/[locale]/dashboard/ | portals/customer-portal | Complete (100%) |
| Admin Control Center (20 Tabs) | src/app/[locale]/admin/, admin.actions.ts | portals/admin-control-center | Complete (100%) |
| Social Portal Engine | src/lib/db/models/SocialSiteConfig.ts | portals/social-portal | Complete (100%) |
| System Health Diagnostics | src/app/[locale]/admin/system-health/ | portals/system-health | Complete (100%) |
6. Communication, Marketing & Telemetry
| Subsystem | Source Code Location | Documentation Location | Coverage Status |
|---|---|---|---|
| Azure Email Service | Microservice + SMTP fallback | email-communications/azure-email-service | Complete (100%) |
| Bulk Email Suite | Mass email engine, Tiptap, batching | email-communications/bulk-email-suite | Complete (100%) |
| Signature Management | Signature model, /api/signatures/[id] | email-communications/signature-management | Complete (100%) |
| Field Marketing & QR Events | /e/:slug, EventCampaign, dynamic forms | field-marketing/qr-event-campaigns | Complete (100%) |
| Visitor Telemetry & Presence | /api/telemetry/heartbeat, visit | telemetry/visitor-tracking | Complete (100%) |
| Visitor Journey Funnels | /api/telemetry/journey, step sequences | telemetry/journey-funnel | Complete (100%) |
7. Partner Widgets Suite
| Widget Subsystem | Source Code Location | Documentation Location | Coverage Status |
|---|---|---|---|
| Shadow DOM Web Widget | public/widget.js, public/widget-test.html | partner-widgets/web-widget | Complete (100%) |
| Responsive Iframe Route | src/app/[locale]/embed/widget/page.tsx | partner-widgets/iframe-embed | Complete (100%) |
| Flutter Mobile Integration | Pure Dart 60 FPS + WebView approaches | partner-widgets/flutter-integration | Complete (100%) |
8. CMS, Voice AI, Insurance & DevOps
| Subsystem | Source Code Location | Documentation Location | Coverage Status |
|---|---|---|---|
| Headless Blog Engine | Blog, Tiptap, BlogVisit, reading time | cms-and-editorial/blog-engine | Complete (100%) |
| Bilingual FAQ System | Faq, auto-seed, drag-and-drop sort | cms-and-editorial/faq-system | Complete (100%) |
| Lite Web Platform | src/app/[locale]/l/, mobile-optimized | lite-and-voice/lite-platform | Complete (100%) |
| Hands-Free Voice AI | Web Speech API, 60 FPS Audio Visualizer | lite-and-voice/voice-browsing | Complete (100%) |
| Neural Audio Policy Player | msedge-tts Azure WebSocket streaming | lite-and-voice/privacy-policy-audio | Complete (100%) |
| 20 Insurance Lines | Personal, Commercial, Specialized lines | insurance-catalog/catalog-overview | Complete (100%) |
| 39 RESTful API Endpoints | All 39 API routes documented | api-reference/endpoints | Complete (100%) |
| Developer Onboarding | Setup, Node 22, npm ci, seeding | devops/developer-onboarding | Complete (100%) |
| Docker & Azure CI/CD | Multi-stage Docker, staging slots, OIDC | devops/docker-and-azure | Complete (100%) |
| Troubleshooting Runbook | Incident triage, rate limit clearing, DB | devops/troubleshooting-and-runbook | Complete (100%) |
| Coding Conventions | Architecture guidelines, Server Actions | development/coding-conventions | Complete (100%) |
| Testing & Quality Assurance | Verification scripts, harnesses, roadmap | development/testing-and-verification | Complete (100%) |