--- fonte: 01-canonicos/seed-praticas.md versao_da_fonte: v0.1 secao: 09 titulo: "Proposta comercial — estrutura (maio/2026)" sequencia: 11 de 17 bytes_do_corpo: 16360 md5_do_corpo: f051044de4af2db1c3e038a603e78054 gerado_por: 06-validacao/geradores/gen-camada-ia.py nota: fatia GERADA — o corpo abaixo é byte a byte o trecho do canônico; edite o canônico, nunca esta fatia. Canônico inteiro em https://ds.seed.eng.br/01-canonicos/seed-praticas.md --- ## 9. Proposta comercial — estrutura (maio/2026) > **Origem:** `seed-ds-proposta/references/estrutura-proposta-seed.md` (skill de 2026-05-13, 15706 bytes, MD5 `584de4715f4e09ef9d16026a0dbc4e9b`; cópia preservada em `09-pesquisa/skills-v1-2026-05/referencias/estrutura-proposta-seed.md`) · **Importado em 2026-09-06 sem edição** — só os títulos foram rebaixados dois níveis (código intacto). > > **Estado: ⚠ não auditado contra o DS v2.** Contradições medidas — vale a regra de precedência do cabeçalho: 7 cor(es) em hex — só os tokens do `seed-tokens.json` valem (marca §3, §11). ### Estrutura modular de proposta SEED — 2 modos Reference exclusiva da skill `seed-ds-proposta`. Define os dois sub-modos da skill: **curto** (Excel + PDF, 1-2 páginas, default operacional) e **longo** (Word + PDF, 4-8 páginas, modular). **Regra dura:** a skill NUNCA decide sozinha qual modo aplicar. Pergunta no briefing — Rafael decide caso a caso. --- #### Modo CURTO — Excel + PDF **Filosofia:** densidade visual, escopo direto, sem overhead institucional. Para cliente que já conhece a SEED, com escopo claro, decisão rápida. **Saídas:** - `.xlsx` editável (Rafael ajusta valores depois conforme negociação) - `.pdf` final (envio ao cliente) **Páginas:** 1-2 (segunda só se houver tabela de materiais detalhada) **Estrutura visual canônica** (8 blocos): ``` ┌────────────────────────────────────────────────────┐ │ [logo SEED] SEED-NNNN-AAAA │ altura ~70px │ DD/MM/AAAA │ fundo branco ├════════════════════════════════════════════════════┤ ← faixa turquesa 11B0A0 │ PROPOSTA · {Título descritivo} │ altura ~50px │ {Tipo de obra} · {Cidade/UF} │ texto branco ├────────────────────────────────────────────────────┤ │ CLIENTE CONTATO │ 2 colunas │ {Nome do cliente} {Telefone} │ borders flat │ CPF/CNPJ {número} {email} │ │ [A/C: {pessoa} — opcional se PJ] │ ├─ OBJETIVO ─────────────────────────────────────────┤ ← linha turquesa fina │ {1-2 frases descritivas} │ ├─ ESCOPO ───────────────────────────────────────────┤ │ 1. {Item principal — bold turquesa 11pt} │ │ 1.1 {Sub-item — regular cinza 10pt} │ │ 1.2 {...} │ │ 2. {Item principal} │ │ 2.1 {...} │ ├─ OBSERVAÇÕES ──────────────────────────────────────┤ │ • {Observação 1} │ │ • {Observação 2 — destaque se valor estimado} │ ├─ EXCLUSÕES ────────────────────────────────────────┤ │ • {O que NÃO está incluso} │ ├─ INVESTIMENTO ─────────────────────────────────────┤ │ │ │ R$ {valor} │ número 36pt turquesa │ {Descrição do que inclui} │ 10pt cinza │ │ │ {Forma pagto} · {Frete} · Validade {N} dias │ ├════════════════════════════════════════════════════┤ ← rodapé turquesa-deep │ SEED engenharia · seed.eng.br · 0800 591 5374 │ texto branco 9pt └────────────────────────────────────────────────────┘ ``` ##### Campos do cabeçalho (reformulados) **Cabeçalho técnico (topo direito):** - Código SEED-NNNN-AAAA (rastreabilidade ERP) - Data emissão DD/MM/AAAA **Faixa de identificação (turquesa):** - "PROPOSTA · {Título}" — exemplos: "Ampliação Fotovoltaica", "Subestação Industrial 300 kVA", "Diagnóstico 360°" - "{Tipo} · {Cidade/UF}" — exemplos: "Residencial · Aimorés/MG", "Industrial · Itabira/MG" **Bloco cliente (2 colunas):** - CLIENTE: nome + CPF/CNPJ - CONTATO: telefone + email - A/C: opcional (só se PJ com interlocutor específico) ##### Página 2 (opcional — materiais) Quando proposta envolve fornecimento de materiais detalhado: ``` ┌─ MATERIAIS ────────────────────────────────────────┐ │ ITEM PRODUTO UN QNT VALOR │ │ 1.1 {Descrição} un XX R$ X │ │ 1.2 {Descrição} kit XX R$ X │ │ ... │ │ TOTAL R$ XXX,XX│ └────────────────────────────────────────────────────┘ ``` Header turquesa, sem decorative bars, números à direita, descrição à esquerda. ##### Tipografia modo curto - **Família:** Montserrat (fallback Arial) - **Logo:** 1.2" largura no topo esquerdo - **Código + data:** 9pt regular, cinza - **Faixa turquesa título:** 14pt SemiBold, branco - **Faixa turquesa subtítulo:** 11pt Regular, branco - **Labels (CLIENTE/CONTATO):** 9pt SemiBold UPPERCASE, cinza - **Conteúdo de campos:** 11pt Regular, text-dark - **Cabeçalho de seção (OBJETIVO/ESCOPO/etc):** 9pt SemiBold UPPERCASE turquesa + linha 1pt turquesa abaixo - **Item principal escopo (1.0/2.0):** 11pt SemiBold turquesa - **Sub-item escopo (1.1/1.2):** 10pt Regular cinza - **Valor investimento:** 36pt Bold turquesa - **Rodapé:** 9pt Regular branco ##### Cores (paleta SEED canônica) - Faixa identificação: `--turquesa #11B0A0` - Rodapé: `--turquesa-deep #0a8478` - Linhas separadoras de seção: `--turquesa #11B0A0` 1pt - Texto principal: `--text #2a3942` - Texto secundário: `--cinza #617683` - Cabeçalho de seção: `--turquesa #11B0A0` - Borders flat de tabela materiais: `--cinza-border #e1e6ea` ##### Implementação técnica (openpyxl) Modo curto usa `openpyxl` (via skill `xlsx` em composição). Pontos críticos: ```python from openpyxl import Workbook from openpyxl.styles import Font, PatternFill, Alignment, Border, Side from openpyxl.drawing.image import Image # Fonts canônicos F_TITULO = Font(name='Montserrat', size=14, bold=True, color='FFFFFF') F_SUBTITULO = Font(name='Montserrat', size=11, color='FFFFFF') F_SECAO = Font(name='Montserrat', size=9, bold=True, color='11B0A0') F_LABEL = Font(name='Montserrat', size=9, bold=True, color='617683') F_CONTEUDO = Font(name='Montserrat', size=11, color='2A3942') F_ITEM = Font(name='Montserrat', size=11, bold=True, color='11B0A0') F_SUBITEM = Font(name='Montserrat', size=10, color='617683') F_VALOR = Font(name='Montserrat', size=36, bold=True, color='11B0A0') F_RODAPE = Font(name='Montserrat', size=9, color='FFFFFF') # Fills FILL_TURQUESA = PatternFill('solid', start_color='11B0A0', end_color='11B0A0') FILL_TURQUESA_DEEP = PatternFill('solid', start_color='0A8478', end_color='0A8478') # Border-bottom turquesa pra separar seções BORDER_SECAO = Border(bottom=Side(style='thin', color='11B0A0')) ``` **Geometria padrão:** - Página A4 retrato (210×297mm) - Margens: 0.5 inch (top/bottom/left/right) - Largura das colunas: usar `column_dimensions` com larguras explícitas - Logo: inserir via `Image()` posicionado em `A1` com offset **Conversão pra PDF:** `soffice --headless --convert-to pdf arquivo.xlsx --outdir .` (LibreOffice nativo, fidelidade alta). --- #### Modo LONGO — Word + PDF **Filosofia:** estrutura modular, núcleo obrigatório + módulos opcionais. Sem overhead boilerplate. Cliente recebe APENAS as seções que fazem sentido para o caso. **Saídas:** - `.docx` editável (skill `docx` cuida da geração técnica) - `.pdf` final **Páginas:** 4-8 típico (depende dos módulos acionados) ##### Núcleo obrigatório (4 seções, sempre) | # | Seção | Função | Páginas | |---|---|---|---| | 1 | **Capa** | Identidade SEED + título da proposta + cliente + data + código | 1 | | 2 | **Escopo do serviço** | O que será feito (numeração 1.0/1.1/1.2 — mesmo formato modo curto) | 1-2 | | 3 | **Investimento + condições** | Valor + forma de pagamento + validade + frete | 1 | | 4 | **Próximos passos + aceite** | Cronograma sintético + linha de assinatura | 1 | ##### Módulos opcionais (briefing aciona) Skill pergunta no briefing: *"Além do núcleo, quais módulos: [ ] sumário [ ] sobre SEED [ ] metodologia [ ] garantias [ ] anexos"*. Rafael marca. | Módulo | Quando incluir | Páginas | |---|---|---| | **Sumário executivo** | Quando proposta passa de 5 páginas — vale resumir no topo (1ª página depois da capa) | 1 | | **Sobre a SEED** | Quando cliente é novo / primeira proposta da relação | 1 | | **Metodologia técnica** | Projetos complexos: diagnóstico, dimensionamento detalhado, regulatório | 1-2 | | **Garantias e SLA** | Contrato vultoso ou cliente exige explicitamente | 1 | | **Anexos** | Por demanda: ART, datasheets de equipamento, layout, simulação financeira | variável | ##### Capa modo longo (1ª página) ``` ┌────────────────────────────────────────────────────┐ │ │ │ │ │ [logo SEED grande centralizado] │ │ │ │ │ │ PROPOSTA COMERCIAL │ │ {Título descritivo} │ │ │ │ │ │ Para: {Cliente} │ │ Local: {Cidade/UF} │ │ Data: DD/MM/AAAA │ │ Código: SEED-NNNN-AAAA │ │ │ │ │ │ [onda decorativa SEED base] │ │ SEED engenharia · seed.eng.br · 0800 591 5374 │ └────────────────────────────────────────────────────┘ ``` Fundo branco. Logo grande no centro (largura 4"). Título principal Montserrat Bold 28pt turquesa. Subtítulo (título da proposta) Montserrat Regular 20pt text-dark. Dados em Montserrat Regular 12pt cinza. Onda decorativa SEED na base (SVG dos assets). Rodapé fino turquesa-deep com contato. ##### Sumário executivo (módulo) Estrutura sugerida (1 página): - **Objetivo** (1 parágrafo): por que a proposta existe - **Solução proposta** (3 bullets máximo): o que a SEED entrega - **Investimento e prazo** (2 linhas): valor total + prazo execução - **Próximos passos** (1 linha): "Aceite até DD/MM/AAAA" Quando proposta passa de 5 páginas, esse módulo poupa tempo do decisor. ##### Sobre a SEED (módulo) Conteúdo padrão (1 página): - 1 parágrafo institucional (de `empresa.md`) - 3 stats: "10 anos no mercado · 200+ projetos · ES/MG/BA/GO/TO" - 1 parágrafo sobre diferenciais (técnico + regulatório + suporte) - 3-4 logos/nomes de clientes referência (com autorização) **NÃO incluir** se cliente já te conhece — overhead puro. ##### Metodologia técnica (módulo) Estrutura típica (1-2 páginas): - **Fase 1 — Diagnóstico** (visita técnica, análise de consumo, identificação de oportunidades) - **Fase 2 — Dimensionamento** (cálculos, simulação, especificação técnica) - **Fase 3 — Projeto e regularização** (ART, protocolo concessionária) - **Fase 4 — Execução** (mobilização, instalação, comissionamento) - **Fase 5 — Operação assistida** (start-up, monitoramento, treinamento) Acionar quando o projeto técnico justifica explicar o método (Diagnóstico 360°, projetos industriais complexos, subestações). ##### Garantias e SLA (módulo) Estrutura típica (1 página): - Garantia de componentes (módulos, inversores, estrutura) com prazo de fabricante - Garantia de instalação SEED (12-24 meses, conforme escopo) - SLA de atendimento (resposta inicial em X horas úteis) - O&M (Operação e Manutenção) se ofertado ##### Anexos (módulo) Por demanda — ART, datasheets, layout, simulação financeira PVsyst, ofícios. ##### Investimento + condições (núcleo) Estrutura (1 página): ``` INVESTIMENTO R$ {valor total} {Descrição do que inclui} DETALHAMENTO Serviço: R$ {valor} Material: R$ {valor} Projeto: R$ {valor} ───────────── TOTAL: R$ {valor} CONDIÇÕES COMERCIAIS Forma de pagamento: {À vista antecipado | 50/50 | etc} Disponibilidade: {Imediata | A combinar | dd/mm/aaaa} Validade: {N} dias Frete: {CIF | FOB} ``` Valor total em destaque (Montserrat Bold 36pt turquesa). Detalhamento opcional (depende se escopo separa Serviço/Material/Projeto). ##### Próximos passos + aceite (núcleo) Estrutura (1 página, sempre a última): - Cronograma sintético em 4-5 marcos (semanas, não datas absolutas — fica flexível) - Linha de aceite com nome do cliente + CPF/CNPJ + assinatura + data - Linha de aceite SEED (Rafael ou responsável comercial) --- #### Decisão de modo — checklist Pergunta-chave no briefing: **"Modo curto (1-2 páginas, planilha Excel) ou longo (Word com seções)?"** Sinais que indicam CURTO (mas Rafael decide): - Cliente já te conhece (não é primeira proposta) - Escopo claro, sem complexidade técnica - Valor de contrato baixo a médio (R$ 30k-300k típico) - Decisão rápida esperada (validade 7-15 dias) - Reposta a pedido específico do cliente Sinais que indicam LONGO (mas Rafael decide): - Cliente novo precisa do "quem somos" - Licitação ou processo formal com seções obrigatórias - Projeto técnico complexo (Diagnóstico 360°, subestação, projeto regulatório) - Contrato vultoso (acima R$ 300k típico) - Cliente solicita anexos múltiplos (ART, simulação, layout) **Skill NÃO infere automaticamente.** Pergunta. Sempre. --- #### Anti-padrões verificados (não repetir) 1. **Modo curto com narrativa institucional ("a SEED é uma empresa...")** → vira modo longo mal feito 2. **Modo longo com todas as 14 seções por default** → 80% boilerplate, cliente pula 3. **Decisão automática de modo pela skill** → Rafael perde controle, vira surpresa ruim 4. **Modo curto sem código SEED-NNNN-AAAA** → perde rastreabilidade no ERP 5. **Modo curto sem 0800 no rodapé** → perde canal imediato (issue conhecido SEED) 6. **Modo curto com logo gigante quebrando densidade** → logo 1.2" max 7. **Modo curto convertido pra PDF com fontes substituídas** → embeddar Montserrat ou aceitar fallback Arial documentado 8. **Modo longo sem opção de módulos** → vira "tudo ou nada" e perde flexibilidade 9. **Valor R$ sem destaque** (em meio a tabela) → bloco INVESTIMENTO precisa respirar 10. **Grafia "SEED Engenharia"** ou "seed engenharia" → sempre "SEED engenharia" ---