Loja

Módulo da documentação dedicado à Loja (backend-store), o módulo satélite de gestão de itens unitários (produtos, estoque e vendas) das academias.

Backend (backend-store)

API REST multi-tenant (saas_id), autenticada via Keycloak JWT e integrada ao SaaS principal (backend do FUJI) via HTTP. Stack: Python, FastAPI, PostgreSQL, SQLAlchemy 2.0 assíncrono, Alembic.

Entidades principais: Categoria, Produto, Estoque, Movimentacao e Venda.

Estoque e movimentação de estoque são sempre segmentados por academia (academia_id), além do tenant (saas_id) — uma rede com várias academias mantém saldo de estoque independente por academia, não agregado. academia_id é uma referência a um dado do SaaS principal (sem tabela local própria de academias).

Ver também Frontend Multi-Projeto (fuji-loja) para a arquitetura do frontend (fuji-loja).