# Auditoria de Tabelas — VF Portal

**Data:** 2026-04-24  
**Metodologia:** grep recursivo em `src/`, `public/apps/`, `templates/`, `routes/`, `public/assets/js/` buscando cada nome de tabela em arquivos `.php` e `.js`. Tabelas com ≥ 1 hit = em uso; 0 hits = possivelmente não utilizada.  
**Bancos:** `mikafo61_portal_auth`, `mikafo61_geral_db`, `mikafo61_mika_db`, `mikafo61_emil_db`, `mikafo61_wp356` (WordPress/WooCommerce, somente leitura).

---

## Tabelas em uso

### portal_auth (`mikafo61_portal_auth`)

| Tabela | Arquivos que referenciam |
|--------|--------------------------|
| `roles` | `src/Auth/RBAC.php`, `src/Models/Admin/Usuario.php`, migrações |
| `permissions` | `src/Auth/RBAC.php`, `src/Models/Admin/Usuario.php`, migrações |
| `role_permissions` | `src/Auth/RBAC.php`, migrações |
| `users` | `src/Models/User.php`, `src/Models/Admin/Usuario.php`, `src/Auth/JWTService.php`, `src/Router/Router.php` |
| `user_permissions` | `src/Auth/RBAC.php`, `src/Models/Admin/Usuario.php` |
| `sessions` | `src/Auth/JWTService.php` |
| `audit_log` | `src/Helpers/Audit.php` |
| `audit_acessos` | `src/Models/Admin/Usuario.php` — log de acessos por sistema (migration 018) |

### geral_db (`mikafo61_geral_db`)

| Tabela | Arquivos que referenciam |
|--------|--------------------------|
| `alugueis_imoveis` | `src/Models/Alugueis/Imovel.php`, `src/Models/Alugueis/Contrato.php`, `src/Controllers/AlugueisController.php` |
| `alugueis_contratos` | `src/Models/Alugueis/Contrato.php`, `src/Controllers/AlugueisController.php` |
| `alugueis_pagamentos` | `src/Models/Alugueis/Pagamento.php`, `src/Controllers/AlugueisController.php` |
| `alugueis_fotos` | `src/Models/Alugueis/Imovel.php`, `src/Controllers/AlugueisController.php` |
| `alugueis_documentos` | `src/Models/Alugueis/Imovel.php`, `src/Controllers/AlugueisController.php` |
| `fluxo_categorias` | `src/Models/Fluxo/Lancamento.php`, `src/Controllers/FluxoController.php` |
| `fluxo_caixa` | `src/Models/Fluxo/Lancamento.php`, `src/Models/Fluxo/WooCommerce.php`, `src/Controllers/FluxoController.php` e outros |
| `fluxo_saldos` | `src/Models/Fluxo/Saldo.php` |
| `fluxo_importados` | `src/Models/Fluxo/Importado.php` |
| `planejamento_itens` | `src/Models/PlanejamentoModel.php` |
| `planejamento_cenarios` | `src/Models/PlanejamentoModel.php` |
| `planejamento_cenario_valores` | `src/Models/PlanejamentoModel.php` |
| `patrimonio_bens` | `src/Models/Fluxo/Patrimonio.php`, `src/Controllers/FluxoController.php` |

### mika_db (`mikafo61_mika_db`)

