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