Fragmentação e pouca visibilidade.
Dados duplicados, documentos dispersos e rotinas manuais dificultam o acompanhamento operacional e fiscal das locações.
Projeto Integrador · 3º semestre · 2026
ImobFiscal.
MVP web para centralizar a gestão de imóveis, contratos e cobranças, com uma simulação didática de IBS e CBS para proprietários e pequenas imobiliárias.
O projeto
Um só lugar para informações que estavam espalhadas.
Proprietários e pequenas imobiliárias ainda distribuem contratos, pagamentos, reajustes e informações fiscais entre planilhas, documentos e conversas. Essa fragmentação reduz a visibilidade das pendências e aumenta o risco de retrabalho, esquecimento e erro.
Um fluxo único e rastreável.
Permitir o cadastro de locadores e imóveis, a criação de contratos, o acompanhamento de status, a simulação de tributos e a geração de cobranças demonstrativas.
Escopo acadêmico: a simulação de IBS e CBS serve para estudo e demonstração. Ela não substitui orientação contábil nem representa emissão fiscal oficial.
Evolução do PI
O problema ficou mais concreto a cada semestre.
A evolução mostra como o grupo reduziu a amplitude inicial e aproximou o produto de usuários e rotinas que poderiam ser pesquisados, demonstrados e avaliados.
- 1º semestre
Link Fiscal
O projeto começou como uma ideia de emissão de nota e split fiscal. A falta de dados e a amplitude do tema mostraram a necessidade de um problema mais específico.
- 2º semestre
Domínio imobiliário
O grupo migrou para a gestão de imóveis e passou a estruturar entidades e fluxos de locação, aproximando o projeto de rotinas observáveis.
- 3º semestre
ImobFiscal
A proposta foi consolidada como um SaaS de apoio a proprietários e imobiliárias, com gestão de locadores, imóveis, contratos, cobranças e simulação fiscal.
Demonstração do MVP
O que existe hoje e o que ainda vem depois.
As etiquetas abaixo separam a versão demonstrável dos recursos que ainda estão sendo construídos ou permanecem planejados.
Versão demonstrável
- Cadastro e login com JWT assinado.
- Rotas protegidas com Spring Security.
- Isolamento do acesso por imobiliária.
- Gestão de locadores e imóveis.
- Criação e acompanhamento de contratos.
- Simulação didática de IBS e CBS.
- Geração e consulta de cobranças simuladas.
Fortalecimento do MVP
- Autorização detalhada por perfil e operação.
- Revogação e renovação de tokens.
- Trilha de auditoria em banco não relacional.
- Ampliação dos testes automatizados.
- Validação formal de usabilidade.
- Estudo experimental com Next.js e NestJS.
Roadmap
- Notificações por e-mail e WhatsApp.
- Exportação contábil e assinatura eletrônica.
- Integração bancária.
- Emissão fiscal oficial.
- Split payment real.
- Aplicativo móvel.
Interação Humano-Computador
Projetar para quem administra locações de verdade.
A persona e a jornada ajudam a transformar um domínio complexo em decisões de interface mais claras, guiadas e verificáveis.
Persona principal
Carlos Mendes
46 anos · empresário autônomo e proprietário de imóveis
Tem domínio digital intermediário e administra diversas locações com planilhas, arquivos e WhatsApp. Recorre ao contador quando surgem dúvidas fiscais.
“Eu preciso controlar meus aluguéis sem depender de várias planilhas e sem correr o risco de errar na parte fiscal.”
Objetivos
Centralizar informações, acompanhar pagamentos, evitar esquecimentos, entender valores fiscais e compartilhar dados organizados com a contabilidade.
Frustrações
Documentos espalhados, informações duplicadas, pouca visão de pendências, retrabalho e linguagem tributária complexa.
Necessidades
Painel claro, formulários guiados, validação imediata, confirmação de ações críticas, histórico e explicação do cálculo.
Jornada resumida
Da entrada no sistema ao acompanhamento.
| Etapa | Ação | Principal fricção | Resposta de design |
|---|---|---|---|
| Acesso | Entra no sistema | Não saber por onde começar | Painel orientado a tarefas |
| Locador | Registra dados e regime | Termos fiscais | Ajuda contextual e validação |
| Imóvel | Associa imóvel ao locador | Vínculo incorreto | Resumo da associação |
| Contrato | Informa datas e valor | Alto risco de erro | Etapas curtas e revisão |
| Simulação | Consulta IBS e CBS | Não entender o cálculo | Memória de cálculo e aviso didático |
| Cobrança | Gera o registro | Medo de duplicidade | Confirmação, status e valores detalhados |
| Acompanhamento | Consulta pendências | Baixa visibilidade | Filtros, prioridades e histórico |
Maior tensão: contratoMaior alívio: confirmação da cobrança
Arquitetura técnica
A versão demonstrável.
A arquitetura abaixo representa a implementação atual. A estrutura parcial em Next.js, NestJS, Prisma e Supabase é um estudo de evolução e não deve ser confundida com a versão funcional.
FrontendReact 18 + ViteReact Router · Axios
↓ComunicaçãoAPI RESTRequisições e respostas JSON
↓BackendJava 17 + Spring Boot 3.3Spring Security · Controller → Service → Repository
↓PersistênciaMySQL / MariaDBSpring Data JPA
Fluxo técnico em destaque
Geração de cobrança simulada
- O usuário seleciona um contrato e informa o vencimento.
- A API busca contrato, imóvel e locador.
- Regime tributário, tipo do imóvel e ano determinam a alíquota.
- O motor calcula IBS, CBS e valor líquido.
- A cobrança armazena a memória do cálculo.
- O frontend apresenta o resultado e o status.
Planejado
Banco de dados não relacional
A implementação atual usa MySQL, que é relacional. Supabase/PostgreSQL também é relacional. Para atender à disciplina, o roadmap propõe MongoDB para eventos de auditoria, histórico de alterações e notificações, preservando o banco relacional para os dados transacionais.
Desenvolvimento Web III
Da aparência de login para uma API protegida.
O UUID aleatório do fluxo anterior foi substituído por JWT assinado. O backend agora valida cada chamada protegida e impede que o usuário troque a imobiliária pela URL.
Token sem validação
O frontend enviava um identificador no cabeçalho, mas a API não conferia assinatura, expiração ou identidade.
Spring Security + JWT
Login com BCrypt, token assinado, filtro por requisição, contexto autenticado e rotas privadas.
Imobiliária isolada
Usuário, token e URL precisam indicar a mesma imobiliária. Uma tentativa de acesso cruzado recebe HTTP 403.
12 testes aprovados
JWT, validações, 401, 403, login, próprio tenant e motor tributário foram executados com sucesso.
Relatório técnico completo
Código explicado, fluxo, testes, limitações e referências.
Integração do semestre
O projeto conecta decisões de várias disciplinas.
Gestão, pesquisa, interface, desenvolvimento e dados se encontram no mesmo fluxo de trabalho.
Organização
Escopo, backlog, priorização, ciclos de entrega e evidências no Trello.
Experiência
Persona, jornada, redução de carga cognitiva, prevenção de erros e validação de usabilidade.
Aplicação
Frontend, API REST, integrações, autenticação e testes automatizados.
Auditoria
Estudo de uma trilha de eventos e histórico em MongoDB, ainda não implementada.
Consolidação
Documentação, avaliação do MVP e comunicação dos resultados do grupo.
Gestão ágil
Cinco ciclos para orientar o backlog.
O planejamento distribui o trabalho em entregas menores e permite revisar decisões a partir de testes, evidências e feedback.
- 01
Escopo e experiência
Consolidação do problema, persona, jornada e documentação.
- 02
Segurança e qualidade
Autenticação, validações e ampliação dos testes.
- 03
Auditoria NoSQL
Planejamento da trilha de eventos e do histórico de alterações.
- 04
Usabilidade e iterações
Testes com usuários, análise dos resultados e ajustes de interface.
- 05
Produto e comunicação
Produto final, apresentação, documentação e portfólio.
Controle das entregas
Todos os entregáveis do PI em um só lugar.
O quadro reúne o cronograma, os três documentos técnicos, as demonstrações e a entrega final. Os estados abaixo deixam claro o que já possui evidência e o que ainda precisa ser consolidado.
Proposta do projeto
- Nome, equipe e responsabilidades.
- Problema, público-alvo e justificativa.
- Objetivos, solução e resultado esperado.
Documento 1 · Requisitos
- Requisitos funcionais e não funcionais.
- Regras de negócio vinculadas aos requisitos.
- Prioridades e matriz de rastreabilidade.
Documento 2 · Funcionalidades
- Casos de uso e atores.
- Histórias de usuário e critérios de aceitação.
- Fluxos principal, alternativos e exceções.
Documento 3 · Dados e arquitetura
- DER legível com entidades, chaves e relacionamentos.
- Dicionário das tabelas e tipos de dados.
- Stack, camadas e justificativas técnicas.
Protótipo e Sprints 1 e 2
- Telas principais e fluxo de navegação.
- Repositório e estrutura inicial.
- Cadastros, consultas e primeiras regras de negócio.
Protótipo funcional
- Telas e funcionalidades codificadas.
- Estrutura, banco configurado e integração.
- Dificuldades e tarefas pendentes.
Segurança com Spring Security
- JWT assinado e autenticação stateless.
- Isolamento por imobiliária e validação dos DTOs.
- 12 testes aprovados sem falhas.
Sprint 3, MVP e testes
- 26/10: integração das funcionalidades e fluxo principal.
- 02/11: MVP executável do início ao fim.
- 09/11: relatório de testes, ajustes e correções.
Sistema, arquivos e documentação final
- Sistema funcionando, banco integrado, fluxo completo e tratamento de erros.
- Código-fonte, scripts do banco, versões e instruções de execução.
- Documento final com capa, resumo, requisitos, modelagens, telas, testes, dificuldades, conclusão e referências.
- Apresentação final com demonstração prática.
Atenção: parte da documentação do repositório foi produzida no 2º semestre e está sendo usada como base. Os documentos marcados como “revisar” ainda precisam ser alinhados ao escopo, à arquitetura e ao estado real do 3º semestre antes da entrega final.
Documentos da professora
Cronograma, modelos e critérios de avaliação.
Atividade integrada · 19/10/2026
Avaliação cruzada de protótipos.
A dinâmica reuniu IHC e Gestão Ágil: cada equipe analisou projetos da turma, observou a experiência de uso e registrou oportunidades de melhoria para apoiar os próximos ciclos.
Atividade realizada
PDF · Proposta da aula
Protótipo funcional e dinâmica UX
Orientações da atividade prática: interação cruzada entre equipes, construção de persona, observação da jornada do usuário e elaboração de sugestões fundamentadas em IHC.
Baixar atividade em PDF ↓Relatório concluído
DOCX · Entrega da equipe
Análise dos projetos da turma
A equipe ImobFiscal avaliou Ambydata, Conecta Serviços, EasyGest e Ciclo Kids. O relatório registra o estágio de cada proposta e recomenda melhorias de identificação, recorte de escopo, dados de exemplo, ações rápidas e atividades para o público infantil.
Baixar relatório em DOCX ↓Aprendizado
A comparação com outros sistemas mostrou que feedback externo ajuda a encontrar problemas que a própria equipe pode deixar passar e transforma observações de uso em melhorias mais claras para o backlog.
Evidências técnicas
Resultados já verificados.
Os resultados abaixo descrevem o estado observado da versão atual, sem transformar recursos planejados em entregas prontas.
Frontend
JWT e imobiliária armazenados após o login; Axios envia o Bearer token nas chamadas autenticadas.
Backend
Spring Security protege as rotas e o filtro valida identidade, expiração e tenant.
Testes
Doze testes aprovados: 0 falhas, 0 erros, 0 ignorados e BUILD SUCCESS.
Documentação
Relatório técnico com código, fluxo, resultados, limitações e referências oficiais.
Transparência acadêmica
O que o sistema ainda não faz.
Registrar as limitações evita conclusões incorretas sobre o estágio do MVP e ajuda a transformar lacunas em próximos passos claros.
- O cálculo fiscal é uma simulação acadêmica.
- Os boletos não possuem registro bancário.
- Não existe emissão fiscal oficial.
- O logout ainda não revoga imediatamente um JWT emitido.
- Perfis existem, mas a autorização por operação ainda deve ser detalhada.
- O cadastro público ainda usa uma imobiliária padrão.
- Política de senha, rate limiting e recuperação de senha precisam evoluir.
- O requisito NoSQL está planejado, não concluído.
Equipe
Responsabilidades no projeto.
O trabalho reúne gestão, arquitetura, dados, liderança técnica e desenvolvimento.
Daniel Doneda
Líder Técnico
Christian Dumont
Arquiteto de Sistemas
Denise Dumont
Gerente de Projetos
Bruno Prado
DBA
Gabriel Fagundes
Desenvolvedor
Conheça o projeto