Update all documentation for 3-level roles, organismos, and Histórico

Reflect current project state across all 8 docs: ADMIN/ORGANISMO_OPERADOR/OPERATOR
role hierarchy, scope filtering, organismos_operadores table, Histórico de Tomas
page, new SQL migrations, and updated API endpoints with auth requirements.

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

docs/MANUAL_USUARIO.md

@@ -8,10 +8,12 @@
 4. [Gestion de Concentradores](#gestion-de-concentradores)
 5. [Gestion de Medidores](#gestion-de-medidores)
 6. [Consumo y Lecturas](#consumo-y-lecturas)
-7. [Panel de Carga CSV](#panel-de-carga-csv)
-8. [Notificaciones](#notificaciones)
-9. [Administracion de Usuarios](#administracion-de-usuarios)
-10. [Auditoria](#auditoria)
+7. [Historico de Tomas](#historico-de-tomas)
+8. [Organismos Operadores](#organismos-operadores)
+9. [Panel de Carga CSV](#panel-de-carga-csv)
+10. [Notificaciones](#notificaciones)
+11. [Administracion de Usuarios](#administracion-de-usuarios)
+12. [Auditoria](#auditoria)
 
 ---
 
@@ -28,13 +30,24 @@
 3. Introduzca su contraseña
 4. Haga clic en "Iniciar Sesion"
 
-### Roles de Usuario
+### Roles de Usuario (Jerarquia de 3 niveles)
 
-| Rol | Permisos |
-|-----|----------|
-| **ADMIN** | Acceso completo a todas las funciones |
-| **OPERATOR** | Gestion de medidores y lecturas de su proyecto asignado |
-| **VIEWER** | Solo visualizacion de datos |
+| Rol | Permisos | Visibilidad |
+|-----|----------|-------------|
+| **ADMIN** | Acceso completo a todas las funciones | Ve todos los datos del sistema |
+| **ORGANISMO_OPERADOR** | Gestion de usuarios y visualizacion de su organismo | Ve datos de los proyectos de su organismo |
+| **OPERATOR** | Operacion de medidores de su proyecto | Ve datos de su proyecto asignado |
+
+### Menu Lateral por Rol
+
+| Seccion | ADMIN | ORGANISMO_OPERADOR | OPERATOR |
+|---------|-------|-------------------|----------|
+| Dashboard | Si | Si | Si |
+| Project Management | Si | Si | Si |
+| Users Management | Si | Si | No |
+| Organismos Operadores | Si | No | No |
+| Conectores | Si | No | No |
+| Analytics | Si | Si | No |
 
 ---
 
@@ -204,6 +217,83 @@ Los concentradores son dispositivos que agrupan multiples medidores.
 
 ---
 
+## Historico de Tomas
+
+*Disponible para todos los roles. Cada rol solo ve los medidores de su scope.*
+
+### Acceder al Historico
+1. Navegue a **Historico** en la seccion "Project Management" del menu lateral
+2. Vera un selector de medidor y un estado vacio inicial
+
+### Seleccionar Medidor
+1. Haga clic en el campo de busqueda
+2. Escriba para filtrar por:
+   - Nombre del medidor
+   - Numero de serie
+   - Ubicacion
+   - Cuenta CESPT
+   - Clave catastral
+3. Seleccione el medidor del dropdown
+
+### Informacion del Medidor
+Al seleccionar un medidor se muestra:
+- **Tarjeta de informacion:** Serial, nombre, proyecto, ubicacion, tipo, estado, ultima lectura
+- **Cards de consumo:**
+  - **Consumo Actual:** Lectura mas reciente (consumo diario)
+  - **Consumo Pasado:** Lectura del primer dia del mes anterior
+  - **Diferencial:** Diferencia entre actual y pasado (con indicador de tendencia)
+
+### Filtrar por Fechas
+1. Use los campos "Desde" y "Hasta" para definir un rango
+2. Los datos se actualizan automaticamente
+3. Use el boton "Limpiar" para remover los filtros
+
+### Grafica de Consumo
+- Grafica de area con gradiente azul
+- Eje X: fechas, Eje Y: valor de lectura (m3)
+- El rango del eje Y se ajusta automaticamente a los datos
+
+### Tabla de Lecturas
+- Columnas: Fecha/Hora, Lectura (m3), Tipo, Bateria, Senal
+- Paginacion configurable: 10, 20 o 50 registros por pagina
+- Indicadores visuales de bateria y senal
+
+### Exportar CSV
+1. Haga clic en el boton **"Exportar CSV"** en el encabezado
+2. Se descargara un archivo `historico_{serial}_{fecha}.csv`
+
+---
+
+## Organismos Operadores
+
+*Solo disponible para usuarios con rol ADMIN*
+
+### Ver Organismos
+1. Haga clic en **"Organismos Operadores"** en el menu lateral
+2. Vera la tabla con todos los organismos registrados
+
+### Crear Organismo
+1. Haga clic en **"Nuevo Organismo"**
+2. Complete los campos:
+   - **Nombre:** Nombre del organismo (ej: CESPT Tijuana)
+   - **Codigo:** Codigo unico (ej: CESPT-TJ)
+   - **Contacto:** Nombre de la persona de contacto
+   - **Email:** Correo electronico de contacto
+   - **Telefono:** Numero de telefono
+   - **Estado:** Activo/Inactivo
+3. Haga clic en **"Guardar"**
+
+### Editar Organismo
+1. Haga clic en el icono de edicion del organismo
+2. Modifique los campos necesarios
+3. Haga clic en **"Guardar"**
+
+### Vincular Proyectos y Usuarios
+- Los proyectos se vinculan a un organismo via el campo `organismo_operador_id` en la pagina de Proyectos
+- Los usuarios con rol ORGANISMO_OPERADOR se vinculan a un organismo via la pagina de Usuarios
+
+---
+
 ## Panel de Carga CSV
 
 El panel de carga CSV permite subir datos de medidores y lecturas sin necesidad de autenticacion.
@@ -297,11 +387,11 @@ MED002,567.89,2024-01-20 10:35:00,MANUAL,90,-42
 
 ## Administracion de Usuarios
 
-*Solo disponible para usuarios con rol ADMIN*
+*Disponible para ADMIN (ve todos) y ORGANISMO_OPERADOR (ve los de su organismo)*
 
 ### Ver Usuarios
 1. Navegue a **Usuarios** en el menu lateral
-2. Vera la lista de todos los usuarios
+2. Vera la lista de usuarios filtrada segun su rol
 
 ### Crear Usuario
 1. Haga clic en **"Nuevo Usuario"**
@@ -309,8 +399,9 @@ MED002,567.89,2024-01-20 10:35:00,MANUAL,90,-42
    - **Email**: Correo electronico (sera el usuario de login)
    - **Nombre**: Nombre completo
    - **Contraseña**: Contraseña inicial
-   - **Rol**: ADMIN, OPERATOR, o VIEWER
-   - **Proyecto**: Solo para OPERATOR - proyecto asignado
+   - **Rol**: ADMIN, ORGANISMO_OPERADOR, u OPERATOR
+   - **Organismo Operador**: Para ORGANISMO_OPERADOR - organismo asignado
+   - **Proyecto**: Para OPERATOR - proyecto asignado
 3. Haga clic en **"Guardar"**
 
 ### Editar Usuario