Gerador de Documentação para Clientes PWS
Este é o processo de documentação de integração do Diretor de Construção. Ele transforma um engajamento com escopo definido em documentos prontos para assinatura, com a marca, a partir do modelo mestre da PWS — não modelos cheios de instruções para si mesmo. Use-o a partir do projeto do próprio cliente (não do projeto geral da PWS) ao criar a documentação real desse cliente, para que seu escopo, preços e anotações reais estejam disponíveis enquanto você o preenche.
Gatilho
- Um novo cliente está pronto para um acordo de serviços (qualquer engajamento, único ou recorrente).
- Um cliente existente está iniciando uma nova compilação distinta (um novo SOW) além do que já assinou.
- O engajamento de um cliente precisa de uma Autorização de Consentimento e Acesso do Cliente correspondente (sempre que a PWS precisar acessar as próprias contas/arquivos/sistemas do cliente).
Decisões centrais (tome estas antes de escrever qualquer coisa — nunca suponha)
- Um acordo por compilação, não um contrato gigante. Agrupe entregáveis em um único acordo apenas quando eles estiverem sendo escopados/entregues juntos, aproximadamente no mesmo cronograma. Divida em acordos separados quando os cronogramas ou a prontidão divergirem — os "80% devidos na conclusão" de um único acordo funcionam de forma limpa apenas quando tudo em seu Anexo A termina aproximadamente ao mesmo tempo. Cada acordo independente pode ser rotulado como sua própria "Fase" (Fase 1, Fase 2, ...) por meio do campo preenchível próximo ao topo do acordo, idealmente na ordem de prioridade declarada pelo cliente — isso é um rótulo em um documento completo e com preço separado, nunca uma forma de dividir o escopo de um documento em uma parte com preço e uma parte pendente sem preço.
- Estrutura de pagamento: trabalho único é uma taxa total fixa, 20% devidos na assinatura / 80% devidos na conclusão. A seção Taxas e Pagamento NÃO imprime seus próprios valores em dólar — ela faz referência ao Preço Total de Compilação Inicial do Anexo A como a única fonte de verdade ("a taxa total pelo Escopo do Trabalho é o Preço Total de Compilação Inicial declarado no Anexo A"). O trabalho recorrente/retido nunca é incluído nessa divisão 20/80 — ele vive em sua própria seção "Serviços Recorrentes, Pagamento Automático e Cancelamento" com autorização de pagamento automático e um aviso de cancelamento por escrito de 30 dias necessário, cobrado mensalmente.
- Nunca imprima cálculos de desconto. Sem comparações de tarifa padrão, sem "você está economizando X%", sem enquadramento de "tarifa de primeiro cliente" no próprio documento. Marcos apresenta qualquer desconto verbalmente quando apresenta o negócio. O documento apenas declara a taxa. Pedidos de depoimento/direitos de revenda (se usados) são independentes, não enquadrados como uma troca por um desconto.
- Nunca invente números. Valores de taxas, datas-alvo, horas-incluídas-por-mês, tempos de resposta — se Marcos não deu um número real, deixe como uma linha em branco para preenchimento, nunca um palpite. Extraia a linguagem de escopo real dos e-mails/notas do próprio cliente quando disponível — não parafraseie de memória se o original for acessível (verifique Gmail/Notion para isso).
- Conteúdo de retenção, quando aplicável: o que está incluído (monitoramento, correções de quebras causadas por mudanças em plataformas conectadas, uma cota mensal limitada de horas/ajustes), um compromisso de tempo de resposta, autorização de pagamento automático e o aviso de cancelamento de 30 dias. Preços iniciais sugeridos para aconselhar Marcos (não para imprimir): ~$150–250/mês apenas para monitoramento, até ~$350–500/mês se incluir trabalho ativo como ajuste de canal de geração de leads — sempre bem abaixo de qualquer sinal de sensibilidade a preço que o cliente já tenha dado.
Processo de construção
- Obtenha entradas reais. Nome legal/comercial do cliente, data de vigência (ou em branco), os itens de escopo reais (de seus e-mails/notas, não parafraseados de memória), se cada item é único ou recorrente e qualquer preço que Marcos realmente decidiu. Pergunte a ele diretamente sobre qualquer coisa ainda não decidida, em vez de adivinhar.
- Use o módulo de marca compartilhada (reconstrua se este ambiente não o tiver — é curto, reproduza-o do trecho abaixo em
brand.jsjunto com uma cópia recortada do logotipo da PWS):
const BRAND = {
navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
bodyFont: "Times New Roman", // serifa profissional/legal universal
headingFont: "Poppins", // sans-serif geométrica em negrito, ecoa a marca PEAK
};
function docStyles() {
return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText): imagem do logotipo + título em negrito na cor navy (fonte: BRAND.headingFont) sob uma linha laranja
// footer(): "Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com" centralizado, pequeno, cinza, linha azul no topo
// h1(texto) / h2(texto): títulos em negrito na cor navy, fonte: BRAND.headingFont
Propague ...docStyles() em cada chamada new Document({...}) para que o texto do corpo padrão seja Times New Roman; os títulos/cabeçalhos substituem explicitamente para Poppins em Negrito.
-
Os cabeçalhos das tabelas são em preto e branco, nunca com sombreamento colorido. Uma versão anterior sombreava as células do cabeçalho em azul escuro — o texto do cabeçalho não tinha cor definida, então aparecia como preto sobre azul escuro, com baixo contraste genuíno em algumas telas. Os cabeçalhos das tabelas são apenas texto preto em negrito sobre fundo branco com bordas de grade simples. Não reintroduza uma cor de
shade/preenchimento nas células do cabeçalho. -
Linhas em branco para preenchimento: use um espaço em branco curto dentro das células da tabela. A linha em branco padrão (
U = "________________", 16 sublinhados) é para texto do corpo e células largas. Dentro de células de tabela mais estreitas (uma coluna de Cronograma, uma célula de preço da linha de Total) ela quebra em uma segunda linha e parece quebrada — use um espaço em branco mais curto lá (US = "__________", 10 sublinhados). -
Fluxo de seção padrão (docx-js via a skill
docx): bloco de abertura/partes, então uma linha preenchível "Fase ___ — ___ (nome do engajamento)"; Serviços e Escopo do Trabalho; Prazo; Taxas e Pagamento (cláusulas numeradas: Taxa [referencia o Total do Anexo A, sem espaço em branco separado para dólar], Cronograma de Pagamento [20/80, sem espaços em branco separados para dólar], Escopo adicional vai para um novo acordo, Faturamento, Atraso no pagamento); [Serviços Recorrentes, Pagamento Automático e Cancelamento — somente se este engajamento tiver um componente de retenção]; Responsabilidades do Cliente; Acesso a Sistemas e Dados do Cliente; Propriedade Intelectual e Direitos de Revenda (Resultados específicos do cliente, Ferramentas do provedor, Depoimento, Direitos de revenda); Confidencialidade; Garantia e Isenção de Responsabilidade; Limitação de Responsabilidade; Contratante Independente; Rescisão; Lei Aplicável; Acordo Integral e Emendas; quebra de página; Anexo A; Assinaturas. -
Estrutura do Anexo A — sempre use esta forma:
- Tabela "Compilações de Automação": colunas Automação | Descrição | Cronograma | Preço de Compilação Inicial. Uma linha para cada automação/entregável distinto neste engajamento — um projeto de 20 linhas obtém 20 linhas, um projeto de 2 linhas obtém 2. Quando Marcos fornece itens de linha reais (nome, descrição, cronograma, preço), preencha cada linha diretamente, em vez de deixá-la em branco. Termine com uma linha inferior, primeiras três colunas mescladas (
columnSpan: 3) lendo "Preço Total de Compilação Inicial", última coluna contendo o total em dólar — some você mesmo os preços por linha inseridos em vez de deixar em branco quando cada item de linha tiver um preço real; deixe como uma linha em branco para preenchimento apenas se um ou mais itens de linha ainda não tiverem um preço decidido. - Seção "Retenção/Manutenção Mensal" imediatamente abaixo, sua própria tabela pequena com apenas três colunas — Frequência | Taxa | Pagamento Automático (sem coluna "Serviço"; Marcos achou pouco claro o que iria lá quando o engajamento tem apenas uma linha de retenção) — "Mensal" pré-preenchido em Frequência, uma caixa de seleção
☐ Autorizado (Seção 4.3)em Pagamento Automático. Inclua esta tabela apenas se o engajamento tiver um componente recorrente; caso contrário, afirme claramente "Nenhum serviço de manutenção ou retenção recorrente se aplica a este engajamento." em vez de excluir a seção (mantém cada Anexo A com a mesma forma).
- Tabela "Compilações de Automação": colunas Automação | Descrição | Cronograma | Preço de Compilação Inicial. Uma linha para cada automação/entregável distinto neste engajamento — um projeto de 20 linhas obtém 20 linhas, um projeto de 2 linhas obtém 2. Quando Marcos fornece itens de linha reais (nome, descrição, cronograma, preço), preencha cada linha diretamente, em vez de deixá-la em branco. Termine com uma linha inferior, primeiras três colunas mescladas (
-
Armadilhas de numeração (específicas do docx-js, já batidas duas vezes — não repita):
- Uma string
numbering.referenceconta continuamente em TODO o documento se reutilizada entre seções. Dê a cada bloco de cláusula numerada (Taxas, Recorrente, PI) seu próprio nome de referência (por exemplo,clausesFees,clausesRecurring,clausesIP), nunca uma referência"clauses"compartilhada. - Quando a lista de seções de um documento varia (por exemplo, seção Recorrente presente ou ausente), não digite manualmente o texto "Seção 4" / "Seção 12" — ele se desvia no momento em que seções são adicionadas ou removidas. Pré-calcule um array ordenado de chaves de seção, mapeie cada uma para seu número uma vez e interpole esse número em referências cruzadas. Veja o padrão: construa
sectionOrder(incluindo condicionalmente "recurring"), entãosecNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1), então referenciesecNum.terminationetc. sempre que um número de seção for mencionado no texto do corpo. TableCellprecisa de uma opçãocolumnSpanpassada através do seu helpercell()para construir a linha Total mesclada — não se esqueça de adicioná-la se estiver reutilizando um helpercell()mais antigo que só lida comwidth/shade.
- Uma string
-
Construa a Autorização de Consentimento e Acesso correspondente para qualquer engajamento que envolva novos sistemas — não reutilize linhas de tabela de acesso de um engajamento antigo para uma compilação diferente. Mesma marca, mesmo padrão de tabela preto e branco preenchível (Sistema/Conta, Item Específico, Acesso Concedido, Propósito).
-
Verifique antes de entregar — sempre: converta para PDF (o script
soffice.py --headless --convert-to pdfda skilldocx), renderize para JPG (pdftoppm -jpeg -r 100) e realmenteLeiacada imagem de página para confirmar: marca correta, números de seção estão sequenciais e referências cruzadas correspondem, nenhuma linguagem de desconto/tarifa padrão apareceu, espaços em branco estão genuinamente em branco (não números obsoletos de um cliente anterior), nenhuma quebra de linha feia em espaços em branco curtos e o total de Compilações de Automação realmente é igual à soma de suas linhas. Nunca envie uma reconstrução sem reverificar. -
Entregue via SendUserFile e registre o que foi construído + quaisquer decisões de preço/estrutura no projeto/registro de construção do próprio cliente, não no projeto geral da PWS.
Verificação
- Nenhum valor em dólar, data ou número de horas aparece no documento a menos que Marcos tenha fornecido explicitamente
- Nenhuma linguagem de cálculo de desconto, porcentagem de economia ou "tarifa de primeiro cliente" em nenhum lugar
- Cada serviço recorrente está sob sua própria Seção (pagamento automático + cancelamento de 30 dias), nunca dentro da divisão 20/80 de serviço único
- Os números de seção foram lidos do PDF real renderizado, não assumidos do código
- O Preço Total de Compilação Inicial do Anexo A é igual à soma de seus itens de linha preenchidos
- A seção Taxas e Pagamento faz referência ao total do Anexo A em vez de imprimir seu próprio espaço em branco separado para dólar
- Os cabeçalhos da tabela são texto preto em negrito sobre fundo branco — sem sombreamento de cor em nenhum lugar
- A tabela de retenção tem exatamente três colunas (Frequência | Taxa | Pagamento Automático), sem coluna Serviço
- A marca (logotipo, azul escuro/azul/laranja, corpo Times New Roman / títulos Poppins em Negrito, rodapé) corresponde em todas as páginas
- Um lembrete foi dado de que um advogado licenciado em WA deve revisar antes que qualquer cliente realmente assine