Documentacion EnReading

1) Requerimientos del proyecto

• PHP 8.2 o superior.
• Composer 2.x.
• Node.js 20 o superior y npm.
• Base de datos MySQL/MariaDB o SQLite para entornos locales.
• Extensiones PHP comunes para Laravel: Ctype, fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer y XML.

2) Instalacion del proyecto

A) Instalador web — /install (recomendado)

La forma mas sencilla de instalar. Sube los archivos al servidor, crea la base de datos en tu panel de hosting y luego abre la siguiente URL en el navegador:

https://tu-dominio.com/install

Asistente de instalacion web paso a paso.

1. Sube todos los archivos del proyecto al servidor (FTP, Git, panel de hosting, etc.).
2. Crea una base de datos MySQL/MariaDB en tu panel de hosting y anota los datos de acceso.
3. Abre https://tu-dominio.com/install en tu navegador.
4. Sigue el asistente: ingresa datos de base de datos, correo, y usuario administrador.
5. Al finalizar, el instalador se elimina automaticamente por seguridad.
6. Inicia sesion con el usuario administrador que creaste.

B) Instalacion manual (servidores propios / CLI)

Alternativa para entornos con acceso a terminal (VPS, Docker, desarrollo local).

1. Instala dependencias PHP: composer install
2. Crea el entorno: cp .env.example .env
3. Configura credenciales en .env (BD, mail, app URL).
4. Genera clave de app: php artisan key:generate
5. Ejecuta migraciones: php artisan migrate --force
6. Instala dependencias front-end: npm install
7. Compila assets: npm run build (o npm run dev para desarrollo).
8. Opcional para archivos publicos: php artisan storage:link

Tambien puedes usar composer run setup desde la raiz para ejecutar todos los pasos anteriores de forma automatica.

3) Notas de version 1.0.0 (Initial Release)

• Stack base: Laravel 12, PHP 8.2+, Vite y UI basada en Bootstrap.
• Panel Administrador y Panel de Creador completamente funcionales.
• Instalador web por pasos con migraciones y cuenta admin.
• Sistema de monetizacion: monedas, ventas, retiros y anuncios.
• Importador visual de Content Demo por lotes en Settings.
• Sistema de actualizaciones por ZIP desde Admin.
• Sistema multi idioma con crear/editar/exportar/importar/traducir.
• Compatibilidad mejorada con hosting compartido para storage:link.

4) Mapa de navegacion

Menu principal Administrador (segun interfaz real)

Panel de Creador (menu superior)

Inicio Comics Novelas Reportes Seguidores Avatar > Configuracion de Cuenta

2) Administrador > Tablero

1. Entra al panel de administrador.
2. Revisa metricas generales (volumen de contenido, actividad, tendencias).
3. Usa el Tablero como punto de chequeo diario antes de moderacion y pagos.

3) Administrador > Comics

A) Crear comic nuevo

Administrador > Comics > Agregar Comic

1. Completa portada, estado web, estado de contenido, demografia y tipo de comic.
2. Configura autores, slider, recomendado, y permisos de publicacion por otros scans si aplica.
3. Completa titulo, titulos alternativos, descripcion, fechas y direccion de lectura.
4. Selecciona idiomas y generos.
5. Guarda con Crear comic.

B) Publicar capitulos del comic

Administrador > Comics > Lista de Comics > Acciones > Agregar capitulos

1. Completa datos base del capitulo: titulo, numero, descripcion corta, portada, fecha de salida y fecha de publicacion.
2. Si es un capitulo ya existente, activa Publicar en capitulo existente y selecciona numero existente.
3. Por idioma, define acceso Gratis o Premium y fecha premium si corresponde.
4. Sube contenido por idioma en modo Imagenes o ZIP/CBZ.
5. Si usas imagenes: ordena paginas existentes arrastrando y elimina las que no van.
6. Guarda con Crear capitulo.

C) Operaciones diarias en Lista de Comics

• Filtrar por tipo, demografia, estado de contenido, estado web e idiomas.
• Eliminacion masiva para limpieza de lotes.
• Acciones por item: Editar, Ver, Copiar, Agregar capitulos, Eliminar.

4) Administrador > Novelas

A) Crear novel nueva

Administrador > Novelas > Agregar Novela

