# Matriu de cobertura · encàrrec Astrovet

Font funcional: contracte actual `docs/contracts/clinical-reports.md` i inventari candidat `docs/technical/action-manager-next-run.md`. Només consultats com a fonts: no importem mòduls operatius ni recuperem codi antic. El contracte d'aquesta maqueta és independent. «Acordat» indica origen contractual, no aprovació clínica ni paritat amb l'API; «Proposta» necessita validació d'Astrovet.

## Camps

| Bloc promès | Cobertura al catàleg i a la interfície |
|---|---|
| Identificació i avís | Referència DEMO, data, tipus, responsable, client, contracte; motiu, hora i origen de l'avís com a propostes separades. |
| Lloc i horari | Municipi, districte/zona, adreça, UTM E/N, CRS, origen i precisió declarada; arribada/finalització amb dates completes i zona local del dispositiu explícita a la maqueta/exportació. No timestamps clínics. |
| Mapa i ubicació | OSM real activat explícitament, zoom/pan/punt amb teclat/tacte, latitud/longitud o UTM manuals amb conversió aproximada, GPS opt-in d'una lectura amb origen/precisió/instant. Privadesa, permís denegat i fallada de tiles explícits. Sense mapa offline; coordenades editables. |
| Servei i context | Mètode, «Altres» amb detall, hàbitat, entorn multiselecció amb «Altres», meteorologia, queixa, antecedents, altres agents; resultat del servei, no execució i motiu. |
| Observacions i recomptes | Observats/capturats/retirats, cap animal explícit, composició de grup/individus no fitxats. La diferència observats/fitxes és informació, no error universal. |
| Animals 0..n | Referència automàtica d'observació, manual, espècie, noms comú/científic proposats, sexe, classe d'edat, maduresa, edat estimada/unitat/mètode/incertesa, desenvolupament, pes estimat/mesurat, fenotip, comportament, captura, fotos fictícies, retirada, resultat/altres/destí i notes. |
| Rúbrica de comportament | Text de proposta per definir-la amb Astrovet. Cap escala numèrica, llindar ni puntuació inventats. |
| Paparres i custòdia | Presència, rang, mostres, estimació per mostra; estat, destí, lloc, municipi proposat i notes de custòdia. Avisos sense inferir defunció o resultat. |
| Incidències | Files repetibles amb tipus i descripció; estat desconegut vs confirmat buit. |
| Intervencions | Files de proposta: metodologia, protocol/versió declarat, animal vinculat, data/hora i complicacions. Cap catàleg clínic inventat. |
| Administracions | Producte/preparació, finalitat, animal, volum, abast total/individual proposat, data/hora i notes. Sense dosi ni repartiment automàtic. |
| Mostres | ID estable intern, referència llegible proposada, tipus, animal o actuació, recollida, destinació, altres destinacions proposades, estat/qualitat i notes. |
| Laboratori posterior | Mostra vinculada, prova/analit, estat, recepció, resultat declarat, unitat, data, laboratori/font i interpretació humana declarada. Tot és proposta de maqueta. |
| Revisió | Tots els camps i totes les files, inclosos errors i valors ocults conservats. Retorn al camp/registre. Fotos de confirmació de mostra, control de recompte de fitxes i confirmació de revisió no bloquejant. |

## Resultats funcionals

