CACiC Account Manager

Monorepo Nx do gerenciador de contas do CACiC. O projeto centraliza autenticação, onboarding, perfil do usuário, preferências de privacidade, solicitações LGPD, verificação de vínculo estudantil, integração com Discord e contratos para comunicação M2M entre serviços CACiC.

Stack

• Nx para orquestrar aplicações e bibliotecas.
• Bun como gerenciador de pacotes e executor de comandos de desenvolvimento.
• Angular com Angular Material, SSR e Storybook no frontend.
• NestJS no backend, com Swagger, Prisma, PostgreSQL, Redis, BullMQ e sessões HTTP.
• Keycloak para autenticação, autorização e clientes M2M.
• Discord API para OAuth, bot e role connections.
• S3 compatível com SeaweedFS para arquivos de LGPD e documentos.
• Docker Compose para dependências locais e deploy com Traefik.

Pré-requisitos

• Bun instalado.
• Docker, quando for usar PostgreSQL e Redis locais via Compose.
• Python 3, para os fluxos do backend que validam PDFs.

Instale as dependências com:

bun install

Configuração Local

Copie o exemplo de ambiente do backend e ajuste os valores reais:

cp apps/account-backend/.env.example apps/account-backend/.env

Para subir apenas as dependências locais:

docker compose -f docker/docker-compose.dev.yml up -d

Prisma

Depois de instalar dependências ou alterar apps/account-backend/prisma/schema.prisma, gere o client:

bunx prisma generate --schema apps/account-backend/prisma/schema.prisma

Desenvolvimento

bunx nx serve account-frontend
bunx nx serve account-backend

Comandos principais

# Ver projetos conhecidos pelo Nx
bunx nx show projects

# Build das aplicações
bunx nx build account-frontend
bunx nx build account-backend

# Testes
bunx nx test account-frontend
bunx nx test account-backend
bunx nx e2e account-backend

# Lint
bunx nx affected -t eslint:lint --parallel=3

# Storybook do frontend
bunx nx storybook account-frontend
bunx nx build-storybook account-frontend

# Bibliotecas publicáveis no npm
bun run build:packages
bun run publish:packages