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

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:

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

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: 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"

---