Arkeon

Plataforma SaaS multi-tenant para gestão completa de barbearias — agenda, financeiro, estoque, metas e CRM em um único sistema.

---

O que é

Arkeon substitui planilhas e softwares avulsos por uma operação centralizada. Desenvolvido para barbearias que precisam de controle real sobre o negócio — não apenas um agendamento.

Problema resolvido: gestão fragmentada em 4+ ferramentas diferentes, sem visibilidade consolidada de caixa, metas e operação.

---

Funcionalidades

Módulo	Descrição
Financeiro	Contas a pagar/receber, DRE, fluxo de caixa, compensação bancária
Metas	Metas mensais por barbearia, por profissional e ticket médio
Precificação	Simulador de preços e configuração de margens
Estoque	Produtos, fornecedores, movimentações e alertas
Lista da Vez	Rodízio de atendimento com isolamento por unidade
Assinaturas	Clube de fidelidade com integração Asaas
Analytics	Dashboard com KPIs e insights operacionais
Multi-unidade	Isolamento completo de dados por tenant e unidade

---

Stack

Back-end

Front-end

Infra

---

Arquitetura

Clean Architecture + DDD com multi-tenancy por coluna (tenant_id em todas as tabelas) e RLS no PostgreSQL.

┌─────────────────────────────────────┐
│   Presentation  (HTTP Handlers)     │
├─────────────────────────────────────┤
│   Application   (Use Cases)         │
├─────────────────────────────────────┤
│   Domain        (Entities / Rules)  │
├─────────────────────────────────────┤
│   Infrastructure (DB / Ext. APIs)   │
└─────────────────────────────────────┘

Documentação completa em docs/.

---

Início rápido

Pré-requisitos

• Go 1.24+
• Bun 1.1+
• PostgreSQL 16+ (ou Docker)

Setup

# Clone
git clone https://github.com/andviana23/arkeon2.0.git
cd arkeon2.0

# Bootstrap automático (Ubuntu)
make install   # instala dependências, sobe DB, aplica migrations
make up        # inicia backend + frontend

# Frontend: http://localhost:3000
# Backend:  http://localhost:8080

Setup manual

# Backend
cd backend
cp .env.example .env
# Editar DATABASE_URL e JWT_SECRET no .env
go mod download
go run ./cmd/api/main.go

# Frontend
cd frontend
bun install
cp .env.example .env.local
# Editar NEXT_PUBLIC_API_URL=http://localhost:8080/api/v1
bun run dev

---

Testes

# Backend
cd backend && make test

# Frontend
cd frontend
bun run test        # unitários
bun run test:e2e    # E2E com Playwright

---

Status

• MVP 2.0 em produção — VPS + Neon (PostgreSQL)
• 78 endpoints backend implementados
• Auditoria MVP 2.0 concluída em 08/04/2026

---

Autor

Andrey Viana — Full-Stack Freelancer