Le site public
Ce que fait le site public : ses pages, les licences et leur paiement, la documentation, le journal et le changelog, le formulaire de contact, le passage au tableau de bord, et les moteurs de recherche.
Pour le pack Full Stack
Pages
Chaque page existe en anglais sous /en et en arabe sous /ar, dans un thème clair et un thème sombre. Seules deux parties du site appellent l'API Northstack : le formulaire de contact et le paiement des licences. Tout le reste est écrit dans le site lui-même.
| Page | Chemin | Ce qu'elle affiche |
|---|---|---|
| Accueil | /en | Le hero avec Get the starter et Live demo, puis les fondations, un aperçu de l'espace de travail, le parcours de lancement, les rôles de l'espace de travail, la section développeur, les deux licences, les questions courantes et un appel à l'action final. |
| Tarifs | /en/pricing | Les deux licences, Single project et Studio, un tableau comparatif et les questions sur les licences. Get single project et Get Studio ouvrent le récapitulatif d'achat. |
| Paiement | /en/checkout?license=studio | Les informations de l'acheteur et le moyen de paiement, à côté de la commande. Ses pages de retour sont /en/checkout/success, /en/checkout/cancelled et le paiement test /en/checkout/test. |
| Documentation | /en/docs, /en/docs/<article> | Dix articles en trois groupes (Getting started, Core concepts, Deployment), avec une recherche. /en/docs ouvre le Quickstart. |
| Journal | /en/blog, /en/blog/<article> | Sept articles avec des catégories, une recherche et des pages de sept. |
| Changelog | /en/changelog | Chaque version, la plus récente d'abord, filtrée par Major, Minor ou Patch. |
| Contact | /en/contact | Le formulaire de contact et trois questions courantes. |
| Pages légales | /en/legal/privacy, /en/legal/terms, /en/legal/cookies, /en/legal/gdpr | Politique de confidentialité, Conditions d'utilisation, Politique de cookies et Vos droits sur vos données : des textes d'exemple à réécrire pour votre activité. |
| Connexion, inscription, réinitialisation du mot de passe | /en/auth/signin, /en/auth/signup, /en/auth/forgot-password | Aucune page propre : chacune envoie le visiteur vers la même page du tableau de bord, dans la même langue, en gardant la chaîne de requête. |
| Pages d'erreur | /en/error/401, /en/error/404, /en/error/500 | Accès requis, page introuvable et erreur, chacune avec son chemin de retour. |
L'en-tête renvoie vers Product, Docs, Pricing et Changelog, et Start building ouvre la page des tarifs. Le pied de page renvoie vers Documentation, Journal, Contact, Privacy et Terms.
Liens vers le tableau de bord
Le site n'a pas de comptes propres. Les gens se connectent, s'inscrivent et travaillent dans le tableau de bord, à l'adresse de NEXT_PUBLIC_DASHBOARD_URL (http://localhost:3031 quand elle est vide).
| Contrôle | Où il mène |
|---|---|
| Live demo (hero), Explore the demo (aperçu de l'espace de travail et page de contact) | La page de connexion du tableau de bord, /<locale>/auth/signin, dans la langue de la page. |
| See role controls (la section des rôles de la page d'accueil) | La même page de connexion, puis la page Roles de l'espace de travail une fois connecté. |
Sign in sur la page Access required, et les adresses /auth/... ci-dessus | La page du même nom du tableau de bord. |
L'en-tête n'a pas de lien de connexion propre. Les liens de démo portent ?demo=1, qui, avec le mode démo désactivé, ouvre le formulaire de connexion ordinaire, où n'importe quel compte du seed se connecte.
Les licences et leur paiement
La page des tarifs, la section des licences de la page d'accueil et le paiement lisent les deux licences dans src/config/licenses.ts : leur prix, le nombre de produits finaux que chacune couvre et les lignes que liste chaque carte. Un bouton de licence ouvre le Purchase summary, et Continue to checkout ouvre /checkout pour cette licence, ou le paiement d'une boutique externe quand il y en a une.
L'acheteur paie sur la page de Stripe ou de PayPal, aucun champ de carte n'est donc jamais présent sur le site. Sans clés de paiement sur l'API, les deux moyens passent par le paiement test du site, qui ne débite personne.
Documentation, journal et changelog
- Leur texte fait partie du site, un fichier par langue :
src/content/docs/,src/content/journal/etsrc/content/changelog/, chacun avec unen.jsonet unar.json. L'ordre des articles et des groupes de la documentation estDOCS_NAVdanssrc/content/docs/index.ts, la catégorie, la date et le temps de lecture de chaque article du journal sontJOURNAL_ARTICLESdanssrc/content/journal/index.ts, et la date et les types de changement de chaque version sontRELEASESdanssrc/content/changelog/index.ts. - La recherche de la documentation s'exécute dans le navigateur sur chaque article de la langue de la page.
- La catégorie, la recherche et la page du journal sont gardées dans l'adresse sous
category,qetpage, et le type de version du changelog soustype: une liste filtrée peut ainsi être partagée et rechargée. - La documentation décrit Northstack lui-même : réécrivez-la ou supprimez-la pour votre propre produit.
Le formulaire de contact
Un nom (2 à 120 caractères), un e-mail professionnel, un sujet (Licensing, Setup ou Product question) et un message de 20 à 2 000 caractères, puis Send message. L'API enregistre chaque message dans sa table contact_messages et, quand CONTACT_INBOX est défini dans son .env, le transfère par e-mail à cette adresse. Le tableau de bord n'a aucune page qui les liste.
Le formulaire porte un champ caché qui piège les robots (un champ rempli reçoit la réponse « envoyé » et n'est stocké nulle part), n'envoie le même message qu'une seule fois quel que soit le nombre de tentatives, et accepte cinq messages par adresse en une heure ; le sixième dit de réessayer plus tard. Derrière un reverse proxy, définissez TRUST_PROXY=1 dans le .env de l'API, sinon tous les visiteurs partagent le quota du proxy.
Moteurs de recherche
- Chaque page définit son propre titre, sa description, son adresse canonique, ses alternatives de langue et sa carte de partage, construits à partir de
NEXT_PUBLIC_SITE_URL: définissez-la donc avec votre vraie adresse avant le build. /sitemap.xmlliste l'accueil, les tarifs, la documentation, le journal, le changelog, le contact et les pages légales, chaque article de la documentation et du journal, chacun dans les deux langues avec son alternative./robots.txtautorise chaque page et pointe vers le sitemap.- Le paiement, ses pages de retour et les pages d'erreur sont marqués
noindex. - Aucun outil d'analyse ni de publicité n'est chargé.
Sans l'API
Construit avec NEXT_PUBLIC_API_BASE_URL vide, ou démarré sans .env, le site fonctionne sur ses données d'exemple intégrées : le formulaire de contact et le paiement des licences répondent dans le navigateur, une commande ouvre le paiement test du site et son reçu affiche une clé de licence, et rien n'est envoyé nulle part. Un avis Sample data en bas de chaque page le signale.
La ligne de pied de page de la démo publique
Inclus avec votre achat. Connectez-vous pour le lire, ou ouvrez-le dans votre téléchargement.
Ce que le site change quand il est construit comme démo publique.
Comment s'organise le code du site
Inclus avec votre achat. Connectez-vous pour le lire, ou ouvrez-le dans votre téléchargement.
La structure du code et les conventions à respecter quand vous le modifiez.