context agent

DOCUMENTACAO/templates/modulo.yml.template

@@ -2,7 +2,7 @@
 # Este arquivo é obrigatório na raiz de todos os projetos que utilizam .agent.
 # Ele define a identidade oficial e as configurações de rota do módulo.
 
-# Identificador único do módulo (utilizado para pacotes, wikis <modulo-wiki>/<modulo-id>/, regras de negócio e sessão isolada do agent-browser --session <modulo-id>)
+# Identificador único do módulo (utilizado para pacotes, wikis <modulo-wiki>/<modulo-id>/, regras de negócio e sessão isolada do agent-browser --session <modulo-id>_<contexto?>)
 modulo-id: nome-do-modulo.submodulo
 
 # Rota/prefixo utilizado na URL e navegação do módulo (com barras inicial e final)
@@ -14,10 +14,24 @@ modulo-descricao: Descrição detalhada do módulo para contextualização opera
 # Descrição da arquitetura, stack tecnológica e banco de dados
 modulo-tipo: aplicação web com back e front nas tecnologias bun e vue 3 com banco postgres
 
-# Credenciais padrão para autenticação em testes (agent-browser, E2E, QA)
+# Credenciais para autenticação em testes (agent-browser, E2E, QA)
+# Formato Simples (aplicação com perfil único de acesso):
 modulo-acesso:
   usuario: usuario@exemplo.com.br
   senha: "123"
 
+# Ou Formato Multi-Contexto (quando a aplicação possui acessos distintos - evita mistura de tokens):
+# modulo-acesso:
+#   interno:
+#     usuario: operador@empresa.com.br
+#     senha: "123"
+#   cliente:
+#     usuario: cliente@cliente.com.br
+#     senha: "123"
+#   externo:
+#     usuario: cidadao@gov.br
+#     senha: "123"
+#   anonimo: null # acesso público/deslogado
+
 # Caminho para a Wiki do projeto (quando omitido ou vazio, o padrão adotado é ../wiki/)
 modulo-wiki: ../wiki