backend phase 2: identity — phone-OTP auth, sessions & roles (REST)

- six REST endpoints (auth/request_otp, verify_otp, refresh, logout, me,
  me/select_role) wrapping the existing JWE/TOTP/RBAC engine
- usr.UserSessions with refresh-token rotation + stolen-token (replay)
  detection → revoke-all + 401; logout rotates the security stamp
- users extended: gender, national_id (enc, NULL until KYC),
  shahkar_verified_at (auto-reset on phone change), phone_hash UNIQUE,
  is_active, deleted_at + soft-delete filter; phone/email/national_id
  encrypted at rest via IFieldEncryptor value converter
- user_roles grant/revoke audit trail + global revoked filter; 7 roles
  seeded; admin sub-roles never self-assignable (403)
- ISmsSender seam (mock logs the OTP code) replaces the TODO log lines
- OperationResult/BaseController learned enveloped 401/403
- auth knobs as platform_configs rows (resend/attempts/session TTL)
- migration IdentitySessionsAndUserExtensions applied to the dev DB
- 24 new tests incl. Baya.Test.Api (WebApplicationFactory over SQLite);
  47 total green, zero new build warnings; swagger snapshot + contract
  (identity-auth.md), handoff, report, mocks-registry updated

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
hamid
2026-07-02 02:34:11 +03:30
parent 94fdcbe0d1
commit 3a51305343
88 changed files with 4619 additions and 91 deletions
@@ -0,0 +1,280 @@
using System;
using Microsoft.EntityFrameworkCore.Migrations;
#nullable disable
#pragma warning disable CA1814 // Prefer jagged arrays over multidimensional
namespace Baya.Infrastructure.Persistence.Migrations
{
/// <inheritdoc />
public partial class IdentitySessionsAndUserExtensions : Migration
{
/// <inheritdoc />
protected override void Up(MigrationBuilder migrationBuilder)
{
migrationBuilder.AddColumn<DateTimeOffset>(
name: "DeletedAt",
schema: "usr",
table: "Users",
type: "datetimeoffset",
nullable: true);
migrationBuilder.AddColumn<string>(
name: "Gender",
schema: "usr",
table: "Users",
type: "nvarchar(10)",
maxLength: 10,
nullable: true);
migrationBuilder.AddColumn<bool>(
name: "IsActive",
schema: "usr",
table: "Users",
type: "bit",
nullable: false,
defaultValue: false);
migrationBuilder.AddColumn<string>(
name: "NationalId",
schema: "usr",
table: "Users",
type: "nvarchar(max)",
nullable: true);
migrationBuilder.AddColumn<DateTimeOffset>(
name: "NationalIdVerifiedAt",
schema: "usr",
table: "Users",
type: "datetimeoffset",
nullable: true);
migrationBuilder.AddColumn<string>(
name: "PhoneHash",
schema: "usr",
table: "Users",
type: "nvarchar(64)",
maxLength: 64,
nullable: true);
migrationBuilder.AddColumn<DateTimeOffset>(
name: "PhoneVerifiedAt",
schema: "usr",
table: "Users",
type: "datetimeoffset",
nullable: true);
migrationBuilder.AddColumn<DateTimeOffset>(
name: "ShahkarVerifiedAt",
schema: "usr",
table: "Users",
type: "datetimeoffset",
nullable: true);
migrationBuilder.AddColumn<DateTimeOffset>(
name: "GrantedAt",
schema: "usr",
table: "UserRoles",
type: "datetimeoffset",
nullable: false,
defaultValue: new DateTimeOffset(new DateTime(1, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)));
migrationBuilder.AddColumn<int>(
name: "GrantedById",
schema: "usr",
table: "UserRoles",
type: "int",
nullable: true);
migrationBuilder.AddColumn<DateTimeOffset>(
name: "RevokedAt",
schema: "usr",
table: "UserRoles",
type: "datetimeoffset",
nullable: true);
migrationBuilder.CreateTable(
name: "UserSessions",
schema: "usr",
columns: table => new
{
Id = table.Column<long>(type: "bigint", nullable: false)
.Annotation("SqlServer:Identity", "1, 1"),
UserId = table.Column<int>(type: "int", nullable: false),
RefreshTokenHash = table.Column<string>(type: "nvarchar(128)", maxLength: 128, nullable: false),
DeviceInfo = table.Column<string>(type: "nvarchar(400)", maxLength: 400, nullable: true),
IpAddress = table.Column<string>(type: "nvarchar(64)", maxLength: 64, nullable: true),
IsRevoked = table.Column<bool>(type: "bit", nullable: false, defaultValue: false),
RevokedAt = table.Column<DateTimeOffset>(type: "datetimeoffset", nullable: true),
ExpiresAt = table.Column<DateTimeOffset>(type: "datetimeoffset", nullable: false),
CreatedAt = table.Column<DateTimeOffset>(type: "datetimeoffset", nullable: false),
ModifiedAt = table.Column<DateTimeOffset>(type: "datetimeoffset", nullable: true),
CreatedById = table.Column<int>(type: "int", nullable: true),
ModifiedById = table.Column<int>(type: "int", nullable: true)
},
constraints: table =>
{
table.PrimaryKey("PK_UserSessions", x => x.Id);
table.ForeignKey(
name: "FK_UserSessions_Users_UserId",
column: x => x.UserId,
principalSchema: "usr",
principalTable: "Users",
principalColumn: "UserId",
onDelete: ReferentialAction.Restrict);
});
migrationBuilder.InsertData(
schema: "ops",
table: "PlatformConfigs",
columns: new[] { "Id", "CreatedAt", "CreatedById", "DataType", "Description", "Key", "ModifiedAt", "ModifiedById", "Value" },
values: new object[,]
{
{ 13L, new DateTimeOffset(new DateTime(2026, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)), null, "int", "Seconds a phone must wait before another OTP can be requested.", "auth_otp_resend_seconds", null, null, "120" },
{ 14L, new DateTimeOffset(new DateTime(2026, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)), null, "int", "Wrong-code attempts allowed before OTP verification is refused until a fresh code.", "auth_otp_max_attempts", null, null, "5" },
{ 15L, new DateTimeOffset(new DateTime(2026, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)), null, "int", "Refresh-token session lifetime in days.", "auth_session_ttl_days", null, null, "30" }
});
// Phone/email are encrypted at rest from this migration on, and reads now decrypt. Pre-b2
// rows hold plaintext the decryptor would choke on — clear them (pre-launch dev/test
// accounts only) and keep the seeded admin sign-in-able.
migrationBuilder.Sql(
"UPDATE [usr].[Users] SET [Email] = NULL, [NormalizedEmail] = NULL, [PhoneNumber] = NULL, [PhoneNumberConfirmed] = 0;");
migrationBuilder.Sql(
"UPDATE [usr].[Users] SET [IsActive] = 1 WHERE [UserName] = 'admin';");
migrationBuilder.CreateIndex(
name: "IX_Users_PhoneHash",
schema: "usr",
table: "Users",
column: "PhoneHash",
unique: true,
filter: "[PhoneHash] IS NOT NULL");
migrationBuilder.CreateIndex(
name: "IX_UserRoles_GrantedById",
schema: "usr",
table: "UserRoles",
column: "GrantedById");
migrationBuilder.CreateIndex(
name: "IX_UserSessions_RefreshTokenHash",
schema: "usr",
table: "UserSessions",
column: "RefreshTokenHash",
unique: true);
migrationBuilder.CreateIndex(
name: "IX_UserSessions_UserId_IsRevoked",
schema: "usr",
table: "UserSessions",
columns: new[] { "UserId", "IsRevoked" });
migrationBuilder.AddForeignKey(
name: "FK_UserRoles_Users_GrantedById",
schema: "usr",
table: "UserRoles",
column: "GrantedById",
principalSchema: "usr",
principalTable: "Users",
principalColumn: "UserId");
}
/// <inheritdoc />
protected override void Down(MigrationBuilder migrationBuilder)
{
migrationBuilder.DropForeignKey(
name: "FK_UserRoles_Users_GrantedById",
schema: "usr",
table: "UserRoles");
migrationBuilder.DropTable(
name: "UserSessions",
schema: "usr");
migrationBuilder.DropIndex(
name: "IX_Users_PhoneHash",
schema: "usr",
table: "Users");
migrationBuilder.DropIndex(
name: "IX_UserRoles_GrantedById",
schema: "usr",
table: "UserRoles");
migrationBuilder.DeleteData(
schema: "ops",
table: "PlatformConfigs",
keyColumn: "Id",
keyValue: 13L);
migrationBuilder.DeleteData(
schema: "ops",
table: "PlatformConfigs",
keyColumn: "Id",
keyValue: 14L);
migrationBuilder.DeleteData(
schema: "ops",
table: "PlatformConfigs",
keyColumn: "Id",
keyValue: 15L);
migrationBuilder.DropColumn(
name: "DeletedAt",
schema: "usr",
table: "Users");
migrationBuilder.DropColumn(
name: "Gender",
schema: "usr",
table: "Users");
migrationBuilder.DropColumn(
name: "IsActive",
schema: "usr",
table: "Users");
migrationBuilder.DropColumn(
name: "NationalId",
schema: "usr",
table: "Users");
migrationBuilder.DropColumn(
name: "NationalIdVerifiedAt",
schema: "usr",
table: "Users");
migrationBuilder.DropColumn(
name: "PhoneHash",
schema: "usr",
table: "Users");
migrationBuilder.DropColumn(
name: "PhoneVerifiedAt",
schema: "usr",
table: "Users");
migrationBuilder.DropColumn(
name: "ShahkarVerifiedAt",
schema: "usr",
table: "Users");
migrationBuilder.DropColumn(
name: "GrantedAt",
schema: "usr",
table: "UserRoles");
migrationBuilder.DropColumn(
name: "GrantedById",
schema: "usr",
table: "UserRoles");
migrationBuilder.DropColumn(
name: "RevokedAt",
schema: "usr",
table: "UserRoles");
}
}
}
@@ -251,6 +251,33 @@ namespace Baya.Infrastructure.Persistence.Migrations
Description = "Tiered cancellation refund policy: refund_percent by hours before the visit.",
Key = "cancellation_tiers",
Value = "[{\"min_hours_before\":48,\"refund_percent\":100},{\"min_hours_before\":24,\"refund_percent\":50},{\"min_hours_before\":0,\"refund_percent\":0}]"
},
new
{
Id = 13L,
CreatedAt = new DateTimeOffset(new DateTime(2026, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)),
DataType = "int",
Description = "Seconds a phone must wait before another OTP can be requested.",
Key = "auth_otp_resend_seconds",
Value = "120"
},
new
{
Id = 14L,
CreatedAt = new DateTimeOffset(new DateTime(2026, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)),
DataType = "int",
Description = "Wrong-code attempts allowed before OTP verification is refused until a fresh code.",
Key = "auth_otp_max_attempts",
Value = "5"
},
new
{
Id = 15L,
CreatedAt = new DateTimeOffset(new DateTime(2026, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified), new TimeSpan(0, 0, 0, 0, 0)),
DataType = "int",
Description = "Refresh-token session lifetime in days.",
Key = "auth_session_ttl_days",
Value = "30"
});
});
@@ -558,6 +585,9 @@ namespace Baya.Infrastructure.Persistence.Migrations
.IsConcurrencyToken()
.HasColumnType("nvarchar(max)");
b.Property<DateTimeOffset?>("DeletedAt")
.HasColumnType("datetimeoffset");
b.Property<string>("Email")
.HasMaxLength(256)
.HasColumnType("nvarchar(256)");
@@ -568,9 +598,18 @@ namespace Baya.Infrastructure.Persistence.Migrations
b.Property<string>("FamilyName")
.HasColumnType("nvarchar(max)");
b.Property<string>("Gender")
.HasMaxLength(10)
.HasColumnType("nvarchar(10)");
b.Property<string>("GeneratedCode")
.HasColumnType("nvarchar(max)");
b.Property<bool>("IsActive")
.ValueGeneratedOnAdd()
.HasColumnType("bit")
.HasDefaultValue(false);
b.Property<bool>("LockoutEnabled")
.HasColumnType("bit");
@@ -580,6 +619,12 @@ namespace Baya.Infrastructure.Persistence.Migrations
b.Property<string>("Name")
.HasColumnType("nvarchar(max)");
b.Property<string>("NationalId")
.HasColumnType("nvarchar(max)");
b.Property<DateTimeOffset?>("NationalIdVerifiedAt")
.HasColumnType("datetimeoffset");
b.Property<string>("NormalizedEmail")
.HasMaxLength(256)
.HasColumnType("nvarchar(256)");
@@ -591,15 +636,25 @@ namespace Baya.Infrastructure.Persistence.Migrations
b.Property<string>("PasswordHash")
.HasColumnType("nvarchar(max)");
b.Property<string>("PhoneHash")
.HasMaxLength(64)
.HasColumnType("nvarchar(64)");
b.Property<string>("PhoneNumber")
.HasColumnType("nvarchar(max)");
b.Property<bool>("PhoneNumberConfirmed")
.HasColumnType("bit");
b.Property<DateTimeOffset?>("PhoneVerifiedAt")
.HasColumnType("datetimeoffset");
b.Property<string>("SecurityStamp")
.HasColumnType("nvarchar(max)");
b.Property<DateTimeOffset?>("ShahkarVerifiedAt")
.HasColumnType("datetimeoffset");
b.Property<bool>("TwoFactorEnabled")
.HasColumnType("bit");
@@ -617,6 +672,10 @@ namespace Baya.Infrastructure.Persistence.Migrations
.HasDatabaseName("UserNameIndex")
.HasFilter("[NormalizedUserName] IS NOT NULL");
b.HasIndex("PhoneHash")
.IsUnique()
.HasFilter("[PhoneHash] IS NOT NULL");
b.ToTable("Users", "usr");
});
@@ -710,13 +769,81 @@ namespace Baya.Infrastructure.Persistence.Migrations
b.Property<DateTime>("CreatedUserRoleDate")
.HasColumnType("datetime2");
b.Property<DateTimeOffset>("GrantedAt")
.HasColumnType("datetimeoffset");
b.Property<int?>("GrantedById")
.HasColumnType("int");
b.Property<DateTimeOffset?>("RevokedAt")
.HasColumnType("datetimeoffset");
b.HasKey("UserId", "RoleId");
b.HasIndex("GrantedById");
b.HasIndex("RoleId");
b.ToTable("UserRoles", "usr");
});
modelBuilder.Entity("Baya.Domain.Entities.User.UserSession", b =>
{
b.Property<long>("Id")
.ValueGeneratedOnAdd()
.HasColumnType("bigint");
SqlServerPropertyBuilderExtensions.UseIdentityColumn(b.Property<long>("Id"));
b.Property<DateTimeOffset>("CreatedAt")
.HasColumnType("datetimeoffset");
b.Property<int?>("CreatedById")
.HasColumnType("int");
b.Property<string>("DeviceInfo")
.HasMaxLength(400)
.HasColumnType("nvarchar(400)");
b.Property<DateTimeOffset>("ExpiresAt")
.HasColumnType("datetimeoffset");
b.Property<string>("IpAddress")
.HasMaxLength(64)
.HasColumnType("nvarchar(64)");
b.Property<bool>("IsRevoked")
.ValueGeneratedOnAdd()
.HasColumnType("bit")
.HasDefaultValue(false);
b.Property<DateTimeOffset?>("ModifiedAt")
.HasColumnType("datetimeoffset");
b.Property<int?>("ModifiedById")
.HasColumnType("int");
b.Property<string>("RefreshTokenHash")
.IsRequired()
.HasMaxLength(128)
.HasColumnType("nvarchar(128)");
b.Property<DateTimeOffset?>("RevokedAt")
.HasColumnType("datetimeoffset");
b.Property<int>("UserId")
.HasColumnType("int");
b.HasKey("Id");
b.HasIndex("RefreshTokenHash")
.IsUnique();
b.HasIndex("UserId", "IsRevoked");
b.ToTable("UserSessions", "usr");
});
modelBuilder.Entity("Baya.Domain.Entities.User.UserToken", b =>
{
b.Property<int>("UserId")
@@ -815,6 +942,10 @@ namespace Baya.Infrastructure.Persistence.Migrations
modelBuilder.Entity("Baya.Domain.Entities.User.UserRole", b =>
{
b.HasOne("Baya.Domain.Entities.User.User", null)
.WithMany()
.HasForeignKey("GrantedById");
b.HasOne("Baya.Domain.Entities.User.Role", "Role")
.WithMany("Users")
.HasForeignKey("RoleId")
@@ -832,6 +963,17 @@ namespace Baya.Infrastructure.Persistence.Migrations
b.Navigation("User");
});
modelBuilder.Entity("Baya.Domain.Entities.User.UserSession", b =>
{
b.HasOne("Baya.Domain.Entities.User.User", "User")
.WithMany("Sessions")
.HasForeignKey("UserId")
.OnDelete(DeleteBehavior.Restrict)
.IsRequired();
b.Navigation("User");
});
modelBuilder.Entity("Baya.Domain.Entities.User.UserToken", b =>
{
b.HasOne("Baya.Domain.Entities.User.User", "User")
@@ -856,6 +998,8 @@ namespace Baya.Infrastructure.Persistence.Migrations
b.Navigation("Logins");
b.Navigation("Sessions");
b.Navigation("Tokens");
b.Navigation("UserRefreshTokens");