By name: mgcred-dashboard description: Use em qualquer trabalho em app.py ou componentes do dashboard. Router para os docs autoritativos em docs/agents/.
MGCred Dashboard — Router
Padrões específicos deste projeto vivem em docs/agents/. Este arquivo
apenas indica onde procurar.
Princípios inegociáveis (resumo)
- Entrypoint único:
app.py(root).dashboard*.pysão obsoletos. - RLS antes de render:
aplicar_rls→aplicar_rls_metas→aplicar_rls_supervisores. - Cache dual:
carregar_*→ branch_atual/_historicovia_eh_mes_atual(). - Width API:
width="stretch"em Streamlit ≥ 1.35 (excetosac.*). - Dias úteis: sempre
from src.shared.dias_uteis import calcular_dias_uteis.
Onde procurar
| Tópico | Doc |
|---|---|
| Árvore de arquivos, entrypoint, banco | docs/agents/architecture.md |
| Pontuação, cartão, seguros, super conta, pipeline, metas | docs/agents/business-rules.md |
Supabase views/RPCs, paginação, cache _atual/_historico, TTLs |
docs/agents/data-layer.md |
| Ordem de RLS, hierarquia de 5 perfis, "Visualizar Como" | docs/agents/rls.md |
Naming, formatters PT-BR, Width API, chart template, CHART_COLORS |
docs/agents/conventions.md |
sac.divider/tabs/segmented, exibir_tabela, tab renderer |
docs/agents/ui-components.md |
Fluxo recomendado
- Leia
AGENTS.mdedocs/agents/README.md(primeira sessão). - Para a tarefa: abra o doc específico da tabela acima.
- Se a tarefa introduz padrão novo, documente em
docs/agents/patterns/. - Ao fechar tarefa com decisão não óbvia, registre em
docs/agents/progress/.