Requisitos Funcionais

Cadastro e Gerenciamento de Usuários

Código	Descrição
RF-01	O sistema deverá permitir que administradores de imobiliárias realizem seu próprio cadastro, informando pelo menos nome completo, e-mail e definindo uma senha de acesso.
RF-02	O sistema deverá permitir que locatários (inquilinos) realizem seu cadastro na plataforma, informando pelo menos nome completo, e-mail e definindo uma senha de acesso.
RF-03	O sistema deverá permitir que administradores de imobiliárias realizem o cadastro de imobiliárias (empresas) no sistema, informando pelo menos nome da empresa e CNPJ. Esse cadastro inicial permitirá que o administrador possa gerenciar seus imóveis, contratos e usuários.
RF-04	O sistema deverá permitir que o administrador de imobiliária cadastre, edite, remova e liste os seus corretores (funcionários da imobiliária). Deverá ser possível informar os dados pessoais do corretor (nome, contato etc.), incluindo seu registro profissional (CRECI), vinculando-o à imobiliária.
RF-05	O sistema deverá permitir que o administrador de imobiliária cadastre, edite, remova e liste os proprietários de imóveis (locadores) no sistema, incluindo dados pessoais/contato e associando cada proprietário aos imóveis que ele possui. Dessa forma, a imobiliária manterá um registro dos proprietários para fins de contrato e prestação de contas, embora proprietários não tenham acesso direto ao sistema nessa versão.
RF-06	O sistema deverá permitir que o administrador da imobiliária atribua papéis/perfis de acesso aos usuários da sua empresa. Por exemplo, designar determinados usuários como administradores ou assistentes, controlando as permissões de cada um conforme as regras de negócio definidas (implementação de Role-Based Access Control - RBAC). Essa gestão de papéis deverá incluir pelo menos a capacidade de alterar o papel de um usuário existente e definir novos usuários com papéis no momento do cadastro.
RF-07	O sistema deverá permitir que o administrador de imobiliária visualize a lista de locatários cadastrados que estejam ou estiveram vinculados a alugueis de seus imóveis. Deve ser possível consultar os locatários que já realizaram contratos com a imobiliária, ver seus dados de contato básicos e status (ativo/inadimplente, etc.), facilitando o acompanhamento e eventual comunicação com eles.

Gestão de Propriedades e Residenciais

Código	Descrição
RF-08	O sistema deverá permitir que o administrador de imobiliária cadastre novos imóveis (propriedades) no sistema, bem como editar os dados, remover e visualizar as propriedades já cadastradas. Cada imóvel incluirá informações como endereço, tipo (por exemplo: apartamento, casa, sala comercial), valor do aluguel, descrição e fotos. Durante o cadastro ou edição de um imóvel, deve ser possível associá-lo a um residencial existente (por exemplo, indicar a qual condomínio ou edifício ele pertence) e também vincular um proprietário responsável (dono do imóvel). A imobiliária também poderá listar/consultar todos os imóveis cadastrados de forma filtrada (por status, por residencial, por tipo, etc.).
RF-09	O sistema deverá permitir que o administrador de imobiliária vincule um imóvel a um locatário quando for efetivada uma locação. Ao alugar um imóvel para um determinado locatário (já cadastrado no sistema), o usuário da imobiliária deverá conseguir selecionar o imóvel e o locatário desejado, estabelecendo assim a locação ativa. O sistema deve garantir que cada locatário possua apenas uma locação ativa (um imóvel alugado) simultaneamente – ou seja, não deverá ser possível alugar múltiplos imóveis para o mesmo locatário ao mesmo tempo, prevenindo conflitos de contrato.
RF-10	O sistema deverá permitir cadastrar, editar, remover e listar os chamados residenciais, entendidos como agrupamentos de imóveis. Por exemplo, a imobiliária poderá cadastrar um residencial "Condomínio XYZ" e então vincular vários imóveis a esse residencial. Cada residencial terá informações como nome, endereço/localização e, possivelmente, um identificador do conjunto (como bloco, torre, etc.). Isso facilita a organização de imóveis que fazem parte de um mesmo condomínio ou complexo residencial.
RF-11	O sistema deverá oferecer mecanismos de cadastro em lote de imóveis pela interface. Ou seja, a imobiliária poderá adicionar múltiplos imóveis de uma só vez de forma manual na interface (por exemplo, preenchendo uma planilha ou formulário com vários imóveis em sequência) agilizando o cadastro inicial de muitos imóveis. Essa funcionalidade de adição múltipla deverá permitir inclusive já definir, para cada imóvel inserido em lote, a qual residencial ele pertence (se aplicável) e seu proprietário.
RF-12	O sistema deverá permitir a importação de imóveis via arquivo CSV para cadastro em lote. A imobiliária poderá preparar um arquivo .CSV conforme um modelo pré-definido (contendo colunas de informações dos imóveis, como endereço, tipo, valor, proprietário, residencial, etc.) e importá-lo no sistema. Ao importar, o sistema deverá processar o arquivo e criar os imóveis listados automaticamente, retornando uma confirmação ou listagem de erros (por exemplo, caso algum registro esteja incompleto ou em formato inválido). Essa é uma alternativa automatizada ao RF-10, facilitando cargas massivas de dados existentes.

