PWS-Client-Papierkram-Generator
Dies ist der Onboarding-Papierkram-Prozess des Bauleiters. Er verwandelt ein abgegrenztes Engagement in unterzeichnungsfähige, markierte Dokumente aus der PWS-Mastervorlage – nicht in Vorlagen voller Anweisungen an einen selbst. Verwenden Sie dies von einem eigenen Projekt des Kunden (nicht dem allgemeinen PWS-Projekt), wenn Sie die tatsächlichen Unterlagen dieses Kunden erstellen, sodass dessen tatsächlicher Umfang, Preisgestaltung und Notizen während des Ausfüllens verfügbar sind.
Auslöser
- Ein neuer Kunde ist bereit für eine Dienstleistungsvereinbarung (jedes Engagement, einmalig oder wiederkehrend).
- Ein bestehender Kunde beginnt einen neuen, eigenständigen Build (einen neuen SOW), der über das bereits Unterzeichnete hinausgeht.
- Für das Engagement eines Kunden wird eine entsprechende Client Consent & Access Authorization benötigt (immer wenn PWS Zugriff auf die eigenen Konten/Dateien/Systeme des Kunden benötigt).
Kernentscheidungen (treffen Sie diese, bevor Sie etwas schreiben – niemals annehmen)
- Eine Vereinbarung pro Build, nicht ein riesiger Vertrag. Bündeln Sie Liefergegenstände nur dann in einer Vereinbarung, wenn sie gemeinsam abgegrenzt/geliefert werden und ungefähr denselben Zeitplan haben. Teilen Sie sie in separate Vereinbarungen auf, wenn die Zeitpläne oder die Bereitschaft auseinandergehen – die „80 % bei Fertigstellung“-Regelung einer einzelnen Vereinbarung funktioniert nur sauber, wenn alles in Anlage A ungefähr zur gleichen Zeit fertig wird. Jede eigenständige Vereinbarung kann über das ausfüllbare Feld oben in der Vereinbarung als eigene „Phase“ (Phase 1, Phase 2, ...) bezeichnet werden, idealerweise in der vom Kunden selbst angegebenen Prioritätsreihenfolge – das ist eine Bezeichnung auf einem vollständigen, separat bepreisten Dokument, niemals eine Möglichkeit, den Umfang eines Dokuments in einen bepreisten und einen unbepreisten, ausstehenden Teil aufzuteilen.
- Zahlungsstruktur: Einmalige Arbeit ist eine Pauschalgebühr, 20 % bei Unterzeichnung / 80 % bei Fertigstellung fällig. Der Abschnitt „Gebühren und Zahlung“ druckt KEINE eigenen Zahlen – er verweist auf den Gesamtpreis des initialen Builds in Anlage A als einzige Quelle der Wahrheit („Die Gesamtgebühr für den Leistungsumfang ist der Gesamtpreis des initialen Builds, wie in Anlage A angegeben“). Wiederkehrende/Retainer-Arbeiten werden niemals in diese 20/80-Aufteilung einbezogen – sie leben in einem eigenen Abschnitt „Wiederkehrende Dienste, automatische Zahlung und Kündigung“ mit Autopay-Autorisierung und einer erforderlichen 30-tägigen schriftlichen Kündigungsfrist, monatlich abgerechnet.
- Niemals Rabattmathematik drucken. Keine Standardpreisvergleiche, keine „Sie sparen X %“, keine „Erstkundenpreis“-Rahmung im Dokument selbst. Marcos präsentiert Rabatte mündlich, wenn er das Angebot vorlegt. Das Dokument gibt lediglich die Gebühr an. Anfragen zu Testimonials/Wiederverkaufsrechten (falls verwendet) stehen für sich allein, nicht als Gegenleistung für einen Rabatt dargestellt.
- Niemals Zahlen erfinden. Gebührenbeträge, Zieltermine, enthaltene Stunden pro Monat, Reaktionszeiten – wenn Marcos keine tatsächliche Zahl genannt hat, lassen Sie es als leere Ausfüllzeile, niemals als Schätzung. Entnehmen Sie tatsächliche Formulierungen aus den E-Mails/Notizen des Kunden, wenn verfügbar – paraphrasieren Sie nicht aus dem Gedächtnis, wenn das Original erreichbar ist (überprüfen Sie Gmail/Notion dafür).
- Retainer-Inhalt, falls zutreffend: Was enthalten ist (Überwachung, Fehlerbehebungen bei durch Änderungen an verbundenen Plattformen verursachten Problemen, eine gedeckelte monatliche Stunden-/Optimierungszulage), eine Reaktionszeitverpflichtung, Autopay-Autorisierung und die 30-tägige Kündigungsfrist. Vorgeschlagene Startpreise zur Beratung von Marcos (nicht zum Drucken): ~150–250 $/Monat für reine Überwachung, bis zu ~350–500 $/Monat, wenn es aktive Arbeit wie die Optimierung von Lead-Generierungskanälen beinhaltet – immer deutlich unter dem Preissensibilitätssignal, das der Kunde bereits gegeben hat.
Erstellungsprozess
- Sammeln Sie echte Eingaben. Rechts-/Handelsname des Kunden, Wirksamkeitsdatum (oder leer), die tatsächlichen Umfangspunkte (aus dessen E-Mails/Notizen, nicht aus dem Gedächtnis paraphrasiert), ob jeder Punkt einmalig oder wiederkehrend ist, und alle Preise, die Marcos tatsächlich festgelegt hat. Fragen Sie ihn direkt nach allem, was noch nicht entschieden ist, anstatt zu raten.
- Verwenden Sie das gemeinsame Markenmodul (neu erstellen, falls diese Umgebung es nicht hat – es ist kurz, reproduzieren Sie es aus dem folgenden Ausschnitt in
brand.jszusammen mit einer zugeschnittenen Kopie des PWS-Logos):
const BRAND = {
navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
bodyFont: "Times New Roman", // universelle professionelle/rechtliche Serifenschrift
headingFont: "Poppins", // fette geometrische Sans, spiegelt das PEAK-Wortmarke wider
};
function docStyles() {
return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText): Logo-Bild + fette navy-Überschrift (Schriftart: BRAND.headingFont) unter einem orangefarbenen Strich
// footer(): zentriert "Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com", klein, grau, blauer oberer Strich
// h1(text) / h2(text): fette navy-Überschriften, Schriftart: BRAND.headingFont
Verteilen Sie ...docStyles() in jeden new Document({...})-Aufruf, sodass der Fließtext standardmäßig in Times New Roman gesetzt wird; Überschriften/Briefkopf überschreiben explizit mit Poppins Bold.
-
Tabellenüberschriften sind schwarz-weiß, niemals farbig schattiert. Eine frühere Version schattierte Kopfzellen in Navy – der Kopftext hatte keine explizite Farbe gesetzt, sodass er auf einigen Bildschirmen als schwarz-auf-navy, ehrlich gesagt mit geringem Kontrast, dargestellt wurde. Tabellenüberschriften sind einfach fetter schwarzer Text auf Weiß mit einfachen Gitterlinienrändern. Führen Sie keine
shade/Füllfarbe für Kopfzellen wieder ein. -
Leere Ausfüllzeilen: Verwenden Sie eine kurze Leerzeile innerhalb von Tabellenzellen. Die Standard-Ausfüllzeile (
U = "________________", 16 Unterstriche) ist für Fließtext und breite Zellen. In engeren Tabellenzellen (einer Zeitplanspalte, einer Preiszeile für die Gesamtsumme) bricht sie in eine zweite Zeile um und sieht kaputt aus – verwenden Sie stattdessen dort eine kürzere Leerzeile (US = "__________", 10 Unterstriche). -
Standard-Abschnittsfluss (docx-js über das
docx-Skill): Eröffnungs-/Parteienblock, dann eine ausfüllbare Zeile „Phase ___ — ___ (Engagement-Name)“; Dienstleistungen und Leistungsumfang; Laufzeit; Gebühren und Zahlung (nummerierte Klauseln: Gebühr [verweist auf Anlage A Gesamtsumme, kein separates Dollarfeld], Zahlungsplan [20/80, keine separaten Dollarfelder], Zusätzlicher Umfang führt zu einer neuen Vereinbarung, Rechnungsstellung, Zahlungsverzug); [Wiederkehrende Dienste, automatische Zahlung und Kündigung – nur wenn dieses Engagement eine Retainer-Komponente hat]; Verantwortlichkeiten des Kunden; Zugang zu Kundensystemen und -daten; Geistiges Eigentum und Wiederverkaufsrechte (Kundenspezifische Ergebnisse, Anbieterwerkzeuge, Testimonial, Wiederverkaufsrechte); Vertraulichkeit; Gewährleistung und Haftungsausschluss; Haftungsbeschränkung; Selbstständiger; Kündigung; Geltendes Recht; Gesamtvereinbarung und Änderungen; Seitenumbruch; Anlage A; Unterschriften. -
Anlage A-Struktur – verwenden Sie immer diese Form:
- Tabelle „Automatisierungs-Builds“: Spalten Automatisierung | Beschreibung | Zeitplan | Initialer Build-Preis. Eine Zeile pro eindeutiger Automatisierung/Liefergegenstand in diesem Engagement – ein 20-zeiliges Projekt erhält 20 Zeilen, ein 2-zeiliges Projekt erhält 2. Wenn Marcos tatsächliche Einzelposten (Name, Beschreibung, Zeitplan, Preis) angibt, füllen Sie jede Zeile direkt aus, anstatt sie leer zu lassen. Enden Sie mit einer unteren Zeile, die ersten drei Spalten zusammengeführt (
columnSpan: 3) mit dem Text „Gesamter initialer Build-Preis“, die letzte Spalte enthält den Dollar-Gesamtbetrag – summieren Sie die eingegebenen Preise pro Zeile selbst, anstatt sie leer zu lassen, wenn jeder Einzelposten einen tatsächlichen Preis hat; lassen Sie sie nur dann als leere Ausfüllzeile, wenn einer oder mehrere Einzelposten noch keinen festgelegten Preis haben. - Abschnitt „Monatlicher Retainer / Wartung“ direkt darunter, eigene kleine Tabelle mit nur drei Spalten – Häufigkeit | Gebühr | Autopay (keine Spalte „Dienstleistung“; Marcos fand es unklar, was dort hinkäme, wenn das Engagement nur eine Retainer-Zeile hat) – „Monatlich“ vorausgefüllt in Häufigkeit, ein Kontrollkästchen
☐ Autorisiert (Abschnitt 4.3)in Autopay. Fügen Sie diese Tabelle nur ein, wenn das Engagement eine wiederkehrende Komponente hat; andernfalls geben Sie klar an: „Für dieses Engagement gelten keine wiederkehrenden Wartungs- oder Retainer-Dienste.“, anstatt den Abschnitt zu löschen (damit jede Anlage A die gleiche Form behält).
- Tabelle „Automatisierungs-Builds“: Spalten Automatisierung | Beschreibung | Zeitplan | Initialer Build-Preis. Eine Zeile pro eindeutiger Automatisierung/Liefergegenstand in diesem Engagement – ein 20-zeiliges Projekt erhält 20 Zeilen, ein 2-zeiliges Projekt erhält 2. Wenn Marcos tatsächliche Einzelposten (Name, Beschreibung, Zeitplan, Preis) angibt, füllen Sie jede Zeile direkt aus, anstatt sie leer zu lassen. Enden Sie mit einer unteren Zeile, die ersten drei Spalten zusammengeführt (
-
Nummerierungsfallen (docx-js-spezifisch, bereits zweimal aufgetreten – nicht wiederholen):
- Eine
numbering.reference-Zeichenfolge zählt über das GESAMTE Dokument kontinuierlich, wenn sie über Abschnitte hinweg wiederverwendet wird. Geben Sie jedem logischen nummerierten Klauselblock (Gebühren, Wiederkehrend, IP) einen eigenen Referenznamen (z.B.clausesFees,clausesRecurring,clausesIP), niemals eine gemeinsame Referenz"clauses". - Wenn die Abschnittsliste eines Dokuments variiert (z.B. Abschnitt „Wiederkehrend“ vorhanden oder nicht), geben Sie „Abschnitt 4“ / „Abschnitt 12“-Text nicht von Hand ein – dieser driftet, sobald Abschnitte hinzugefügt oder entfernt werden. Berechnen Sie vorab ein geordnetes Array von Abschnittsschlüsseln, mappen Sie jeden auf seine Nummer einmal und interpolieren Sie diese Nummer in Querverweise. Siehe das Muster: erstellen Sie
sectionOrder(bedingt einschließlich "recurring"), dannsecNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1), dann referenzieren SiesecNum.terminationusw., wo immer eine Abschnittsnummer im Fließtext erwähnt wird. TableCellbenötigt einecolumnSpan-Option, die durch Ihrencell()-Helper gefädelt werden muss, um die zusammengeführte Gesamtzeile zu erstellen – vergessen Sie nicht, sie hinzuzufügen, wenn Sie einen älterencell()-Helper wiederverwenden, der nurwidth/shadeverarbeitet.
- Eine
-
Erstellen Sie die passende Consent & Access Authorization für jedes Engagement, das neue Systeme berührt – verwenden Sie keine Zugangstabellenzeilen eines alten Engagements für einen anderen Build wieder. Gleiches Branding, gleiches schwarz-weißes ausfüllbares Tabellenmuster (System/Konto, Spezifischer Punkt, Zugriff gewährt, Zweck).
-
Vor der Auslieferung überprüfen – jedes Mal: in PDF konvertieren (
soffice.py --headless --convert-to pdf-Skript desdocx-Skills), in JPG rendern (pdftoppm -jpeg -r 100) und tatsächlich jede SeiteReaden, um zu bestätigen: korrektes Branding, Abschnittsnummern sind fortlaufend und Querverweise stimmen überein, keine Rabatt-/Standardpreissprache eingeschlichen, Leerfelder sind wirklich leer (keine veralteten Zahlen von einem vorherigen Kunden), kein hässlicher Zeilenumbruch bei kurzen Leerfeldern, und die Gesamtsumme der Automatisierungs-Builds entspricht tatsächlich der Summe ihrer Zeilen. Liefern Sie niemals eine Neuerstellung ohne erneute Überprüfung aus. -
Auslieferung über SendUserFile, und protokollieren Sie, was erstellt wurde + alle Preis-/Strukturentscheidungen im eigenen Projekt/Build-Log dieses Kunden, nicht im allgemeinen PWS-Projekt.
Überprüfung
- Kein Dollarbetrag, Datum oder Stundenanzahl erscheint im Dokument, es sei denn, Marcos hat es explizit angegeben
- Keine Rabattmathematik, Sparprozentsätze oder „Erstkundenpreis“-Sprache an irgendeiner Stelle
- Jeder wiederkehrende Dienst fällt unter seinen eigenen Abschnitt (Autopay + 30-tägige Kündigung), niemals innerhalb der einmaligen 20/80-Aufteilung
- Abschnittsnummern wurden aus dem tatsächlich gerenderten PDF abgelesen, nicht aus dem Code angenommen
- Anlage A Gesamter initialer Build-Preis entspricht der Summe seiner ausgefüllten Einzelposten
- Abschnitt „Gebühren und Zahlung“ verweist auf die Gesamtsumme von Anlage A, anstatt ein eigenes separates Dollarfeld zu drucken
- Tabellenüberschriften sind fetter schwarzer Text auf Weiß – keine Farbschattierung irgendwo
- Retainer-Tabelle hat genau drei Spalten (Häufigkeit | Gebühr | Autopay), keine Spalte „Dienstleistung“
- Branding (Logo, navy/blau/orange, Times New Roman Fließtext / Poppins Bold Überschriften, Fußzeile) stimmt auf jeder Seite überein
- Es wurde eine Erinnerung gegeben, dass ein lizenzierter WA-Anwalt die Unterlagen prüfen sollte, bevor sie ein Kunde tatsächlich unterschreibt