# Roadmap de Implementação — Golden Factory v2

Plano de fases para o desenvolvimento, validação e implantação da versão 2.0 em paralelo com o sistema atual.

---

## Cronograma em Fases

```mermaid
flowchart TD
    Fase1["Fase 1: Fundação & Infraestrutura Central<br/>(Banco SQLite, API Router, CSS Theme)"]
    Fase2["Fase 2: Núcleo de Engenharia & Almoxarifado<br/>(Molde, Peça Piloto, Insumos BOM, Custos)"]
    Fase3["Fase 3: Setores Produtivos na v2<br/>(Corte, Bordado, Serigrafia, DTF, Costura, Acabamento)"]
    Fase4["Fase 4: Expedição, Hub de Produção & Relatórios<br/>(Painéis, TV Relógio, Balanço de Perdas)"]
    Fase5["Fase 5: Testes de Campo & Virada de Chave<br/>(Piloto com operadores, migração final, corte da v1)"]

    Fase1 --> Fase2
    Fase2 --> Fase3
    Fase3 --> Fase4
    Fase4 --> Fase5
```

---

## Detalhamento das Fases

### Fase 1: Fundação & Infraestrutura Central
- [ ] **Banco de Dados SQLite v2**:
  - Definir `v2/database/schema.sql` completo com chave estrangeiras (`FOREIGN KEY`), índices e integridade referencial.
  - Script para conectar o SQLite em modo WAL com timeout seguro e transações.
- [ ] **API Router Centralizado**:
  - Implementar `/v2/api/index.php`, roteador para controllers, handler de sessão/auth unificado e middleware de resposta JSON padronizada (`{ ok, data }` / `{ ok, error }`).
- [ ] **Design System Duck Golden (CSS)**:
  - Criar `theme.css` com paleta de cores oficial, variáveis, tipografia e reset.
  - Criar `components.css` com botões, cards, tabelas de grade universal, modais e formulários.
  - Criar `layout.css` com header/sidebar de navegação limpa.
- [ ] **Portal de Entrada v2**:
  - `v2/index.html` com dashboard moderno e atalhos rápidos para todos os módulos.

---

### Fase 2: Núcleo de Engenharia (Molde / Peça Piloto) & Almoxarifado
- [ ] **Migração do Almoxarifado para SQLite**:
  - Migrar `itens.json` e `movimentacoes.json` para tabelas relacionais `almoxarifado_itens` e `almoxarifado_movimentacoes`.
  - Endpoint de listagem rápida e busca de insumos com preço unitário atualizado.
- [ ] **Módulo Peça Piloto & Molde (BOM)**:
  - Cadastro de molde com foto, tabela de medidas e tecidos.
  - Adição de insumos do almoxarifado (etiquetas, viés, vivo, botões, elásticos).
  - Calculadora de custo unitário em tempo real (tecido + aviamentos + beneficiamento).
  - Exportação de ficha técnica para PDF/impressão limpa para a oficina de costura.

---

### Fase 3: Setores Produtivos na v2 (Corte ao Acabamento)
- [ ] **Padronizador de Grades Universal**:
  - Componente JS reutilizável para renderizar e validar grades (`adulto`, `infantil`, `numerico`).
- [ ] **Corte**:
  - Lançamento de lotes base, recortes e golas com vínculo opcional ao molde/peça piloto.
  - Explosão de materiais: alerta de estoque de aviamentos no momento do corte.
- [ ] **Bordado, Serigrafia e DTF**:
  - Telas redesenhadas sem CSS inline, com foco em botões grandes e poucos cliques.
  - Persistência direta em SQLite via transações atômicas.
- [ ] **Costura**:
  - Conferência automática com o cortado.
  - Interface otimizada para operador de chão de fábrica.
- [ ] **Acabamento**:
  - Lançamento de saída, retorno de conserto e perda definitiva com cálculo de saldo em aberto via consultas SQL instantâneas.

---

### Fase 4: Expedição, Hub de Produção & Relatórios
- [ ] **Expedição**:
  - Divisão de fardos para lojas (`castanheira`, `icoaraci`, `lounge`) e atacado.
  - Romaneios de entrega e histórico unificado.
- [ ] **Hub de Produção**:
  - Relatórios de produtividade por período, setor e coleção com agregadores SQL rápidos (`SUM`, `COUNT`, `GROUP BY`).
  - Monitor geral da fábrica com atualização leve.
- [ ] **Painel de TV (Relógio)**:
  - Visualização em tela cheia com metas, turno e aniversariantes lendo do SQLite.

---

### Fase 5: Testes de Campo, Auditoria e Virada de Chave
- [ ] **Ambiente de Homologação**:
  - Operadores testam a navegação no endereço `heitor.net.br/goldenfactory2/v2/`.
  - Coleta de feedbacks de usabilidade (tamanho de fonte, botões, agilidade de digitação).
- [ ] **Script de Migração Final (JSON ➔ SQLite v2)**:
  - Carga completa de todo o histórico dos anos anteriores para o banco v2.
  - Verificação de integridade e paridade dos números.
- [ ] **Virada de Chave**:
  - Redirecionar o tráfego da raiz para a v2 com segurança.