Add NAHV Sales & Lead Management Platform

[pimholthof]

Summary

This PR introduces a complete sales and lead management platform for NAHV, consisting of a Next.js frontend and Express backend with SQLite database. The application provides comprehensive tools for tracking leads through the sales pipeline, analyzing acquisition channels, and monitoring key performance indicators.

Key Changes

Backend (Express + SQLite)

• Database Layer (src/nahv/backend/src/db/database.ts): SQL.js-based SQLite wrapper with persistent file storage, schema initialization, and seed data
• Lead Management (src/nahv/backend/src/routes/leads.ts): CRUD endpoints for leads with fields tracking status, pricing, source, and customer conversion
• Analytics Engine (src/nahv/backend/src/routes/analytics.ts): Comprehensive metrics computation including conversion rates, ARR calculations, deal cycle analysis, and source attribution
• Pipeline Tracking (src/nahv/backend/src/routes/pipeline.ts): Open pipeline overview with stale lead detection and value aggregation
• Type Definitions (src/nahv/backend/src/types.ts): TypeScript interfaces for Lead, AnalyticsSummary, and related data structures

Frontend (Next.js 14 + React)

• Dashboard (src/nahv/frontend/app/page.tsx): Main overview with KPIs including total leads, conversion rates, ARR metrics, and performance trends
• Lead Management (src/nahv/frontend/app/leads/page.tsx): Searchable lead table with filtering by status and customer status, inline editing via modal
• Pipeline View (src/nahv/frontend/app/pipeline/page.tsx): Open opportunities tracking with deal value, age, and stale lead warnings
• KPI Dashboard (src/nahv/frontend/app/kpi/page.tsx): Target-based performance monitoring with visual status indicators
• Source Analysis (src/nahv/frontend/app/bronanalyse/page.tsx): Channel attribution analysis showing leads, conversions, and ARR per acquisition source
• Email Templates (src/nahv/frontend/app/templates/page.tsx): Pre-built email templates (NL/EN) for kennismaking, proposals, and onboarding with copy-to-clipboard functionality
• Lead Modal (src/nahv/frontend/components/LeadModal.tsx): Reusable form component for creating/editing leads
• Sidebar Navigation (src/nahv/frontend/components/Sidebar.tsx): Main navigation with links to all dashboard sections
• API Client (src/nahv/frontend/lib/api.ts): Typed fetch wrapper for backend communication with utility functions for formatting

Styling & Configuration

• Tailwind CSS: Global styles with custom component classes (buttons, inputs, cards)
• Next.js Config: API rewrites for local development, TypeScript strict mode enabled
• Build Configuration: Both frontend and backend with appropriate TypeScript and tooling setup

Notable Implementation Details

• Lead Lifecycle Tracking: Supports multiple statuses (Contact gelegd, Afspraak gepland, Offerte verstuurd, Klant, Geen reactie) with next action tracking
• Multi-language Support: Templates and UI support both Dutch (NL) and English (EN)
• Financial Metrics: Tracks proposal pricing, ARR calculations, and separates NAHV-sourced revenue from external network revenue
• Performance Analytics: Computes conversion funnels, deal cycle duration, follow-up speed, and identifies stale opportunities
• Source Attribution: Categorizes leads by acquisition channel (Google, Academie, Referral/Netwerk, Eigen acquisitie, Klant NAHV)
• Responsive UI: Card-based layout with color-coded status indicators and real-time filtering

https://claude.ai/code/session_01B4Hd1gFuAgP86vfZDk2e8p