Observaciones
Una observación registra una afirmación sobre una entidad en un momento del historial; una afirmación posterior no edita la anterior.
Qué contiene una observación
Una observación se refiere a una entidad y contiene campos, tiempos, contexto de esquema y procedencia. Su fuente puede ser un archivo aportado u otra entrada registrada. Una escritura estructurada de un agente o una corrección puede no tener archivo fuente aparte; la falta de enlace a un documento no demuestra por sí sola que la observación sea inválida. Su atribución y contexto de escritura siguen importando.
Los campos se interpretan según un esquema declarado para el tipo de entidad. Una clave enviada que el esquema no declara puede conservarse como fragmento sin procesar en lugar de aparecer entre los campos actuales de la entidad. Después de escribir, recupera la entidad y verifica el campo exacto, no solo el estado de la respuesta.
Omitir un campo dice menos que aportar un valor explícito. Por ejemplo, omitir el estado en una observación nueva deja la afirmación de estado anterior disponible para el reductor; indicar un estado concreto crea otra afirmación que debe considerar. null, cero y una cadena vacía también tienen significados propios según el esquema: no los uses indiscriminadamente como «desconocido».
Las correcciones añaden evidencia
Una corrección crea otra observación. La anterior sigue disponible para examen, lo que permite entender por qué el valor actual difiere del primero registrado. Las correcciones reciben una prioridad propia en la vía de reducción configurada, pero el resultado efectivo depende de la política de combinación del campo. No presupongas que todos los campos siguen la misma regla para elegir el valor ganador.
En un campo con política last_write, decide la marca temporal observada más reciente. Con highest_priority, deciden la prioridad de fuente y luego los desempates definidos. Las políticas de combinación de arrays tienen reglas propias de contribución. Lee la política del tipo de entidad antes de predecir qué valor ganará.
Reinterpretación e historial
Reinterpretar una fuente crea observaciones nuevas con su propio contexto de configuración; no altera silenciosamente la interpretación anterior. La extracción asistida por IA puede dar otro resultado en una ejecución posterior: examina la observación nueva y su configuración. El cálculo determinista de la instantánea empieza una vez fijados el conjunto de observaciones y el esquema.
La arquitectura de observaciones describe el ciclo de vida. Resolución de conflictos define las políticas por campo. Continúa con Instantáneas actuales para ver cómo se calcula una respuesta presente.
Temas relacionados
El modelo del registroNeotoma separa la identidad estable de una cosa de las observaciones sobre ella y de la vista actual calculada a partir de esas observaciones.
Instantáneas actuales de entidadesUna instantánea de la entidad es la vista de campos actuales calculada a partir de las observaciones según un esquema activo y sus políticas de combinación.
Esquemas y reglas de campoEl esquema de una entidad declara qué campos pertenecen a un tipo y cómo las observaciones de cada campo se convierten en un valor actual.