mirror of
https://github.com/aaronpo97/the-biergarten-app.git
synced 2026-07-16 17:47:22 +00:00
fd341e332c
Auth and Emails land together since Auth's registration/resend flows need Emails to exist first. Service.Auth's four services (Register, Login, Confirmation, Token) collapse into MediatR commands/queries in Features.Auth; TokenService stays as a slice-internal service since multiple handlers call it. Auth no longer references Emails directly — it sends SendRegistrationEmailCommand/SendResendConfirmationEmailCommand (defined in Shared.Application) which Features.Emails handles, so neither slice has a project reference on the other. Service.Emails' IEmailService becomes Features.Emails' IEmailDispatcher, simplified to take (firstName, email, token) instead of a full UserAccount since that's all it ever used. API.Specs' TestApiFactory/MockEmailService are updated to swap in the relocated interface. Also deletes Infrastructure.Repository now that Breweries, UserManagement, and Auth have all moved their repos out of it, and replaces the two now-dead docker-compose test services (repository.tests, service.auth.tests, both pointing at deleted Dockerfiles) with a single unit.tests service that runs every Features.*.Tests project via Dockerfile.tests.
85 lines
3.5 KiB
C#
85 lines
3.5 KiB
C#
using Domain.Entities;
|
|
|
|
namespace Features.Auth.Repository;
|
|
|
|
/// <summary>
|
|
/// Repository for authentication-related database operations including user registration and credential management.
|
|
/// </summary>
|
|
public interface IAuthRepository
|
|
{
|
|
/// <summary>
|
|
/// Registers a new user with account details and initial credential.
|
|
/// Uses stored procedure: USP_RegisterUser
|
|
/// </summary>
|
|
/// <param name="username">Unique username for the user</param>
|
|
/// <param name="firstName">User's first name</param>
|
|
/// <param name="lastName">User's last name</param>
|
|
/// <param name="email">User's email address</param>
|
|
/// <param name="dateOfBirth">User's date of birth</param>
|
|
/// <param name="passwordHash">Hashed password</param>
|
|
/// <returns>The newly created UserAccount with generated ID</returns>
|
|
Task<Domain.Entities.UserAccount> RegisterUserAsync(
|
|
string username,
|
|
string firstName,
|
|
string lastName,
|
|
string email,
|
|
DateTime dateOfBirth,
|
|
string passwordHash
|
|
);
|
|
|
|
/// <summary>
|
|
/// Retrieves a user account by email address (typically used for login).
|
|
/// Uses stored procedure: usp_GetUserAccountByEmail
|
|
/// </summary>
|
|
/// <param name="email">Email address to search for</param>
|
|
/// <returns>UserAccount if found, null otherwise</returns>
|
|
Task<Domain.Entities.UserAccount?> GetUserByEmailAsync(string email);
|
|
|
|
/// <summary>
|
|
/// Retrieves a user account by username (typically used for login).
|
|
/// Uses stored procedure: usp_GetUserAccountByUsername
|
|
/// </summary>
|
|
/// <param name="username">Username to search for</param>
|
|
/// <returns>UserAccount if found, null otherwise</returns>
|
|
Task<Domain.Entities.UserAccount?> GetUserByUsernameAsync(string username);
|
|
|
|
/// <summary>
|
|
/// Retrieves the active (non-revoked) credential for a user account.
|
|
/// Uses stored procedure: USP_GetActiveUserCredentialByUserAccountId
|
|
/// </summary>
|
|
/// <param name="userAccountId">ID of the user account</param>
|
|
/// <returns>Active UserCredential if found, null otherwise</returns>
|
|
Task<UserCredential?> GetActiveCredentialByUserAccountIdAsync(
|
|
Guid userAccountId
|
|
);
|
|
|
|
/// <summary>
|
|
/// Rotates a user's credential by invalidating all existing credentials and creating a new one.
|
|
/// Uses stored procedure: USP_RotateUserCredential
|
|
/// </summary>
|
|
/// <param name="userAccountId">ID of the user account</param>
|
|
/// <param name="newPasswordHash">New hashed password</param>
|
|
Task RotateCredentialAsync(Guid userAccountId, string newPasswordHash);
|
|
|
|
/// <summary>
|
|
/// Marks a user account as confirmed.
|
|
/// </summary>
|
|
/// <param name="userAccountId">ID of the user account to confirm</param>
|
|
/// <returns>The confirmed UserAccount entity, or null if the user account does not exist</returns>
|
|
Task<Domain.Entities.UserAccount?> ConfirmUserAccountAsync(Guid userAccountId);
|
|
|
|
/// <summary>
|
|
/// Retrieves a user account by ID.
|
|
/// </summary>
|
|
/// <param name="userAccountId">ID of the user account</param>
|
|
/// <returns>UserAccount if found, null otherwise</returns>
|
|
Task<Domain.Entities.UserAccount?> GetUserByIdAsync(Guid userAccountId);
|
|
|
|
/// <summary>
|
|
/// Checks whether a user account has been verified.
|
|
/// </summary>
|
|
/// <param name="userAccountId">ID of the user account</param>
|
|
/// <returns>True if the user has a verification record, false otherwise</returns>
|
|
Task<bool> IsUserVerifiedAsync(Guid userAccountId);
|
|
}
|