1. Completa portada, estado web, estado de contenido, tipo de novela, demografia y autores.
2. Configura carrusel, recomendado y permitir publicacion de scan segun estrategia.
3. Completa titulo, descripcion, fechas, idiomas y generos.
4. Guarda con Crear novela.

B) Publicar capitulos de novel

Administrador > Novelas > Lista de Novelas > Acciones > Agregar capitulos

1. Define datos basicos del capitulo: portada, titulo, numero, descripcion corta, fecha de salida y fecha de publicacion.
2. Por idioma, define Gratis/Premium y fecha de expiracion premium.
3. En novelas el contenido se edita en texto enriquecido por idioma (TinyMCE o CKEditor).
4. Guarda y valida visualmente en lectura publica.

5) Administrador > Moderacion y Scans

A) Reportes de capitulos

Administrador > Moderacion y Scans > Reportes de Capitulos

1. Filtra por tipo y estado.
2. Abre cada reporte y revisa contexto (contenido, idioma, capitulo, scan).
3. Marca estado (pendiente/corregido) segun correccion.
4. Elimina reportes obsoletos de forma individual o masiva.

B) Moderacion de comentarios

Administrador > Moderacion y Scans > Comentarios

• Acciones: marcar spam, marcar visible, enviar a papelera, restaurar, eliminar definitivo.
• Usa acciones masivas para incidentes de gran volumen.

C) Idiomas de contenido

Administrador > Moderacion y Scans > Idiomas de Contenido

• Crear, editar, eliminar idiomas de contenido.
• Importar/Exportar para mover catalogo entre entornos.

6) Administrador > Soporte

A) Tickets

Administrador > Soporte > Tickets

1. Filtra por estado: abierto, en progreso, cerrado.
2. Abre ticket, revisa historial y prioridad.
3. Responde al scan desde el formulario de respuesta.
4. Actualiza estado en cada respuesta para trazabilidad.

B) Alertas

Administrador > Soporte > Alertas

• Crear alertas globales de soporte.
• Activar/desactivar sin borrar para uso temporal.
• Eliminar de forma individual o masiva.

7) Administrador > Personas

Administrador > Personas > Usuarios / Suscriptores / Scans / Roles y Permisos

1. Gestiona cuentas (alta, edicion, restablecer contrasena, 2FA, baja).
2. Usa Suscriptores y Scans para perfiles de negocio y equipos.
3. Mantiene Roles y Permisos alineado al minimo privilegio.

8) Administrador > Pagos y Monetizacion

A) Retiros

Administrador > Pagos y Monetizacion > Retiros

1. Filtra solicitudes por estado (pendiente/aprobado/rechazado).
2. Abre detalle, revisa metodo y datos de cobro.
3. Define monto a pagar, agrega notas y aprueba o rechaza.
4. Limpia registros antiguos con eliminacion individual o masiva.

B) Monedas

Administrador > Pagos y Monetizacion > Monedas

1. Controla stock total y stock disponible.
2. Usa Agregar stock de monedas para sumar reserva.
3. Crea paquetes con icono, nombre, monedas, monedas de oferta, precio y estado.
4. Edita, activa/desactiva o elimina paquetes segun rendimiento comercial.

C) Ventas

Administrador > Pagos y Monetizacion > Ventas

• Audita compras por referencia, usuario, paquete, proveedor y estado.
• Aplica filtros por estado y busqueda.
• Borra lotes obsoletos cuando politica de retencion lo permita.

D) Anuncios

Administrador > Pagos y Monetizacion > Anuncios

1. Crea anuncio con nombre, tipo (display/recompensado), prioridad, ubicacion y audiencia.
2. Para recompensado define monedas de recompensa, limite diario y segundos requeridos.
3. Elige tipo de contenido: imagen o HTML/codigo.
4. Activa/desactiva anuncios segun rendimiento.

9) Administrador > Reportes

Administrador > Reportes > Reportes

1. Genera reportes por periodo, tipo, estado y busqueda.
2. Descarga reportes historicos cuando se requiera auditoria.
3. Elimina reportes antiguos para mantener orden.

10) Administrador > Almacenamiento Externo (si el modulo esta activo)

Administrador > Almacenamiento Externo > Servidores / Configuracion

1. Registra servidores externos y valida conexion.
2. Marca servidor por defecto cuando quieras priorizar uno.
3. Activa/desactiva servidores sin eliminar historial.
4. Ajusta la configuracion global del modulo.

