Feature/data models (#11)

* DB user entity

* role enum

* skill entity and model

* user skill entity

* Skill model class to record

* user skill model

* project entity and model

* team entity and model

* team membership

* Recommendation entity

* Add Recommendation model

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Add XML doc comments to all entities, enums, and models

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: dcl10

backend/src/SkillMatrixLlm.Api/Data/Entities/Project.cs

@@ -0,0 +1,33 @@
+namespace SkillMatrixLlm.Api.Data.Entities;
+
+using SkillMatrixLlm.Api.Enums;
+
+/// <summary>A project requiring team assembly.</summary>
+public class Project
+{
+  /// <summary>Primary key.</summary>
+  public Guid Id { get; set; }
+
+  /// <summary>Short title of the project.</summary>
+  public required string Title { get; set; }
+
+  /// <summary>Full description of the project's goals and requirements.</summary>
+  public required string Description { get; set; }
+
+  /// <summary>Target number of team members.</summary>
+  public required int DesiredTeamSize { get; set; }
+
+  /// <summary>Expected timeline or duration of the project.</summary>
+  public required string Timeline { get; set; }
+
+  /// <summary>Current lifecycle status of the project.</summary>
+  public ProjectStatus Status { get; set; }
+
+  /// <summary>Foreign key to the user who created the project.</summary>
+  public Guid CreatedByUserId { get; set; }
+  /// <summary>The user who created the project.</summary>
+  public User? CreatedByUser { get; set; }
+
+  /// <summary>When the project was created.</summary>
+  public DateTime CreatedAt { get; set; }
+}

backend/src/SkillMatrixLlm.Api/Data/Entities/Recommendation.cs

@@ -0,0 +1,27 @@
+namespace SkillMatrixLlm.Api.Data.Entities;
+
+using System.ComponentModel.DataAnnotations.Schema;
+
+/// <summary>Audit record storing a raw LLM team recommendation.</summary>
+public class Recommendation
+{
+  /// <summary>Primary key.</summary>
+  public Guid Id { get; set; }
+
+  /// <summary>Foreign key to the project the recommendation was generated for.</summary>
+  public Guid ProjectId { get; set; }
+  /// <summary>The project this recommendation was generated for.</summary>
+  public Project? Project { get; set; }
+
+  /// <summary>Foreign key to the team proposed by this recommendation.</summary>
+  public Guid TeamId { get; set; }
+  /// <summary>The team proposed by this recommendation.</summary>
+  public Team? Team { get; set; }
+
+  /// <summary>Raw JSON response from the LLM.</summary>
+  [Column(TypeName = "jsonb")]
+  public required string RawResponse { get; set; }
+
+  /// <summary>When the recommendation was generated.</summary>
+  public DateTime CreatedAt { get; set; }
+}

backend/src/SkillMatrixLlm.Api/Data/Entities/Skill.cs

@@ -0,0 +1,11 @@
+namespace SkillMatrixLlm.Api.Data.Entities;
+
+/// <summary>A skill in the curated catalogue.</summary>
+public class Skill
+{
+  /// <summary>Primary key.</summary>
+  public Guid Id { get; set; }
+
+  /// <summary>Display name of the skill.</summary>
+  public required string Name { get; set; }
+}

backend/src/SkillMatrixLlm.Api/Data/Entities/Team.cs

@@ -0,0 +1,24 @@
+namespace SkillMatrixLlm.Api.Data.Entities;
+
+using SkillMatrixLlm.Api.Enums;
+
+/// <summary>A proposed or confirmed team for a project.</summary>
+public class Team
+{
+  /// <summary>Primary key.</summary>
+  public Guid Id { get; set; }
+
+  /// <summary>Foreign key to the project this team was assembled for.</summary>
+  public Guid ProjectId { get; set; }
+  /// <summary>The project this team was assembled for.</summary>
+  public Project? Project { get; set; }
+
+  /// <summary>Whether the team was LLM-generated or manually assembled.</summary>
+  public ProjectSource Source { get; set; }
+
+  /// <summary>Current status of the team.</summary>
+  public TeamStatus Status { get; set; }
+
+  /// <summary>When the team was created.</summary>
+  public DateTime CreatedAt { get; set; }
+}

backend/src/SkillMatrixLlm.Api/Data/Entities/TeamMembership.cs

@@ -0,0 +1,26 @@
+namespace SkillMatrixLlm.Api.Data.Entities;
+
+using SkillMatrixLlm.Api.Enums;
+
+/// <summary>Join entity linking a user to a team with a role and invitation status.</summary>
+public class TeamMembership
+{
+  /// <summary>Primary key.</summary>
+  public Guid Id { get; set; }
+
+  /// <summary>Foreign key to the team.</summary>
+  public Guid TeamId { get; set; }
+  /// <summary>The team this membership belongs to.</summary>
+  public Team? Team { get; set; }
+
+  /// <summary>Foreign key to the user.</summary>
+  public Guid UserId { get; set; }
+  /// <summary>The user who is a member of the team.</summary>
+  public User? User { get; set; }
+
+  /// <summary>The role this user plays within the project.</summary>
+  public required string ProjectRole { get; set; }
+
+  /// <summary>Whether the user has been invited, accepted, or declined.</summary>
+  public MembershipStatus MembershipStatus { get; set; }
+}

backend/src/SkillMatrixLlm.Api/Data/Entities/User.cs

@@ -0,0 +1,22 @@
+namespace SkillMatrixLlm.Api.Data.Entities;
+
+using SkillMatrixLlm.Api.Enums;
+
+/// <summary>Represents an authenticated user in the application database.</summary>
+public class User
+{
+  /// <summary>Primary key.</summary>
+  public Guid Id { get; set; }
+
+  /// <summary>The corresponding user ID in Keycloak.</summary>
+  public required string KeycloakId { get; set; }
+
+  /// <summary>Display name shown in the UI.</summary>
+  public required string DisplayName { get; set; }
+
+  /// <summary>Email address.</summary>
+  public required string Email { get; set; }
+
+  /// <summary>Application role determining what the user can do.</summary>
+  public Role Role { get; set; }
+}

backend/src/SkillMatrixLlm.Api/Data/Entities/UserSkill.cs

@@ -0,0 +1,23 @@
+namespace SkillMatrixLlm.Api.Data.Entities;
+
+using SkillMatrixLlm.Api.Enums;
+
+/// <summary>Join entity representing a user's proficiency in a skill.</summary>
+public class UserSkill
+{
+  /// <summary>Primary key.</summary>
+  public Guid Id { get; set; }
+
+  /// <summary>Foreign key to the user.</summary>
+  public Guid UserId { get; set; }
+  /// <summary>The user this skill entry belongs to.</summary>
+  public User? User { get; set; }
+
+  /// <summary>Foreign key to the skill.</summary>
+  public Guid SkillId { get; set; }
+  /// <summary>The skill this entry describes.</summary>
+  public Skill? Skill { get; set; }
+
+  /// <summary>The user's proficiency level in this skill.</summary>
+  public Level Level { get; set; }
+}

backend/src/SkillMatrixLlm.Api/Enums/Level.cs

@@ -0,0 +1,12 @@
+namespace SkillMatrixLlm.Api.Enums;
+
+/// <summary>Proficiency level of a user in a skill.</summary>
+public enum Level
+{
+  /// <summary>Basic familiarity with the skill.</summary>
+  Basic,
+  /// <summary>Working proficiency.</summary>
+  Intermediate,
+  /// <summary>Expert-level proficiency.</summary>
+  Pro
+}

backend/src/SkillMatrixLlm.Api/Enums/MembershipStatus.cs

@@ -0,0 +1,12 @@
+namespace SkillMatrixLlm.Api.Enums;
+
+/// <summary>Invitation status of a user's team membership.</summary>
+public enum MembershipStatus
+{
+  /// <summary>The user has been invited but not yet responded.</summary>
+  Invited,
+  /// <summary>The user has accepted the invitation.</summary>
+  Accepted,
+  /// <summary>The user has declined the invitation.</summary>
+  Declined
+}

backend/src/SkillMatrixLlm.Api/Enums/ProjectSource.cs

@@ -0,0 +1,10 @@
+namespace SkillMatrixLlm.Api.Enums;
+
+/// <summary>Indicates how a team was assembled for a project.</summary>
+public enum ProjectSource
+{
+  /// <summary>The team was proposed by the LLM.</summary>
+  LlmGenerated,
+  /// <summary>The team was manually assembled by a project manager.</summary>
+  ManuallyAssembled
+}