CoddexaNOVA

AI Voice · Business Intelligence · Pipeline

◈ CoddexaNOVA — Business Intelligence Pipeline
Entry
User Submits BI Prompt
Boss types a business name, city, URL or topic and clicks Run Analysis. Session created instantly with unique ID. Research thread launched in background — no waiting.
Output
session_id = nbi-{date}-{hex} status: running prompt saved
Phase 00 Pre-flight — Entity Extraction, Validation & Query Generation ~5–10s · synchronous · pre-flight gate
Phase 00
Prompt Parser & Business Validator
grok-3-mini
Receives raw Boss input. Extracts company name, city, country, domain and market context. Validates that a real business is identifiable (pre-flight gate — stops pipeline if not_found). Generates 13 focused search queries, one per downstream Gemini phase, optimised for web grounding.
Output (JSON)
company_name city / country market_context validation_status search_queries[13] urls[]
Phases 01–13 Deep Research — Sequential · Gemini 2.5 Pro + Google Search Grounding ~3–4 min per phase · polled every 2s
Phase 01
Identity & Presence
gemini-2.5-pro
Website, social media, location, business type, online platforms
Output
presence_mapplatforms[]score
Phase 02
Reputation & Reviews
gemini-2.5-pro
Aggregate rating, review trend, platforms, praised vs criticized
Output
avg_ratingtrendscore
Phase 03
Review Sentiment & Themes
gemini-2.5-pro
Top positive/negative themes, recurring complaints, patterns 1★ vs 5★
Output
themes_pos[]themes_neg[]score
Phase 04
Products & Services
gemini-2.5-pro
Menu/services, pricing, hours, delivery, loyalty, special offers
Output
offer_mapprice_rangescore

Phase 05
Competitive Intel
gemini-2.5-pro
Direct/indirect competitors, market gaps, positioning
Output
competitor_matrix[]gaps[]score
Phase 06
Demand & Market
gemini-2.5-pro
Local market, traffic, seasonality, relevant demographics
Output
market_sizedemand_signals[]score
Phase 07
Digital Marketing
gemini-2.5-pro
Website, GMB, social media, ads, SEO, influencer mentions
Output
digital_auditmaturity_scorescore
Phase 08
People & Team
gemini-2.5-pro
Owner/founder, staff quality, notable partners, awards
Output
team_profilestaff_signals[]score

Phase 09
Official Records
gemini-2.5-pro
Registration, health inspections, certifications, legal, compliance
Output
legal_statuscertifications[]score
Phase 10
Operational Signals
gemini-2.5-pro
Wait times, capacity, peak hours, operational issues
Output
ops_signals[]peak_hoursscore
Phase 11
Extended Web Listening
gemini-2.5-pro
Reddit, local press, blogs, YouTube, Wayback, viral moments
Output
web_mentions[]viral_signalsscore

Phase 12
Risk & Vulnerabilities
gemini-2.5-pro
Reputation, operational, market, regulatory, fake reviews
Output
risk_register[]score
Phase 13
Growth Opportunities
gemini-2.5-pro
Quick wins 0-90d, bets 3-12m, expansion, new segments
Output
quick_wins[]strategic_bets[]score
Quality Gate Post-Research Confidence Assessment automatic · no extra API call
Gate B
Quality Gate — Coverage & Confidence Summary
After all 13 phases complete, computes: coverage % (phases with data), count of high/medium/low confidence phases. Passed to Claude synthesis so it can weight uncertain data appropriately. Displayed in UI as a compact bar above the SWOT.
Output
coverage_pct high_confidence medium_confidence low_confidence
Phase 14 Strategic Synthesis — Executive Summary + SWOT + Recommendations ~45s · all 13 phase outputs + quality gate injected
Synthesis
Claude Sonnet — Strategic Analysis
claude-sonnet-4-6
Receives all 13 phase outputs concatenated with quality gate data. Generates: executive summary (3-4 sentences), full SWOT with evidence from research, 5 prioritized recommendations with impact/effort scores and timeline tags.
Output (JSON)
executive_summary strengths[] weaknesses[] opportunities[] threats[] recommendations[5] data_quality
Output
Session Complete — Report Ready
Full JSON stored at nova-bi-sessions/{sid}.json. Frontend polls every 2s during execution, renders phase cards progressively as they complete (with score + bullets + expandable brief), then quality gate bar + executive summary + full SWOT + recommendations on status: done. Export to Markdown available.
API Endpoints
POST /nova/bi/run GET /nova/bi/session/{sid} GET /nova/bi/sessions
#PhasePurposeModelOutput
00Pre-flight & Entity ExtractionBusiness validation, entity extraction, 13 search queries Grok-3 Mini company_name, city, country, validation_status, search_queries[13]
01Identity & PresenceWebsite, social media, platformsGemini 2.5 Propresence_map, platforms, score/10
02Reputation & ReviewsAggregate ratings, trend, platformsGemini 2.5 Proavg_rating, review_count, trend, score/10
03Review Sentiment & ThemesRecurring themes, complaints, patternsGemini 2.5 Prothemes_pos[], themes_neg[], score/10
04Products & ServicesMenu/offer, pricing, hours, deliveryGemini 2.5 Prooffer_map, price_range, score/10
05Competitive IntelDirect/indirect competitors, gapsGemini 2.5 Procompetitor_matrix[], gaps[], score/10
06Demand & MarketMarket size, demand, seasonalityGemini 2.5 Promarket_size, demand_signals[], score/10
07Digital MarketingWebsite, GMB, social, ads, SEOGemini 2.5 Prodigital_audit, maturity_score, score/10
08People & TeamOwner, staff quality, partnershipsGemini 2.5 Proteam_profile, staff_signals[], score/10
09Official RecordsRegistration, inspections, legalGemini 2.5 Prolegal_status, certifications[], score/10
10Operational SignalsWait times, capacity, peak hoursGemini 2.5 Proops_signals[], peak_hours, score/10
11Extended Web ListeningReddit, press, blogs, YouTube, WaybackGemini 2.5 Proweb_mentions[], viral_signals, score/10
12Risk & VulnerabilitiesReputation, market, regulatory risksGemini 2.5 Prorisk_register[], score/10
13Growth OpportunitiesQuick wins, bets, expansion potentialGemini 2.5 Proquick_wins[], strategic_bets[], score/10
14Strategic SynthesisExecutive summary, SWOT, prioritized actions Claude Sonnet executive_summary, SWOT, recommendations[5] with impact/effort/timeline
Grok-3 Mini — Pre-flight & Extraction
Gemini 2.5 Pro — Deep Research (grounded)
Claude Sonnet — Synthesis
Output / Complete
Sequential · ~40–50 min total · sessions stored indefinitely