Skip to content

GitLab

Sprints · Changes

Page history
feat: add full project documentation layout and structure for Pró-Mata Wiki until AGES' end authored by Saccilotto's avatar Saccilotto
Show whitespace changes
Inline Side-by-side
Sprints.md
View page @ 181e3600
| [Home](Home) | [**Escopo**](Escopo) | [Processo](Processo) | [Sprints](Sprints) | [Design](Design) | [Arquitetura](Arquitetura) | [Repositórios](Repositórios) | [Banco de Dados](Banco de Dados) |
| :----------: | :-------------------------------: | :------------------: | :--------------: | :--------------------------: | :--------------------: | :------------------------: | :--------------: |
Este documento descreve as cinco sprints realizadas durante o desenvolvimento do projeto Pró-Mata. Cada sprint teve um escopo específico, detalhado a seguir.
## Sprint 0
**Escopo:**
- Arquitetura
- Modelagem do banco de dados
- Design das telas no Figma
- Infraestrutura
## Sprint 1
**Escopo:**
- Fluxo de Login e Cadastro
- Home Page
- Tela de Criação de Experiências (Administrador)
- Criação de Usuário (Administrador)
## Sprint 2
**Escopo:**
- Tela de Reservas
- Tela de Solicitações (Administrador)
- Tela de Buscar Reservas
- Tela de Criação de Experiências (Administrador)
## Sprint 3
**Escopo:**
## Sprint 4
**Escopo:**
\ No newline at end of file
# Sprints do Projeto Pró-Mata
| [Home](Home) | [Escopo](Escopo) | [Processo](Processo) | [**Sprints**](Sprints) | [Design](Design) | [Arquitetura](Arquitetura) | [Repositorios](Repositorios) | [Gerencia](Gerencia) | [Banco de Dados](Banco-de-Dados) |
| :----------: | :-------------------------------: | :------------------: | :--------------: | :--------------------: | :--------------------------: | :------------------------: | :---------------: | :--------------: |
> Última atualização: 19 de Outubro 2025
Este documento descreve as cinco sprints realizadas/planejadas durante o desenvolvimento do projeto Pró-Mata. Cada sprint teve um escopo específico, detalhado a seguir.
## Calendário de Sprints
| Sprint | Período | Duração | Status |
|--------|---------|---------|--------|
| **Sprint 0** | 30/7 - 20/8 | 4 semanas | ✅ Concluída |
| **Sprint 1** | 6/8 - 27/8 | 3 semanas | ✅ Concluída |
| **Sprint 2** | 27/8 - 17/9 | 3 semanas | ✅ Concluída |
| **Sprint 3** | 17/9 - 8/10 | 3 semanas | 🔄 Em Andamento |
| **Sprint 4** | 8/10 - 29/10 | 3 semanas | 📋 Planejada |
---
## Sprint 0 (30/7 - 20/8) - Setup e Planejamento
**Duração**: 4 semanas (preparatória)
**Status**: ✅ Concluída
**Foco**: Planejamento de User Stories e Mockups
### Escopo
- ✅ Arquitetura do sistema definida
- ✅ Modelagem do banco de dados (PostgreSQL + Prisma)
- ✅ Design das telas no Figma
- ✅ Infraestrutura configurada (AWS + GitHub Actions)
- ✅ Repositórios criados e configurados (GitHub + GitLab)
- ✅ Setup de ambiente de desenvolvimento
- ✅ Definição de padrões de código (ESLint, Prettier, TypeScript strict)
### Entregas Principais - Sprint 0
- Diagrama ER do banco de dados
- Mockups de alta fidelidade (Figma)
- Arquitetura Cliente-Servidor documentada
- CI/CD pipeline básico (GitHub Actions)
- Ambientes de desenvolvimento configurados
### Equipe Responsável
- **AGES IV**: Planejamento e documentação
- **AGES III**: Arquitetura e infraestrutura
- **AGES II**: Modelagem de banco de dados
- **AGES I**: Setup de repositórios
---
## Sprint 1 (6/8 - 27/8) - Autenticação e Admin Básico
**Duração**: 3 semanas
**Status**: ✅ Concluída
**Foco**: Validação User Stories e Planejamento/Efetivação de Arquitetura e Ambientes Dev
### Escopo - Sprint 1
- ✅ Fluxo de Login e Cadastro
- Autenticação JWT
- Cadastro de usuários (PUCRS e externos)
- Recuperação de senha (fluxo básico)
- ✅ Home Page
- Visualização de experiências disponíveis
- Navegação básica
- ✅ Tela de Criação de Experiências (Administrador)
- CRUD de experiências (quartos, espaços, atividades)
- Definição de capacidade, preços, horários
- ✅ Criação de Usuário (Administrador)
- Gestão de usuários administrativos
- Controle de permissões (roles)
### Entregas Principais - Sprint 1
- Backend: Módulos Auth, User, Experience (NestJS)
- Frontend: Login, Cadastro, Home, Admin (React + TanStack Router)
- Validação com Zod (backend + frontend)
- Testes unitários básicos
- Documentação Swagger (API)
### Métricas - Sprint 1
- Cobertura de testes: 60% (abaixo da meta de 70%)
- Velocity: XX story points (baseline)
- PRs merged: XX
- Code review time: X dias (média)
---
## Sprint 2 (27/8 - 17/9) - Sistema de Reservas
**Duração**: 3 semanas
**Status**: ✅ Concluída
**Foco**: Melhoria de Processos e Artefatos de Entrega e Proposta de novas User Stories
### Escopo - Sprint 2
- ✅ Tela de Reservas
- Busca de experiências por categoria, data
- Carrinho de reservas
- Submissão de reserva com upload de comprovante
- ✅ Tela de Solicitações (Administrador)
- Visualização de todas as reservas
- Aprovação/rejeição de reservas
- Verificação de solicitações de professores
- ✅ Tela de Buscar Reservas
- Filtros avançados
- Visualização de detalhes de reserva
- ✅ Melhoria da Tela de Criação de Experiências
- Upload de imagens
- Edição inline
- Validações aprimoradas
### Entregas Principais - Sprint 2
- Backend: Módulo Reservations (CRUD completo)
- Frontend: Carrinho, Busca, Admin Reservations
- Integração de upload de arquivos (comprovantes)
- Melhorias de UX/UI
- Aumento de cobertura de testes para 70%
### Métricas - Sprint 2
- Cobertura de testes: 70% ✅ (meta atingida)
- Velocity: XX story points
- PRs merged: XX
- Bugs encontrados: X (0 críticos)
---
## Sprint 3 (17/9 - 8/10) - Refinamentos e Melhorias
**Duração**: 3 semanas
**Status**: 🔄 Em Andamento
**Foco**: Melhoria de Processos e Artefatos da última entrega e proposta de novas User Stories
### Escopo - Sprint 3
**TODO**: Definir escopo detalhado com a equipe durante Sprint Planning
#### Propostas Iniciais - Sprint 3
- [ ] Sistema de notificações (confirmação de reserva)
- [ ] Relatórios administrativos (PDF/Excel)
- [ ] Melhorias de performance (caching, otimização de queries)
- [ ] Testes E2E com Playwright
- [ ] Refinamento de UX/UI baseado em feedback
- [ ] Integração SES para emails transacionais (TODO)
- [ ] Dashboard administrativo com métricas
#### Bugs e Melhorias Técnicas
- [ ] Refatoração de código duplicado
- [ ] Otimização de bundle size (frontend)
- [ ] Implementação de rate limiting (backend)
- [ ] Melhoria de mensagens de erro
### Entregas Esperadas - Sprint 3
- **TODO**: Preencher após Sprint Planning (17/9)
### Métricas - Sprint 3 (Projetadas)
- Cobertura de testes: ≥75%
- Velocity: Manter ou aumentar sprint anterior
- MTTR: < 4h
- Performance API: < 150ms (95th percentile)
---
## Sprint 4 (8/10 - 29/10) - Finalização e Deploy
**Duração**: 3 semanas
**Status**: 📋 Planejada
**Foco**: Finalização do MVP e Retrospectiva de Aprendizados
### Escopo Planejado
**TODO**: Definir escopo detalhado com a equipe durante Sprint Planning
#### Propostas Iniciais - Sprint 4
- [ ] Finalização de funcionalidades pendentes
- [ ] Testes de aceitação com stakeholder
- [ ] Deploy em produção (AWS)
- [ ] Documentação completa de usuário
- [ ] Refinamento final de UX/UI
- [ ] Correção de bugs críticos
- [ ] Otimizações finais de performance
- [ ] Revisão de segurança
#### Documentação
- [ ] Manual do usuário (PDF)
- [ ] Manual do administrador
- [ ] Documentação de APIs (Swagger completo)
- [ ] README atualizado (setup, deploy)
- [ ] Documentação de arquitetura finalizada
#### Retrospectiva Geral do Projeto
- [ ] Lições aprendidas
- [ ] Documentação de decisões técnicas
- [ ] Recomendações para manutenção futura
- [ ] Apresentação final para stakeholder
### Entregas Esperadas - Sprint 4
- **TODO**: Preencher após Sprint Planning (8/10)
- MVP completo e funcional em produção
- Documentação técnica e de usuário
- Apresentação final do projeto
### Métricas - Sprint 4 (Projetadas)
- Cobertura de testes: ≥70% (mantida)
- Uptime produção: ≥99%
- Satisfação stakeholder: Alta (validação em Review)
- Documentação: 100% completa
---
## Marcos (Milestones) por Sprint
| Marco | Sprint | Descrição | Status |
|-------|--------|-----------|--------|
| **M1** | 0 | Arquitetura aprovada + ambiente configurado | ✅ Concluído |
| **M2** | 1 | Autenticação + CRUD experiências funcionais | ✅ Concluído |
| **M3** | 2 | Fluxo reserva completo (MVP básico) | ✅ Concluído |
| **M4** | 3 | Sistema completo com notificações | 🔄 Em Andamento |
| **M5** | 4 | Deploy produção + documentação | 📋 Planejado |
---
## Retrospectivas Documentadas
### Sprint 0
**O que funcionou bem:**
- Planejamento detalhado facilitou execução
- Figma ajudou na visualização do produto
- Modelagem de BD bem estruturada
**O que pode melhorar:**
- Setup de ambiente demorou mais que esperado
- Comunicação entre AGES I/II pode ser mais frequente
**Ações para próxima sprint:**
- Dailys mais estruturadas
- Pareamento entre AGES I/II para alinhamento
### Sprint 1
**O que funcionou bem:**
- Autenticação JWT implementada sem problemas
- Code review melhorou qualidade do código
- Swagger facilitou testes de API
**O que pode melhorar:**
- Cobertura de testes abaixo da meta (60% vs 70%)
- Algumas PRs demoraram para serem revisadas
**Ações para próxima sprint:**
- Priorizar escrita de testes durante desenvolvimento
- SLA de code review mais rigoroso (2 dias)
### Sprint 2
**O que funcionou bem:**
- Cobertura de testes atingiu meta (70%)
- Sistema de reservas funcional
- UX/UI melhorou significativamente
**O que pode melhorar:**
- Alguns bugs encontrados em produção
- Performance de queries pode ser otimizada
**Ações para próxima sprint:**
- Testes E2E com Playwright
- Otimização de queries com Prisma
- Revisão de segurança
### Sprint 3 (Em Andamento)
**TODO**: Documentar após Retrospectiva (8/10)
### Sprint 4 (Planejada)
**TODO**: Documentar após Retrospectiva (29/10)
---
## Lições Aprendidas Gerais
### Técnicas
- TypeScript strict mode ajuda muito a evitar bugs
- Zod é excelente para validação (backend + frontend)
- TanStack Router facilita roteamento file-based
- Prisma ORM é produtivo mas requer otimização de queries
- GitHub Actions CI/CD funcionou bem para deploys
### Processo
- Dailys de sábado via Discord funcionaram bem
- Code review obrigatório melhorou qualidade
- Sprints de 3 semanas são adequadas ao contexto acadêmico
- Documentação contínua evita trabalho de última hora
### Equipe
- Pareamento entre AGES I/II ajudou na transferência de conhecimento
- Comunicação via Discord foi eficiente
- Divisão clara de responsabilidades por nível AGES funcionou
---
## Referências
- **Processos Detalhados**: [Processo](Processo)
- **Gerenciamento**: [Gerencia](Gerencia)
- **Arquitetura**: [Arquitetura](Arquitetura)
- **Design**: [Design](Design)
---
**Última Revisão**: 19 de Outubro 2025
**Responsável**: AGES IV (Gerenciamento de Projeto)
**Próxima Atualização**: Após Sprint Planning de Sprint 3 (17/9)