9. Proposta comercial — estrutura

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).

Revisão: conteúdo revisado em 2026-09-08 · ciclo de 6 meses (V-B3 = A) · vence em 2027-03-08

Estado: ✅ auditada em 2026-09-08 (F9.8, onda 2). Os dois modos e os layouts foram mantidos. Corrigidas as três cores divergentes que a §7.0 mediu (a mais séria é o texto principal) e nomeada a pendência PB-P4 sobre a série do código da proposta. Ver 9.0.

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.

9.0 O que a auditoria de 2026-09-08 corrigiu#

⚠ O que esta seção não consegue provar: nada de desempenho — é estrutura de documento. Tudo aqui é [SEED], e o canon de marca vence sobre qualquer valor escrito nesta seção.

• ⛔ Três cores estavam desatualizadas, pelas mesmas medições da §7.0: texto principal #2a3942 → #0B3330 (seed.semantic.text.primary), rodapé #0a8478 → #006C62 (seed.semantic.surface.brand-deep), borda de tabela #e1e6ea → #E3EBF0 (seed.semantic.border.subtle). Toda proposta gerada até aqui saiu com o corpo de texto fora da cor da marca.
• ⛔ Dado institucional não vem desta seção nem do empresa.md de maio/2026 — vem do sobreaseed.md, e a matriz é Governador Valadares / MG (Rua Duarte Coelho, 205), com Baixo Guandu / ES e São Félix do Coribe / BA como filiais. Ver §8.1.
• ✅ PB-P4 MEDIDA e FECHADA do lado do DS em 2026-09-11 — a série do código da proposta. O formato SEED-NNNN-AAAA existia só aqui: nenhum outro canônico do DS o define. Medido no ERP (seed-erp/supabase/migrations/20260903024527_bloco5b_orcamentos.sql, lido em 2026-09-11): o orçamento comercial é numerado como sequencia 1..N por card e cada revisão como numero 1..N por orçamento, atribuídos por trigger sob lock, sem código humano — não existe SEED-NNNN-AAAA em lugar nenhum do sistema. Conclusão para esta base: o DS não emite série; os layouts da §9 mostram o marcador {{código da proposta}}, e a peça recebe o número que o ERP der. Achado que fica com o ERP (e com ele): pela regra dele de 2026-09-03 — "pergunto se nao seria interessante a tarefa ter numeraçao (…) e sirva de pratica analisar para demais que aparecerem" —, a proposta é ente que cliente e vendedor citam por telefone, e hoje não tem referência humana; a série (formato, contadora, ano) é decisão do projeto do SIGA (Sistema Integrado de Gestão Assistida), não desta base. O texto original desta pendência dizia: "o ERP em construção vai precisar emitir esse número." Pela regra da casa, número de série vem do servidor e a contadora é única. Enquanto a decisão não for tomada, o formato desta seção é convenção provisória — não replicar em sistema antes de o SIGA declarar a série.

---

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]           {{código da proposta}}       │  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 da proposta — {{código da proposta}}, emitido pelo SIGA (rastreabilidade); o DS não define a série (PB-P4)
• 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)#

Valores conferidos contra o seed-tokens.json v1.23 em 2026-09-08. Derivar do arquivo de token, não digitar (§7.0).

Implementação técnica (openpyxl)#

Modo curto usa openpyxl (via skill xlsx em composição). Pontos críticos:

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='0B3330')   # text.primary (era 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='006C62', end_color='006C62')  # surface.brand-deep (era 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)#

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.

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: {{código da proposta}}          │
│                                                    │
│                                                    │
│            [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 — do sobreaseed.md, nunca do empresa.md de maio/2026 (§8.1)
• 3 números, todos do sobreaseed.md. ⛔ A linha que estava aqui até a v0.5 dizia "10 anos no mercado · 200+ projetos · ES/MG/BA/GO/TO" e tinha dois erros graves para um documento que vai ao cliente: os números reais são mais de 1.000 obras (mais de 400 só na Bahia) e mais de 50.000 painéis instalados — "200+ projetos" subestima em cinco vezes e não veio de lugar nenhum; e Goiás e Tocantins não são área de atendimento da SEED, que atende Espírito Santo, Minas Gerais e Bahia, com expansão para estados vizinhos. Afirmar cobertura que não existe, numa proposta, é problema comercial e contratual, não de redação
• 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 o código da proposta → perde rastreabilidade no SIGA
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"

---