Built on Modern Tech

FineWineAi is built with cutting-edge technology for performance, security, and scalability. No legacy systems, no technical debt.

Architecture

Frontend
Next.js 15 + TypeScript
  • • React 19 with Server Components
  • • Tailwind CSS v4 for styling
  • • shadcn/ui component library
  • • Mobile-first responsive design
  • • WCAG 2.1 AA accessibility
Backend
Next.js API Routes
  • • Neon PostgreSQL (serverless)
  • • Drizzle ORM with RLS
  • • Firebase Authentication
  • • Zod validation on all inputs
  • • pgvector for embeddings
Infrastructure
Google Cloud Platform
  • • Cloud Run (containers)
  • • Cloud Storage (files)
  • • Cloud Logging
  • • Cloud Scheduler (jobs)
  • • Sentry error monitoring

AI Integration

Two-Tier Model Strategy

We use Claude Haiku 4.5 for fast intent classification and routing, then Claude Sonnet 4.5 for reasoning and generation. This keeps costs low while maintaining high quality.

  • Haiku: Intent routing (<$0.01/query)
  • Sonnet: Domain handlers ($0.10-0.50/query)
  • Prompt caching for system prompts

Embeddings & Search

Product descriptions are embedded using Voyage AI's voyage-3.5 model (Anthropic's preferred partner). Semantic search powered by pgvector.

  • 1024-dimensional embeddings
  • Cosine similarity search
  • Natural language queries

Security & Compliance

Enterprise Security
  • • Row-Level Security on all tenant tables
  • • OWASP Top 10 compliant
  • • All inputs validated with Zod
  • • Firebase Authentication
  • • Audit logging on all mutations
  • • Encrypted data at rest and in transit
Compliance Features
  • • TTB Form 5120.17 auto-generation
  • • 50-state DTC shipping rules
  • • Native tax calculation (no Avalara)
  • • License expiration tracking
  • • Taxpaid removal records
  • • Complete audit trails

No Third-Party Lock-in

We built native solutions for tax calculation and compliance instead of relying on expensive third-party services like Avalara or ShipCompliant.

🧮

Native Tax Engine

Federal excise, state excise, state sales, and local taxes calculated in-house

🚚

Compliance Rules

50-state shipping rules maintained and versioned internally

📝

TTB Reporting

Form 5120.17 generated directly from production data

Developer-Friendly

Code Quality

  • TypeScript strict mode enabled
  • ESLint 9 with flat config
  • Comprehensive test coverage
  • CI/CD with GitHub Actions

Performance

  • Server Components for zero JS
  • Route prefetching
  • Database query optimization
  • Image optimization

Ready to Experience Modern Wine Software?