Update Sessions 1-2: pivot to recreational boats + sticky features

Critical market corrections:
- Target: Jeanneau Prestige 40-50ft (€250K-€480K), NOT mega yachts
- Riviera Plaisance: 150+ boats/year, 20,500+ customers
- Owner profile: weekend users (20-40 days/year), NOT crew-managed

New feature priority (sticky daily engagement):
1. Inventory tracking - prevent €15K-€50K forgotten value at resale
2. Camera/monitoring - 'is my boat OK?' peace of mind
3. Maintenance log - service reminders, expense tracking
4. Contact management - one-tap call to marina/mechanic
5. Expense tracking - annual spend visibility
6. Impeccable search - structured faceted results, NO long lists

Documentation features now secondary to daily engagement.

🤖 Generated with Claude Code
This commit is contained in:
Danny Stocker 2025-11-13 00:57:13 +01:00
parent 92af41b81f
commit 7787a57ff8
2 changed files with 133 additions and 108 deletions

View file

@ -11,113 +11,129 @@
## Mission Statement ## Mission Statement
Gather comprehensive yacht sales market intelligence to support Riviera Plaisance sales pitch, focusing on Mediterranean yacht brokerage market and documentation pain points that NaviDocs solves. Gather comprehensive market intelligence for Riviera Plaisance Euro Voiles, focusing on **recreational motor boat owners** (Jeanneau Prestige 40-50ft, €250K-€480K range) and the daily boat management pain points that NaviDocs solves with sticky engagement features.
--- ---
## Context (Read First) ## Context (Read First)
**NaviDocs:** Marine documentation management platform with OCR, warranty tracking, and multi-jurisdiction document assembly. **NaviDocs:** Daily boat management app with sticky engagement (cameras, maintenance logs, inventory tracking) that happens to have perfect documentation when you need it.
**Meeting:** Riviera Plaisance yacht sales agent (Sylvain) - pitch to include NaviDocs with every boat sale **Meeting:** Riviera Plaisance yacht sales agent (Sylvain) - pitch NaviDocs as included service with every boat sale
**Riviera Plaisance Euro Voiles Profile:**
- **Location:** Antibes, Golfe Juan, Beaulieu (French Riviera)
- **Brands:** Jeanneau, Prestige Yachts, Fountaine Pajot, Monte Carlo Yachts
- **Volume:** 150+ new boats/year, 20,500+ active customers
- **Boat Types:** Recreational motor boats 40-50ft (€250K-€480K range)
- **Owner Profile:** Weekend/holiday users (20-40 days/year), NOT crew-managed mega yachts
**Current NaviDocs Status:** **Current NaviDocs Status:**
- 65% complete MVP - 65% complete MVP
- Production-ready architecture (13 tables, 40+ APIs) - Production-ready architecture (13 tables, 40+ APIs)
- OCR pipeline functional (Tesseract + Google Vision) - OCR pipeline functional (Tesseract + Google Vision)
- Multi-tenant ready - Multi-tenant ready
- Gaps: MLS integration, sale workflow, expiration tracking - **Critical Gap:** Lacks sticky daily-use features (cameras, maintenance, inventory, contacts)
**Key Documents Found (Local Research):** **Key Insights from Local Research:**
1. Warranty tracking prevents €8K-€33K losses per yacht 1. **Inventory tracking pain:** Owners forget €15K-€50K in upgrades when selling (tender, electronics, blinds)
2. €400K-€800K total active warranty value per yacht 2. **Passive docs don't work:** Owners ignore documentation vault until emergency/sale
3. 9-jurisdiction documentation nightmare (flag changes) 3. **Sticky features needed:** Camera check, maintenance log, crew contacts, expense tracking
4. Charter operations need crew tracking, safety checklists 4. **Warranty tracking:** Still valuable (€8K-€33K losses) but secondary to daily engagement
5. **Search UX critical:** No long lists - structured, impeccable search results
--- ---
## Your Tasks (Spawn 10 Haiku Agents in Parallel) ## Your Tasks (Spawn 10 Haiku Agents in Parallel)
### Agent 1: Riviera Yacht Brokerage Market Size ### Agent 1: Recreational Boat Market (Jeanneau Prestige Focus)
**Research:** **Research:**
- Mediterranean yacht sales market size (2024-2025) - Jeanneau Prestige 40-50ft market (units sold annually, price range €250K-€480K)
- Number of yacht brokerages in French Riviera - Riviera Plaisance Euro Voiles volume (150+ boats/year validated)
- Average yachts sold per brokerage per year - Typical owner demographics (age, usage patterns, pain points)
- Average yacht prices (€300K-€5M range focus) - Boat ownership costs (annual maintenance, storage, upgrades)
**Deliverable:** Market sizing report with citations **Deliverable:** Market sizing report for recreational boat segment with citations
### Agent 2: Competitor Analysis ### Agent 2: Competitor Analysis (Boat Management Apps)
**Research:** **Research:**
- Existing yacht documentation software (BoatVault, DeckDocs, etc.) - Boat management apps (Savvy Navvy, Dockwa, Boat Buddy, BoatVault, DeckDocs)
- Pricing models ($50-$500/month range) - Daily engagement features (cameras, maintenance logs, inventory tracking)
- Feature gaps vs NaviDocs - Pricing models (€5-€50/month for consumer apps)
- Customer reviews and pain points - Feature gaps: Do they solve "forgot €15K tender" problem?
- Customer reviews: What makes boat apps sticky vs abandoned?
**Deliverable:** Competitive matrix with 5-10 competitors **Deliverable:** Competitive matrix showing NaviDocs differentiation (daily engagement + perfect docs)
### Agent 3: Broker Pain Points ### Agent 3: Owner Pain Points (Daily Boat Management)
**Research:** **Research:**
- What documentation challenges do yacht brokers face? - What frustrates recreational boat owners? (maintenance tracking, expense tracking, remote monitoring)
- Time spent on pre-sale documentation prep - "Forgot to sell the tender" problem - how common is inventory loss at resale?
- Common deal delays due to missing paperwork - Camera/remote monitoring needs (is my boat OK while I'm away?)
- Value of "turnkey documentation" to buyers - Crew/service contact management (who do I call for cleaning/repairs?)
- Accounting pain (how much am I spending on this boat annually?)
**Deliverable:** Pain point analysis with time/cost impacts **Deliverable:** Owner pain point analysis ranked by frequency and financial impact
### Agent 4: Warranty Tracking Value Proposition ### Agent 4: Inventory Tracking & Resale Value Protection
**Research:** **Research:**
- Average warranty claims per yacht per year - Boat equipment upgrade market (tenders, electronics, deck refinishing, automatic systems)
- Cost of missed warranty claims - Average upgrade spend per boat per year (Jeanneau Prestige 40-50ft owners)
- Broker liability for undisclosed warranty issues - "Forgotten inventory" problem - how much value is lost at resale?
- Value of warranty transfer during sale - Receipt/invoice management for boats (tax deduction, warranty claims, resale documentation)
- Comparable: RV/car inventory tracking solutions
**Deliverable:** ROI calculator inputs (warranty savings) **Deliverable:** ROI calculator for inventory tracking (€X forgotten value prevented)
### Agent 5: Regulatory Requirements ### Agent 5: Sticky Engagement Feature Research
**Research:** **Research:**
- French maritime documentation requirements - Boat camera/monitoring systems (Siren Marine, GOST, Nautic Alert)
- Flag registration paperwork (French, Italian, Spanish flags) - Maintenance reminder apps (what makes them sticky vs ignored?)
- Survey requirements for yacht sales - Expense tracking for recreational vehicles (boats, RVs, classic cars)
- Insurance documentation needs - Contact management for boat services (marina, mechanics, cleaners, charter crew)
- User engagement metrics: daily active users for boat apps
**Deliverable:** Regulatory checklist by jurisdiction **Deliverable:** Feature prioritization - which sticky features drive daily/weekly engagement?
### Agent 6: Charter Fleet Documentation ### Agent 6: Search UX Best Practices (Critical for Inventory)
**Research:** **Research:**
- Charter company documentation requirements - Search UX for inventory/asset management (how to avoid long lists?)
- Coast Guard compliance needs - Structured search results (Pinterest, Amazon, Airbnb approaches)
- Crew certification tracking - Filtering/faceting for boat equipment (by zone, category, value, warranty status)
- Pre-departure safety checklist regulations - Mobile-first search (owners check from phone)
- Voice search for boat management ("Show me tender warranty")
**Deliverable:** Charter fleet feature requirements **Deliverable:** Search UX recommendations - impeccable structured results, zero long lists
### Agent 7: Pricing Strategy Research ### Agent 7: Pricing Strategy Research (Broker-Included Model)
**Research:** **Research:**
- SaaS pricing for marine software (€50-€500/month) - "Included with purchase" software models (Tesla app, luxury car apps)
- Per-boat vs per-brokerage pricing models - Broker/dealer software bundling strategies
- One-time setup fees vs recurring revenue - Freemium boat apps (free basic, paid premium features)
- Freemium vs paid-only strategies - Monthly subscription tolerance (€5-€20/month for boat owners?)
- Revenue share models (broker pays €X per boat sold, owner pays ongoing)
**Deliverable:** Pricing model recommendations **Deliverable:** Pricing recommendation for "included with every Riviera boat" model
### Agent 8: Integration Opportunities ### Agent 8: Home Assistant & Camera Integration Research
**Research:** **Research:**
- Yacht listing platforms (YachtWorld, Boat Trader) - Home Assistant boat monitoring setups (camera feeds, bilge sensors, battery monitoring)
- Broker CRM systems (Salesforce, HubSpot marine) - Marine camera systems compatible with HA (Hikvision, Reolink, marine-rated cameras)
- MLS systems for yacht sales - Boat monitoring hardware (Victron, Siren Marine, GOST integrations)
- Payment processing for documentation services - Remote boat access use cases (security, maintenance alerts, peace of mind)
- API integration patterns (webhook, MQTT, REST)
**Deliverable:** Integration partnership targets **Deliverable:** Technical feasibility report for Home Assistant/camera integration
### Agent 9: Sales Objection Research ### Agent 9: Broker Sales Objection Research
**Research:** **Research:**
- Why brokers resist new software adoption - Why brokers resist including software with boat sales (complexity, support burden)
- Common objections to SaaS tools - Owner adoption challenges (will they actually use it after purchase?)
- What drives yacht broker technology decisions - Sticky product examples (what makes owners keep using bundled software?)
- Success stories from marine tech adoption - Success stories: software included with high-ticket purchases (luxury cars, boats, RVs)
- "I already use X" objections (existing boat management apps)
**Deliverable:** Objection handling playbook **Deliverable:** Objection handling playbook for Sylvain meeting
### Agent 10: Evidence Synthesis ### Agent 10: Evidence Synthesis
**Research:** **Research:**

View file

@ -11,7 +11,7 @@
## Mission Statement ## Mission Statement
Design comprehensive technical architecture for NaviDocs yacht sales features, leveraging InfraFabric's IF.bus and multi-agent patterns. Create 4-week implementation roadmap with acceptance criteria. Design technical architecture for **sticky daily-use features** (inventory tracking, cameras, maintenance logs, contacts, accounting) that make NaviDocs indispensable to recreational boat owners. Documentation features are secondary to engagement.
--- ---
@ -30,12 +30,13 @@ Design comprehensive technical architecture for NaviDocs yacht sales features, l
- OCR: Tesseract + Google Vision - OCR: Tesseract + Google Vision
- Auth: JWT + bcrypt - Auth: JWT + bcrypt
**Integration Gaps (from Session 1):** **Critical Feature Gaps (from Session 1):**
- No MLS/listing platform integration - **No inventory tracking** (€15K-€50K forgotten value at resale)
- No sale workflow automation - **No camera/monitoring integration** (owners want "is my boat OK?" reassurance)
- No expiration tracking (surveys, warranties) - **No maintenance log** (when was last engine service? upcoming work alerts?)
- Limited notifications (only password reset) - **No contact management** (crew, marina, mechanics, cleaners)
- No collaboration features (e-signatures) - **No expense tracking** (how much am I spending on this boat?)
- **No impeccable search** (avoid long lists, structured faceted results)
--- ---
@ -50,59 +51,67 @@ Design comprehensive technical architecture for NaviDocs yacht sales features, l
**Deliverable:** Architecture map with integration points **Deliverable:** Architecture map with integration points
### Agent 2: Warranty Tracking System Design ### Agent 2: Inventory Tracking System Design (CRITICAL)
**Design:** **Design:**
- Database schema for warranties (expiration, claims, transfers) - Database schema: `boat_inventory` (item_name, category, zone, purchase_date, purchase_price, receipt_url, warranty_expiration, current_value)
- Expiration alert system (90, 30, 14 days) - Categories: tender/zodiac, electronics, engine, deck, interior, safety
- Auto claim package generator workflow - Zones: salon, galley, helm, engine room, stern storage
- Jurisdiction-aware document assembly - OCR receipt extraction (auto-populate item, price, date)
- Resale value calculator (total upgrades since purchase)
- Search facets (by category, zone, value range, warranty status)
**Deliverable:** Warranty feature spec with DB migrations **Deliverable:** Inventory tracking spec with impeccable search UX
### Agent 3: Sale Workflow Automation ### Agent 3: Maintenance Log & Reminder System
**Design:** **Design:**
- "As-built" document package generator - Database schema: `maintenance_log` (service_type, date, cost, provider, next_due_date, engine_hours)
- Pre-sale documentation checklist - Service types: engine, electronics, hull, deck, safety equipment
- Buyer handoff workflow (document transfer) - Reminder alerts (based on date OR engine hours)
- Broker collaboration tools (comments, approvals) - Service provider contacts (auto-suggest from past services)
- Expense rollup (total maintenance spend YTD, annual)
**Deliverable:** Sale workflow spec with API endpoints **Deliverable:** Maintenance tracking spec with smart reminders
### Agent 4: Home Assistant Integration ### Agent 4: Camera & Remote Monitoring Integration (STICKY!)
**Research + Design:** **Research + Design:**
- Home Assistant webhook API - Home Assistant camera feed integration (Hikvision, Reolink, marine cameras)
- MQTT integration for onboard sensors - Webhook architecture (NaviDocs ← HA events: motion detected, battery low, bilge alert)
- Camera system integration (security monitoring) - Camera snapshot storage (link to boat, timestamp, auto-cleanup old images)
- Automation triggers (document expiration → alert) - Mobile-first UI (owners check from phone: "is my boat OK?")
- Use cases: security monitoring, dock check, weather damage assessment
**Deliverable:** Home Assistant integration architecture **Deliverable:** Camera/HA integration architecture with peace-of-mind UX
### Agent 5: Offline Mode Enhancement ### Agent 5: Contact Management System
**Design:** **Design:**
- Service worker caching strategy - Database schema: `boat_contacts` (name, role, phone, email, notes, last_used)
- Critical manual pre-caching (engine, safety) - Roles: marina, mechanic, cleaner, charter crew, electrician, surveyor
- Offline sync queue (upload when online) - One-tap call/email from mobile
- Conflict resolution (offline edits) - Auto-suggest from maintenance log (provider → contact)
- Quick actions: "Call my mechanic", "Email charter crew"
**Deliverable:** Offline-first PWA spec **Deliverable:** Contact management spec with mobile-first UX
### Agent 6: MLS/Listing Platform Integration ### Agent 6: Expense Tracking & Accounting
**Research + Design:** **Design:**
- YachtWorld, Boat Trader APIs - Database schema: expense tracking across inventory, maintenance, marina fees
- Broker CRM sync (Salesforce, HubSpot) - Expense categories (maintenance, upgrades, insurance, marina, fuel, crew)
- Automated listing updates (documentation status) - Annual/monthly rollups (how much is this boat costing me?)
- Document sharing with prospective buyers - Budget alerts ("You've spent €15K this year, €3K over budget")
- Tax deduction report (for chartered boats)
**Deliverable:** MLS integration spec with API contracts **Deliverable:** Expense tracking spec with budget management
### Agent 7: Security & Compliance ### Agent 7: Impeccable Search UX Design (CRITICAL)
**Audit:** **Design:**
- Current security issues (5 vulnerabilities from handover doc) - Search architecture (Meilisearch faceted search)
- DELETE endpoint protection needed - Structured results (NO long lists - Pinterest/Airbnb grid layout)
- Auth enforcement gaps - Facets: category, zone, value range, warranty status, date range
- GDPR/data protection requirements (EU yachts) - Mobile-first (owners search from phone)
- Voice search support ("Show me tender warranty")
- Quick filters: "Show expensive items", "Show expiring warranties"
**Deliverable:** Security remediation plan **Deliverable:** Search UX spec with visual mockups (avoid long lists!)
### Agent 8: Notification System Design ### Agent 8: Notification System Design
**Design:** **Design:**