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"]
PICK[Pick Favorites]
PROFILE[Digital Profile Builder]
end
subgraph OUTPUT["📤 OUTPUT"]
PAGE[Custom Public Page]
MAP[Google Maps Zoom Embed]
ADMIN["/admin Dashboard"]
end
YT --> API
IG --> API
TT --> API
FB --> API
API --> FILTER
FILTER --> QUERY
QUERY --> TRANS
TRANS --> EXTRACT
EXTRACT --> ADDR
ADDR --> PICK
PICK --> PROFILE
PROFILE --> PAGE
PROFILE --> MAP
PROFILE --> ADMIN
PAGE --> MAP
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[Maps Embed]
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 --> REVIEW[Review Results]
REVIEW --> PICK{Pick Businesses}
PICK -->|Yes| BUILD[Build Digital Profile]
PICK -->|No| SEARCH
BUILD --> PUBLISH[Publish Custom Page]
PUBLISH --> MAP[Google Maps Zoom Load]
MAP --> ADMIN[Client Edits via /admin]
ADMIN --> DONE([Live Profile])
4. Technical Stack Architecture
Frontend • Backend • Services • Infrastructure
flowchart TB
subgraph FRONTEND["Frontend"]
REACT["React / Next.js"]
TAILWIND[Tailwind CSS]
MAPS[Google Maps API]
end
subgraph BACKEND["Backend"]
NODE[Node.js API]
QUEUE[Job Queue]
WORKER[Background Workers]
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 INFRA["Infrastructure"]
DB[(PostgreSQL)]
REDIS[(Redis)]
S3[(Storage)]
end
FRONTEND --> BACKEND
BACKEND --> SERVICES
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[Positive Reviews]
EMBED[Google Maps Zoom]
end
LOGIN --> DASH
DASH --> EDIT
DASH --> REVIEWS
DASH --> MAP
EDIT --> PAGE
REVIEWS --> POSITIVE
MAP --> EMBED
PAGE --> SLUG
SLUG --> POSITIVE
SLUG --> EMBED
Investment Summary
Total Project Cost
€1,975
Deposit (50%)
€987.50
Balance on Completion
€987.50
Timeline
7–14 days