Générateur de documents clients PWS
Ceci est le processus de paperasse d'intégration du Directeur de Construction. Il transforme un engagement défini en documents signables et aux couleurs de la marque à partir du modèle maître PWS — et non à partir de modèles remplis d'instructions à soi-même. Utilisez-le depuis le projet propre du client (pas le projet général PWS) lors de la création de la paperasse réelle de ce client, afin que son périmètre réel, ses prix et ses notes soient à portée de main pendant que vous remplissez le document.
Déclencheur
- Un nouveau client est prêt pour une convention de services (n'importe quel engagement, ponctuel ou récurrent).
- Un client existant commence un nouveau projet distinct (un nouveau périmètre de travaux) au-delà de ce qu'il a déjà signé.
- L'engagement d'un client nécessite une Autorisation de consentement et d'accès client correspondante (chaque fois que PWS a besoin d'accéder aux comptes/fichiers/systèmes du client).
Décisions fondamentales (à prendre avant d'écrire quoi que ce soit — ne jamais supposer)
- Un accord par version, pas un contrat unique géant. Regroupez les livrables dans un seul accord uniquement lorsqu'ils sont définis/livrés ensemble sur à peu près le même calendrier. Séparez-les en accords distincts lorsque les calendriers ou l'état de préparation divergent — le « 80 % dû à l'achèvement » d'un seul accord ne fonctionne proprement que lorsque tout ce qui se trouve dans son Annexe A se termine à peu près en même temps. Chaque accord autonome peut être étiqueté comme sa propre « Phase » (Phase 1, Phase 2, ...) via le champ remplissable près du haut de l'accord, idéalement dans l'ordre de priorité indiqué par le client — c'est une étiquette sur un document complet et séparément tarifé, jamais un moyen de diviser le périmètre d'un document en une partie tarifée et une partie en attente non tarifée.
- Structure de paiement : le travail ponctuel est un montant forfaitaire total, 20 % dû à la signature / 80 % dû à l'achèvement. La section Honoraires et Paiement N'imprime PAS ses propres montants en dollars — elle fait référence au Prix Total de la Version Initiale de l'Annexe A comme source unique de vérité (« le montant total des honoraires pour le Périmètre de Travaux est le Prix Total de la Version Initiale indiqué dans l'Annexe A »). Le travail récurrent/de rétention n'est jamais intégré dans cette répartition 20/80 — il figure dans sa propre section « Services récurrents, prélèvement automatique et annulation » avec autorisation de prélèvement automatique et un préavis de résiliation écrit de 30 jours requis, facturé mensuellement.
- N'imprimez jamais de calculs de réduction. Pas de comparaison de tarifs standard, pas de « vous économisez X % », pas de mention de « tarif premier client » dans le document lui-même. Marcos présente toute réduction verbalement lorsqu'il présente l'offre. Le document indique simplement les honoraires. Les demandes de témoignage/droits de revente (si utilisées) sont indépendantes, jamais présentées comme un échange contre une réduction.
- N'inventez jamais de chiffres. Montants des honoraires, dates cibles, heures incluses par mois, délais de réponse — si Marcos n'a pas donné de chiffre réel, laissez-le comme une ligne de remplissage vierge, jamais une estimation. Extrayez le langage réel du périmètre des emails/notes du client lorsqu'il est disponible — ne paraphrasez pas de mémoire si l'original est accessible (vérifiez Gmail/Notion pour cela).
- Contenu de la rétention, le cas échéant : ce qui est inclus (surveillance, correctifs pour les pannes causées par des modifications des plateformes connectées, une allocation mensuelle maximale d'heures/réglages), un engagement de délai de réponse, une autorisation de prélèvement automatique et le préavis d'annulation de 30 jours. Tarification de départ suggérée pour conseiller Marcos (pas à imprimer) : environ 150 à 250 $/mois pour la surveillance uniquement, jusqu'à environ 350 à 500 $/mois si cela inclut un travail actif comme le réglage des canaux de génération de leads — toujours bien en dessous du signal de sensibilité au prix que le client a déjà donné.
Processus de création
- Recueillez les entrées réelles. Nom légal/nom commercial du client, date d'effet (ou blanc), les éléments réels du périmètre (à partir de ses emails/notes, pas paraphrasés de mémoire), si chaque élément est ponctuel ou récurrent, et tout prix que Marcos a réellement décidé. Demandez-lui directement tout ce qui n'est pas encore décidé plutôt que de deviner.
- Utilisez le module de marque partagé (reconstruisez-le si cet environnement ne l'a pas — il est court, reproduisez-le à partir de l'extrait ci-dessous dans
brand.jsavec une copie recadrée du logo PWS) :
const BRAND = {
navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
bodyFont: "Times New Roman", // police à empattement universelle professionnelle/pour documents juridiques
headingFont: "Poppins", // police géométrique sans empattement en gras, écho au mot-symbole PEAK
};
function docStyles() {
return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText) : image du logo + titre en bleu marine et gras (police : BRAND.headingFont) sous une règle orange
// footer() : centré « Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com », petit, gris, règle bleue en haut
// h1(text) / h2(text) : titres en bleu marine et gras, police : BRAND.headingFont
Étalez ...docStyles() dans chaque appel new Document({...}) afin que le texte du corps utilise par défaut Times New Roman ; les titres/en-tête de lettre remplacent explicitement par Poppins Bold.
-
Les en-têtes de tableau sont en noir et blanc, jamais avec un fond de couleur. Une version antérieure avait des cellules d'en-tête ombrées en bleu marine — le texte d'en-tête n'avait pas de couleur explicite définie, il s'affichait donc en noir sur bleu marine, avec un contraste vraiment faible sur certains écrans. Les en-têtes de tableau sont simplement du texte noir en gras sur fond blanc avec des bordures de quadrillage simples. Ne réintroduisez pas de couleur de
shade/remplissage dans les cellules d'en-tête. -
Lignes de remplissage vierges : utilisez un blanc court dans les cellules du tableau. La ligne de remplissage vierge standard (
U = "________________", 16 tirets bas) est destinée au texte du corps et aux cellules larges. Dans les cellules de tableau plus étroites (une colonne Calendrier, une cellule de prix de ligne Total), elle passe à la ligne suivante et semble cassée — utilisez plutôt un blanc plus court (US = "__________", 10 tirets bas). -
Flux de sections standard (docx-js via la compétence
docx) : bloc d'ouverture/parties, puis une ligne « Phase ___ — ___ (nom de l'engagement) » ; Services et Périmètre de Travaux ; Durée ; Honoraires et Paiement (clauses numérotées : Honoraires [fait référence au Total de l'Annexe A, pas d'espace dollar séparé], Échéancier de paiement [20/80, pas d'espaces dollar séparés], Le périmètre supplémentaire donne lieu à un nouvel accord, Facturation, Paiement en retard) ; [Services récurrents, prélèvement automatique et annulation — uniquement si cet engagement a un volet de rétention] ; Responsabilités du client ; Accès aux systèmes et données du client ; Propriété intellectuelle et droits de revente (Sorties spécifiques au client, Outils du fournisseur, Témoignage, Droits de revente) ; Confidentialité ; Garantie et exclusion de responsabilité ; Limitation de responsabilité ; Sous-traitant indépendant ; Résiliation ; Droit applicable ; Intégralité de l'accord et modifications ; saut de page ; Annexe A ; Signatures. -
Structure de l'Annexe A — utilisez toujours cette forme :
- Tableau « Automation Builds » : colonnes Automatisation | Description | Calendrier | Prix de la version initiale. Une ligne par automatisation/livrable distinct dans cet engagement — un projet de 20 lignes a 20 lignes, un projet de 2 lignes a 2 lignes. Lorsque Marcos donne des lignes réelles (nom, description, calendrier, prix), remplissez chaque ligne directement plutôt que de laisser des blancs. Terminez par une ligne de bas, les trois premières colonnes fusionnées (
columnSpan: 3) indiquant « Prix Total de la Version Initiale », la dernière colonne contenant le total en dollars — additionnez vous-même les prix saisis par ligne plutôt que de laisser un blanc lorsque chaque ligne a un prix réel ; laissez une ligne de remplissage vierge uniquement si un ou plusieurs postes n'ont pas encore de prix décidé. - Section « Rétention / Maintenance mensuelle » immédiatement en dessous, son propre petit tableau avec seulement trois colonnes — Fréquence | Honoraires | Prélèvement automatique (pas de colonne « Service » ; Marcos a trouvé peu clair ce qui irait là lorsque l'engagement n'a qu'une seule ligne de rétention) — « Mensuel » pré-rempli dans Fréquence, une case à cocher
☐ Autorisé (Section 4.3)dans Prélèvement automatique. Incluez ce tableau uniquement si l'engagement a une composante récurrente ; sinon, indiquez clairement « Aucun service de maintenance ou de rétention récurrent ne s'applique à cet engagement. » plutôt que de supprimer la section (cela permet de garder la même forme pour chaque Annexe A).
- Tableau « Automation Builds » : colonnes Automatisation | Description | Calendrier | Prix de la version initiale. Une ligne par automatisation/livrable distinct dans cet engagement — un projet de 20 lignes a 20 lignes, un projet de 2 lignes a 2 lignes. Lorsque Marcos donne des lignes réelles (nom, description, calendrier, prix), remplissez chaque ligne directement plutôt que de laisser des blancs. Terminez par une ligne de bas, les trois premières colonnes fusionnées (
-
Pièges de numérotation (spécifiques à docx-js, déjà rencontrés deux fois — ne pas répéter) :
- Une chaîne
numbering.referencecompte en continu sur l'ENSEMBLE du document si elle est réutilisée entre les sections. Donnez à chaque bloc de clause numérotée logique (Honoraires, Récurrent, PI) son propre nom de référence (par exempleclausesFees,clausesRecurring,clausesIP), jamais une référence"clauses"partagée. - Lorsque la liste des sections d'un document varie (par exemple section Récurrent présente ou absente), ne tapez pas manuellement le texte « Section 4 » / « Section 12 » — cela dérive dès que des sections sont ajoutées ou supprimées. Précalculez un tableau ordonné de clés de section, associez chaque clé à son numéro une fois, et interpolez ce numéro dans les références croisées. Voir le modèle : construisez
sectionOrder(en incluant conditionnellement « recurring »), puissecNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1), puis référencezsecNum.terminationetc. partout où un numéro de section est mentionné dans le texte du corps. TableCella besoin d'une optioncolumnSpantransmise via votre fonction d'aidecell()pour construire la ligne Total fusionnée — n'oubliez pas de l'ajouter si vous réutilisez une ancienne fonctioncell()qui ne gère quewidth/shade.
- Une chaîne
-
Créez l'Autorisation de consentement et d'accès correspondante pour tout engagement qui touche à de nouveaux systèmes — ne réutilisez pas les lignes du tableau d'accès d'un ancien engagement pour une version différente. Même image de marque, même motif de tableau remplissable noir et blanc (Système/Compte, Élément spécifique, Accès accordé, Objet).
-
Vérifiez avant de livrer — à chaque fois : convertissez en PDF (le script
soffice.py --headless --convert-to pdfde la compétencedocx), rendezez en JPG (pdftoppm -jpeg -r 100), et lisez (Read) chaque image de page pour confirmer : image de marque correcte, numéros de section séquentiels et références croisées cohérentes, aucun langage de réduction/tarif standard infiltré, les blancs sont vraiment vierges (pas de chiffres obsolètes d'un client précédent), pas de saut de ligne disgracieux sur les blancs courts, et le total de l'Automation Builds est bien égal à la somme de ses lignes. Ne livrez jamais une reconstruction sans revérifier. -
Livrez via SendUserFile, et consignez ce qui a été construit + toutes les décisions de prix/structure dans le journal de construction du projet propre du client, et non pas dans le projet général PWS.
Vérification
- Aucun montant en dollars, date ou nombre d'heures n'apparaît dans le document à moins que Marcos ne l'ait explicitement fourni
- Aucun calcul de réduction, pourcentage d'économie ou mention de « tarif premier client » nulle part
- Chaque service récurrent est sous sa propre Section (prélèvement automatique + annulation 30 jours), jamais à l'intérieur de la répartition 20/80 unique
- Les numéros de section ont été lus à partir du PDF réel rendu, pas supposés à partir du code
- Le Prix Total de la Version Initiale de l'Annexe A est égal à la somme des lignes remplies
- La section Honoraires et Paiement fait référence au total de l'Annexe A plutôt que d'imprimer son propre espace dollar séparé
- Les en-têtes de tableau sont du texte noir en gras sur fond blanc — aucun ombrage de couleur nulle part
- Le tableau de rétention a exactement trois colonnes (Fréquence | Honoraires | Prélèvement automatique), pas de colonne Service
- L'image de marque (logo, bleu marine/bleu/orange, corps Times New Roman / titres Poppins Bold, pied de page) correspond sur chaque page
- Un rappel a été fait qu'un avocat agréé de l'État de Washington devrait examiner le document avant que tout client ne le signe