Skip to main content

Social Portal Configuration (social.hitechinsurance.ai)

The Social Management Tab in the HiTech Admin Control Center provides real-time content management and dynamic layout controls for the dedicated social microsite (social.hitechinsurance.ai).

The portal serves as a mobile-first digital hub for social media followers, QR code scans from marketing materials, and convention attendees, consolidating rich media, video tips, customer reviews, physical branch finders, FAQs, and instant agent contact cards.

1. Architecture & Data Flow​

Content on social.hitechinsurance.ai is dynamically backed by MongoDB and managed via Next.js Server Actions:

  • Backing Model: src/lib/db/models/SocialSiteConfig.ts
  • Default Seed Data: src/lib/default-social-config.ts
  • Server Actions: src/server/actions/social.actions.ts (getSocialConfig, updateSocialConfig)
  • Localization: Every text field is stored as a localized object { en: string, es: string }, allowing simultaneous management of English and Spanish content.

2. All 10 Configurable Modules​

2.1 Hero Section & Quick Actions​

  • Branding Assets: Configurable logo (/logo.png), banner image (/Banner.webp), and background grid (/Background_original_grid.webp).
  • Headlines: Localized brand name and dynamic tagline.
  • Quick Action Buttons: Configurable floating action buttons (e.g., Call Now, Text Us, Get Quote, Emergency Dispatch) with custom icons, hrefs, and target window modes (_blank vs _self).
  • Video Embed Engine: Auto-resolves standard YouTube links (https://youtube.com/watch?v=...), short URLs (https://youtu.be/...), and YouTube Shorts (https://youtube.com/shorts/...) into secure responsive iframe embeds via getYouTubeEmbedUrl.
  • Localized Copy: Customizable section title, subtitle, and Watch Now call-to-action text.
  • Activation Toggle: Can be toggled on/off instantly.

2.3 Insurance Tips & Video Reels​

  • Educational Tips Catalog: Categorized tips (Auto, Commercial Trucking, Personal Lines, Business Insurance).
  • Tip Card Attributes: Tip number, category badge, localized headline, full caption, detailed body text, video URL, poster/thumbnail image, and Instagram reel link.
  • Interactive Modal Player: Clicking a tip card opens a full-screen vertical reel player with localized captions.

2.4 Quick Links & Resources​

  • Curated Links: Dynamic grid of high-priority external and internal links (e.g., DOT Compliance Guide, Trucker Tax Tips, Instant COI Request).
  • Badges & Primary Highlights: Optional localized badge chips (e.g., New, Popular, Essential) and primary card highlighting.

2.5 Social Grid Channels​

  • Social Network Channels: Configurable link pills for Instagram, LinkedIn, Facebook, TikTok, YouTube, and X (Twitter).
  • Brand Colors & Handles: Customizable handle displays and brand accent colors per network.

2.6 Active Event Campaign Banner​

  • Convention & Trade Show Integration: Dynamically highlights an active event campaign (e.g., Great American Trucking Show, Texas Trucking Expo).
  • Slug Linking: Associates the banner with a dynamic event campaign ID and slug, allowing attendees to register via dynamic event landing forms.

2.7 Client Testimonials & Reviews Carousel​

  • Dynamic Policyholder Stories: Displays authentic commercial driver, owner-operator, and fleet manager reviews.
  • Testimonial Schema Attributes:
    • name: Client or company name (e.g., "Carlos Rodriguez", "Apex Logistics Fleet").
    • role: Localized title (e.g., en: "Verified Owner-Operator", es: "Operador Propietario Verificado").
    • rating: Star rating (1 to 5 stars).
    • text: Localized review statement.
    • avatar: URL to client headshot or company logo.
    • isActive: Toggle visibility without deleting records.
    • order: Numeric sort order in the carousel.

2.8 Physical Branch Locations Banner​

  • Texas Office Directory: Prominent section directing visitors to HiTech Insurance's regional office branches and agent meeting locations in Texas.
  • Configurable Attributes:
    • Localized section title & subtitle.
    • Localized button text (e.g., Find an Office Near You / Ver Todas las Sucursales).
    • Destination URL (defaults to https://www.hitechinsurance.ai/locations).
    • Active toggle.

2.9 Frequently Asked Questions (FAQ)​

  • Bilingual FAQ Accordion: Addresses common client inquiries (commercial trucking certificates, payment options, dispatch questions, roadside proof).
  • FAQ Item Attributes:
    • question: Localized question { en, es }.
    • answer: Localized answer { en, es }.
    • isActive: Toggle visibility.
    • order: Drag-and-drop or numeric reordering.

2.10 Community & Newsletter Capture​

  • Audience Ingestion: Localized email capture form allowing social visitors to join the HiTech community.
  • Privacy Disclaimers: Customizable localized disclaimer notes and success confirmation messages.

2.11 Digital Business Card (vCard)​

  • Single-Tap Save Contact: Generates standard .vcf vCard contact files for instant smartphone contact book saving.
  • Contact Details: Agent name, business phone, dispatch email, company website, and social links.

3. Admin Operations & Management Workflow​

Administrators manage all social portal configurations from /admin under the Social Management tab:

  1. Side-by-Side Bilingual Editing: English and Spanish fields appear side-by-side with validation alerts for missing translations.
  2. Reordering & Visibility Toggles: Testimonials, tips, FAQs, and links can be rearranged or temporarily hidden with single-click switches.
  3. Atomic Persistence: Changes save atomically via Mongoose updates with automatic update auditing (updatedBy, updatedAt).