name: landing-software-extra description: Utiliser lorsque uma landing page precisa de software além da página estática: agenda ou reserva, painel, API, banco, e-mail transacional, notificação, ou qualquer serviço que roda no servidor ao lado de outro sistema. Não usar para páginas apenas de HTML, CSS e JS.
Landing : logiciel supplémentaire
La décision d'architecture appartient au propriétaire du projet. Violer la lettre, c'est violer l'esprit.
Loi de fer
AUCUNE DÉCISION DE STACK, RÉSEAU OU RESSOURCE PARTAGÉE
SANS DEMANDER AU PRÉALABLE. PHASE À HAUT RISQUE : ACCEPTEZ UNIQUEMENT VIA COMMANDE DE FELIPE.
Première action : node check-gate.js --cliente <nom> --antes-de software-extra ; lire 01 et plano.md ; lire references/agendamento.md s'il y a une réservation.
Fonction de porte
- Listez les décisions en suspens (stack, base de données, où ça tourne, ce qui est partagé, e-mail, notification, sauvegarde).
- Pour chacune : options, recommandation avec justification, coût en cas d'erreur. Demandez ; ne choisissez pas.
- Enregistrez dans
03-decisoes.md(D). Si une règle globale est enfreinte, enregistrezoverride: R-nnnavec l'approbation de Felipe. - Felipe exécute
! node approve.js --file <03> --fase software-extra --via comando. Ce n'est qu'ensuite que vous implémentez. - Implémentez avec TDD. Réviseur indépendant à la fin.
- Après le déploiement : un chemin réel du voisin (ex. :
GET /api/healthde l'autre système) etdocker logs <proxy> --since 2m | grep -c "502|refused".
Règles fixes
- Préfixe du projet dans tout service, conteneur et alias de réseau partagé (
agenda-api,agenda-db). Avant d'entrer dans un réseau, listez les noms que le voisin résout (set $api,upstream,proxy_pass). - Secret uniquement dans
.envdu serveur, permission 600 ; ce qui est passé par le chat est recommandé d'être changé. - Horaires, services et prix proviennent d'une source (la base de données) ; le HTML statique n'est qu'une sauvegarde.
- Le nom de l'option et la durée sont des champs différents ; l'écran décide quoi afficher selon une règle explicite.
- L'écran interne passe par
landing-direcao-visualetfrontend-design; l'ajout comprend une maquette et une vérification élément par élément. - Production : sauvegarde avant,
nginx -tavant de recharger, fenêtre qui ne fait pas planter, instruction de retour en arrière écrite. Ce qui nécessite root devient une ligne pour Felipe.
Drapeaux rouges : arrêtez-vous
- Choisir la base de données "parce que c'est la meilleure" · réutiliser le nom
api· déployer sans sauvegarde - Réexécuter sur le serveur un plan de 5 000 lignes que vous exécuteriez vous-même
- "Ça fonctionne ici" sans tester le voisin
| Rationalisation | Réalité |
|---|---|
| "Le choix est évident" | Si Felipe le découvrait par le code, serait-il surpris ? Alors demandez |
| "Le nom court est plus propre" | api sur le réseau edge a fait tomber le voisin avec 502 |
| "L'accord était pour la landing" | L'approbation d'un contexte ne vaut pas pour l'autre |