Skip to content

GitLab

Last edited by Saccilotto
Page history

Repositórios

Repositórios do Projeto

Home Escopo Processo Sprints Design Arquitetura Repositorios Gerencia Banco de Dados

Última atualização: 19 de Outubro 2025

Estrutura de Repositórios

O projeto Pró-Mata utiliza uma estrutura híbrida GitLab (oficial) + GitHub (desenvolvimento):

  • GitLab: Repositórios oficiais (requisito institucional AGES)
  • GitHub: Desenvolvimento ativo (familiaridade da equipe, ferramentas)
  • Sincronização: Automática GitHub → GitLab

Repositórios Oficiais (GitLab)

Frontend

URL: https://tools.ages.pucrs.br/pro-mata/frontend

Descrição: Interface Web do usuário (React 19 + TypeScript)

Tecnologias Principais:

  • React 19
  • Vite 6
  • TanStack Router (file-based routing)
  • TanStack Query (server state)
  • Tailwind CSS 4
  • Shadcn/UI + Radix UI
  • Vitest (unit/integration) + Playwright (E2E)

Estrutura:

src/
├── components/ui/    # Shadcn/UI components
├── features/         # Feature modules
├── lib/              # Utilities
├── routes/           # TanStack Router (file-based)
├── styles/           # Tailwind + tokens
└── main.tsx          # App bootstrap

Scripts Principais:

  • npm run dev: Dev server (hot reload)
  • npm run build: Build produção
  • npm run test: Testes unitários (Vitest)
  • npm run test:e2e: Testes E2E (Playwright)

Deploy: AWS S3 static hosting (via GitHub Actions)

Backend

URL: https://tools.ages.pucrs.br/pro-mata/backend

Descrição: API REST (NestJS + Node.js 22)

Tecnologias Principais:

  • NestJS (framework)
  • Node.js 22
  • TypeScript (strict mode)
  • Prisma ORM + PostgreSQL 15
  • JWT (autenticação)
  • Zod (validação)
  • Swagger (documentação API)
  • Jest (testes)

Estrutura:

src/
├── analytics/        # Umami integration
├── auth/             # JWT auth + roles
├── database/         # Prisma client
├── user/             # User management
├── experience/       # Experiences CRUD
└── main.ts           # App bootstrap

prisma/
├── schema.prisma     # Database schema
└── migrations/       # Database migrations

Scripts Principais:

  • npm run dev: Dev server (hot reload)
  • npm run build: Build produção
  • npm run test: Testes unitários (Jest)
  • npm run prisma:migrate: Rodar migrations
  • npm run prisma:generate: Gerar Prisma Client

Deploy: AWS EC2 (Docker container via GitHub Actions)

Documentação API: https://api.pro-mata.exemplo.com/api (Swagger)

Infraestrutura

URL: https://tools.ages.pucrs.br/pro-mata/infrastructure

Descrição: Configuração de infraestrutura (scripts, configs)

Conteúdo:

  • Scripts de deploy
  • Configurações AWS
  • Docker Compose files
  • Documentação de infraestrutura

Nota: Infraestrutura atual simplificada (AWS S3 + EC2). Ver repositório de backup para stack completa.

Repositórios Desenvolvimento (GitHub)

Frontend (GitHub)

URL: https://github.com/AGES-Pro-Mata/frontend

Status: Desenvolvimento ativo (mirror → GitLab)

Acesso: Privado (membros org AGES-Pro-Mata)

CI/CD:

  • Trigger: Push em main
  • Pipeline: Lint → Test → Build → Deploy S3
  • Ferramentas: GitHub Actions

Backend (GitHub)

URL: https://github.com/AGES-Pro-Mata/backend

Status: Desenvolvimento ativo (mirror → GitLab)

Acesso: Privado (membros org AGES-Pro-Mata)

CI/CD:

  • Trigger: Push em main
  • Pipeline: Lint → Test → Build → Docker → Deploy EC2
  • Registry: Docker Hub (imagens públicas)

Issues e Projects

GitHub Projects: https://github.com/orgs/AGES-Pro-Mata/projects/1

Acesso: Privado (membros org)

Kanban: Backlog → To Do → In Progress → Review → Done

Sincronização Issues: GitHub Issues → GitLab Issues (automatizada, simplificada)

Repositório de Backup (Infraestrutura Multi-Cloud)

Infra Multi-Cloud (Azure + AWS)

URL: https://github.com/Saccilotto/pro-mata-infra

Owner: André Sacilotto Santos (AGES IV - pessoal)

Status: Standby (não utilizado em produção atual)

Descrição: Infraestrutura completa multi-cloud com Terraform + Ansible + Docker Swarm

