RoomMatch

Fase 2

Escopo

• Desenvolver um sistema que facilite o encontro entre pessoas que estão à procura de um quarto para alugar e as que já possuem o quarto disponível para locação em seus imóveis
• A proposta é criar uma plataforma digital (via web) que funcione como um matchmaking de moradia, similar ao funcionamento de apps de relacionamento, com base em critérios como localização, orçamento, perfil de convivência e preferências pessoais

Requisitos Funcionais

[RF001] Implementar visualização de detalhes (quarto e perfil)

[RF002] Implementar match

Melhores práticas

Single Responsibility Principle - Responsabilidade Única

A classe class UserRepository(BaseRepository) Possui métodos de responsabilidade única como mostrado abaixo:

    def get_user_by_id(self, user_id: int) -> Optional[User]:
        """Busca um usuário pelo ID."""
        stmt = select(User).where(User.id == user_id)
        result = self.execute_stmt(stmt)
        return result.scalar_one_or_none()

Essa função tem uma única responsabilidade que é obter o usuário do repositório não aplicando sobre o usuário nenhum tipo de regra de negócio ou modificação.

Open/Closed Principle - Aberto para Extensão, Fechado para Modificação A classe class UserService Tem métodos que estão fechados para modificação mas a classe pode ser extendida adicionando novos métodos, como mostrado abaixo:

class UserService:
    def __init__(self, user_repository: UserRepository):
        self.user_repository = user_repository

    def create_user(self, name: str, email: str, senha: str, birthday: Date, profile_picture_path: str, description: str = None) -> User:
        # Verificar se já existe um usuário com este e-mail
        existing_user = self.user_repository.get_user_by_email(email)
        if existing_user:
            raise ValueError("Este e-mail já está cadastrado")

        # Hash the password before storing
        hashed_password = bcrypt.hashpw(senha.encode('utf-8'), bcrypt.gensalt())
        return self.user_repository.create_user(
            name=name,
            email=email,
            senha=hashed_password.decode('utf-8'),
            birthday=birthday,
            profile_picture_path=profile_picture_path,
            description=description
        )

    def get_user_by_id(self, user_id: int) -> Optional[User]:
        return self.user_repository.get_user_by_id(user_id)

    def update_user(self, user_id: int, **kwargs) -> Optional[User]:
        return self.user_repository.update_user(user_id, **kwargs)

    def delete_user(self, user_id: int) -> bool:
        return self.user_repository.delete_user(user_id)
    
    def get_user_by_email(self, email: str) -> Optional[User]:
        """Busca um usuário pelo email."""
        return self.user_repository.get_user_by_email(email)

    def authenticate_user(self, email: str, senha: str) -> Optional[User]:
        """Autentica um usuário verificando email e senha"""
        user = self.user_repository.get_user_by_email(email)
        if not user:
            return None
        
        if not bcrypt.checkpw(senha.encode('utf-8'), user.senha.encode('utf-8')):
            return None
        
        return user

Liskov Substitution Principle - Substituição de Liskov

def soma(a, b):
    return a + b

Interface Segregation Principle - Segregação de Interfaces

def soma(a, b):
    return a + b

Dependency Inversion Principle - Inversão de Dependência

def soma(a, b):
    return a + b

Evolução do projeto

Item	Data	Atividades Room Match	Realizado
1	14/11/2025	Documentar tópico Investigação	0%
2	14/11/2025	Definir Proposta de Projeto	0%
3	14/11/2025	Validar Visão do Usuário	0%
4	14/11/2025	Especificar RFs e RNFs - Fase 2	100%
5	17/11/2025	RF01: Implementar visualização de detalhes	25%
x	24/11/2025	TeckWeek
6	01/12/2025	Melhores Práticas
7	01/12/2025	RF01: Implementar visualização de detalhes
8	01/12/2025	RF02: Implementar match
9		Desenvolver 3o RF
10		Desenvolver 4o RF
11		Incrementar diferencial tecnológico