Generador de Documentos para Clientes de PWS
Este es el proceso de documentación de incorporación del Director de Construcción. Convierte un compromiso definido en documentos listos para firmar y con la marca de la empresa, a partir de la plantilla maestra de PWS, no de plantillas llenas de instrucciones internas. Úselo desde el propio proyecto del cliente (no el proyecto general de PWS) al crear la documentación real de ese cliente, de modo que su alcance real, precio y notas estén disponibles mientras lo completa.
Activación
- Un nuevo cliente está listo para un acuerdo de servicios (cualquier compromiso, único o recurrente).
- Un cliente existente está iniciando una nueva construcción distinta (un nuevo alcance de trabajo) más allá de lo que ya firmó.
- El compromiso de un cliente necesita una Autorización de Consentimiento y Acceso (cada vez que PWS necesite acceso a las cuentas/archivos/sistemas del propio cliente).
Decisiones clave (tómelas antes de escribir nada — nunca asuma)
- Un acuerdo por construcción, no un contrato gigante. Agrupe los entregables en un solo acuerdo solo cuando se estén definiendo/entregando juntos en aproximadamente el mismo cronograma. Sepárelos en acuerdos separados cuando los cronogramas o la preparación diverjan — el "80% debido al finalizar" de un solo acuerdo solo funciona limpiamente cuando todo en su Anexo A finaliza aproximadamente al mismo tiempo. Cada acuerdo independiente puede etiquetarse como su propia "Fase" (Fase 1, Fase 2, ...) mediante el campo rellenable cerca de la parte superior del acuerdo, idealmente en el orden de prioridad indicado por el cliente — eso es una etiqueta en un documento completo con precio separado, nunca una forma de dividir el alcance de un documento en una parte con precio y una parte pendiente sin precio.
- Estructura de pago: el trabajo único tiene una tarifa total plana, 20% pagadero al firmar / 80% pagadero al finalizar. La sección de Honorarios y Pago NO imprime sus propias cifras en dólares — hace referencia al Precio Total Inicial de Construcción del Anexo A como la única fuente de verdad ("la tarifa total por el Alcance del Trabajo es el Precio Total Inicial de Construcción indicado en el Anexo A"). El trabajo recurrente/por retención nunca se incluye en esa división 20/80 — vive en su propia sección "Servicios Recurrentes, Pago Automático y Cancelación" con autorización de pago automático y un aviso de cancelación por escrito de 30 días requerido, facturado mensualmente.
- Nunca imprima descuentos matemáticos. Sin comparaciones de tarifas estándar, sin "está ahorrando X%", sin redacción de "tarifa de primer cliente" en el documento mismo. Marcos presenta cualquier descuento verbalmente cuando presenta el trato. El documento solo indica la tarifa. Las solicitudes de testimonio/derechos de reventa (si se usan) son independientes, no se enmarcan como un intercambio por un descuento.
- Nunca invente números. Montos de tarifas, fechas objetivo, horas incluidas por mes, tiempos de respuesta — si Marcos no ha dado un número real, déjelo como una línea de relleno en blanco, nunca una suposición. Extraiga el lenguaje de alcance real de los correos electrónicos/notas del cliente cuando estén disponibles — no parafrasee de memoria si el original es accesible (revise Gmail/Notion para encontrarlo).
- Contenido del retenedor, cuando corresponda: qué está incluido (monitoreo, correcciones por daños causados por cambios en las plataformas conectadas, un límite mensual de horas/ajuste), un compromiso de tiempo de respuesta, autorización de pago automático y el aviso de cancelación de 30 días. Precios sugeridos iniciales para asesorar a Marcos (no para imprimir): ~$150–250/mes solo para monitoreo, hasta ~$350–500/mes si incluye trabajo activo como el ajuste de canales de generación de leads — siempre muy por debajo de cualquier señal de sensibilidad al precio que el cliente ya haya dado.
Proceso de construcción
- Recopile entradas reales. Nombre legal/nombre comercial del cliente, fecha de vigencia (o en blanco), los elementos de alcance reales (de sus correos electrónicos/notas, no parafraseados de memoria), si cada elemento es único o recurrente, y cualquier precio que Marcos haya decidido realmente. Pregúntele directamente cualquier cosa que aún no esté decidida en lugar de adivinar.
- Use el módulo de marca compartido (reconstruya si este entorno no lo tiene — es corto, reproduzcalo del fragmento a continuación en
brand.jsjunto con una copia recortada del logotipo de PWS):
const BRAND = {
navy: "001E47", blue: "2F8DD2", orange: "FE6701", gray: "5A6472",
bodyFont: "Times New Roman", // serifa profesional/legal universal
headingFont: "Poppins", // sans-serif geométrica en negrita, hace eco de la marca PEAK
};
function docStyles() {
return { default: { document: { run: { font: BRAND.bodyFont } } } };
}
// letterhead(titleText): imagen del logotipo + título en negrita navy (fuente: BRAND.headingFont) bajo una regla naranja
// footer(): centrado "Peak Workflow Solutions, LLC | Selah, WA | pwslocal.com", pequeño, gris, regla azul superior
// h1(text) / h2(text): encabezados en negrita navy, fuente: BRAND.headingFont
Propague ...docStyles() en cada llamada a new Document({...}) para que el texto del cuerpo tenga como valor predeterminado Times New Roman; los encabezados/letterhead anulan explícitamente a Poppins Bold.
-
Los encabezados de tabla son en blanco y negro, nunca sombreados en color. Una versión anterior sombreaba las celdas de encabezado en navy — el texto del encabezado no tenía un color explícito establecido, por lo que se mostraba como negro sobre navy, con un contraste realmente bajo en algunas pantallas. Los encabezados de tabla son solo texto negro en negrita sobre blanco con bordes de línea de cuadrícula simples. No reintroduzca un color de
shade/relleno en las celdas de encabezado. -
Líneas de relleno en blanco: use un espacio en blanco corto dentro de las celdas de la tabla. La línea de relleno en blanco estándar (
U = "________________", 16 guiones bajos) es para texto del cuerpo y celdas anchas. Dentro de celdas de tabla más estrechas (una columna de Cronograma, una celda de precio de fila Total) se envuelve en una segunda línea y se ve rota — use un espacio en blanco más corto allí en su lugar (US = "__________", 10 guiones bajos). -
Flujo de sección estándar (docx-js a través del skill
docx): bloque de apertura/partes, luego una línea rellenable "Fase ___ — ___ (nombre del compromiso)"; Servicios y Alcance del Trabajo; Plazo; Honorarios y Pago (cláusulas numeradas: Tarifa [hace referencia al Total del Anexo A, sin espacio en blanco para dólares separado], Calendario de pago [20/80, sin espacios en blanco para dólares separados], El alcance adicional va a un nuevo acuerdo, Facturación, Pago atrasado); [Servicios Recurrentes, Pago Automático y Cancelación — solo si este compromiso tiene un componente de retención]; Responsabilidades del Cliente; Acceso a los Sistemas y Datos del Cliente; Propiedad Intelectual y Derechos de Reventa (Resultados específicos del cliente, Herramientas del proveedor, Testimonio, Derechos de reventa); Confidencialidad; Garantía y Exención de Responsabilidad; Limitación de Responsabilidad; Contratista Independiente; Terminación; Ley Aplicable; Acuerdo Completo y Modificaciones; salto de página; Anexo A; Firmas. -
Estructura del Anexo A — use siempre esta forma:
- Tabla de "Construcciones de Automatización": columnas Automatización | Descripción | Cronograma | Precio Inicial de Construcción. Una fila por automatización/entregable distinto en este compromiso — un proyecto de 20 líneas obtiene 20 filas, un proyecto de 2 líneas obtiene 2. Cuando Marcos dé elementos de línea reales (nombre, descripción, cronograma, precio), complete cada fila directamente en lugar de dejarla en blanco. Termine con una fila inferior, las primeras tres columnas fusionadas (
columnSpan: 3) que diga "Precio Total Inicial de Construcción", la última columna con el total en dólares — sume usted mismo los precios por línea ingresados en lugar de dejarlo en blanco cuando cada elemento de línea tenga un precio real; déjelo como una línea de relleno en blanco solo si uno o más elementos de línea aún no tienen un precio decidido. - Sección "Retención/Mantenimiento Mensual" inmediatamente debajo, su propia tabla pequeña con solo tres columnas — Frecuencia | Tarifa | Pago Automático (sin columna "Servicio"; Marcos encontró poco claro qué iría allí cuando el compromiso solo tiene una línea de retención) — "Mensual" prellenado en Frecuencia, una casilla de verificación
☐ Autorizado (Sección 4.3)en Pago Automático. Incluya esta tabla solo si el compromiso tiene un componente recurrente; de lo contrario, indique claramente "No aplica ningún servicio de mantenimiento o retención recurrente a este compromiso." en lugar de eliminar la sección (mantiene todos los Anexos A con la misma forma).
- Tabla de "Construcciones de Automatización": columnas Automatización | Descripción | Cronograma | Precio Inicial de Construcción. Una fila por automatización/entregable distinto en este compromiso — un proyecto de 20 líneas obtiene 20 filas, un proyecto de 2 líneas obtiene 2. Cuando Marcos dé elementos de línea reales (nombre, descripción, cronograma, precio), complete cada fila directamente en lugar de dejarla en blanco. Termine con una fila inferior, las primeras tres columnas fusionadas (
-
Problemas de numeración (específicos de docx-js, ya ocurridos dos veces — no los repita):
- Una cadena
numbering.referencecuenta continuamente en TODO el documento si se reutiliza en todas las secciones. Dé a cada bloque de cláusulas numeradas lógicas (Honorarios, Recurrente, PI) su propio nombre de referencia (por ejemplo,clausesFees,clausesRecurring,clausesIP), nunca una referencia compartida"clauses". - Cuando la lista de secciones de un documento varía (por ejemplo, sección Recurrente presente o ausente), no escriba a mano el texto "Sección 4" / "Sección 12" — se desplaza en el momento en que se agregan o eliminan secciones. Precalcule una matriz ordenada de claves de sección, asigne a cada una su número una vez e interpole ese número en las referencias cruzadas. Vea el patrón: construya
sectionOrder(incluyendo condicionalmente "recurring"), luegosecNum = {}; sectionOrder.forEach((k,i) => secNum[k]=i+1), luego haga referencia asecNum.terminationetc. dondequiera que se mencione un número de sección en el texto del cuerpo. TableCellnecesita una opcióncolumnSpanintegrada en su ayudantecell()para construir la fila Total fusionada — no olvide agregarla si reutiliza un ayudantecell()anterior que solo manejawidth/shade.
- Una cadena
-
Construya la Autorización de Consentimiento y Acceso correspondiente para cualquier compromiso que toque nuevos sistemas — no reutilice las filas de la tabla de acceso de un compromiso anterior para una construcción diferente. Misma marca, mismo patrón de tabla rellenable en blanco y negro (Sistema/Cuenta, Elemento Específico, Acceso Concedido, Propósito).
-
Verifique antes de entregar — cada vez: convierta a PDF (el script
soffice.py --headless --convert-to pdfdel skilldocx), renderice a JPG (pdftoppm -jpeg -r 100), y realmenteLeacada imagen de página para confirmar: marca correcta, números de sección secuenciales y referencias cruzadas coincidentes, sin lenguaje de descuento/tarifa estándar que se haya colado, espacios en blanco realmente en blanco (no números obsoletos de un cliente anterior), sin ajuste de línea feo en espacios en blanco cortos, y el total de Construcciones de Automatización realmente igual a la suma de sus filas. Nunca envíe una reconstrucción sin volver a verificar. -
Entregue mediante SendUserFile y registre lo que se construyó + cualquier decisión de precio/estructura en el proyecto/registro de construcción de ese cliente, no en el proyecto general de PWS.
Verificación
- Ninguna cifra en dólares, fecha o número de horas aparece en el documento a menos que Marcos lo haya dado explícitamente
- Sin descuentos matemáticos, porcentajes de ahorro o redacción de "tarifa de primer cliente" en ninguna parte
- Cada servicio recurrente está bajo su propia Sección (pago automático + cancelación de 30 días), nunca dentro de la división única 20/80
- Los números de sección se leyeron del PDF real renderizado, no se asumieron del código
- El Precio Total Inicial de Construcción del Anexo A es igual a la suma de sus elementos de línea completados
- La sección de Honorarios y Pago hace referencia al total del Anexo A en lugar de imprimir su propio espacio en blanco de dólares separado
- Los encabezados de tabla son texto negro en negrita sobre blanco — sin sombreado de color en ninguna parte
- La tabla de retención tiene exactamente tres columnas (Frecuencia | Tarifa | Pago Automático), sin columna de Servicio
- La marca (logotipo, navy/azul/naranja, cuerpo Times New Roman / encabezados Poppins Bold, pie de página) coincide en cada página
- Se recordó que un abogado con licencia en WA debe revisar antes de que cualquier cliente firme realmente