Skip to content

docs: documentos de producto en docs/ - #359

Merged
aacienfuegos merged 2 commits into
developfrom
docs/documentos-producto
Oct 15, 2026
Merged

aacienfuegos merged 2 commits into
developfrom
docs/documentos-producto

Conversation

@cienfuegos-agentes

@cienfuegos-agentes cienfuegos-agentes Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

Documentos de producto de tripplanner en docs/: producto.md, tecnico.md, pantallas.md, diseno.md y datos.md. Describen develop tal como está (cabeza e85fa14), con la ruta de origen de cada afirmación; lo que no se puede confirmar en el código va como "Pendiente de confirmar". Solo documentación: no toca código, CLAUDE.md, AGENTS.md ni README.md.

Sin Closes: no hay issue de GitHub (encargo interno CIE-193, plan de CIE-190).

Discrepancias con el código encontradas al escribirlos

Están documentadas en los ficheros tal como las dice el código, sin cambiarlo:

  • CLAUDE.md describe un stub web de la base de datos de Android y un aviso en apps/android/app/_layout.tsx; en develop no existe ningún fichero .web.* en apps/android ni comprobación de Platform.OS === "web" (docs/tecnico.md).
  • Web: la acción deleteTrip existe pero ninguna pantalla la invoca (docs/pantallas.md).
  • Android: la escala primary de tailwind.config.js no la usa ninguna clase (docs/diseno.md).
  • Web: --font-mono apunta a --font-geist-mono, que no se define en ningún sitio (docs/diseno.md).

Verificación

1. Rutas citadas existen. Script que extrae las rutas entre comillas invertidas de docs/*.md y las comprueba con os.path.exists o glob (corchetes escapados), contra la raíz y los directorios base que cada documento declara para sus rutas relativas:

rutas comprobadas: 325
no encontradas: [('docs/pantallas.md', 'loading.tsx'), ('docs/pantallas.md', 'error.tsx'), ('docs/pantallas.md', 'not-found.tsx')]

Las tres "no encontradas" son correctas: pantallas.md las cita para decir que no existen (find apps/web/src/app -name loading.tsx -o -name error.tsx -o -name not-found.tsx devuelve 0 ficheros).

2. Repo público, sin hosts, IP, URL ni emails. Control positivo previo: el mismo patrón detecta una URL y un email en un fichero de prueba.

$ grep -nE '([0-9]{1,3}\.){3}[0-9]{1,3}|https?://|\.lan\b|\.local\b|@[a-z0-9-]+\.[a-z]' docs/
(exit 1)

Además, sin coincidencias para dev-local|homelab|dockhand|staging\.|ghcr|traefik ni asignaciones VAR=valor. Variables de entorno solo por nombre y solo las que aparecen en apps/web/src (grep -rnoE "process\.env\.[A-Z_]+").

3. Sin emojis. Control positivo previo con un emoji de prueba.

$ grep -nP '[\x{1F300}-\x{1FAFF}\x{2600}-\x{27BF}]' docs/
(exit 1)

Build, tsc y tests no aplican en local (no cambia código); el gate es la CI del PR.

CI

En rojo solo por el paso "Auditoría de seguridad npm" (run 38373787321): 52 advisories en dependencias que ya están en develop, no en este PR, que solo añade Markdown. "Type check", "Type check Android" y "Tests" pasan; "Build" y el smoke test se saltan porque van después de la auditoría. El arreglo es #358 (chore/npm-audit-advisories-357), en verde y pendiente de merge; tras mergearlo, un rebase de esta rama sobre develop debería dejar la CI en verde.

🤖 Generated with Claude Code

cienfuegos-agentes Bot added a commit that referenced this pull request Oct 13, 2026
runAgentOSImport pasa a usar requireUser en tripplanner#360; datos.md
decía que solo comprobaba la sesión. Condición del ciso sobre #359.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
cienfuegos-agentes Bot and others added 2 commits October 15, 2026 16:59
Cada plan volvía a leer el repo desde cero para saber qué pantallas,
datos y aspecto tiene la app. Estos cinco documentos (producto, técnico,
pantallas, diseño y datos) describen develop tal como está, con la ruta
de origen de cada afirmación, para que un plan diga solo qué cambia.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
runAgentOSImport pasa a usar requireUser en tripplanner#360; datos.md
decía que solo comprobaba la sesión. Condición del ciso sobre #359.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cienfuegos-agentes
cienfuegos-agentes Bot force-pushed the docs/documentos-producto branch from 1523386 to f9270de Compare October 15, 2026 16:59
@aacienfuegos
aacienfuegos merged commit a65edba into develop Oct 15, 2026
2 checks passed
@aacienfuegos
aacienfuegos deleted the docs/documentos-producto branch October 15, 2026 17:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant