PRODUCT.md

Rama main · réplica de lectura del repositorio original.

# Product

## Register

product

## Users

TradePilot serves 1-5 person foreign-trade teams that manage customers, inquiries, quotations, orders, shipments, product content, and AI integrations throughout the workday. Users need to scan exceptions quickly, act with limited operational support, and keep business data under their own control.

## Product Purpose

TradePilot is an open-source, self-hosted foreign-trade operations platform. It brings CRM workflows, order fulfillment, product media production, and user-supplied AI providers into one dependable workspace. Success means a small team can see what needs attention, complete routine work with fewer context switches, and deploy the system without specialist help.

## Brand Personality

Expert, calm, and decisive. The product should feel premium through clarity, proportion, and responsive feedback rather than decoration. It should communicate control during operational work and focused creative energy during product-media production.

## Anti-references

- An all-dark administration interface with low-contrast text.
- A default component-library demo with interchangeable cards, fabricated metrics, or generic spacing.
- Purple gradients, decorative blobs, excessive glassmorphism, or neon cyber styling.
- A marketing landing page disguised as an operations tool.
- Decorative page-load choreography that delays access to the user's work.

## Design Principles

1. Put exceptions and decisions before totals: the first viewport should explain what needs action.
2. Keep daily operations bright, dense, and scannable. The public website and authentication story use a dark, cinematic harbor identity with warm cream typography; the app pairs a deep forest navigation with a quiet light canvas.
3. Group navigation by user workflow, not by the order features were added.
4. Use motion to explain state, progress, and spatial continuity, never as background decoration.
5. Make self-hosted services understandable through visible health, readiness, and recovery states.

## Accessibility & Inclusion

Target WCAG 2.2 Level AA. Normal text must meet 4.5:1 contrast, controls must have visible keyboard focus and at least a 24px target, status may not rely on color alone, and all motion must honor `prefers-reduced-motion`. Dark studio surfaces must retain high-contrast text and controls.

## User-approved visual reference (2026-10-13)

The supplied creative-studio reference is adapted to TradePilot as a voyage from prospect discovery to communication and fulfillment. Use the product's actual business flow and honest feature boundaries. Keep the Next.js stack and existing business contracts. Platform administration remains a separate navigation group restricted by the existing roles. Do not use the artistic studio's copy, unrelated autoplay videos, or made-up business outcomes.