InventList Production Stack

This collection represents the production stack for InventList (inventlist.com), a SaaS inventory management platform.

## Project Context
InventList is a B2B SaaS platform for:
- Product/inventory tracking
- Catalog management
- Analytics and reporting
- Team collaboration
- Stripe subscription billing

## Architecture Philosophy
This stack combines Rails conventions with modern component-driven UI:
- ViewComponent + Phlex for reusable UI components
- Shadcn-UI Rails port for consistent design system
- Devise + Passwordless for flexible authentication
- Pay gem for subscription management

## Key Technical Decisions
1. **Database**: PostgreSQL with pg_search for search
2. **Authentication**: Devise + Passwordless (magic links)
3. **Authorization**: CanCanCan for role-based access
4. **UI Components**: ViewComponent + Phlex + Shadcn-UI
5. **Payments**: Pay gem + Stripe (subscriptions, invoices)
6. **Analytics**: Ahoy for tracking, Chartkick + Groupdate for visualization
7. **Background Jobs**: Redis-backed (Sidekiq-compatible)
8. **Assets**: jsbundling-rails + cssbundling-rails

## Component Architecture
The app uses a hybrid component approach:
- Phlex for lightweight, Ruby-first components
- ViewComponent for complex, testable components
- Shadcn-UI patterns ported to Rails

## When using this stack
- Use components for any repeated UI pattern
- Leverage Pay gem's built-in Stripe webhooks
- Use Ahoy for all analytics tracking
- Prefer magic links over passwords for auth