PLAN T NELSON

Architecture Blueprint & System Flow

€1,975 50% upfront • 7–14 days

1. End-to-End System Flow

Full Pipeline: Input → Search → AI → Profile → Output

flowchart TB subgraph INPUT["🌐 INPUT LAYER"] YT[YouTube] IG[Instagram] TT[TikTok] FB[Facebook] end subgraph SEARCH["🔍 SEARCH and AGGREGATION"] API[Platform APIs] FILTER[Location Filter] QUERY[Review Query Engine] end subgraph AI["🤖 AI PROCESSING"] TRANS[Auto Transcript Reader] EXTRACT[Business Info Extraction] ADDR["Address, Website, Contact"] end subgraph CURATE["📋 CURATION & AUTO-CREATE"] QUALIFY[Qualified Leads] AUTO[Auto-Create Digital Profiles] PROFILE[Digital Profile Builder] end subgraph OUTPUT["📤 OUTPUT"] PAGE[Custom Public Page] MAP[Google Earth Zoom Embed] REVIEWS[Video Reviews Gallery] QR[QR Code → Business Page] ADMIN["/admin Dashboard"] end subgraph EMAIL["📧 LEAD NOTIFICATION"] TEMPLATE[Best Kept Secrets Template] BRANDED[QR on Logo + Business Name] SEND[Email to All Qualified Leads] end YT --> API IG --> API TT --> API FB --> API API --> FILTER FILTER --> QUERY QUERY --> TRANS TRANS --> EXTRACT EXTRACT --> ADDR ADDR --> QUALIFY QUALIFY --> AUTO AUTO --> PROFILE PROFILE --> PAGE PROFILE --> MAP PROFILE --> REVIEWS PROFILE --> QR PROFILE --> ADMIN PAGE --> MAP PAGE --> REVIEWS QR --> TEMPLATE TEMPLATE --> BRANDED BRANDED --> SEND

2. Data Flow & Component Architecture

External Sources → Core Engine → Storage → Delivery

flowchart LR subgraph EXTERNAL["External Sources"] direction TB S1[YouTube] S2[Instagram] S3[TikTok] S4[Facebook] end subgraph CORE["Core Engine"] direction TB A[Search API] B[Location Filter] C[Transcript Parser] D[Business Extractor] end subgraph STORAGE["Data Layer"] direction TB DB[(Database)] CACHE[(Cache)] end subgraph DELIVERY["Delivery"] direction TB E[Profile Pages] F[Admin Panel] G[Google Earth Zoom] H[Video Reviews] I[QR Code Generator] J[Best Kept Secrets Email] end EXTERNAL --> CORE CORE --> STORAGE STORAGE --> DELIVERY

3. User Journey Flow

From Search to Live Profile

flowchart TD START([Start]) --> SEARCH[Search Platforms] SEARCH --> FILTER[Filter by Location] FILTER --> COLLECT[Collect All Reviews] COLLECT --> TRANSCRIBE[Auto Transcript Reader] TRANSCRIBE --> EXTRACT[Extract Business Info] EXTRACT --> QUALIFY[Qualified Leads] QUALIFY --> AUTO[Auto-Create Profiles for All] AUTO --> BUILD[Build Digital Profile] BUILD --> PUBLISH[Publish Custom Page] PUBLISH --> MAP[Google Earth Zoom Embed] PUBLISH --> REVIEWS[Embed Video Reviews] PUBLISH --> QR[Generate QR → Business Page] QR --> TEMPLATE[Best Kept Secrets Template] TEMPLATE --> EMAIL[Email QR + Logo to Leads] MAP --> ADMIN[Client Edits via /admin] EMAIL --> DONE([Leads Receive Branded QR]) ADMIN --> DONE

4. Technical Stack Architecture

Frontend • Backend • Services • Infrastructure

flowchart TB subgraph FRONTEND["Frontend"] REACT["React / Next.js"] TAILWIND[Tailwind CSS] MAPS[Google Earth / Maps API] end subgraph BACKEND["Backend"] NODE[Node.js API] QUEUE[Job Queue] WORKER[Background Workers] QR_GEN[QR Code Generator] EMAIL_SVC[Email Service] end subgraph SERVICES["External Services"] YT_API[YouTube API] IG_API[Instagram Graph] TT_API[TikTok API] FB_API[Facebook Graph] SPEECH[Speech-to-Text] LLM[LLM Extraction] end subgraph ASSETS["Brand Assets"] BKS_TEMPLATE["Best Kept Secrets Template"] BKS_LOGO[Diamond QR Placeholder] end subgraph INFRA["Infrastructure"] DB[(PostgreSQL)] REDIS[(Redis)] S3[(Storage)] end FRONTEND --> BACKEND BACKEND --> SERVICES BACKEND --> QR_GEN BACKEND --> EMAIL_SVC QR_GEN --> BKS_TEMPLATE BKS_TEMPLATE --> EMAIL_SVC BACKEND --> INFRA

5. Admin & Profile Management

Admin Dashboard → Public Profile

flowchart TB subgraph ADMIN["Admin Dashboard /admin"] LOGIN[Login] DASH[Dashboard] EDIT[Edit Profile] REVIEWS[Manage Reviews] MAP[Update Map] end subgraph PUBLIC["Public Profile"] PAGE[Custom Page] SLUG["/business-slug"] POSITIVE[Video Reviews Gallery] EMBED[Google Earth Zoom] QR_LINK[QR Code → Opens Page] end LOGIN --> DASH DASH --> EDIT DASH --> REVIEWS DASH --> MAP EDIT --> PAGE REVIEWS --> POSITIVE MAP --> EMBED PAGE --> SLUG SLUG --> POSITIVE SLUG --> EMBED SLUG --> QR_LINK

6. Best Kept Secrets — QR Email Flow

Branded Template → QR Code → Email to Qualified Leads

flowchart LR subgraph PROFILE["Digital Profile"] PAGE[Business Page] VIDEO[Video Reviews] EARTH[Google Earth Zoom] end subgraph GEN["Generation"] QR[Generate QR Code] TEMPLATE["Best Kept Secrets Template"] MERGE[Merge: QR + Business Name] end subgraph DELIVERY["Email to Leads"] ATTACH[Branded Graphic] SEND[Email All Qualified Leads] end PAGE --> QR QR --> TEMPLATE TEMPLATE --> MERGE MERGE --> ATTACH ATTACH --> SEND PAGE --> VIDEO PAGE --> EARTH

Template: Best Kept Secrets logo with BUSINESS NAME placeholder + diamond QR area ("SEE WHY"). Each qualified lead receives a personalized branded graphic with their business name and QR code linking to their digital profile.

Best Kept Secrets template Template reference — QR goes in diamond • Business name in gold panel

Investment Summary

Total Project Cost

€1,975

Deposit (50%)

€987.50

Balance on Completion

€987.50

Timeline

7–14 days