Biblioteca de Producto

Un registro anclado al código de cómo funcionan de verdad los productos de Welcome Back. No es marketing ni guía de uso. Es el comportamiento real de nuestros servicios, trazado desde el código y verificado en cada versión. Es la mitad técnica del cerebro de la empresa: alimenta las respuestas de CS, el agente Finn de Intercom (lado técnico), las decisiones de producto y el onboarding de ingeniería.

El centro de ayuda externo explica cómo usar Welcome Back. Esta biblioteca explica cómo se comporta de verdad.

Las reglas (solo funciona si se mantiene honesto)

Cada afirmación de comportamiento apunta al código. Lleva archivo:línea, y el documento guarda el commit contra el que se verificó (verified_at). Una afirmación que no puedes señalar no es una afirmación.
Los documentos son derivados, nunca la autoridad. La capa de comportamiento es propiedad de la máquina. Si el documento está mal, el código se movió. Arregla el código o el trazador. Nunca edites a mano una afirmación de comportamiento. Las personas editan el resumen, las preguntas y las notas.
La honestidad se re-verifica en cada release. En cada release comparamos los archivos citados entre el commit verified_at del documento y el de producción. Si alguna línea citada se movió, el documento queda desactualizado y se re-traza.
La cobertura es pública y honesta. El registro de superficies lista cada superficie del backend y dice si está documentada. Mostramos los huecos; no los escondemos.

Cómo funciona

Cada documento de feature es datos estructurados (YAML). Cada afirmación lleva repo · archivo · línea. El sitio se genera desde ahí: diagrama, preguntas frecuentes, comportamientos, y un chip </> por afirmación que abre la línea exacta en GitHub.
El verificador de deriva compara cada documento contra producción y marca lo que quedó viejo. Para wb-services usa el último tag en develop; para wb-ui usa la rama release.
Los features viven en carpetas por dominio: loyalty/, catalog/, reviews/, …

Estados

estado	significado
`verified`	totalmente trazado, todo anclado, commit actual
`partial`	algunos comportamientos trazados, otros pendientes
`stale`	el código citado cambió desde `verified_at` — hay que re-trazar
`untraced`	listado en el registro, aún sin documentar

Cobertura (v0)

Superficies documentadas: 4 / 779 en 2 documentos — el piloto de Lealtad (ledger/adjust + reverse, customer-cards/deactivate + reactivate). Es la línea de partida honesta.