Gestão de Contratos

Código	Descrição
RF-13	O sistema deverá permitir que a imobiliária cadastre, edite, remova e liste modelos de contrato de locação. Um modelo de contrato consiste no texto base ou template que será utilizado para gerar contratos individuais. A imobiliária poderá manter vários modelos, com cláusulas padrão e campos variáveis (como nome do locatário, endereço do imóvel, valor do aluguel, data de início, etc.) que serão preenchidos automaticamente.
RF-14	O sistema deverá permitir que a imobiliária associe um modelo de contrato a cada imóvel. Ou seja, para cada imóvel cadastrado, poderá ser definido qual modelo de contrato será utilizado quando aquele imóvel for alugado. Isso garante que, ao alugar o imóvel, o sistema saiba qual template de contrato usar para gerar o documento específico.
RF-15	Quando a imobiliária vincular um imóvel a um locatário (conforme RF-08), o sistema deverá gerar automaticamente um contrato de locação com base no modelo associado ao imóvel. Os dados específicos do contrato (nome do locatário, dados do imóvel, valor, datas de vigência, etc.) serão preenchidos no template, resultando em um documento de contrato completo, pronto para assinatura. Esse contrato gerado ficará armazenado no sistema e acessível tanto pela imobiliária quanto pelo locatário.
RF-16	O sistema deverá manter o histórico de obrigações financeiras do locatário mesmo após o término ou interrupção de um contrato. Especificamente, caso um locatário seja desvinculado de um imóvel (por término do contrato, inadimplência ou abandono), eventuais dívidas pendentes permanecerão registradas em nome desse locatário. Assim, a imobiliária poderá continuar visualizando e cobrando faturas em aberto daquele ex-locatário. Esse requisito garante a rastreabilidade e conservação do histórico financeiro de cada locatário, evitando que a saída do locatário do imóvel apague registros de débitos não quitados.

Gestão de Cobranças e Pagamentos

