# Reestruturação da Integração ComfortClean com Google Sheets
## Objetivo
Reestruturar a integração existente entre o ComfortClean e o Google Sheets para estabelecer uma arquitetura centralizada, confiável e eficiente, garantindo a integridade dos dados e a performance do sistema.
## Regras Gerais
* **Não recriar do zero:** Trabalhar diretamente na estrutura e código atuais.
* **Preservar dados:** Não apagar dados existentes, não criar dados fictícios e não substituir informações reais por exemplos.
* **Manter funcionalidades:** Não remover funcionalidades existentes sem necessidade.
* **Auditoria prévia:** Realizar uma auditoria completa da implementação atual antes de qualquer alteração.
* **Fonte de verdade:** Definir claramente a fonte primária de cada tipo de informação.
* **Evitar duplicação:** Implementar estratégias para evitar duplicação de registros.
* **Testes rigorosos:** Realizar testes reais completos após a implementação.
* **Não usar dados falsos:** Remover simulações de dados e conectar ao fluxo real.
* **Não quebrar o sistema:** Preservar todas as funcionalidades existentes do ComfortClean.
## Etapa 1: Auditoria Obrigatória
Investigar o projeto para identificar:
1. **Localização da integração:** Onde a conexão com o Google Sheets está implementada.
2. **Componentes utilizados:** APIs, funções, Edge Functions, webhooks, variáveis de ambiente, bibliotecas, credenciais.
3. **Recursos do Google Sheets:** Planilha conectada, abas utilizadas, colunas em cada aba.
4. **Fluxo de dados:** Quais dados são lidos ou enviados e para onde.
5. **Dependências do ComfortClean:** Quais partes do sistema dependem dessa integração.
6. **Status da integração:** Identificar erros, conexões quebradas, funções incompletas ou simulações.
**Verificação do fluxo real:**
```mermaid
graph TD
ComfortClean -->|Chamada de Função/API| IntegracaoExistente(Integração Google Sheets Existente)
IntegracaoExistente -->|Dados| GoogleSheets(Google Sheets)
IntegracaoExistente -->|Dados| Supabase(Supabase)
GoogleSheets -->|Retorno de Dados| IntegracaoExistente
Supabase -->|Retorno de Dados| IntegracaoExistente
```
## Etapa 2: Definição da Arquitetura Correta
Adotar a seguinte arquitetura centralizada:
```mermaid
graph LR
GoogleSheets(GOOGLE SHEETS) -->|API / SINCRONIZAÇÃO| Integracao(CAMADA DE INTEGRAÇÃO)
Integracao -->|Dados| Supabase(SUPABASE - BANCO DE DADOS)
Supabase -->|REALTIME| PainelSocio(PAINEL SÓCIO)
Supabase -->|REALTIME| Atendente(ATENDENTE)
Supabase -->|REALTIME| Funcionario(FUNCIONÁRIO)
```
**Regra de Arquitetura:** O frontend do ComfortClean não deve depender de chamadas diretas ao Google Sheets. Toda comunicação deve ser centralizada através da camada de integração e Supabase.
## Etapa 3: Não Apagar a Conexão Existente
* Se a integração existente estiver funcional, aproveitá-la e corrigi-la apenas onde for necessário.
* Identificar precisamente os pontos de falha em conexões quebradas antes de modificar.
* Utilizar exclusivamente as informações reais da configuração e integração existente (credenciais, IDs de planilha, abas, nomes de colunas).
## Etapa 4: Definição da Fonte de Verdade
* **Dados Históricos/Existentes:**
```mermaid
graph TD
DadosExistentes(DADOS EXISTENTES/HISTÓRICOS) --> GoogleSheets(Google Sheets)
GoogleSheets -->|Processo de sincronização| Supabase(Supabase)
Supabase -->|Dados Operacionais| ComfortClean(ComfortClean)
```
* **Dados Operacionais do Sistema:**
```mermaid
graph TD
ComfortClean(ComfortClean) --> Supabase(Supabase)
Supabase --> SistemaOperacional(Sistema Operacional)
```
* O Google Sheets pode ser usado para dados históricos, relatórios, sincronização, exportação e integração administrativa, mas não deve ser a fonte primária para telas operacionais.
## Etapa 5: Fluxo de Sincronização
### Fluxo Google Sheets → ComfortClean
```mermaid
graph TD
GoogleSheets(Google Sheets) -->|API / Webhook / Sincronização| Integracao(Camada de Integração)
Integracao -->|Validação| Supabase(Supabase)
Supabase -->|Realtime| Interface(Interface Atualizada)
subgraph Exemplo
Planilha(Cliente João<br>Serviço: Lavagem de sofá<br>Valor: R$ 500<br>Status: Agendado) -->|SINCRONIZAÇÃO| SupabaseAtualizado(Supabase atualizado)
SupabaseAtualizado -->|REALTIME| PainelComfortClean(Painel do ComfortClean atualizado)
end
```
### Fluxo ComfortClean → Google Sheets
```mermaid
graph TD
ComfortClean(ComfortClean) --> Supabase(Supabase)
Supabase -->|Função Centralizada| Integracao(Google Sheets)
subgraph Estratégia
CRIAR(CRIAR)
ATUALIZAR(ATUALIZAR)
EVITAR_DUPLICACAO(EVITAR DUPLICAÇÃO)
TRATAR_CONFLITOS(TRATAR CONFLITOS)
end
```
* Não implementar duplicação automática de registros.
* Verificar a existência de um identificador correspondente antes de criar um novo registro.
## Etapa 6: Identificadores Únicos
* Cada registro sincronizado deve possuir um identificador único confiável que relacione Supabase e Google Sheets.
* Exemplo conceitual: `ID Supabase <-> ID Integração <-> Linha Google Sheets`.
* Não utilizar apenas nomes como identificadores.
* Implementar estratégia segura para impedir duplicação, atualizações incorretas e sobrescritas de dados.
## Etapa 7: Realtime do ComfortClean
* Utilizar o Supabase Realtime para atualizar interfaces após a centralização dos dados no banco.
* Lógica: `ALTERAÇÃO NO BANCO → SUPABASE REALTIME → TELAS CONECTADAS → ATUALIZAÇÃO AUTOMÁTICA`.
* Para funcionalidades de localização em tempo real, otimizar a estrutura de atualização para não sobrecarregar o banco.
## Etapa 8: Não Usar Dados Falsos
* Realizar busca completa no código por mock data, fake data, dummy data, arrays estáticos, valores temporários ou dados hardcoded.
* Se dados falsos estiverem sendo exibidos, remover a simulação, conectar ao fluxo real e testar com os dados existentes.
## Etapa 9: Não Quebrar o ComfortClean
* Preservar todas as funcionalidades existentes: Clientes, Ordens de Serviço, Agenda, Funcionários, Financeiro, Estoque, Compras, Despesas, Investimentos, Painel do Sócio, Atendimento, Portal do Funcionário, permissões e perfis.
* Verificar dependências antes de alterar tabelas, funções ou fluxos existentes.
## Etapa 10: Teste Real Obrigatório
Executar os seguintes testes após a implementação:
1. **Teste 1:** Buscar dados reais da integração existente.
2. **Teste 2:** Verificar se os dados chegam corretamente ao Supabase.
3. **Teste 3:** Alterar um registro permitido.
4. **Teste 4:** Verificar se a alteração não gera duplicação.
5. **Teste 5:** Verificar se a interface recebe a atualização.
6. **Teste 6:** Verificar o Realtime.
7. **Teste 7:** Criar ou atualizar um registro pelo ComfortClean.
8. **Teste 8:** Verificar a sincronização com o Google Sheets (se aplicável ao fluxo).
## Resultado Final Esperado
A estrutura final deve seguir o diagrama:
```mermaid
graph LR
GoogleSheets(GOOGLE SHEETS<br>Dados existentes<br>Relatórios<br>Sincronização) -->|API / Sincronização| Integracao(CAMADA CENTRAL DE INTEGRAÇÃO<br>API / Functions<br>Validação<br>Sincronização)
Integracao -->|Dados| Supabase(SUPABASE<br>Fonte central operacional)
Supabase -->|REALTIME| PainelSocio(PAINEL SÓCIO)
Supabase -->|REALTIME| Atendente(ATENDENTE)
Supabase -->|REALTIME| Funcionario(FUNCIONÁRIO)
```
## Forma de Execução
1. Executar o trabalho diretamente no código do projeto.
2. Realizar a auditoria da implementação existente.
3. Corrigir e implementar a arquitetura necessária.
4. Não criar integrações paralelas desnecessárias.
5. Não usar dados fictícios, substituir dados reais ou apagar registros.
6. Não alterar funcionalidades fora do escopo sem verificar dependências.
## Confirmação Técnica (Ao Concluir)
Apresentar um relatório técnico detalhado confirmando:
* Localização e funcionamento da integração original.
* Problemas identificados e corrigidos.
* Alterações realizadas.
* Nova fonte de verdade para cada fluxo.
* Funcionamento da sincronização Google Sheets → ComfortClean.
* Funcionamento da sincronização ComfortClean → Google Sheets (se implementado).
* Como o Realtime atualiza as telas.
* Testes reais executados e resultados.
* Problemas encontrados e corrigidos durante os testes.
Bem-vindo à ComfortClean
Acesse sua conta para acompanhar seus serviços.
Ao continuar você concorda com os termos e políticas da ComfortClean.
v1.0.0 · mts8vc4d