Escopo

Home	Escopo	Processo	Sprints	Design	Arquitetura	Repositorios	Gerencia	Banco de Dados

Escopo do Projeto

Última atualização: 19 de Outubro 2025

Visão Geral

O projeto Pró-Mata consiste no desenvolvimento de uma plataforma digital de hotelaria para o Centro de Pesquisas e Proteção da Natureza (CPPN) Pró-Mata, visando oferecer um sistema eficiente, acessível e integrado para a gestão das reservas e serviços do centro.

Objetivo do Projeto

Desenvolver uma plataforma Web que:

• Facilite o processo de reservas, agendamento e planejamento
• Amplie o público alcançado pelo centro
• Promova maior transparência e comodidade para os usuários
• Otimize a organização interna do CPPN Pró-Mata
• Aprimore a experiência do visitante

Escopo do Produto

No Escopo

1. Identificação de Usuários

• Alunos e professores da PUCRS: Acesso com identificação institucional
• Alunos e professores de outras universidades: Cadastro com validação acadêmica
• Público geral: Cadastro aberto para visitantes

2. Módulo Administrativo

• Atualização de informações da plataforma
• Elaboração de relatórios de múltiplas reservas
• Emissão de confirmações de reserva
• Gestão de usuários (criação, edição, inativação)
• Gestão de experiências (quartos, espaços, atividades)
• Verificação de solicitações de professores

3. Módulo de Reservas

Hospedagem:

• Consulta de disponibilidade de quartos individuais e coletivos
• Reserva de quartos com datas de check-in/check-out
• Visualização de capacidade e características dos quartos

Espaços:

• Laboratórios
• Salas multiuso
• Auditório

Atividades:

• Trilhas interpretativas
• Visitas turísticas
• Retiros espirituais
• Cursos e eventos acadêmicos

4. Sistema de Pagamento

• Acesso a diversas formas de pagamento
• Anexação de comprovantes de pagamento na submissão das reservas
• Armazenamento seguro de comprovantes

5. Funcionalidades Técnicas

• Autenticação JWT com controle de papéis (usuário, admin)
• Validação de dados com Zod
• Documentação API com Swagger
• Testes automatizados (≥70% cobertura)
• Analytics com Umami (privacy-respecting)
• Deploy automatizado (CI/CD GitHub Actions)

Fora do Escopo

• ❌ Integração com portais de pagamento (gateways como PagSeguro, MercadoPago)
• ❌ Aplicativo mobile nativo (apenas Web responsivo)
• ❌ Sistema de fidelidade ou pontos
• ❌ Chat em tempo real com administradores
• ❌ Integração com redes sociais
• ❌ Sistema de avaliações/reviews de experiências

Público-Alvo

Perfis de Usuário

Perfil	Descrição	Necessidades Principais
Aluno PUCRS	Estudante da PUCRS interessado em atividades acadêmicas/recreativas	Acesso rápido, reservas para grupos, preços institucionais
Professor PUCRS	Docente organizando atividades de ensino/pesquisa	Reservas de laboratórios, espaços para eventos, gestão de grupos
Aluno/Professor Externo	Acadêmicos de outras universidades	Validação institucional, informações sobre o centro
Público Geral	Visitantes interessados em ecoturismo/retiros	Informações sobre atividades, processo de reserva simples
Administrador	Funcionários do CPPN Pró-Mata	Gestão completa de reservas, relatórios, confirmações

Requisitos Funcionais (Resumo)

RF01 - Autenticação e Cadastro

• Sistema de login com email e senha
• Cadastro de novos usuários (PUCRS e externos)
• Recuperação de senha via email (TODO: integração SES)
• Perfil de usuário editável

RF02 - Gestão de Experiências (Admin)

• CRUD completo de experiências (quartos, espaços, atividades)
• Definição de capacidade, preços, horários disponíveis
• Categorização de experiências

RF03 - Sistema de Reservas

• Busca de experiências por categoria, data, capacidade
• Carrinho de reservas
• Submissão de reserva com upload de comprovante
• Visualização de reservas do usuário

