Começando (desenvolvimento)

Pré-requisitos

• bun (front), Python 3.12 (back), Docker (Postgres local).

Backend

git clone ssh://git@gitlab.cloudface.tech:2424/cloudface/abys-smart-transfer-api.git
cd abys-smart-transfer-api
python3.12 -m venv .venv && . .venv/bin/activate
pip install -e ".[dev]"

# Postgres local
docker run -d --name abys-pg -e POSTGRES_USER=abys -e POSTGRES_PASSWORD=abys \
  -e POSTGRES_DB=abys -p 5433:5432 postgres:16-alpine
export ABYS_DATABASE_URL="postgresql+asyncpg://abys:abys@localhost:5433/abys"

alembic upgrade head            # migrations
python -m app.seed.seed         # tenant + lojas + usuário demo
python -m app.seed.seed_dominio # produtos + estoque + lote + recos (paridade c/ mock)
uvicorn app.main:app --reload --port 8000
# Swagger: http://localhost:8000/api/v1/docs

Testes & lint

export ABYS_DATABASE_URL_TEST="postgresql+asyncpg://abys:abys@localhost:5433/abys_test"
pytest -q
ruff check .

Frontend

git clone ssh://git@gitlab.cloudface.tech:2424/cloudface/abys-smart-transfer.git
cd abys-smart-transfer
bun install

# mock (default — sem backend):
bun run dev

# contra o backend real:
VITE_USE_MOCK=false VITE_API_URL=http://localhost:8000/api/v1 bun run dev

Documentação (este site)

git clone ssh://git@gitlab.cloudface.tech:2424/cloudface/abys-docs.git
cd abys-docs && bun install && bun run docs:dev