| Tabela | Arquivos que referenciam |
|--------|--------------------------|
| `controle_producao_itens` | `public/apps/mika_folica/producao/salvar.php`, `public/apps/mika_folica/producao/salvar_opcoes.php`, `public/apps/mika_folica/producao/index.php` |
| `internal_requests` | `public/apps/mika_folica/demandas/index.php`, `demandas/salvar-pi.php`, `demandas/resolver-pi.php`, `producao/salvar-pi.php`, `producao/resolver-pi.php` |
| `mf_apuracoes` | `public/apps/mika_folica/repasse/api/apurar.php` e outros 6 |
| `mf_apuracao_itens` | `public/apps/mika_folica/repasse/api/apurar.php` e outros 7 |
| `mf_escolas` | `public/apps/mika_folica/repasse/api/salvar_escola.php` e outros 7 |
| `mf_regras_repasse` | `public/apps/mika_folica/repasse/api/salvar_regra.php` e outros 6 |
| `mf_regras_repasse_produto` | `public/apps/mika_folica/repasse/api/salvar_regra_produto.php` e outros 2 |
| `onboarding_escolas` | `public/apps/mika_folica/onboarding/api/escolas.php` e outros 3 |
| `onboarding_escola_produtos` | `public/apps/mika_folica/onboarding/api/escolas.php` e outros 2 |
| `onboarding_produtos` | `public/apps/mika_folica/onboarding/api/produtos.php`, `sync-produtos.php`, `index.php` |
| `onboarding_usuarios` | `public/apps/mika_folica/onboarding/alterar-senha.php`, `includes/auth.php` |
| `mika_fornecedores` | `src/Models/Mika/Fornecedor.php` |
| `mika_produtos_tecido` | `src/Models/Mika/Fornecedor.php` |
| `mika_produtos_servico` | `src/Models/Mika/Fornecedor.php` |
| `mika_produtos_revenda` | `src/Models/Mika/Fornecedor.php` |
| `mika_catalogo_links` | `src/Models/Mika/TabelaPrecos.php` |
| `mika_devolucoes` | `src/Models/Mika/Devolucao.php` |
| `mika_devolucoes_historico` | `src/Models/Mika/Devolucao.php` |
| `vendas_metas` | `public/apps/mika_folica/vendas/index.php` |

### emil_db (`mikafo61_emil_db`)

| Tabela | Arquivos que referenciam |
|--------|--------------------------|
| `emil_planos` | `public/apps/emil/producao/index.php` |
| `emil_plano_itens` | `public/apps/emil/producao/index.php`, `apontamento.php` |
| `emil_apontamentos` | `public/apps/emil/producao/index.php` |
| `emil_apontamento_pausas` | `public/apps/emil/producao/index.php` |
| `emil_colaboradores` | `public/apps/emil/producao/index.php`, `apontamento.php`, `colaboradores.php` |
| `emil_logs` | `public/apps/emil/producao/index.php`, `log.php` |
| `emil_pedidos` | `src/Models/Emil/Pedido.php` |
| `emil_pedido_entregas` | `src/Models/Emil/Pedido.php` |

### WordPress (`mikafo61_wp356`) — somente leitura

> ⚠️ Tabelas acessadas com prefixo dinâmico via `WC_TABLE_PREFIX` env var (padrão `wp_`, produção `wpjq_`). O grep não encontra esses nomes literalmente — uso identificado por inspeção manual.

| Tabela (prefixo `wpjq_`) | Arquivos que referenciam |
|--------------------------|--------------------------|
| `wpjq_posts` | `public/apps/mika_folica/producao/index.php`, `repasse/services/woo_service.php`, `src/Models/Fluxo/WooCommerce.php` |
| `wpjq_postmeta` | `public/apps/mika_folica/producao/index.php`, `src/Models/Mika/TabelaPrecos.php`, `src/Models/Fluxo/WooCommerce.php` |
| `wpjq_woocommerce_order_items` | `public/apps/mika_folica/producao/index.php`, `repasse/` |
| `wpjq_woocommerce_order_itemmeta` | `public/apps/mika_folica/producao/index.php`, `repasse/` |
| `wpjq_term_relationships` | `repasse/services/woo_service.php` |
| `wpjq_term_taxonomy` | `public/apps/mika_folica/producao/index.php`, `repasse/` |
| `wpjq_terms` | `public/apps/mika_folica/producao/index.php`, `repasse/` |
| `wpjq_wc_orders` | `src/Models/Fluxo/WooCommerce.php` (WC 7+, fallback para `wpjq_posts`) |
| `wpjq_woocommerce_order_items` | `repasse/api/apurar.php` |

---

## Tabelas possivelmente não utilizadas

