[LOGIC / BUSINESS] F-06.3 — Comentarios en Códigos de Error
Épica: EPIC-06 — Catálogo de Códigos de Error (CRUD)
🏷️ Categoría
Categoría: Logic / BusinessSecundaria: UI / PresentationImpacta en: Equipo Fullstack (Livewire + Laravel + Base de Datos)
📦 Dependencias
Backlogs que deben estar completados antes de implementar esta feature.
| Backlog | Motivo |
|---|---|
| F-06.2 | Vista detalle del error code donde se incrusta el componente de comentarios |
| F-03.3 | Editor TipTap 2 instalado |
| F-04.4 | Componente CommentSection reutilizable ya implementado y probado |
| F-05.5 | Usuario autenticado para autoría y ErrorCodeCommentPolicy |
Prioridad: Could
Descripción: Como administrador del sistema Quiero poder añadir comentarios a un código de error específico Para documentar notas adicionales, soluciones aplicadas o información de contexto sobre ese tipo de error concreto
Criterios de Aceptación (Checklist):
- [ ] Escenario 1 (Añadir comentario): Dado que estoy en el detalle de un error code, cuando escribo un comentario en el editor TipTap y pulso "Añadir", entonces el comentario aparece en el hilo con fecha y nombre del autor.
- [ ] Escenario 2 (Hilo cronológico): Dado que un error code tiene varios comentarios, cuando se carga el detalle, entonces los comentarios aparecen ordenados cronológicamente (más antiguo arriba, más reciente abajo) con el nombre del usuario y la fecha.
- [ ] Escenario 3 (Editar propio comentario): Dado que soy el autor de un comentario, cuando pulso el icono de editar, entonces puedo modificar el contenido. No puedo editar comentarios de otros usuarios.
- [ ] Escenario 4 (Input sticky): El campo de nuevo comentario está siempre visible al fondo del panel de comentarios, aunque la lista de comentarios sea larga (sticky bottom).
- [ ] Escenario 5 (Rich text): El editor de comentarios usa TipTap 2 con Alpine.js bridge (mismo que F-04.5), con soporte de negrita, cursiva, listas e imágenes (máx. 2 MB por imagen, 10 MB total).
- [ ] Requisito Técnico: Componente Livewire
ErrorCodeCommentSectionreutilizando la lógica deCommentSection(F-04.4). Tablaerror_code_comments(F-00.2).ErrorCodeCommentPolicy@updateverifica autoría. Sanitizar HTML con HTMLPurifier. La sección de comentarios se renderiza en la vista/error-codes/{id}como componente separado.
MoSCoW: COULDSprint: Sprint 4
Notas:
- Esta feature comparte exactamente la misma lógica de negocio que F-04.4 (hilo de comentarios del histórico). Se puede reutilizar el componente
CommentSectioncon una prop$modelque acepta tantoArchivedLogcomoErrorCode. - La tabla
error_code_commentses separada decommentspara mantener la integridad referencial clara y permitir evolución independiente.