Nota: este modulo no esta incluido en la compra, tiene que comprarlo a parte.

11) Administrador > Configuracion

En esta seccion se configura plataforma completa: general, correo, metodos de pago, monetizacion, panel de scans, inicio de sesion social, idiomas, moneda, modulos, paginas front, API de Google, actualizaciones y licencia.

Flujo recomendado de configuracion inicial

1. General: nombre del sistema, URL base, zona horaria.
2. Correo y Plantillas: SMTP/API y prueba de envio.
3. Metodos de Pago + Monetizacion: habilitar proveedores y reglas de negocio.
4. Idiomas + Moneda: definir idioma por defecto y catalogo activo.
5. Modulos: activar extensiones requeridas.
6. Licencia/Actualizaciones: dejar instancia validada.

12) Administrador > Configuracion > Content Demo

El contenido de demostracion ya no se instala durante el wizard para evitar timeouts en hosting compartido. Ahora se importa desde Admin Panel > Settings > Content Demo en lotes seguros.

1. Abre Configuracion > Content Demo.
2. Presiona Import demo (o Continue import si quedo una sesion pendiente).
3. Espera a que la barra llegue a 100% y el estado muestre Completed.
4. Refresca el frontpage para validar comics/novelas de ejemplo.

Importador visual por lotes para contenido demo.

13) Recuperar storage:link si falla en instalacion

En algunos entornos (cPanel, Hostinger, HestiaCP, VestaCP o shared hosting) el enlace simbolico puede fallar en instalacion inicial por permisos o rutas del webroot.

A) Opcion recomendada: boton en Admin

Administrador > Configuracion > General > Retry Storage Link

1. Entra a Settings > General.
2. Busca el bloque Public Storage Link.
3. Haz clic en Retry Storage Link.
4. Revisa el resultado y el Attempt log mostrado en pantalla.

B) Opcion por consola (SSH)

1. Ve a la carpeta del proyecto.
2. Ejecuta php artisan storage:link --force.
3. Si tu webroot usa public_html, crea el enlace manual: ln -s /ruta/a/storage/app/public /ruta/a/public_html/storage
4. Verifica que se sirvan archivos desde /storage/....

14) Panel de Creador (menu superior)

A) Inicio

Creador > Inicio

• Resumen de contenido publicado, capitulos, seguidores y ganancias.
• Graficos de tendencia de lecturas, mas seguidos, mas leidos y ganancias recientes.

B) Comics

Creador > Comics

1. Crea comic con el mismo conjunto de campos del administrador (portada, estado, metadatos, idiomas, generos).
2. Publica capitulos por idioma con imagenes/zip y reglas premium.
3. Si el comic ya tiene capitulo padre, usa publicar existente cuando corresponda.

C) Novelas

Creador > Novelas

1. Crea novela con metadatos completos.
2. Publica capitulo por idioma usando editor de texto enriquecido.
3. Configura premium por idioma para monetizacion segmentada.

D) Reportes

Creador > Reportes

1. Filtra reportes por tipo y estado.
2. Abre detalle y corrige capitulo desde acceso rapido.
3. Marca como corregido cuando cierre la incidencia.

E) Seguidores

Creador > Seguidores

• Revisa crecimiento de audiencia y comportamiento de seguimiento.

15) Creador > Configuracion de Cuenta

Creador > Menu de avatar > Configuracion de Cuenta

16) Capturas de pantalla (version final)

Capturas reales incluidas desde docs/shots/. Haz clic en cualquier imagen para verla en grande.

admin-dashboard.pngTablero principal de administracion.

admin-comics-list.pngListado de comics con filtros y acciones.

admin-comic-create.pngFormulario de creacion de comic.

admin-comic-chapter-create.pngPublicacion de capitulo multi idioma.

admin-novel-create.pngFormulario de creacion de novel.

admin-novel-chapter-create.pngEditor de capitulo por idioma.

admin-payments-coins.pngMonetizacion: stock y paquetes de monedas.

admin-payments-withdraws.pngGestion de retiros y aprobaciones.

admin-ads.pngConfiguracion y gestion de anuncios.

admin-content-demo.pngImportacion por lotes del contenido de demostracion.

admin-tickets-show.pngVista de detalle de ticket y respuestas.

creator-dashboard.pngPanel principal de creador.

creator-account-settings.pngSeccion de Configuracion de Cuenta del creador.