Auto-generated from .context/docs on 2026-02-02T18:54:57.410Z
type: doc name: rules-GEMINI description: Regras fundamentais de comportamento, workflow PREVC e proatividade do agente category: rules generated: 2026-01-23 status: filled scaffoldVersion: "2.0.0"
Este documento detalha as regras e diretrizes que o agente GEMINI segue, com base no ecossistema de contexto e ferramentas do AI Coders Academy. O agente opera com um foco rigoroso em especificações, segurança e um fluxo de trabalho estruturado.
- Idioma: Todas as interações e saídas do agente devem ser em Português do Brasil (PT-BR).
- Pensamento: O raciocínio interno do agente será sempre conduzido em Português antes de qualquer ação ser executada.
- Filosofia: O agente adere estritamente às filosofias de "Especificações antes do código" e "Sem suposições", garantindo que todas as ações sejam baseadas em requisitos claros e validados.
O agente GEMINI não opera de forma autônoma sem supervisão. Ele segue um fluxo de trabalho de cinco etapas universais para garantir a qualidade e a conformidade do projeto:
- P - Planejamento: Definição clara do objetivo ("o que" será construído) antes de qualquer implementação de código.
- R - Revisão: Validação da arquitetura proposta e avaliação de riscos técnicos potenciais.
- E - Execução: Implementação do projeto de acordo com as especificações previamente aprovadas.
- V - Validação: Realização de testes, auditorias de segurança e revisão completa contra o plano original.
- C - Confirmação: Documentação das etapas, realização de commits e finalização do processo.
- Ação Proativa: O agente tem permissão para executar ferramentas de leitura e exploração do código sem a necessidade de solicitar aprovação prévia.
- Contexto Unificado: O diretório
.context/é a fonte primária e única de verdade para todos os playbooks, skills e documentação do projeto. - Zero Placeholder: Todo o conteúdo gerado deve ser real, técnico e funcional, evitando o uso de placeholders ou informações genéricas.
- Integridade: É imperativo proteger absolutamente os arquivos de sessão do WhatsApp (
.wwebjs_auth), garantindo sua integridade e confidencialidade. - Foco Vue 3: O desenvolvimento de front-end prioriza a utilização moderna do Vue 3 no diretório
frontend-vue-3, com ênfase em "Wowed Aesthetics".
O agente GEMINI está integrado e utiliza o servidor MCP ai-context para orquestração de agentes e para manter a consistência e a sanidade do projeto. Em cenários onde o contexto necessite de atualização, o agente está configurado para realizar essas atualizações proativamente.
type: doc name: rules-comuncacao description: Diretrizes de idioma (PT-BR), tom de voz e clareza técnica na comunicação category: rules generated: 2026-01-23 status: filled scaffoldVersion: "2.0.0"
Este documento estabelece as diretrizes fundamentais para a comunicação dentro do projeto TikTickets-zing, visando garantir clareza, padronização e eficácia nas interações. As regras aqui descritas são de cumprimento obrigatório para todas as comunicações, especialmente as geradas automaticamente ou por assistentes virtuais.
As seguintes instruções devem ser rigorosamente seguidas em todas as formas de comunicação:
- Idioma: A comunicação deve ser sempre realizada em português do Brasil. Não há exceções a esta regra.
- Raciocínio: O processo de pensamento e a geração de respostas devem ocorrer em português, refletindo a lógica e o estilo de um falante nativo do idioma.
- Clareza: Utilize uma linguagem natural, clara e direta, adotando um estilo comunicativo típico do português brasileiro. Evite jargões desnecessários e construções complexas.
- Respeito Técnico: Termos técnicos essenciais (como "build", "deploy", "API") devem ser preservados em sua forma original. Contudo, é fundamental que sejam explicados ou contextualizados de maneira natural e compreensível para o público-alvo.
- Correção Automática: Caso a entrada do usuário ou a fonte da comunicação esteja em um idioma diferente do português, o sistema ou comunicador deve converter a mensagem para o português brasileiro automaticamente, sem a necessidade de aviso prévio ao usuário.
O objetivo principal destas diretrizes é assegurar que todas as respostas e comunicações sejam:
- Claras: De fácil entendimento e sem ambiguidades.
- Úteis: Fornecendo informações relevantes e acionáveis.
- Técnicas: Abordando os aspectos técnicos com precisão.
- Em Português Brasileiro: Mantendo a consistência linguística.
- Educadas: Demonstrando respeito e cortesia.
- Objetivas: Focando na informação essencial, sem rodeios.
A adesão a estas diretrizes garante uma comunicação eficiente e coesa em todo o ecossistema do projeto TikTickets-zing.
type: doc name: README description: Índice central de toda a documentação técnica e playbooks do projeto category: navigation generated: 2026-01-23 status: filled scaffoldVersion: "2.0.0"
Este diretório .context/docs/ contém a fonte de verdade técnica e operacional para o desenvolvimento e manutenção do projeto TikTickets-zing v4 Enterprise.
| Guia | Descrição | Status |
|---|---|---|
| 🚀 Visão Geral | O que é o sistema, diferenciais e stack técnica. | ✅ Completo |
| 🏗️ Arquitetura | Camadas, Motor Wbot, Filas BullMQ e Sockets. | ✅ Técnico |
| 📡 Referência de API | Endpoints REST, Auth JWT e API Externa V1. | ✅ Técnico |
| 🔄 Fluxo de Dados | Ciclo de vida da mensagem e eventos de tempo real. | ✅ Detalhado |
| 🗄️ Banco de Dados | Modelos Sequelize e Estratégia Multi-Tenant. | ✅ Estruturado |
| 🛠️ Ferramentas | Setup de IDE, Scripts npm e produtividade. | ✅ Operacional |
| 🛡️ Segurança | Autenticação, segredos e conformidade (LGPD). | ✅ Crítico |
| 🧪 Estratégia de Testes | Jest, Vitest e portões de qualidade. | ✅ Qualidade |
| 📖 Glossário | Terminologia de domínio e conceitos de negócio. | ✅ Referência |
Este repositório foi otimizado para colaboração com IA. Além destes documentos, consulte:
- Playbooks de Agentes: Instruções específicas para diferentes papéis (Arquitetura, Backend, Frontend).
- Skills: Capacidades técnicas detalhadas (Code Review, Bug Investigation, Refactoring).
- Getting Started: Como ligar o projeto em 5 minutos.
- Development Workflow: Regras de branch e padrões de código.
- Regras Gemini: Instruções internas de processamento da IA.
"Código bom é código documentado. Documentação boa é documentação viva."
type: doc name: QA Index README description: Índice de perguntas e respostas técnicas extraídas do código do TikTickets-zing category: navigation status: filled generated: 2026-01-23 scaffoldVersion: "2.0.0"
Tipo de projeto: Web Application (Express + Vue 3)
- How is the codebase organized?
- How does the system isolate data between companies (Multi-Tenancy)?
- How does the system integrate multiple channels (Telegram, WABA, Meta)?
- How does authentication work?
- How is data stored and accessed?
- What API endpoints are available?
- How do real-time features work?
- How do mass messaging campaigns work?
- How do automation flows and chatbots work?
- How does queue and department management work?
- How are statistics and performance reports generated?