RF04 - Gestão Administrativa

• Visualização de todas as reservas
• Aprovação/rejeição de reservas
• Verificação de solicitações de professores
• Geração de relatórios

RF05 - Gestão de Usuários (Admin)

• Listagem de usuários
• Criação de usuários administrativos
• Inativação de usuários

Requisitos Não-Funcionais

RNF01 - Desempenho

• Tempo de resposta de API < 200ms (95th percentile)
• Frontend com carregamento inicial < 3s
• Suporte a 100 usuários simultâneos

RNF02 - Segurança

• Autenticação JWT com tokens de curta duração
• Hashing de senhas com argon2id
• Validação de entrada em todas as rotas (Zod)
• HTTPS obrigatório em produção

RNF03 - Usabilidade

• Interface responsiva (mobile, tablet, desktop)
• Acessibilidade WCAG 2.1 AA (quando aplicável)
• Feedback visual claro para ações do usuário

RNF04 - Manutenibilidade

• Cobertura de testes ≥70%
• Documentação de API (Swagger)
• Código TypeScript com strict mode
• Linting e formatação automatizados (ESLint, Prettier)

RNF05 - Disponibilidade

• Uptime desejado: 99% (tolerância a ~7h downtime/mês)
• Infraestrutura de backup disponível (RTO < 4h)
• Monitoramento com analytics (Umami)

Tecnologias

Frontend

• React 19 + TypeScript
• Vite 6
• TanStack Router + TanStack Query
• Tailwind CSS 4
• Shadcn/UI + Radix UI
• Vitest + Playwright

Backend

• Node.js 22 + NestJS + TypeScript
• Prisma ORM + PostgreSQL 15
• JWT + argon2
• Swagger
• Jest

Infraestrutura

• AWS S3 (frontend) + AWS EC2 (backend/database)
• Docker + Docker Hub
• GitHub Actions (CI/CD)
• GitLab (repositórios oficiais + wiki)

Entregas

Sprint 0 (Concluída)

• ✅ Arquitetura definida
• ✅ Modelagem de banco de dados
• ✅ Design das telas (Figma)
• ✅ Infraestrutura configurada

Sprint 1 (Concluída)

• ✅ Fluxo de Login e Cadastro
• ✅ Home Page
• ✅ Tela de Criação de Experiências (Admin)
• ✅ Criação de Usuário (Admin)

Sprint 2 (Concluída)

• ✅ Tela de Reservas
• ✅ Tela de Solicitações (Admin)
• ✅ Tela de Buscar Reservas
• ✅ Melhorias na Criação de Experiências

Sprint 3 e 4 (Em Andamento/Planejado)

Ver Sprints para detalhes atualizados.

Restrições

• Prazo: Semestre 2025/2 (até final de Novembro)
• Equipe: 4 níveis AGES (I a IV) com responsabilidades distintas
• Tecnologia: Web apenas (sem mobile nativo)
• Orçamento: Infraestrutura AWS com custos controlados
• Requisitos Institucionais: Repositórios GitLab + sincronização GitHub

Critérios de Aceitação Geral

O projeto será considerado bem-sucedido quando:

• ✅ Usuários conseguem se cadastrar e fazer login
• ✅ Usuários conseguem visualizar e reservar experiências
• ✅ Administradores conseguem gerenciar reservas e usuários
• ✅ Sistema está funcional em produção (AWS)
• ✅ Cobertura de testes ≥70%
• ✅ Documentação completa (Wiki + Swagger)
• ✅ Stakeholder valida funcionalidades em Sprint Reviews

Próximos Passos

• Implementar envio de emails (integração SES)
• Completar funcionalidades de Sprint 3 e 4
• Refinamento de UX/UI baseado em feedback
• Otimizações de performance
• Documentação de manual do usuário

---

Stakeholder: Prof. Augusto Mussi Alvim Orientador: Edson Moreno Gerência: Ver Gerencia para estrutura completa da equipe e processos