El sitio web público
Qué hace el sitio web público: sus páginas, las licencias y su pago, la documentación, el diario y el registro de cambios, el formulario de contacto, el traspaso al panel y los buscadores.
Para el paquete Full Stack
Páginas
Cada página existe en inglés bajo /en y en árabe bajo /ar, en un tema claro y uno oscuro. Solo dos partes del sitio llaman a la API de Northstack: el formulario de contacto y el pago de licencias. Todo lo demás está escrito en el propio sitio.
| Página | Ruta | Qué muestra |
|---|---|---|
| Inicio | /en | El hero con Get the starter y Live demo, luego la base, una vista previa del espacio de trabajo, el camino al lanzamiento, los roles del espacio de trabajo, la sección para desarrolladores, las dos licencias, las preguntas frecuentes y una llamada a la acción final. |
| Precios | /en/pricing | Las dos licencias, Single project y Studio, una tabla comparativa y las preguntas sobre licencias. Get single project y Get Studio abren el resumen de compra. |
| Pago | /en/checkout?license=studio | Los datos del comprador y el método de pago, junto al pedido. Sus páginas de retorno son /en/checkout/success, /en/checkout/cancelled y el pago de prueba /en/checkout/test. |
| Documentación | /en/docs, /en/docs/<article> | Diez artículos en tres grupos (Getting started, Core concepts, Deployment), con una búsqueda. /en/docs abre la guía de inicio rápido. |
| Diario | /en/blog, /en/blog/<article> | Siete artículos con categorías, una búsqueda y páginas de siete. |
| Registro de cambios | /en/changelog | Cada versión, la más reciente primero, filtrada por Major, Minor o Patch. |
| Contacto | /en/contact | El formulario de contacto y tres preguntas frecuentes. |
| Legal | /en/legal/privacy, /en/legal/terms, /en/legal/cookies, /en/legal/gdpr | Política de privacidad, condiciones de uso, política de cookies y derechos sobre tus datos: textos de ejemplo que debes reescribir para tu negocio. |
| Inicio de sesión, registro, restablecimiento de contraseña | /en/auth/signin, /en/auth/signup, /en/auth/forgot-password | Sin página propia: cada una envía al visitante a la misma página del panel, en el mismo idioma, conservando la cadena de consulta. |
| Páginas de error | /en/error/401, /en/error/404, /en/error/500 | Acceso requerido, página no encontrada y algo salió mal, cada una con su camino de vuelta. |
El encabezado enlaza a Product, Docs, Pricing y Changelog, y Start building abre la página de precios. El pie enlaza a Documentation, Journal, Contact, Privacy y Terms.
Enlaces hacia el panel
El sitio web no tiene cuentas propias. Las personas inician sesión, se registran y trabajan en el panel, en la dirección de NEXT_PUBLIC_DASHBOARD_URL (http://localhost:3031 cuando está vacía).
| Control | Adónde lleva |
|---|---|
| Live demo (hero), Explore the demo (vista previa del espacio de trabajo y página de contacto) | La página de inicio de sesión del panel, /<locale>/auth/signin, en el idioma de la página. |
| See role controls (la sección de roles de la página de inicio) | La misma página de inicio de sesión, y luego la página Roles del espacio de trabajo una vez iniciada la sesión. |
Sign in en la página de acceso requerido, y las direcciones /auth/... de arriba | La página del panel con el mismo nombre. |
El encabezado no tiene enlace de inicio de sesión propio. Los enlaces de demostración llevan ?demo=1, que con el modo demostración desactivado abre el formulario de inicio de sesión ordinario, donde entra cualquier cuenta de ejemplo.
Las licencias y su pago
La página de precios, la sección de licencias de la página de inicio y el pago leen las dos licencias de src/config/licenses.ts: su precio, cuántos productos finales cubre cada una y las líneas que lista cada tarjeta. Un botón de licencia abre el Purchase summary, y Continue to checkout abre /checkout para esa licencia, o el pago de una tienda externa cuando hay una definida.
El comprador paga en la página de Stripe o de PayPal, así que nunca hay un campo de tarjeta en el sitio web. Sin claves de pago en la API, ambos métodos pasan por el pago de prueba del propio sitio, que no cobra a nadie.
Documentación, diario y registro de cambios
- Su texto forma parte del sitio, con un archivo por idioma:
src/content/docs/,src/content/journal/ysrc/content/changelog/, cada uno con unen.jsony unar.json. El orden de los artículos y grupos de la documentación esDOCS_NAVensrc/content/docs/index.ts, la categoría, la fecha y el tiempo de lectura de cada artículo del diario sonJOURNAL_ARTICLESensrc/content/journal/index.ts, y la fecha y los tipos de cambio de cada versión sonRELEASESensrc/content/changelog/index.ts. - La búsqueda de la documentación se ejecuta en el navegador sobre todos los artículos del idioma de la página.
- La categoría, la búsqueda y la página del diario se guardan en la dirección como
category,qypage, y el tipo de versión del registro de cambios comotype, de modo que una lista filtrada se puede compartir y recargar. - La documentación describe el propio Northstack: reescríbela o elimínala para tu producto.
El formulario de contacto
Un nombre (de 2 a 120 caracteres), un correo de trabajo, un asunto (Licensing, Setup o Product question) y un mensaje de 20 a 2.000 caracteres, y luego Send message. La API guarda cada mensaje en su tabla contact_messages y, cuando CONTACT_INBOX está definido en su .env, lo reenvía allí por correo. El panel no tiene ninguna página que los liste.
El formulario lleva un campo oculto que atrapa bots (uno rellenado se responde como enviado y no se guarda en ninguna parte), envía el mismo mensaje una sola vez por muchas veces que se reintente, y acepta cinco mensajes por dirección en una hora; el sexto indica que lo intentes más tarde. Detrás de un proxy inverso, define TRUST_PROXY=1 en el .env de la API, o todos los visitantes comparten el cupo del proxy.
Buscadores
- Cada página define su propio título, descripción, dirección canónica, alternativas de idioma y tarjeta para compartir, construidos a partir de
NEXT_PUBLIC_SITE_URL, así que defínelo con tu dirección real antes de construir. /sitemap.xmllista las páginas de inicio, precios, documentación, diario, registro de cambios, contacto y legales, y cada artículo de la documentación y del diario, cada uno en ambos idiomas con su alternativa./robots.txtpermite todas las páginas y apunta al mapa del sitio.- El pago, sus páginas de retorno y las páginas de error están marcados con
noindex. - No se carga ninguna etiqueta de analítica ni de publicidad.
Sin la API
Construido con NEXT_PUBLIC_API_BASE_URL vacío, o iniciado sin .env, el sitio web funciona con sus datos de ejemplo integrados: el formulario de contacto y el pago de licencias responden en el navegador, un pedido abre el pago de prueba del propio sitio y su recibo muestra una clave de licencia, y no se envía nada a ninguna parte. Un aviso Sample data al final de cada página lo indica.
La línea del pie de la demostración pública
Incluido con tu compra. Inicia sesión para leerlo o ábrelo en tu descarga.
Qué cambia en el sitio web cuando se construye como demostración pública.
Cómo encaja el código del sitio web
Incluido con tu compra. Inicia sesión para leerlo o ábrelo en tu descarga.
La estructura del código y las convenciones que debes mantener al cambiarlo.