Visão geral
O Aby's OS é a plataforma de gestão de varejo do Grupo Aby's. Esta documentação cobre a arquitetura, os módulos e a API.
Componentes
| Componente | Repositório | Tecnologia | Ambiente dev |
|---|---|---|---|
| Frontend | cloudface/abys-smart-transfer | TanStack Start (SSR) · React 19 · Tailwind v4 · shadcn/ui | https://dev.abys.cloudface.tech |
| Backend (API) | cloudface/abys-smart-transfer-api | FastAPI · SQLAlchemy 2 · PostgreSQL 16 | https://api-dev.abys.cloudface.tech |
| Documentação | cloudface/abys-docs | VitePress | (este site) |
O nome dos repositórios ainda reflete o 1º módulo ("smart-transfer"). Conforme a arquitetura modular evolui, a estrutura interna passa a separar core de módulos.
Acesso ao ambiente dev
- Front: https://dev.abys.cloudface.tech
- Login de teste (seed):
marina.silva@abys.com.br/abys12345(papel analista) - API (Swagger): https://api-dev.abys.cloudface.tech/api/v1/docs
Estado atual
- ✅ Core: autenticação real (JWT/Argon2), RBAC, multi-tenant, catálogo, estoque.
- ✅ Módulo Remanejamento: motor de recomendação, lotes, grade, regras, métricas.
- ✅ Integração front↔back: autenticação real ligada (
VITE_USE_MOCK=false). - 🔲 Em andamento: migração das telas de dados (hoje mock) para a API real.
- 🔲 Roadmap: módulos Vendas/PDV, Compras, Financeiro/BI, Campanhas; Oráculo (IA).