# 📚 Manual Interactivo - Rendicion de cuentas y Transparencia

Guía Completa del Sistema de Rendición de Cuentas

## ¡Bienvenido al Manual Interactivo!

Esta guía le ayudará a comprender y utilizar todas las funcionalidades del Sistema de Rendicion de cuentas y Transparencia, una plataforma diseñada para centralizar la rendición de cuentas, la gestión de fondos y la administración de Distritos.

Utilice el menú lateral para navegar entre las diferentes secciones del manual.

Características Principales del Sistema
🔐

### Seguro

Sistema de autenticación robusto con perfiles diferenciados y registro de auditoría.

📱

### Responsivo

Funciona perfectamente en computadoras, tablets y smartphones.

💰

### Control Financiero

Monitoreo en tiempo real de ingresos, gastos y fondos disponibles.

📊

### Reportes Detallados

Exportación de datos a Excel y PDF para análisis y archivo.

### ¿Qué encontrará en este Manual?

- Acceso al Sistema: Cómo iniciar sesión y credenciales iniciales
- Perfiles de Usuario: Directorio, Distrito y Colaborador
- Gestión de Distritos
- Gestión de Usuarios: Administración de cuentas
- Movimientos de Fondos: Registro de ingresos y gastos
- Panel de Monitoreo: Dashboard con estadísticas en tiempo real
- Reportes: Generación y exportación de informes
- Navegación: Uso en dispositivos móviles y desktop

# 🔐 Acceso al Sistema

### 1.1. URL de Acceso

La URL de acceso al sistema es la dirección donde se ha desplegado la aplicación. Por ejemplo:

- `https://demo.aplicacion.top/politicos/dashboard.php`
- `http://localhost/aplicacion.top/` (para entornos de desarrollo local)

### 1.2. Credenciales de Superadministrador (Directorio)

El sistema incluye un usuario de superadministrador preconfigurado para el Directorio:

Campo | Valor
--- | ---
Usuario | `Rendicion`
Contraseña | `cuenta.2026`

Nota de Seguridad: Se recomienda encarecidamente cambiar la contraseña del superadministrador inmediatamente después del primer inicio de sesión.

# 👥 Perfiles de Usuario y Permisos

El sistema de Rendicion de cuentas y Transparencia está diseñado con una estructura de tres perfiles de usuario, cada uno con un conjunto de permisos y responsabilidades específicas.

Perfil | Rol Principal | Permisos Clave
--- | --- | ---
Directorio | Superadministrador del sistema | Acceso total. Puede crear, editar y eliminar usuarios, distritos y movimientos de fondos. Monitoreo financiero completo.
Distrito | Administrador de una Distritos específica | Puede crear y editar usuarios de tipo Colaborador dentro de su distrito. Puede registrar movimientos de fondos que requieren aprobación del Directorio.
Colaborador | Usuario operativo | Solo puede registrar movimientos de fondos que requieren aprobación del Directorio. Puede imprimir resúmenes y reportes limitados.

### Jerarquía de Permisos

La jerarquía de permisos está diseñada para garantizar la seguridad y la integridad de los datos:

- Directorio: Tiene control total sobre el sistema.
- Distritos: Tiene control sobre su distrito y los colaboradores asignados a ella.
- Colaborador: Tiene permisos limitados, enfocados en la operación diaria.

# 🏢 Módulo de Gestión de Distritos

### 3.1. Creación de un nuevo Distrito

La creación de distritos sigue una norma estricta para la generación de códigos:

1. Acceso: Navegue a la sección Gestionar Distritos.
2. Datos Requeridos: Ingrese el nombre de la Ciudad y el Departamento.
3. Generación Automática de Código: El sistema genera automáticamente el código de la distritos utilizando las 3 primeras letras de la Ciudad y las 3 primeras letras del Departamento.
4. Fondo Inicial: Se debe asignar un fondo inicial a la distritos.

Ejemplo de Código: Si la ciudad es "Asunción" y el departamento es "Central", el código generado será `ASUCEN`.

### 3.2. Monitoreo de Fondos por Distritos

Cada distrito tiene un registro detallado de:

- Fondo Disponible: Saldo actual de la distrito.
- Total Ingresos: Suma de todos los ingresos registrados y aprobados.
- Total Gastos: Suma de todos los gastos registrados y aprobados.

### 3.3. Edición y Desactivación de distrito

El Directorio puede editar la información de una distrito o desactivarla si ya no está operativa. Los distritos desactivadas no aparecen en los listados activos pero se conservan en la base de datos para fines de auditoría.

# 👤 Módulo de Gestión de Usuarios

### 4.1. Creación de Usuarios

1. Acceso: Navegue a la sección Gestionar Usuarios.
2. Selección de Perfil: Elija el Tipo de Usuario (Directorio, Distritos, Colaborador).
3. Asignación de Distrito: Si el perfil es Distrito o Colaborador, debe ser asignado a una Distrito existente.
4. Datos del Usuario: Ingrese el nombre completo, email, teléfono y contraseña.

### 4.2. Generación de Código de Colaborador

