Skip to content

M7: documentación con fuentes abiertas - #9

Merged
Ray86-dev merged 1 commit into
mainfrom
m7-documentacion
Nov 15, 2026
Merged

Ray86-dev merged 1 commit into
mainfrom
m7-documentacion

Conversation

@Ray86-dev

Copy link
Copy Markdown
Owner

Qué hace

La app documenta los lugares y los temas de la novela con cuatro servicios públicos y gratuitos, sin pasar por un modelo:

Qué se busca Servicio
Dónde está un lugar real Nominatim (OpenStreetMap)
Calles y locales cercanos Overpass (OpenStreetMap)
Clima Open-Meteo
Lugares, oficios, objetos, época Wikipedia
  • Un lugar no se busca hasta que el autor dice si existe. Uno inventado no se busca nunca.
  • Solo sale el tema. Un término con el nombre de un personaje se rechaza en el core. La página no envía direcciones: Rust las construye y solo hacia esos cuatro servicios.
  • Sin fuente no se muestra. La base no admite un resultado sin enlace.
  • Una vez por tema, guardado para leerlo sin conexión.
  • Tope diario de 60 búsquedas, regulable, vigilado en Rust.
  • Nunca mientras se escribe: se busca al abrir las fichas. Con las pistas apagadas, solo al pulsar «Buscar ahora».
  • Si la época no es claramente el presente, no se consultan las calles ni los locales de hoy.

Vive en una pestaña nueva de las fichas, Documentación, y en la ficha de cada lugar.

Cambio respecto a lo previsto

La búsqueda web del modelo queda fuera: es de pago y no se puede probar sin saldo. En su lugar, Wikipedia. Lo recoge docs/adr/0019-documentacion-con-fuentes-abiertas.md, que cambia la 0006.

Comprobado

  • 973 pruebas de TypeScript y 77 de Rust, clippy y tipos.
  • Prueba de humo en la app real: esquema 9, una búsqueda con eñe y tilde llega intacta, un pasaje se rechaza sin gastar del tope y la búsqueda que pasa del tope no sale.
  • Una consulta real a cada servicio, hecha a mano, y la app lee bien lo que devolvieron.

Sin comprobar

  • La app no ha hecho ninguna búsqueda contra los servicios reales: las pruebas usan sustitutos.
  • El aspecto de la pantalla.
  • El User-Agent es ink-writer/ y la versión, sin forma de contacto, que Nominatim y Wikipedia piden.

Fuera

La tarjeta del Dashboard (M8), los temas propuestos por la app para oficios y objetos, la época por capítulo y contrastar los datos de la novela con las fuentes.

🤖 Generated with Claude Code

Lugares, época y temas del autor se buscan en OpenStreetMap, Open-Meteo y
Wikipedia, sin pasar por un modelo. Un lugar no se busca hasta que el autor
dice si existe, y uno inventado no se busca nunca.

- Rust construye la dirección de cada búsqueda y vigila el tope diario.
- El core rechaza todo término con el nombre de un personaje.
- Un resultado sin enlace a su fuente no se guarda ni se muestra.
- Migración 9: research_topics y research_items.

Decisiones y límites en docs/adr/0019.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@Ray86-dev
Ray86-dev merged commit 9002cf7 into main Nov 15, 2026
4 checks passed
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