Vapelog

Propósito de este documento

• Objetivos: Presentar el producto, el arranque local y los contratos (CI, docs, seguridad) sin sustituir runbooks ni el índice operativo.
• Estructura: Estado → desarrollo → env → arquitectura → documentación.
• Contenido a integrar según contexto: Adapta stack y comandos de este catálogo (pnpm, TanStack Start). No copies un README de SaaS con auth. Los incidentes viven en SUPPORT.md y docs/runbooks/.

Catálogo técnico de dispositivos, resistencias, líquidos y componentes de vapeo para el mercado de la UE. Fichas con fuente, cruce y calculadoras. No es una tienda y no vende nicotina.

Contratos: AGENTS.md · ARCHITECTURE.md · CONTRIBUTING.md · SECURITY.md · SUPPORT.md · CODE_OF_CONDUCT.md.

Estado	Catálogo puro (sin auth / multiplayer / broker Grok)
Producción	vapelog-alexendros.vercel.app
Stack	TanStack Start · React 19 · TypeScript · Tailwind v4 · OKLCH · Nitro
Gestor	pnpm · Node 22

Desarrollo

git clone git@github.com:Soluciones-Alexendros/vapelog.git && cd vapelog
pnpm install
pnpm dev

Comandos

Comando	Uso
pnpm dev	Servidor de desarrollo
pnpm run build	Build de producción (dist/)
pnpm run typecheck	tsc --noEmit
pnpm run lint	ESLint
pnpm run format:check	Prettier
pnpm test	Tests unitarios (node:test)
pnpm run test:coverage	Cobertura (≥70 % líneas en CI)
pnpm run smoke	Smoke HTTP del preview
pnpm run check:env	Valida .env.example
make validate	lint + test + build + smoke

Variables de entorno

La app no requiere variables obligatorias. Ver .env.example.

Arquitectura

Visión en ARCHITECTURE.md y docs/architecture/overview.md. ADRs en docs/architecture/decisions/.

Documentación

Índice: docs/README.md.