Traducción. Autoritativo: fs-crm-0001-notes.md.
Contexto
La feature más pequeña del módulo y la que más se usa. Una nota es donde va el conocimiento que no cabe en ningún campo: “prefiere que lo llamen después de las 6”, “reclamó por la entrega de marzo”, “es dueño de la franquicia de Avenida Providencia”. Es también el dato personal menos predecible de la plataforma, porque es texto libre escrito por un humano sobre una persona identificada. De ahí dos reglas: las notas se auditan como cualquier cambio de estado, y se borran al suprimir sin remanente anonimizado — a diferencia de una fila del libro de puntos, una nota no tiene valor contable que sobreviva a la persona que describe.Alcance (normativo)
crm.notessobre un contacto, con autor tipado.- Texto enriquecido, acotado en largo.
- Fijar una nota al inicio de un contacto.
- Edición con historial de ediciones conservado.
- Búsqueda de texto completo sobre las notas del tenant.
Fuera de alcance (normativo)
- Adjuntos — F1b. Los archivos traen escaneo de virus, cuotas y su propio camino de supresión.
- Menciones y notificaciones internas — F1b.
- Notas sobre algo que no sea un contacto.
- Plantillas o respuestas predefinidas. Eso es una feature de ticketing.
Comportamiento (normativo)
- Una nota pertenece a exactamente un contacto y registra un autor tipado — usuario, api_key o sistema. Una nota sin autor es un defecto: el valor está en saber quién lo observó.
- El contenido es texto enriquecido, sanitizado al escribir. El HTML guardado se escapa al renderizar; una nota no es un vector de inyección al navegador de un agente.
- El largo está acotado a un máximo documentado. Una nota no es un repositorio de documentos.
- Editar conserva las versiones previas, visibles para quien pueda leer la nota. Una nota reescrita en silencio tras un incidente es la falla que esto previene.
- El borrado es lógico y auditado. La supresión del contacto es un borrado duro de la nota y su historial (DEC-J3).
- Fijar es por contacto con un número acotado, para que fijar siga significando algo.
- La búsqueda está acotada al tenant y a los permisos de quien lee.
- Toda mutación escribe en
core.audit_log.
Datos (normativo)
API (normativo)
Eventos (normativo)
crm.note.created. No se ofrece como webhook saliente: el contenido de una nota es el dato personal
menos predecible que tenemos, y empujarlo a un endpoint arbitrario por defecto no es una decisión que
tomemos por el tenant.
Criterios de aceptación (normativo)
- Una nota registra autor tipado, y crear sin él es imposible.
- El HTML del contenido se sanitiza al escribir y se escapa al renderizar — probado con un fixture de inyección.
- Editar conserva la versión previa y ambas son legibles.
- El borrado lógico oculta la nota y la deja recuperable; la supresión del contacto la elimina por completo, incluido su historial.
- La búsqueda devuelve solo las notas del propio tenant, y solo las que quien lee puede ver.
- El número de notas fijadas está acotado por contacto.
- Toda mutación escribe una fila de auditoría.
- Negativo: ninguna nota referencia un contacto de otro tenant, y ninguna es alcanzable sin
crm.notes.read.
Ejecución
Un solo slice, comando síncrono. La búsqueda usatsvector de Postgres acotado por tenant.