Skip to content

Índice

GaabDevWeb edited this page Jun 6, 2026 · 1 revision

Índice da documentação

Mapa completo das 21 páginas desta wiki. Use a sidebar à direita para navegação rápida por secções expansíveis.

Última revisão: junho/2026.


Público

# Página Conteúdo
1 Home Entrada do projecto, comandos rápidos, links principais
2 Início — guia público O que é o KernelBot, ecossistema, estado do projecto
3 FAQ — utilizador do chat Comandos, pin, memória, fontes, limites para alunos
4 Como contribuir Ambiente local, testes, PR, onde mexer no código

Visão & arquitetura

# Página Conteúdo
5 Visão geral Princípios, limitações, ecossistema ISS + KernelBot
6 Arquitetura Stack, componentes, diagramas, trade-offs
7 Estrutura do código Pastas, módulos, responsabilidades
8 Fluxos operacionais Boot, chat, pin, reload, pipeline ISS

Dados & retrieval

# Página Conteúdo
9 Dados e MySQL Tabela knowledge, contrato 1 row = 1 aula
10 BM25 e chunking Silos, janelas, Opção B2, IDF em RAM
11 Enriquecimento léxico (Opção B2) Histórico de engenharia léxica ISS → BM25
12 Gates e decisões de retrieval DecisionReason, advisory, grounding

API & UI

# Página Conteúdo
13 APIs e protocolo SSE POST /chat, history, ACL_META, /reload
14 Frontend e UI SSE client, pin, histórico, badges, componentes

Operação

# Página Conteúdo
15 Configuração .env, variáveis ACL, prompts, providers
16 Staging e testes locais Docker, scripts bin/, bateria de chat
17 Segurança e observabilidade Logs, redacção de segredos, fallbacks
18 Integração ISS (Fase 5b) Pipeline ingest, CI, secrets, /reload

Referência

# Página Conteúdo
19 Glossário Termos do domínio (pin, advisory, anchored, …)
20 Referência de prompts Arquitectura ACL, CL4R1T4S, guia de edição
21 Backlog e débitos técnicos Concluído, pendente, decisões registadas

Leitura sugerida por perfil

Perfil Ordem
Aluno / curioso FAQInício público
Novo contribuidor Início públicoComo contribuirVisão geralArquitetura
Novo dev (técnico) Visão geralArquiteturaFluxosAPIs
Operador / deploy Integração ISSStagingConfiguração
RAG / retrieval BM25GatesPrompts

Fora da wiki (repositório)

Recurso Link
Código-fonte github.com/GaabDevWeb/KernelBot
Wiki SSOT (docs/wiki/) tree/main/docs/wiki
Staging local TESTE-LOCAL.md
Smoke pin / escopo PERGUNTAS-SMOKE-ESCOPO-PIN.md
Smoke histórico chat PERGUNTAS-SMOKE-HISTORICO-CHAT.md

Clone this wiki locally