# US-MGN-014-001-001: Comentar en Registros (Chatter Pattern)

**RF Asociado:** [RF-MGN-014-001](../../02-modelado/requerimientos-funcionales/mgn-014/RF-MGN-014-001-*.md)
**Módulo:** MGN-014 - Mensajería y Notificaciones
**Epic:** Chatter
**Prioridad:** P0
**Story Points:** 5
**Sprint:** Sprint 28-29
**Estado:** Ready for Development
**Fecha:** 2025-11-24

---

## User Story
**Como** usuario, **Quiero** Comentar en Registros (Chatter Pattern), **Para** mejorar la comunicación y colaboración en el sistema.

## Descripción Detallada
Sistema de mensajería permite colaboración en contexto de registros.

## Criterios de Aceptación

### Escenario 1: Funcionalidad principal (Camino Feliz)
**Dado que** tengo acceso a registro,
**Cuando** ejecuto acción,
**Entonces** resultado esperado.

### Escenario 2: Permisos
**Dado que** no tengo acceso a registro,
**Cuando** intento interactuar,
**Entonces** error 403.

### Escenario 3: Notificaciones
**Dado que** soy follower/involucrado,
**Cuando** hay actividad,
**Entonces** recibo notificación según preferencias.

## Reglas de Negocio
- **RN-1:** Mensajes vinculan a registros específicos (polymorphic).
- **RN-2:** Notificaciones según preferencias de usuario.
- **RN-3:** Followers reciben todas las actualizaciones.
- **RN-4:** RLS aplica en mensajes/notificaciones.

## Tareas Técnicas

### Backend
- [ ] Endpoints necesarios
- [ ] Services de mensajería
- [ ] Sistema de notificaciones
- [ ] WebSocket (si aplica)
- [ ] Unit tests (>80%)
- [ ] Integration tests

### Frontend
- [ ] Componentes de mensajería
- [ ] Widget de notificaciones
- [ ] Real-time updates
- [ ] Component tests

### Database
- [ ] Tabla: messaging.messages (polymorphic)
- [ ] Tabla: messaging.notifications
- [ ] Tabla: messaging.followers
- [ ] Índices para performance

---

## Estimación Detallada
| Tarea | Horas |
|-------|-------|
| Backend | 3 |
| Frontend | 3 |
| Testing | 2 |
| Code Review | 0.5 |
| **TOTAL** | **10 horas = 5 SP** |

---

## Definition of Done
- [ ] Código implementado según ET
- [ ] Tests pasando (>80%)
- [ ] Code review aprobado
- [ ] Notificaciones funcionan
- [ ] Real-time si aplica
- [ ] QA validado
- [ ] PO aprobado

---

## Referencias
- [RF-MGN-014-001](../../02-modelado/requerimientos-funcionales/mgn-014/RF-MGN-014-001-*.md)
- [Traceability](../../02-modelado/trazabilidad/TRACEABILITY-MGN-014.yaml)
