# Fase 2.7 — Assistente de Importação Real BARMO

Orquestração guiada para a **primeira carga de dados reais** após a limpeza da base piloto (Fase 2.5). O assistente **não executa** extração, salvamento ou sync — apenas orienta o fluxo usando módulos já existentes.

## Objetivo

Carregar os produtos reais da BARMO na base canônica (`barmo_produtos_canonicos_v1`) e propagar para Estoque e Anúncios, com backups em cada etapa crítica.

## Pré-requisitos

| Requisito | Onde verificar |
|-----------|----------------|
| Backup multi-PC disponível | [`modules/importacao/index.html#persistencia-section`](../modules/importacao/index.html#persistencia-section) ou banner na Central |
| Data Guard ativo (Fase 2.6.0) | [`modules/importacao/index.html#data-guard-section`](../modules/importacao/index.html#data-guard-section) |
| Base piloto limpa *(opcional)* | [`modules/produtos/index.html#limpeza-piloto-section`](../modules/produtos/index.html#limpeza-piloto-section) — alerta na Importação se canônico vazio |

## Onde usar

- **UI:** [`modules/importacao/index.html#assistente-importacao-real-section`](../modules/importacao/index.html#assistente-importacao-real-section)
- **Core:** `assets/js/core/assistente-importacao-real.js` → `BarmoAssistenteImportacaoReal`
- **Atalho Central:** card Importação com badge *Assistente real* → mesma âncora

## Checklist — 7 passos

| # | Passo | Ação | Link |
|---|-------|------|------|
| 1 | **Backup inicial** | Exportar JSON completo multi-PC (`BarmoPersistencia.exportarBackupJSON`) | [Backup multi-PC](../modules/importacao/index.html#persistencia-section) |
| 2 | **Extrair** | Analisar dashboards legados (somente leitura) | [Extrair dashboards](../modules/importacao/index.html#extracao-section) |
| 3 | **Revisar** | Conferir totais, SKUs ausentes, pendências e divergências na prévia | [Relatório da extração](../modules/importacao/index.html#extracao-section) |
| 4 | **Salvar canônico** | Wizard (Etapa 6) **ou** botão *Salvar na base canônica* da extração — com confirmação e backup | [Wizard](../modules/importacao/index.html) · [Extração → Salvar](../modules/importacao/index.html#extracao-section) |
| 5 | **Sync Estoque** | Sincronização manual canônico → Estoque | [Produtos → Sync Estoque](../modules/produtos/index.html#sync-section) |
| 6 | **Sync Anúncios** | Criar rascunhos em Anúncios a partir do canônico | [Produtos → Sync Anúncios](../modules/produtos/index.html#sync-section) |
| 7 | **Backup final** | Exportar novamente para transferir ao PC2 | [Backup multi-PC](../modules/importacao/index.html#persistencia-section) |

Progresso do assistente fica em **`sessionStorage`** (`barmo_assistente_importacao_v1`) — não altera chaves dos dashboards.

## O que NÃO fazer

- **Não pular o backup inicial** — sem snapshot, não há rollback rápido se algo der errado.
- **Não usar auto-save** — extração e importação exigem clique explícito e confirmação.
- **Não sincronizar antes de salvar o canônico** — sync lê `barmo_produtos_canonicos_v1`; base vazia ou piloto gera lixo nos dashboards.
- **Não editar `localStorage` manualmente** no DevTools durante o fluxo — use Data Guard ou backup JSON.
- **Não assumir que Pesquisa entrou na extração** — seed hardcoded no HTML não é lido automaticamente (ver nota Fase 2.6).

## Pós-importação

1. **Sync Estoque** — conferir produtos e quantidades no módulo Estoque.
2. **Sync Anúncios** — revisar rascunhos criados; publicar manualmente no ML/Shopee fora do painel.
3. **Exportar backup para PC2** — importar o JSON na Central ou Importação do segundo computador.
4. Validar DRE e Pesquisa separadamente (não alterados pelo sync Fase 2.4).

## API `BarmoAssistenteImportacaoReal`

| Método | Descrição |
|--------|-----------|
| `renderAssistente(containerId)` | Renderiza/atualiza cards, barra de progresso e dicas contextuais |
| `markStepDone(n)` | Marca passo `1–7` como concluído (sessionStorage) |
| `getProgress()` | `{ concluidos, total, percentual, passos }` |
| `resetProgress()` | Limpa progresso da sessão |

## O que NÃO é alterado

- Lógica interna de Estoque, DRE, Anúncios, Pesquisa.
- `BarmoExtracaoDashboards`, `BarmoImportacao`, `BarmoSyncCanonico` — apenas links e leitura de estado exposto (`getLastRelatorio`).
- Chaves `localStorage` dos dashboards — assistente não grava nelas.

## Próxima etapa

Após carga real validada nos dois PCs: Fase 3 (edição segura no módulo Produtos) ou integração Pesquisa → SKU.