Base de Conhecimento

Plataforma moderna de Base de Conhecimento (semelhante ao GitBook, Confluence e Notion Wiki), com administração completa, busca inteligente, categorias, tags, versionamento de artigos e arquitetura preparada para IA.

Documentação completa em docs/index.html e o modelo de dados em docs/banco-de-dados.html.

Rotas

• / e /artigo/:slug — portal público de consulta, sem exigir login.
• /login — tela de autenticação (botão "Entrar" no portal).
• /admin — painel administrativo, exige login.

Stack

• Frontend: React 19, TypeScript, Vite, Tailwind CSS v4, TanStack Query, React Router, React Hook Form, Zod, Zustand, TipTap, Recharts, Framer Motion.
• Backend: Python 3.13, FastAPI, SQLAlchemy 2 (async), Alembic, Pydantic v2, JWT, Passlib/bcrypt.
• Banco: PostgreSQL.

Como rodar do zero

1. Banco de dados

Configure backend/.env (copie de backend/.env.example) com as credenciais do seu PostgreSQL local. Crie o banco se ele ainda não existir:

CREATE DATABASE know_base;

2. Backend

cd backend
python -m venv venv
venv\Scripts\pip install -r requirements.txt
copy .env.example .env
REM edite o .env com suas credenciais de banco

venv\Scripts\python -m alembic upgrade head
venv\Scripts\python -m app.seeds.seed_admin

O seed cria os perfis padrão (Administrador, Editor, Revisor, Leitor) e o primeiro usuário administrador:

E-mail: admin@aiconexao.com.br
Senha:  admin123

Troque essa senha assim que fizer o primeiro login (menu do usuário → Alterar Minha Senha).

Para rodar o backend manualmente:

venv\Scripts\python -m uvicorn app.main:app --reload

3. Frontend

cd frontend
npm install
copy .env.example .env
npm run dev

4. Ou suba tudo de uma vez

Na raiz do projeto:

iniciar.bat

Sobe backend (porta 8000) e frontend (porta 5080) em janelas separadas e abre o navegador automaticamente.

Scripts disponíveis

Script	O que faz
iniciar.bat	Sobe backend + frontend e abre o navegador
reiniciar.bat	Encerra instâncias anteriores e chama iniciar.bat
backup.bat	Gera um .zip com data/hora do projeto
versionar.bat "mensagem" [tag]	git add + commit, com tag opcional
release.bat	Builda o frontend e empacota um release em releases/

Variáveis de ambiente

backend/.env

Variável	Descrição
DATABASE_HOST/PORT/USER/PASSWORD/NAME	Conexão com o PostgreSQL
JWT_SECRET_KEY	Chave usada para assinar os tokens de acesso
CORS_ORIGINS	Origens permitidas (padrão: http://localhost:5080)
AI_PROVIDER	Provedor de IA para embeddings/RAG (none por padrão)

frontend/.env

Variável	Descrição
VITE_API_URL	URL base da API (padrão: http://localhost:8000/api/v1)