41 lines
2.7 KiB
Markdown
Executable File
41 lines
2.7 KiB
Markdown
Executable File
# Comportamento da IA
|
|
|
|
Este documento define as regras estritas de como a IA deve interagir com o ambiente e o usuário.
|
|
|
|
## Execução de Comandos
|
|
1. **Permissão e Autonomia**: A IA **PODE E DEVE** executar comandos `php` ou `docker` diretamente. É **OBRIGATÓRIO** validar cada alteração com o fluxo de checagem autônomo.
|
|
2. **Fluxo de Trabalho Obrigatório**:
|
|
- Após qualquer edição: Executar `.\sys.ps1 lint` ou `.\sys.ps1 check`.
|
|
- Se houver erros de estilo: Executar `.\sys.ps1 fix` imediatamente.
|
|
- Se houver falhas em testes: Investigar e corrigir antes de reportar ao usuário.
|
|
3. **Método de Execução**:
|
|
- Preferencialmente via Docker: `docker exec -w /app dockersyscms php [comando]`
|
|
- Via script utilitário (Windows): `.\sys.ps1 [comando]` (ex: `test`, `lint`, `fix`, `check`).
|
|
4. **Procedimento para Scripts PHP**:
|
|
- Quando for necessário executar lógica PHP complexa:
|
|
1. Crie um script PHP na pasta `scripts/`.
|
|
2. Execute-o diretamente via Docker ou `sys.ps1`.
|
|
4. **Validação via HTTP (Opcional)**:
|
|
- Se preferir, a IA ainda pode usar a validação via HTTP (`Invoke-WebRequest`), mas a execução direta via Docker é preferencial para tarefas administrativas.
|
|
|
|
## Operações de Banco de Dados
|
|
1. **Acesso Direto**: A IA tem permissão para executar consultas SQL diretamente no banco de dados do container.
|
|
2. **Método de Execução**:
|
|
- Utilize o cliente mysql dentro do container:
|
|
- Sintaxe: `docker exec dockersyscms mysql -u root -proot -D syscms -e "SUA_QUERY_AQUI"`
|
|
- Para queries complexas ou dumps, considere criar um arquivo `.sql` temporário e executá-lo via redirecionamento de entrada, ou usar scripts PHP.
|
|
3. **Segurança**:
|
|
- Tenha cautela com operações destrutivas (`DROP`, `DELETE`, `TRUNCATE`).
|
|
- Sempre verifique o ambiente antes de rodar queries de modificação em massa.
|
|
|
|
## Criação e Edição de Arquivos
|
|
1. **Não criar arquivos desnecessários**: Só crie arquivos se forem essenciais para a tarefa.
|
|
2. **Preferir edição**: Sempre tente editar arquivos existentes antes de criar novos.
|
|
3. **Documentação**: Não crie arquivos `.md` ou `README` a menos que explicitamente solicitado.
|
|
|
|
## Respostas e Idioma
|
|
1. **Idioma**: Responda sempre no idioma solicitado pelo usuário (padrão: Português).
|
|
2. **Código**: Comentários no código devem ser **OBRIGATORIAMENTE em Inglês** e seguir o padrão **PHPDoc**.
|
|
- Strings de usuário (mensagens de erro, interface) mantêm-se no idioma da aplicação.
|
|
3. **Assertividade**: Seja proativo. Se uma instrução for ambígua, assuma a ação mais lógica e execute-a. Não peça confirmação para cada passo trivial.
|