Stack:

  • IaC: Terraform (Azure VMs / AWS EC2)
  • CaC: Ansible (Docker Swarm config)
  • Orquestração: Docker Swarm
  • Proxy/LB: Traefik v3
  • Observabilidade: Prometheus + Grafana
  • CDN/WAF: Cloudflare
  • Domínio: registro.br

Estrutura:

iac/                  # Terraform (Infrastructure as Code)
cac/                  # Ansible (Configuration as Code)
docker/               # Dockerfiles e Compose
envs/                 # Environment configs
scripts/              # Deployment scripts
docs/                 # Documentation

Propósito: Redundância geográfica, backup, tolerância a falhas (RTO < 4h)

Sincronização Automatizada

GitHub → GitLab (Código)

Ferramenta: GitHub Actions (mirror workflow)

Frequência: A cada push em main ou develop

Conteúdo Sincronizado:

  • Código-fonte (todos os arquivos)
  • Branches (main, develop, feature/*)
  • Commits (histórico completo)
  • Tags (releases)

GitHub Issues → GitLab Issues

Ferramenta: GitHub Actions (custom script)

Frequência: A cada criação/atualização de issue

Conteúdo Sincronizado:

  • Título e descrição
  • Labels (mapeamento básico)
  • Status (aberta/fechada)

Nota: Sincronização simplificada (não inclui comentários completos ou assignees)

Workflow de Desenvolvimento

1. Desenvolvimento (GitHub)

# 1. Criar branch feature
git checkout -b feature/42-login-jwt

# 2. Desenvolver + commits semânticos
git commit -m "feat: adiciona autenticação JWT"

# 3. Push para GitHub
git push origin feature/42-login-jwt

# 4. Abrir Pull Request (GitHub)
# - Target: develop
# - Reviewers: AGES III/IV (mín. 2)

# 5. CI/CD valida automaticamente
# - Lint (ESLint + Prettier)
# - Test (Vitest/Jest)
# - Build (TypeScript)

# 6. Merge após aprovação
# - GitHub: merge PR
# - GitLab: mirror automático

2. Deploy (Automático)

# Após merge em main (GitHub):
# 1. CI/CD build produção
# 2. Frontend → AWS S3
# 3. Backend → Docker Hub → AWS EC2
# 4. Mirror → GitLab

Convenções

Branches

Nomenclatura: feature/[numero-issue]-[descricao]

Exemplos:

  • feature/42-login-jwt
  • feature/15-reservas-crud
  • feature/8-admin-dashboard

Commits

Padrão: Conventional Commits

Formato: tipo: descrição

Tipos:

  • feat: Nova funcionalidade
  • fix: Correção de bug
  • docs: Documentação
  • style: Formatação (sem lógica)
  • refactor: Refatoração
  • test: Testes
  • chore: Manutenção (deps, config)

Exemplos:

git commit -m "feat: adiciona autenticação JWT no backend"
git commit -m "fix: corrige validação de datas em reservas (#15)"
git commit -m "docs: atualiza README com instruções de setup"

Pull Requests

Template:

## Descrição
[O que foi implementado]

## Issue Relacionada
Closes #42

## Tipo de Mudança
- [ ] Nova funcionalidade
- [ ] Correção de bug
- [ ] Breaking change
- [ ] Documentação

## Checklist
- [ ] Testes passando
- [ ] Code review feito
- [ ] Documentação atualizada

Acesso aos Repositórios

GitLab (Oficial)

Acesso: Público (leitura) / Privado (escrita - membros AGES)

Login: Credenciais institucional PUCRS

URL Base: https://tools.ages.pucrs.br

GitHub (Desenvolvimento)

Acesso: Privado (apenas membros org AGES-Pro-Mata)

Convite: Solicitar a AGES IV

URL Base: https://github.com/AGES-Pro-Mata

Backup (Pessoal)

Acesso: Público (leitura)

Owner: André Sacilotto Santos

URL: https://github.com/Saccilotto/pro-mata-infra

Links Rápidos

Repositórios

Gestão

Documentação

Troubleshooting

Problemas Comuns

1. Erro ao clonar repositório GitLab

# Solução: Verificar credenciais PUCRS
git config --global credential.helper store
git clone https://tools.ages.pucrs.br/pro-mata/frontend.git

2. CI/CD falhando

  • Verificar linter: npm run lint
  • Verificar testes: npm run test
  • Verificar build: npm run build

3. Docker build falhando (backend)

# Rebuild containers
docker-compose down
docker-compose build --no-cache
docker-compose up

4. Prisma migrations out of sync

# Backend: sincronizar schema
npm run prisma:migrate deploy
npm run prisma:generate

Última Revisão: 19 de Outubro 2025 Responsável: AGES III (Arquitetura) + AGES IV (Gerência)