name: nexo-m365-calendar-sync
description: Sincroniza calendarios de Microsoft 365 con NEXO AV para operaciones e hitos administrativos. Use when implementing or reviewing Microsoft Graph calendar sync, wiring CalendarPage, mapping Outlook events to project sites, assignments, visits or billing milestones, or diagnosing calendar-based workflows for Instalaciones and Facturacion.
NEXO M365 Calendar Sync
Guia para agentes
| Cuando cargar | Integracion Graph calendario <-> ERP, sync de Instalaciones o Facturacion, implementacion backend del modulo Calendario, mapeo de eventos a entidades operativas de NEXO. |
| Cuando NO cargar | Archivado documental SharePoint puro, notificaciones sin calendario, cambios de UI sin implicacion de sync. |
| Integracion .codex | Si se corrige drift de calendario o permisos Graph, registrar en .codex/errores-soluciones.md; si se fija un contrato de sync reusable, en .codex/avances.md. |
Objetivo
Implementar la capa de sincronizacion entre calendarios M365 y NEXO AV sin mover la fuente de verdad fuera del ERP.
Fuente de verdad
docs/sharepoint/M365_CALENDARS_NEXO_AV.mdsrc/pages/nexo_av/desktop/pages/CalendarPage.tsxsrc/pages/nexo_av/desktop/components/projects/ProjectPlanningTab.tsxreferences/calendar-contract.md
Workflow recomendado
- Leer
references/calendar-contract.md. - Usar siempre mailbox y
calendarIdpersistidos; no depender de discovery tenant-wide. - Implementar backend-first: Graph -> normalizacion -> resolucion ERP -> escritura por RPC/funcion -> log.
- Hacer que
CalendarPagelea el estado ya normalizado del ERP o de un backend dedicado, no Graph directo desde frontend. - Limitar v1 a
InstalacionesyFacturacion.
Guardrails
- No usar
GET /usersoGET /groupscomo dependencia funcional. - No usar SharePoint lists como sustituto del calendario Outlook si el origen real es M365 Calendar.
- No escribir en Graph desde el cliente web.
- No generar facturas automaticamente desde un evento; como maximo crear tarea o dejar el site
READY_TO_INVOICE.
Salida esperada del agente
- Contrato de sync o propuesta de implementacion.
- Riesgos de permisos/config.
- Entidades ERP afectadas.
- Checklist de validacion manual.