| Banco | Tabela | Observação |
|-------|--------|------------|
| `portal_auth` | `password_resets` | Criada no schema inicial para reset de senha por e-mail, nunca implementado. Sem referência em nenhum arquivo. |
| `mika_db` | `producao_ordens` | Schema genérico criado no `mika_db.sql` original. O app de produção usa `controle_producao_itens` (estrutura diferente). Nunca referenciada. |
| `mika_db` | `demandas` | Tabela planejada no schema. O app `/apps/mika_folica/demandas/` usa `internal_requests` — nunca lê `demandas`. |
| `mika_db` | `demandas_comentarios` | Dependente da `demandas` (FK). Nunca referenciada no código. |
| `mika_db` | `vendas_dashboard` | Schema planejado para painel de vendas agregado. Não referenciada — o app `vendas/` lê diretamente do WooCommerce. |
| `mika_db` | `vendas_itens` | Detalhe da `vendas_dashboard`. Sem referências. |
| `mika_db` | `novas_escolas` | Pipeline de prospecção de escolas. Sem referência em nenhum arquivo do portal — possivelmente planejada para fase futura. |
| `mika_db` | `novas_escolas_followups` | Dependente da `novas_escolas`. Sem referências. |
| `mika_db` | `vendas_anotacoes` | Criada na migration 008. Sem referências. |
| `mika_db` | `vendas_snapshots` | Criada na migration 008. Sem referências. |
| `emil_db` | `producao_ordens` | Schema genérico criado no `emil_db.sql` original. O app Emil usa `emil_planos`/`emil_apontamentos`. Nunca referenciada. |
| `emil_db` | `producao_etapas` | Dependente da `producao_ordens` (emil). Sem referências. |
| `emil_db` | `producao_materiais` | Dependente da `producao_etapas`. Sem referências. |
| `emil_db` | `producao_ocorrencias` | Dependente da `producao_ordens` (emil). Sem referências. |

---

## Tabelas com uso indireto ou atenção especial

| Banco | Tabela | Situação |
|-------|--------|----------|
| `mika_db` | `onboarding_usuarios` | Em uso pelo app `/apps/mika_folica/onboarding/` (auth própria). Candidata a migração para SSO portal caso o onboarding seja integrado ao portal principal. |
| `portal_auth` | `audit_acessos` | Criada na migration 018, referenciada em `Usuario.php`. Registra acessos por sistema. Tabela relativamente nova — verificar se está sendo populada em produção. |
| `mika_db` | `vendas_metas` | Referenciada apenas em `public/apps/mika_folica/vendas/index.php`. App standalone simples — tabela existe e é consultada. |
| `geral_db` | `fluxo_importados` | Referenciada em `src/Models/Fluxo/Importado.php` mas funcionalidade de importação CSV não tem rota visível no portal ainda. Tabela existe, model criado, UI não implementada. |

---

## Recomendações

### Seguras para remover (sem referência alguma no código)

1. **`portal_auth.password_resets`** — feature de reset por e-mail nunca implementada. Pode ser removida ou mantida para implementação futura.
2. **`mika_db.producao_ordens`** — substituída funcionalmente por `controle_producao_itens` (schema diferente, uso direto pelo standalone).
3. **`mika_db.demandas`** + **`mika_db.demandas_comentarios`** — o app "Demandas" usa `internal_requests`. Essas duas tabelas existem apenas no schema planejado original.
4. **`mika_db.vendas_dashboard`** + **`mika_db.vendas_itens`** — painel de vendas lê WooCommerce diretamente; essas tabelas de snapshot nunca foram alimentadas.
5. **`mika_db.novas_escolas`** + **`mika_db.novas_escolas_followups`** — pipeline de prospecção planejada, nunca implementada no portal.
6. **`mika_db.vendas_anotacoes`** + **`mika_db.vendas_snapshots`** — criadas na migration 008, sem uso.
7. **`emil_db.producao_ordens`** + **`emil_db.producao_etapas`** + **`emil_db.producao_materiais`** + **`emil_db.producao_ocorrencias`** — schema genérico do `emil_db.sql` original, substituído pelo modelo `emil_planos`/`emil_apontamentos`.

### Manter (em uso ativo)

Todas as demais tabelas listadas em "Tabelas em uso".

### Verificar antes de decisão

- **`onboarding_usuarios`** — em uso, mas candidata a migração para SSO quando o onboarding for integrado ao portal.
- **`fluxo_importados`** — tabela criada e model existente, mas UI de importação ainda não exposta. Manter até a funcionalidade ser implementada ou descartada.

### Nota sobre tabelas WordPress

As tabelas `wpjq_*` são do WordPress/WooCommerce e **não devem ser alteradas pelo portal**. O portal faz apenas leitura (exceto `vendas/index.php` que atualiza status de pedidos). O prefixo real em produção é `wpjq_` — configurado via `WC_TABLE_PREFIX` no `.env`.
