Estrutura do repositório¶
quantix-vision-ai/
├── README.md resumo do produto e início rápido
├── install.sh instalador guiado (prepara Python/Ansible e chama deploy/installer)
├── Makefile build, up/down, logs, lab/demo, backup/restore, gen-env, certs, lint
├── .env.example todas as variáveis de implantação, documentadas
├── docker-compose.yml produção em host único
├── docker-compose.scale.yml override para ambiente grande (recursos, réplicas, coletores extras)
├── docker-compose.cluster.yml override: ClickHouse 2 shards × 2 réplicas + 3 Keeper
├── docker-compose.lab.yml laboratório tudo-em-um (chdb, workers embutidos, demo-seed)
├── backend/
│ ├── Dockerfile imagem única (multi-stage, não-root, tini, Ansible; WITH_CHDB=true → -lab)
│ ├── pyproject.toml dependências, extras automation/embedded/dev, script "quantix", pytest
│ ├── quantix/
│ │ ├── cli.py subcomandos: api, collector, ingestor, engine, automation, demo-seed, reset-admin
│ │ ├── common/ config, catálogo, modelos, banco, tsdb, consultas, topologia, cripto, notificações…
│ │ ├── collector/ serviço coletor, publicador (NATS/HTTPS) e plugins/
│ │ │ └── plugins/ base.py (contrato), _util.py, 17 fabricantes + simulator, README.md
│ │ ├── ingestor/ consumidores JetStream (métricas → ClickHouse, inventário → PostgreSQL)
│ │ ├── engine/ ratings, change detection, previsão, balanceamento, regras, correlação, alertas…
│ │ ├── ai/ provedores LLM e assistente com ferramentas
│ │ ├── automation/ executor ansible-runner + playbooks/*.yml
│ │ ├── api/ FastAPI: main, security (RBAC), ldap_auth, bootstrap, routers/
│ │ └── tools/ demo_seed (laboratório), admin (reset-admin)
│ ├── tests/ unit/, plugins/ (respx/SSH falso), integration/ (PG, chdb, NATS reais)
│ └── tools/benchmark/ scale_benchmark.py
├── frontend/
│ ├── Dockerfile node 20 → nginx-unprivileged 1.27 (inclui docs/site em /docs/)
│ ├── nginx/ nginx.conf, default.conf (template), security-headers.conf, proxy-api.conf
│ ├── scripts/ smoke.mjs (teste de fumaça da API), screenshots.mjs
│ └── src/ React 18 + TypeScript (api/, auth/, components/, features/, layout/, lib/, pages/)
├── deploy/
│ ├── README.md guia de implantação (resumo)
│ ├── ansible/ site, preflight, status, setup-link, collector, backup, restore, upgrade + roles
│ ├── installer/ installer.py (lógica do ./install.sh: perguntas, inventário, preflight, bundle)
│ ├── helm/quantix-vision/ chart Kubernetes
│ ├── clickhouse/ config.d/, users.d/, cluster/ (Keeper, macros, remote_servers)
│ ├── nats/ nats-server.conf, nats-auth.conf
│ └── scripts/ gen-env.py, quantix-backup.sh, quantix-restore.sh
└── docs/
├── mkdocs.yml este site (MkDocs Material, sem CDN)
├── overrides/ scripts do tema em arquivos (CSP)
├── gen_reference.py gera referencia/{metricas,variaveis,permissoes,plataformas}.md do código
├── gen_api.py gera desenvolvimento/api-endpoints.md do openapi.json
├── api/openapi.json especificação OpenAPI exportada da aplicação
└── content/ páginas Markdown
Imagens publicadas: quantix/quantix-vision-backend:<versão> (e -lab) e quantix/quantix-vision-web:<versão>.