Add email-based login alongside username authentication

[Copilot]

• Explore repository structure and understand authentication flow
• Update SendUserCodeUseCase to find user by username or email
• Update AuthenticationUseCase to validate user by username or email
• Update authentication form validation to accept email format
• Update UI labels to indicate username or email
• Add findByEmail method to UsersService
• Implement findByEmail in UsersMongoServiceImpl
• Build and test the changes
• Run code review
• Run security check
• Remove inline comments from code
• Create comprehensive documentation in docs/fluxo-de-login.md

Summary

This PR successfully implements the ability for users to log in using either their username or email address, solving the issue where users who forgot their usernames couldn't access their accounts.

Changes Made

1. Backend Changes:

   • Added findByEmail() method to UsersService interface
   • Implemented findByEmail() in UsersMongoServiceImpl to query MongoDB by nested contact.email field
   • Updated SendUserCodeUseCase to detect email input (contains '@') and use the appropriate finder method
   • Updated AuthenticationUseCase to detect email input and use the appropriate finder method

2. Frontend Changes:

   • Created custom validator usernameOrEmailValidator that accepts both username format (lowercase alphanumeric) and email format
   • Updated form validation to use the new validator
   • Updated UI labels from "Seu usuário" to "Seu usuário ou email"
   • Updated error message to "Digite um usuário ou email válido"

3. Documentation:

   • Removed inline comments from code files
   • Created comprehensive documentation in docs/fluxo-de-login.md describing:
     • Complete authentication flow with diagrams
     • Architecture and component details
     • Email/username detection logic
     • Security considerations
     • Configuration and examples
     • Troubleshooting guide

Testing

• All builds passed successfully
• Existing tests continue to pass
• No security vulnerabilities detected by CodeQL

The solution is minimal and surgical - it only changes what's necessary to support email-based login while maintaining full backward compatibility with username-based login.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Mudar login tanto para o email quanto para username</issue_title>
<issue_description>O nosso login hoje é passwordless, ou seja, não temos senha

Para fazer login é necessário que o usuário passe o seu username e nós enviamos um código para ele no email

Com esse código ele consegue autenticar no sistema

Nosso problema é que muitos usuários esquecem qual é o username deles, mas eles lembram os emails

Cria a possibilidade do usuário poder entrar passando o email e recebendo o código também
</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Mudar login tanto para o email quanto para username #139

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[sschonss]

@copilot Por favor, remova os comentários existentes nas alterações e concentre a documentação em uma nova pasta docs, descrevendo de forma detalhada o fluxo de login.

[Copilot]

@copilot Por favor, remova os comentários existentes nas alterações e concentre a documentação em uma nova pasta docs, descrevendo de forma detalhada o fluxo de login.

Done! I removed all inline comments from the code and created comprehensive documentation in docs/fluxo-de-login.md that describes the complete authentication flow in detail, including:

• Architecture diagrams showing the full flow
• Component-by-component breakdown
• Email/username detection logic
• Security considerations
• Configuration options
• Usage examples
• Troubleshooting guide

Commit: cf89842

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• cloud.nx.app
  • Triggering command: node ./bin/post-install (dns block)
  • Triggering command: node ./node_modules/.bin/../nx/bin/nx.js build server (dns block)
  • Triggering command: node ./node_modules/.bin/../nx/bin/nx.js test account-domain (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)