Código	Descrição
RF-17	O sistema deverá permitir que a imobiliária emita faturas de cobrança de aluguel para os locatários. Para cada período de cobrança (tipicamente mensal), a imobiliária poderá gerar uma fatura no sistema referente ao aluguel daquele período; o sistema então associa a fatura ao contrato/locatário e gera uma cobrança PIX com os dados do pagamento (valor, identificação, etc.). A fatura deve ficar disponível tanto para a imobiliária quanto para o locatário.
RF-18	O cálculo das datas de vencimento das faturas de aluguel deverá ser automatizado pelo sistema com base nas regras do contrato. Por exemplo, se o contrato define pagamento todo dia 5 de cada mês a partir da data de assinatura, o sistema ao gerar cada fatura já atribuirá o vencimento adequado (dia e mês correspondentes), reduzindo erros manuais. Essa lógica considera a data de início do contrato e periodicidade (geralmente mensal).
RF-19	O sistema deverá permitir que a imobiliária acompanhe o status de pagamentos das faturas emitidas, distinguindo entre pagamentos recebidos (faturas quitadas) e pagamentos pendentes (faturas em aberto ou atrasadas). Deve haver uma tela ou relatório onde o usuário da imobiliária possa ver, para cada fatura ou locatário, se o pagamento foi realizado (incluindo data do pagamento) ou se ainda está pendente. Isso auxilia no controle financeiro e na identificação rápida de inadimplência.
RF-20	O sistema deverá gerar uma listagem de locatários inadimplentes, ou seja, aqueles que possuem faturas em atraso. Essa listagem deve permitir visualizar quais locatários estão devendo e, importante, mesmo se o locatário já não estiver mais com um imóvel alugado (por exemplo, deixou o imóvel mas deixou dívidas), ele deve constar como inadimplente enquanto houver faturas pendentes. A imobiliária poderá filtrar ou ordenar essa lista, e visualizar informações como nome do locatário, imóvel relacionado (se ainda alugado), valor em atraso e tempo de atraso.
RF-21	O sistema deverá permitir visualizar as cobranças (faturas) agrupadas por residencial. Ou seja, a imobiliária poderá consultar um relatório que mostre, para cada residencial (condomínio/edifício) cadastrado, quais faturas estão associadas aos imóveis daquele residencial. Isso ajuda, por exemplo, a identificar a saúde financeira de um determinado condomínio (quantos aluguéis em dia vs atrasados em um prédio específico). A visualização agrupada por residencial incluirá totais por residencial (ex.: soma de valores devidos) e detalhes das faturas/locatários de cada grupo.
RF-22	O sistema deverá permitir que a imobiliária envie lembretes de cobrança aos locatários inadimplentes e realize a baixa manual de faturas quando necessário. Especificamente: o usuário da imobiliária poderá, através do sistema, acionar o envio de notificações de cobrança (por e-mail ou outro meio integrado) para locatários com pagamentos atrasados, lembrando-os do débito pendente. Além disso, o sistema deve possibilitar marcar manualmente uma fatura como paga (baixar a fatura) nos casos em que o pagamento for realizado fora da plataforma ou em dinheiro, por exemplo. Ao efetuar a baixa manual, deverá ser registrado no sistema qual usuário fez a baixa, quando, e eventualmente um comprovante ou motivo (para fins de auditoria).
RF-23	O sistema deverá permitir que locatários realizem o pagamento das faturas diretamente pela plataforma, utilizando a integração PIX mencionada. Na prática, isso significa que o locatário, ao acessar uma fatura em aberto em seu painel, poderá clicar em "Pagar agora" ou semelhante e ser guiado para realizar o pagamento via PIX (por leitura do QR Code ou eventualmente pelo recurso de copiar código PIX). Após o pagamento, o sistema deverá atualizar o status da fatura para paga automaticamente (mediante confirmação do gateway de pagamento integrado).

Consulta e Visualização de Dados

Código

Descrição

RF-24

O sistema deverá permitir que locatários visualizem as informações de suas locações ativas. Ao fazer login, o locatário terá acesso a um painel que mostra, por exemplo, qual imóvel está alugando atualmente, desde quando, qual o período do contrato, valor do aluguel, próxima data de vencimento de fatura, e outros detalhes relevantes do contrato vigente. Além disso, deve poder acessar seu histórico de pagamentos (faturas pagas e pendentes) para controle pessoal. Essa transparência permite ao locatário acompanhar sua situação junto à imobiliária facilmente, sem necessidade de contato telefônico para informações básicas.