Lizandro GuarnizoandClaude Opus 5
fe96e5b60d
Toda la documentación pasa de voseo a tratamiento de usted, incluidos los diagramas y los textos de la interfaz. Los prompts de ambos asistentes lo piden explícitamente, para que las respuestas generadas también lo respeten. El panel de LIA en la página de documentación adopta el diseño del dashboard del turnero: mismo botón circular, mismo panel deslizante con encabezado en degradado y logo LIA, mismos chips de atajo, burbujas y campo de entrada. Los atajos se arman con los documentos que ese usuario puede ver. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
Endpoints
Inventario de los endpoints de todos los módulos, generado del filesystem en cada carga. La descripción sale del comentario de cabecera de cada archivo.
Convenciones
Los endpoints son archivos PHP sueltos que devuelven JSON. No pasan por el enrutador: se invocan por su ruta real.
modules/turnero/api/get_historial.php
api/lab/save_domicilio.php
Cada módulo tiene su api/_helpers.php con lo común. Los archivos que empiezan con guión bajo son internos y no se listan acá.
Helpers típicos
| Función | Qué hace |
|---|---|
db() |
Conexión PDO |
inputJson() |
Cuerpo de la petición como arreglo |
jsonOk($datos) |
Respuesta correcta |
jsonError($msg, $codigo) |
Error con código HTTP |
adminId() |
Id del usuario de la sesión |
requireMethod('POST') |
Corta si el método no coincide |
requireTurnero() |
Corta si no tiene acceso al turnero |
Reglas al agregar uno
- Verifique permisos en el propio endpoint. Que la vista haya ocultado el botón no protege nada.
- Resuelva la identidad en el servidor. Para saber quién hace una acción, use
adminId(), no un valor que mande el navegador. - Consultas preparadas siempre.
- Deje un comentario de cabecera describiendo qué hace y qué recibe: es lo que aparece en la tabla de abajo.
Inventario
{{endpoints}}
Endpoints fuera de módulos
api/lab/ agrupa los del laboratorio de la generación anterior — domicilios, pacientes, formularios, configuración. Siguen las mismas convenciones y usan api/lab/_helpers.php.