.cursorrules

# Project Rules and Guidelines

> Auto-generated from .context/docs on 2026-02-02T18:54:57.410Z

## rules-GEMINI

---
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"
---

# Regras do Agente (GEMINI)

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.

## Diretrizes de Resposta

*   **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.

## Fluxo de Trabalho (PREVC)

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:

1.  **P - Planejamento**: Definição clara do objetivo ("o que" será construído) antes de qualquer implementação de código.
2.  **R - Revisão**: Validação da arquitetura proposta e avaliação de riscos técnicos potenciais.
3.  **E - Execução**: Implementação do projeto de acordo com as especificações previamente aprovadas.
4.  **V - Validação**: Realização de testes, auditorias de segurança e revisão completa contra o plano original.
5.  **C - Confirmação**: Documentação das etapas, realização de commits e finalização do processo.

## Regras de Ação

*   **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".

## Conectado ao Ecossistema

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.


## rules-comuncacao

---
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"
---

# Diretrizes de Comunicação

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.

## Instruções Permanentes

As seguintes instruções devem ser rigorosamente seguidas em todas as formas de comunicação:

1.  **Idioma**: A comunicação deve ser sempre realizada em português do Brasil. Não há exceções a esta regra.
2.  **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.
3.  **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.
4.  **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.
5.  **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.

## Objetivo Geral

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.


## README

---
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"
---

# Central de Conhecimento - TikTickets-zing

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**.

## 🗺️ Mapa de Documentação

| Guia | Descrição | Status |
| :--- | :--- | :--- |
| 🚀 **[Visão Geral](./project-overview.md)** | O que é o sistema, diferenciais e stack técnica. | ✅ Completo |
| 🏗️ **[Arquitetura](./architecture.md)** | Camadas, Motor Wbot, Filas BullMQ e Sockets. | ✅ Técnico |
| 📡 **[Referência de API](./api.md)** | Endpoints REST, Auth JWT e API Externa V1. | ✅ Técnico |
| 🔄 **[Fluxo de Dados](./data-flow.md)** | Ciclo de vida da mensagem e eventos de tempo real. | ✅ Detalhado |
| 🗄️ **[Banco de Dados](./database.md)** | Modelos Sequelize e Estratégia Multi-Tenant. | ✅ Estruturado |
| 🛠️ **[Ferramentas](./tooling.md)** | Setup de IDE, Scripts npm e produtividade. | ✅ Operacional |
| 🛡️ **[Segurança](./security.md)** | Autenticação, segredos e conformidade (LGPD). | ✅ Crítico |
| 🧪 **[Estratégia de Testes](./testing-strategy.md)** | Jest, Vitest e portões de qualidade. | ✅ Qualidade |
| 📖 **[Glossário](./glossary.md)** | Terminologia de domínio e conceitos de negócio. | ✅ Referência |

## 🤖 Contexto para Agentes de IA

Este repositório foi otimizado para colaboração com IA. Além destes documentos, consulte:
- **[Playbooks de Agentes](../agents/README.md)**: Instruções específicas para diferentes papéis (Arquitetura, Backend, Frontend).
- **[Skills](../skills/README.md)**: Capacidades técnicas detalhadas (Code Review, Bug Investigation, Refactoring).

## 📌 Links Rápidos para Implementação
- **[Getting Started](./getting-started.md)**: Como ligar o projeto em 5 minutos.
- **[Development Workflow](./development-workflow.md)**: Regras de branch e padrões de código.
- **[Regras Gemini](./rules-GEMINI.md)**: Instruções internas de processamento da IA.

---

> "Código bom é código documentado. Documentação boa é documentação viva."


## README

---
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"
---

# Q&A Index

Tipo de projeto: **Web Application (Express + Vue 3)**

## Getting-started

- [How do I set up and run this project?](./getting-started.md)

## Architecture

- [How is the codebase organized?](./project-structure.md)
- [How does the system isolate data between companies (Multi-Tenancy)?](./multi-tenancy.md)
- [How does the system integrate multiple channels (Telegram, WABA, Meta)?](./multi-channel.md)

## Features

- [How does authentication work?](./authentication.md)
- [How is data stored and accessed?](./database.md)
- [What API endpoints are available?](./api-endpoints.md)
- [How do real-time features work?](./realtime.md)
- [How do mass messaging campaigns work?](./campaigns.md)
- [How do automation flows and chatbots work?](./automation-flows.md)
- [How does queue and department management work?](./queue-management.md)
- [How are statistics and performance reports generated?](./statistics-reports.md)

## Operations

- [How does caching work?](./caching.md)
- [How are errors handled?](./error-handling.md)
- [How do background jobs work?](./background-jobs.md)
- [How are WhatsApp sessions managed and recovered (Wbot Lifecycle)?](./wbot-lifecycle.md)
- [How does the system manage media download and storage?](./media-handling.md)
- [How do I deploy this project?](./deployment.md)