Pular para conteúdo

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>.