feat: version 4.9.0 -- Agenda medica: clic en dia abre cita, autor fijo y borrado logico

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

API.md

@@ -45,8 +45,9 @@ Configuración exige además rol admin/superadmin. Fechas `YYYY-MM-DD HH:mm:ss`
 | `GET /staff/me` | alcance y condición de médico |
 | `GET /doctors` | médicos visibles con horario y tipos activos |
 | `GET /availability?doctorId=&date=&typeId=` | huecos de 15 minutos con duración del tipo |
-| `GET /appointments?from=&to=[&doctorId=][&patientId=]` | citas no canceladas del rango; `patientId` solo recepción |
+| `GET /appointments?from=&to=[&doctorId=][&patientId=]` | citas del rango, incluidas canceladas y eliminadas (`deleted_at`) para trazabilidad; `patientId` solo recepción |
 | `POST /appointments`, `PUT /appointments/:id` | crear o reprogramar/editar; `PUT` exige `editVersion` |
+| `POST /appointments/:id/delete` | `{reason,editVersion}` borrado lógico (solo recepción): libera el horario, conserva la fila con quién/cuándo/motivo |
 | `POST /appointments/:id/status` | `{status,editVersion}`; médico propio solo `attended`/`no_show` |
 | `POST /appointments/:id/cancel` | `{reason,editVersion}`, solo recepción |
 | `GET /blocks?from=&to=[&doctorId=]` | ocurrencias expandidas del rango |