AI Insights & Nudges

UC-OWNER-002: Query Business Insights (NLP)

Purpose: Allow owners to ask natural language questions about their data.

Property	Value
Actor	Business Owner
Trigger	User types/speaks a query in the search bar
Priority	P1

Main Success Scenario:

1. Owner types "What was the top service last week?".
2. NLP engine converts query to SQL/Data Query.
3. System executes query and retrieves result (e.g., "Haircut: 450 bookings").
4. LLM polishes result into conversational text.
5. System displays answer and relevant chart.

Alternate Flows:

• Flow A: Voice Input: Owner clicks microphone, speaks query; system converts STT and proceeds.

• Flow B: Ambiguous Query: System asks clarifying question.

Acceptance Criteria:

1. [ ] Supports text and voice input.
2. [ ] Accurate mapping of intent to database schema.

UC-OWNER-003: Review AI Nudges

Purpose: Present actionable AI-generated recommendations to improve business performance.

Property	Value
Actor	Business Owner
Trigger	System generates a high-confidence nudge
Priority	P1

Main Success Scenario:

1. Dashboard highlights a new "Insight" or "Nudge".
2. Owner clicks the nudge (e.g., "Staff utilization low on Tuesdays").
3. System suggests action: "Launch 'Happy Tuesday' 15% discount campaign".
4. Owner reviews and clicks "Apply" or "Customize".
5. System takes user to Campaign creation flow (pre-filled).

Acceptance Criteria:

1. [ ] Nudges sorted by ROI potential.
2. [ ] "One-click" actionability where possible.