fix(migrations): make runner robust for all tenant DBs

- Register all missing migrations in runner.py
- Make v4.3 idempotent (rename xml_unsigned only if exists)
- Make v3.3 idempotent (skip warehouse_inventory/purchase_order_items ops when tables/columns missing)
- Mark v3.3.1 and v3.9 as master-only (SKIP)
- Mark v3.5.1 as optional (skip if whatsapp tables missing)
- Runner skips files marked with '-- : SKIP'

.env.example

@@ -0,0 +1,71 @@
+# Nexus Autoparts — Environment Variables
+# Copy this file to .env and fill in your values.
+# NEVER commit .env to git.
+
+# ═══════════════════════════════════════════════════════════════════════════
+# DATABASE (REQUIRED)
+# ═══════════════════════════════════════════════════════════════════════════
+DATABASE_URL=postgresql://nexus:YOUR_DB_PASSWORD@localhost/nexus_autoparts
+MASTER_DB_URL=postgresql://nexus:YOUR_DB_PASSWORD@localhost/nexus_autoparts
+TENANT_DB_URL_TEMPLATE=postgresql://nexus:YOUR_DB_PASSWORD@localhost/{db_name}
+
+# ═══════════════════════════════════════════════════════════════════════════
+# SECURITY (REQUIRED)
+# ═══════════════════════════════════════════════════════════════════════════
+# Generate with: python3 -c "import secrets; print(secrets.token_hex(32))"
+JWT_SECRET=change-me-to-a-random-64-char-hex-string
+POS_JWT_SECRET=change-me-to-a-different-random-64-char-hex-string
+
+# ═══════════════════════════════════════════════════════════════════════════
+# AI / OpenRouter (OPTIONAL — enables chatbot)
+# ═══════════════════════════════════════════════════════════════════════════
+OPENROUTER_API_KEY=sk-or-v1-your-openrouter-key
+
+# ═══════════════════════════════════════════════════════════════════════════
+# WHATSAPP BRIDGE (OPTIONAL — enables WhatsApp integration)
+# ═══════════════════════════════════════════════════════════════════════════
+WHATSAPP_BRIDGE_URL=http://localhost:21465
+WHATSAPP_BRIDGE_KEY=your-whatsapp-bridge-secret
+
+# ═══════════════════════════════════════════════════════════════════════════
+# SMTP (OPTIONAL — enables email quotations)
+# ═══════════════════════════════════════════════════════════════════════════
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_USER=your-email@gmail.com
+SMTP_PASS=your-app-password
+SMTP_FROM=noreply@yourdomain.com
+
+# ═══════════════════════════════════════════════════════════════════════════
+# REDIS CACHE (OPTIONAL — enables sub-millisecond stock lookups)
+# ═══════════════════════════════════════════════════════════════════════════
+REDIS_URL=redis://localhost:6379/0
+REDIS_ENABLED=true
+REDIS_STOCK_TTL=300
+
+# ═══════════════════════════════════════════════════════════════════════════
+# MEILISEARCH (OPTIONAL — enables sub-100ms catalog search)
+# ═══════════════════════════════════════════════════════════════════════════
+MEILI_URL=http://localhost:7700
+MEILI_API_KEY=nexus-master-key-change-me
+
+# ═══════════════════════════════════════════════════════════════════════════
+# METABASE KPIs (OPTIONAL — Business Intelligence dashboards)
+# ═══════════════════════════════════════════════════════════════════════════
+METABASE_URL=http://localhost:3000
+METABASE_ADMIN_EMAIL=admin@nexus.local
+METABASE_ADMIN_PASS=change-me-to-a-strong-password
+METABASE_DB_PASS=metabase_secret
+
+# ═══════════════════════════════════════════════════════════════════════════
+# FACTURAPI (OPTIONAL — auto-organization mode for new tenants)
+# ═══════════════════════════════════════════════════════════════════════════
+# If set, new tenants can create Facturapi organizations automatically.
+# Otherwise each tenant must store its secret key in tenant_config.cfdi_facturapi_key.
+FACTURAPI_USER_KEY=sk_user_xxxxxxxxxxxxxxxx
+
+# ═══════════════════════════════════════════════════════════════════════════
+# CURRENCY
+# ═══════════════════════════════════════════════════════════════════════════
+DEFAULT_CURRENCY=MXN
+EXCHANGE_RATE_USD_MXN=17.5

.gitignore

@@ -43,6 +43,21 @@ Thumbs.db
 # Local configuration
 .claude/
 *.local.json
+.env
+.env.local
+.env.production
+
+# Secrets
+*.pem
+*.key
+
+# POS static uploads
+pos/static/images/parts/
+
+# SQLite databases
+*.db
+*.db-shm
+*.db-wal
 
 # Temporary files
 *.tmp
@@ -54,6 +69,10 @@ Thumbs.db
 
 # Data files (TecDoc downloads, too large for git)
 data/
+vehicle_database/
+CapturasWeb/
+.pytest_cache/
+node_modules/
 
 # SQLite WAL files
 *.db-shm
@@ -61,3 +80,14 @@ data/
 
 # Diagram images (served from static, too large for git)
 dashboard/static/diagrams/
+
+# Playwright / Node
+package-lock.json
+
+# Backups
+backups/
+
+
+# Local tools (AWS CLI)
+tools/
+

.kimi/plan.md

@@ -0,0 +1,39 @@
+# Plan: Catálogo por Marca de Vehículo
+
+## Resumen
+Reorganizar el catálogo para que la navegación principal sea:
+**Marca de vehículo → Categoría/Sistema → Partes compatibles**
+
+Ejemplo: Toyota → Frenos → [balatas Bosch, discos Brembo, pastillas NGK...]
+
+## Opción recomendada: Materialized View
+
+No tocamos la tabla masiva `vehicle_parts` (billones de rows). Creamos una materialized view que agregue por marca + categoría.
+
+### Cambios DB (Master)
+1. Crear `brand_catalog_parts` MV desde `vehicle_parts → MYE → models → brands`
+2. Agregar índices: `(brand_id, category_id)`, `(brand_id, part_id)`
+3. Crear función `refresh_brand_catalog()` para refrescar
+
+### Cambios Backend
+1. Nuevos endpoints:
+   - `GET /catalog/vehicle-brands` → lista marcas con conteo de partes
+   - `GET /catalog/brand-categories?brand_id=` → categorías disponibles para esa marca
+   - `GET /catalog/brand-parts?brand_id=&category_id=` → partes compatibles
+2. Modificar `catalog_service.py` con filtros por marca
+
+### Cambios Frontend
+1. Nueva vista inicial: grid de marcas de vehículo (tarjetas con logo/contador)
+2. Click en marca → lista de categorías/sistemas (frenos, motor, suspensión...)
+3. Click en categoría → grid de partes compatibles con esa marca
+4. Filtro opcional: modelo/año/motor para refinar resultados
+
+### Datos
+- `vehicle_parts` ya tiene todo. La MV solo agrega/distinct.
+- Las marcas fabricantes (Bosch, NGK) se muestran como badges en cada parte.
+
+## Tiempo estimado
+- DB + Backend: 2-3 horas
+- Frontend: 2-3 horas
+- Testing: 1 hora
+- Total: ~6 horas