Para el propietario
Guía de uso del panel
Configura WhatsApp, Yape y PayPal, publica tu primer producto y comprueba que la compra y las descargas funcionan desde el celular.
1. Entrar al panel
El panel privado está en /admin/login. La primera vez que se abre, la web pide crear una contraseña de propietario (mínimo 8 caracteres, sin espacios). Esa contraseña se guarda cifrada en el servidor y se puede cambiar luego desde Configuración.
No compartas la contraseña ni publiques el enlace del panel. Si la olvidas, un administrador del servidor puede restablecerla eliminando el bloque admin de data/db.json y volviendo a entrar.
2. Configurar el número de WhatsApp
- Entra a Configuración en el panel.
- Escribe el número comercial con código de país. Ejemplo de formato:
+51 987 654 321. - Pulsa Guardar número. El sistema guarda solo los dígitos y agrega el código 51 si escribes un celular peruano de 9 dígitos que empieza en 9.
Mientras el número esté vacío, no aparecerán los botones de WhatsApp ni el envío de comprobantes. Cuando lo guardes, cada botón Comprar por WhatsApp abrirá una conversación con un mensaje que incluye el título del recurso, el precio en soles y el enlace directo a la ficha. También se usa para recibir los comprobantes de Yape y PayPal.
BASE_URL con la dirección pública para que los enlaces sean siempre correctos.
3. Configurar Yape y PayPal
Los cobros son manuales: la web muestra los datos de pago y el comprador envía su comprobante por WhatsApp. No se guardan datos de tarjetas ni credenciales bancarias.
Yape
- En Configuración → Cobros con Yape, escribe el número Yape de 9 dígitos que empieza en 9.
- Agrega el nombre del titular si quieres que aparezca en la ficha.
- Sube una imagen del QR de Yape (PNG, JPG o WEBP, hasta 5 MB). Es opcional; también puedes mostrar solo el número.
- Pulsa Guardar Yape. En cada producto de pago aparecerá el monto, el número, el QR y un botón para enviar el comprobante por WhatsApp.
PayPal
- En Configuración → Cobros con PayPal, pega tu enlace de pago: puede ser tu enlace de
paypal.meo una página de pago alojada por PayPal. - Si usas
paypal.me, escribe el tipo de cambio en soles por dólar (por ejemplo,3.75). La web agregará al enlace el monto equivalente en dólares y mostrará el estimado en la ficha. - Pulsa Guardar PayPal. El comprador será dirigido a PayPal para completar el pago y luego podrá enviar su comprobante por WhatsApp.
4. Publicar tu primer producto
- En el panel, abre Productos → Nuevo producto.
- Completa título, categoría, formato, precio, resumen, qué contiene, para qué sirve y qué archivos recibe el comprador. Estos textos son los que verá el visitante.
- Sube una portada (PNG, JPG o WEBP). Si no subes una, la web genera una portada técnica con el título.
- Adjunta el archivo del recurso. Si el precio es
0, se guarda como archivo público y se habilita la descarga gratuita. Si el precio es mayor que0, se guarda en una carpeta privada y nunca se sirve por la web. - Marca Destacado si quieres que aparezca en la portada y deja Publicado activo. Guarda los cambios.
Para retirar un recurso del catálogo sin borrarlo, usa el botón Retirar en la lista de productos. Para volver a mostrarlo, pulsa Publicar.
5. Probar desde el celular
- Conecta el celular y la computadora a la misma red Wi-Fi.
- En la computadora, averigua la IP local con
ipconfig(por ejemplo,192.168.1.50). - Abre en el celular
http://192.168.1.50:3000y navega al catálogo. - Busca “metrados”, abre la ficha y revisa los métodos configurados: Yape (número y QR), PayPal y Comprar por WhatsApp.
- Pulsa Pagar con PayPal: debe abrir PayPal con el monto o el enlace configurado. Pulsa Enviar comprobante por WhatsApp después de un pago de prueba y verifica el mensaje.
- Prueba también una descarga gratuita: el archivo debe descargarse directamente sin pedir registro.
Si el celular no carga la página, revisa que el servidor esté encendido (npm start), que el firewall permita el puerto 3000 y que ambos equipos estén en la misma red.
6. Archivos gratuitos y de pago
- Gratis (precio 0): si adjuntas un archivo, se guarda en
storage/publicosy el botón Descargar gratis funciona. El archivo se sirve con un nombre limpio y sin exponer la carpeta. - De pago (precio mayor que 0): el archivo se guarda en
storage/privados. No existe una URL pública para descargarlo; solo el propietario puede descargarlo desde el panel para enviarlo al comprador. - Si cambias un producto de gratuito a pago, el sistema mueve el archivo a la carpeta privada. Si lo cambias de pago a gratuito, lo mueve a la carpeta pública.
- Puedes reemplazar la portada o el archivo desde la ficha de edición. Los archivos anteriores se eliminan al guardar.
7. Quitar el contenido de demostración
Los productos de muestra llevan la etiqueta DEMO y datos ficticios. Cuando tengas materiales reales:
- Edita cada producto demo y desmarca Material de demostración si vas a reutilizarlo con contenido real.
- Reemplaza título, descripción, portada y archivo.
- Elimina los productos que no vayas a usar con el botón Eliminar.
- Actualiza los métodos de pago y revisa el catálogo desde el celular.
La web no muestra testimonios, cifras de ventas ni datos de contacto inventados. Solo aparecen los datos que tú registres en el panel y los conteos reales del catálogo.
¿Todo listo?
Vuelve al panel para configurar Yape, PayPal o WhatsApp y publicar tu primer recurso.