| Requisit | Implementació / límit verificable |
|---|---|
| Només formulari | Entrada directa sense login, tauler ni editor visual; cap canvi al gestor. |
| Camp → completar després | Dues fases sobre la mateixa prova. Primera confirmació de camp conserva snapshot de comparació; canvis posteriors visibles. No revisions operatives ni autor acreditat. |
| Valors incomplets i ocults | Navegar/desar és possible. Col·leccions inactives conserven les files. No es descarta un animal perquè sigui invàlid. |
| Semàntica | No registrat, desconegut, cap/zero i no aplicable diferenciats on pertoqui. Mostres/admin/incidències confirmen explícitament llista buida. |
| Vincles i eliminació | UUIDs ficticis estables. No s'elimina un pare amb fills, ni tan sols si estan ocults. Confirmació abans d'eliminar. |
| Errors/avisos | Dates i cronologia, parella/rang UTM, enters no negatius, espècie, captura/foto, edat/unitat/mètode, vincles i requisits bàsics fills. Avisos de discrepàncies, paparres/custòdia, referències repetides, detalls «Altres», laboratori i revisió. Recalculats sempre de l'estat actual. |
| Desament i recuperació | localStorage separat, import/export de prova fictícia; missatges de quota/malformació i mode memòria. Esborra prova no toca comentaris. |
| Ampliació | Catàleg compartit pel renderer/resum; serialització conserva camps nous i valors retirats. Proves d'extensió i restauració. No editor no-code. |
| Feedback puntual | Botó general i per secció/camp/registre. Intent, expectativa, experiència, sensació i suggeriment; àlies i categoria opcionals. |
| Instruccions de retorn en obrir | Diàleg a cada obertura/recàrrega: comentar, exportar JSON/resum/Excel i reenviar els fitxers pel mateix correu o conversa on s'ha rebut la maqueta. Explica que desar localment no envia res. Es tanca amb botó o Esc, conserva dades i es pot reobrir des del bloc de feedback; respecta el flag de desactivació. |
| Context exacte | Build/catàleg, sessió, prova/escenari, fase/pas, IDs de camp/instància, etiquetes/ajudes/opcions i missatges visibles, hora, idioma i viewport. Sense respostes copiades ni gravació oculta. |
| Captura opcional | Fitxer local triat i previsualitzat; consentiment separat abans de desar/exportar. Cap screenshot automàtic. |
| Retorn del feedback | Comentaris editables/eliminables, recuperables i exportables a JSON + Markdown. Sense enviament centralitzat; retorn manual explícit. |
| Respostes exportables | Excel OOXML multi-full amb dades, IDs, estats, zeros, camps ocults/retirats i avisos. Informe HTML llegible autònom imprimible a PDF. Feedback separat, també exportable a Excel. La ubicació real desada s'inclou als fitxers de respostes. |
| Marcatge funcional al mapa | Botó directe «Marca un punt al mapa», activació també des del llenç, marcador i lectura de coordenades visibles, reubicació per clic/tacte, pan amb previsualització i zoom. Vista/activació conservades en canviar opcions/passos; punt persistent després de recarregar i inclòs a les exportacions. Proves de tiles carregats amb fixture, ratolí, tacte i teclat; comprovació puntual de tiles OSM reals HTTP 200, per fitxer i servidor local. |
| Controls intuïtius dins del mapa | Zoom +/− a l'esquerra; tornar/esborrar punt a la dreta; marcatge i casella GPS a baix. Grups amb noms accessibles, controls tàctils de 44 px o més i estats desactivats. Prova geomètrica en mòbil/escriptori: tots els controls dins la finestra i sense desbordament. Zoom i centrat no alteren la ubicació desada. |
| Només versió de proves | Flag `settings.js`, emmagatzematge propi, cap camp de feedback al registre clínic. |
| Accessibilitat | Labels, passos amb estat, focus al títol/camp/diàleg i retorn, teclat i disseny responsive. Cal contrastar lector de pantalla i Safari físic. |
| Lliurament | Guia d'una pàgina, sis escenaris, carpeta estàtica executable per fitxer o HTTP separat. |

## Deliberadament fora d'abast

No API, login, organitzacions, sincronització real, PWA, service worker, informes reals, Field/dards, simulador, logs, servidor clínic ni desplegament DNS/TLS. No dóna garantia de producció, còpia xifrada, historial clínic immutable o validesa de protocols. No porta l'interval d'edat antic com un segon sistema d'estimació duplicat: es prova edat + unitat + mètode + incertesa; qualsevol rang alternatiu s'ha d'acordar. No són omissions ocultes: queden fora o pendents expressament.

## Criteri de lliurament

Proves automatitzades verdes, cap petició a serveis operatius, resum fidel, feedback exportable sense dades del formulari i un cop d'ull en mòbil/escriptori. Després, prova curta Astrovet en dispositius físics; convertir-ne els comentaris en decisions abans d'ampliar producció. Aquesta matriu no es declara aprovada per Astrovet (`approvedAt:null`).