Para los usuarios de tipo Colaborador, el sistema genera un código único siguiendo el formato:

- `CODIGO_DISTRITO-001`
- `CODIGO_DISTRITO-002`
- Y así sucesivamente...

Ejemplo: Si el distrito es `ASUCEN`, los colaboradores tendrán códigos como `ASUCEN-001`, `ASUCEN-002`, etc.

### 4.3. Restricciones de Creación

- Directorio: Solo puede ser creado por otro usuario de tipo Directorio.
- Ddistrito: Solo puede ser creado por un usuario de tipo Directorio.
- Colaborador: Puede ser creado por un Directorio o por el Distrito de su distrito.

# 💰 Módulo de Movimientos de Fondos

### 5.1. Registro de Movimientos

1. Acceso: Navegue a la sección Registrar Movimiento.
2. Tipo de Movimiento: Seleccione Ingreso o Gasto.
3. Distrito: Seleccione el distrito a la que se aplica el movimiento.
4. Monto: Ingrese el monto del movimiento.
5. Categoría: Seleccione la categoría del movimiento.
6. Descripción: Proporcione una descripción detallada del movimiento.

### 5.2. Proceso de Aprobación

El sistema implementa un flujo de aprobación para garantizar la supervisión del Directorio:

- Los movimientos registrados por el Directorio se aprueban automáticamente.
- Los movimientos registrados por Distritos o Colaboradores quedan en estado Pendiente y requieren la aprobación del Directorio.

### 5.3. Validación de Gastos

Regla de Validación: No se permite registrar un gasto que exceda el Fondo Disponible de el distrito.

# 📈 Panel de Monitoreo (Dashboard)

### 6.1. Monitoreo en la Cabecera

La cabecera de la página muestra información financiera clave en tiempo real:

- Fondos Disponibles: El saldo total consolidado de todas las distritos activos.
- Total Ingresos: La suma de todos los ingresos aprobados en el sistema.
- Total Gastos: La suma de todos los gastos aprobados en el sistema.
- Distritos: El número total de distritos activos.

### 6.2. Estadísticas Generales (Solo Directorio)

El perfil de Directorio tiene acceso a estadísticas detalladas adicionales:

- Fondo Disponible Total: El saldo consolidado de todos los distritos.
- Balance Neto: La diferencia entre ingresos y gastos totales.
- Distritos activos: Número de distritos operativos.
- Movimientos Recientes: Un listado de los últimos movimientos registrados.

# 📊 Módulo de Reportes y Exportación

### 7.1. Tipos de Reportes

El sistema permite generar reportes detallados de:

- Movimientos de Fondos: Listado completo de ingresos y gastos.
- Distritos: Información detallada de todas los distritos.
- Usuarios: Listado de usuarios con sus perfiles.
- Resumen Financiero: Resumen consolidado de la situación financiera.

### 7.2. Exportación de Datos

Formato | Descripción | Tecnología
--- | --- | ---
Excel (.xlsx) | Planilla electrónica compatible | PhpSpreadsheet
PDF (.pdf) | Documento PDF de alta calidad | wkhtmltopdf

# 📱 Navegación Responsiva

### 8.1. Navegación en Desktop

En computadoras de escritorio, el sistema muestra:

- Información del usuario en la esquina superior derecha
- Acciones rápidas en el dashboard
- Tablas y gráficos en formato completo

### 8.2. Navegación en Móvil

En dispositivos móviles, el sistema se adapta automáticamente:

- Menú Lateral (Sidebar): Un botón de hamburguesa (☰) despliega el menú.
- Diseño Optimizado: Elementos reorganizados verticalmente.
- Tamaños Ajustados: Texto legible en pantallas pequeñas.

# ⚙️ Aspectos Técnicos

### 9.1. Especificaciones Técnicas

Componente | Detalle
--- | ---
Lenguaje Backend | PHP 8.1+
Base de Datos | MySQL 5.7+ / MariaDB
Nombre de BD | `rendicionbd`
Usuario BD | `cuentasamp`
Servidor Web | Apache 2.4+

### 9.2. Seguridad

- Hashing de Contraseñas: Algoritmo bcrypt
- Sesiones Seguras: Protección contra fijación de sesión
- Validación de Entrada: Prevención de SQL injection y XSS
- Registro de Auditoría: Todas las acciones críticas registradas

# ❓ Preguntas Frecuentes

### ¿Cómo cambio mi contraseña?

Actualmente, el cambio de contraseña debe ser realizado por un usuario de tipo Directorio a través del módulo de Gestión de Usuarios.

### ¿Qué hago si olvido mi contraseña?

Contacte al Directorio de la Organizacion para que restablezca su contraseña.

### ¿Puedo eliminar un movimiento de fondos?

Solo el Directorio puede eliminar movimientos de fondos. Los Distritos y Colaboradores no tienen este permiso.

### ¿El sistema funciona sin conexión a internet?

No, el sistema requiere conexión a internet para acceder al servidor donde está alojado.

### ¿Puedo acceder al sistema desde mi celular?

Sí, el sistema está completamente optimizado para dispositivos móviles.