Merge pull request 'Add TagType CRUD' (#1) from feature/add-tag-type-crud into development

Reviewed-on: #1
Reviewed-by: Sergio Matías <sergio.matias@agilewebs.com>

Core.Inventory.DAL.API/Controllers/FurnitureBaseController.cs

@@ -40,12 +40,12 @@ namespace Core.Inventory.DAL.API.Controllers
         /// Gets a furniture base record by ID.
         /// </summary>
         [HttpGet]
-        [Route("{id}")]
+        [Route("{mongoId}")]
         [ProducesResponseType(typeof(FurnitureBase), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status404NotFound)]
-        public async Task<IActionResult> GetByIdAsync([FromRoute] string id, CancellationToken cancellationToken)
+        public async Task<IActionResult> GetByIdAsync([FromRoute] string mongoId, CancellationToken cancellationToken)
         {
-            var result = await service.GetByIdAsync(id, cancellationToken);
+            var result = await service.GetByIdAsync(mongoId, cancellationToken);
             return result is not null ? Ok(result) : NotFound("Entity not found");
         }
 
@@ -80,11 +80,11 @@ namespace Core.Inventory.DAL.API.Controllers
         /// Changes the status of a furniture base record.
         /// </summary>
         [HttpPatch]
-        [Route("{id}/{newStatus}/ChangeStatus")]
+        [Route("{mongoId}/{newStatus}/ChangeStatus")]
         [ProducesResponseType(typeof(FurnitureBase), StatusCodes.Status200OK)]
-        public async Task<IActionResult> ChangeStatusAsync([FromRoute] string id, [FromRoute] StatusEnum newStatus, CancellationToken cancellationToken)
+        public async Task<IActionResult> ChangeStatusAsync([FromRoute] string mongoId, [FromRoute] StatusEnum newStatus, CancellationToken cancellationToken)
         {
-            var result = await service.ChangeStatusAsync(id, newStatus, cancellationToken);
+            var result = await service.ChangeStatusAsync(mongoId, newStatus, cancellationToken);
             return Ok(result);
         }
     }

Core.Inventory.DAL.API/Controllers/FurnitureVariantController.cs

@@ -25,12 +25,25 @@ namespace Core.Inventory.DAL.API.Controllers
     [AllowAnonymous]
     public class FurnitureVariantController(IFurnitureVariantProvider service) : ControllerBase
     {
+
         /// <summary>
         /// Gets all furniture variant records.
         /// </summary>
         [HttpGet]
         [ProducesResponseType(typeof(IEnumerable<FurnitureVariant>), StatusCodes.Status200OK)]
-        public async Task<IActionResult> GetAllVariantsByModelIdAsync([FromRoute] string modelId, CancellationToken cancellationToken)
+        public async Task<IActionResult> GetAllAsync(CancellationToken cancellationToken)
+        {
+            var result = await service.GetAllAsync(cancellationToken);
+            return Ok(result);
+        }
+
+        /// <summary>
+        /// Gets all furniture variant records by ModelId.
+        /// </summary>
+        [HttpGet]
+        [Route("ByModel/{modelId}")]
+        [ProducesResponseType(typeof(IEnumerable<FurnitureVariant>), StatusCodes.Status200OK)]
+        public async Task<IActionResult> GetAllVariantsByModelIdAsync(string modelId, CancellationToken cancellationToken)
         {
             var result = await service.GetAllByModelIdAsync(modelId, cancellationToken).ConfigureAwait(false);
 
@@ -46,15 +59,38 @@ namespace Core.Inventory.DAL.API.Controllers
         /// Gets a furniture variant record by ID.
         /// </summary>
         [HttpGet]
-        [Route("{id}")]
+        [Route("{mongoId}")]
         [ProducesResponseType(typeof(FurnitureVariant), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status404NotFound)]
-        public async Task<IActionResult> GetByIdAsync([FromRoute] string id, CancellationToken cancellationToken)
+        public async Task<IActionResult> GetByIdAsync([FromRoute] string mongoId, CancellationToken cancellationToken)
         {
-            var result = await service.GetByIdAsync(id, cancellationToken);
+            var result = await service.GetByIdAsync(mongoId, cancellationToken);
             return result is not null ? Ok(result) : NotFound("Entity not found");
         }
 
+        /// <summary>
+        /// Gets multiple furniture variants by their identifiers.
+        /// </summary>
+        /// <param name="request">List of variant IDs.</param>
+        /// <param name="cancellationToken">Cancellation token.</param>
+        /// <returns>A list of <see cref="FurnitureVariant"/>.</returns>
+        [HttpPost("ByIds")]
+        [ProducesResponseType(typeof(IEnumerable<FurnitureVariant>), StatusCodes.Status200OK)]
+        [ProducesResponseType(StatusCodes.Status204NoContent)]
+        [ProducesResponseType(StatusCodes.Status400BadRequest)]
+        public async Task<IActionResult> GetVariantsByIdsAsync([FromBody] string[] ids, CancellationToken cancellationToken)
+        {
+            if (ids is null || ids.Length == 0)
+                return BadRequest("At least one variant ID must be provided.");
+
+            var result = await service.GetAllByIdsAsync(ids, cancellationToken);
+
+            if (result is null || !result.Any())
+                return NoContent();
+
+            return Ok(result);
+        }
+
         /// <summary>
         /// Creates a new furniture variant.
         /// </summary>
@@ -86,11 +122,11 @@ namespace Core.Inventory.DAL.API.Controllers
         /// Changes the status of a furniture variant record.
         /// </summary>
         [HttpPatch]
-        [Route("{id}/{newStatus}/ChangeStatus")]
+        [Route("{mongoId}/{newStatus}/ChangeStatus")]
         [ProducesResponseType(typeof(FurnitureVariant), StatusCodes.Status200OK)]
-        public async Task<IActionResult> ChangeStatusAsync([FromRoute] string id, [FromRoute] StatusEnum newStatus, CancellationToken cancellationToken)
+        public async Task<IActionResult> ChangeStatusAsync([FromRoute] string mongoId, [FromRoute] StatusEnum newStatus, CancellationToken cancellationToken)
         {
-            var result = await service.ChangeStatusAsync(id, newStatus, cancellationToken);
+            var result = await service.ChangeStatusAsync(mongoId, newStatus, cancellationToken);
             return Ok(result);
         }
     }

Core.Inventory.DAL.API/Controllers/TagTypeController.cs

@@ -0,0 +1,154 @@
+using Asp.Versioning;
+using Core.Adapters.Lib;
+using Core.Blueprint.Logging;
+using Core.Blueprint.Mongo;
+using Core.Inventory.Domain.Contexts.Inventory.Request;
+using Core.Inventory.Provider.Contracts;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Core.Inventory.DAL.API.Controllers
+{
+    /// <summary>
+    /// Handles all requests for TagType authentication.
+    /// </summary>
+    [ApiVersion(MimeTypes.ApplicationVersion)]
+    [Route("api/v{api-version:apiVersion}/[controller]")]
+    [Produces(MimeTypes.ApplicationJson)]
+    [Consumes(MimeTypes.ApplicationJson)]
+    [ApiController]
+    [AllowAnonymous]
+    public class TagTypeController(ITagTypeProvider service) : ControllerBase
+    {
+        /// <summary>
+        /// Gets all the TagTypes.
+        /// </summary>
+        /// <returns>The <see cref="IEnumerable{TagTypeAdapter}"/> found entities.</returns>
+        /// <response code="200">The tagTypes found.</response>
+        /// <response code="404">The tagTypes not found error.</response>
+        /// <response code="500">The service internal error.</response>
+        [HttpGet]
+        [Consumes(MimeTypes.ApplicationJson)]
+        [Produces(MimeTypes.ApplicationJson)]
+        [ProducesResponseType(typeof(IEnumerable<TagTypeAdapter>), StatusCodes.Status200OK)]
+        public async Task<IActionResult> GetAllTagTypesAsync(CancellationToken cancellationToken)
+        {
+            var result = await service.GetAllTagTypes(cancellationToken).ConfigureAwait(false);
+            return Ok(result);
+        }
+
+        /// <summary>
+        /// Gets all the TagTypes by TagType identifiers.
+        /// </summary>
+        /// <param name="TagTypes">The list of TagType identifiers.</param>
+        /// <returns>The <see cref="IEnumerable{TagTypeAdapter}"/> found entities.</returns>
+        /// <response code="200">The TagTypes found.</response>
+        /// <response code="404">The TagTypes not found error.</response>
+        /// <response code="500">The service internal error.</response>
+        [HttpPost]
+        [Route("GetTagTypeList")]
+        [Consumes(MimeTypes.ApplicationJson)]
+        [Produces(MimeTypes.ApplicationJson)]
+        [ProducesResponseType(typeof(IEnumerable<TagTypeAdapter>), StatusCodes.Status200OK)]
+        public async Task<IActionResult> GetAllTagTypesByList([FromBody] string[] tagTypes, CancellationToken cancellationToken)
+        {
+            if (tagTypes == null || !tagTypes.Any())
+            {
+                return BadRequest("TagType identifiers are required.");
+            }
+
+            var result = await service.GetAllTagTypesByList(tagTypes, cancellationToken).ConfigureAwait(false);
+            return Ok(result);
+        }
+
+
+        /// <summary>
+        /// Gets the TagType by identifier.
+        /// </summary>
+        /// <param name="id">The TagType identifier.</param>
+        /// <returns>The <see cref="TagTypeAdapter"/> found entity.</returns>
+        /// <response code="200">The TagType found.</response>
+        /// <response code="404">The TagType not found error.</response>
+        /// <response code="500">The service internal error.</response>
+        [HttpGet]
+        [Route("{id}")]
+        [Consumes(MimeTypes.ApplicationJson)]
+        [Produces(MimeTypes.ApplicationJson)]
+        [ProducesResponseType(typeof(TagTypeAdapter), StatusCodes.Status200OK)]
+        public async Task<IActionResult> GetTagTypeByIdAsync([FromRoute] string id, CancellationToken cancellationToken)
+        {
+            var result = await service.GetTagTypeById(id, cancellationToken).ConfigureAwait(false);
+
+            if (result == null)
+            {
+                return NotFound("Entity not found");
+            }
+
+            return Ok(result);
+        }
+
+        /// <summary>
+        /// Creates a new TagType.
+        /// </summary>
+        /// <param name="newTagType">The TagType to be added.</param>
+        /// <returns>The <see cref="TagTypeAdapter"/> created entity.</returns>
+        /// <response code="201">The TagType created.</response>
+        /// <response code="422">The TagType could not be created.</response>
+        /// <response code="500">The service internal e|ror.</response>
+        [HttpPost]
+        [ProducesResponseType(typeof(TagTypeAdapter), StatusCodes.Status201Created)]
+        public async Task<IActionResult> CreateTagTypeAsync([FromBody] TagTypeRequest newTagType, CancellationToken cancellationToken)
+        {
+            var result = await service.CreateTagType(newTagType, cancellationToken).ConfigureAwait(false);
+            return Created("CreatedWithIdAsync", result);
+        }
+
+        /// <summary>
+        /// Updates a full TagType by identifier.
+        /// </summary>
+        /// <param name="entity">The TagType to update.</param>
+        /// <param name="id">The TagType identifier.</param>
+        /// <returns>The <see cref="TagTypeAdapter"/> updated entity.</returns>
+        /// <response code="200">The TagType updated.</response>
+        /// <response code="404">The TagType not found.</response>
+        /// <response code="422">The TagType could not be updated.</response>
+        /// <response code="500">The service internal error.</response>
+        [HttpPut]
+        [Route("{id}")]
+        [Consumes(MimeTypes.ApplicationJson)]
+        [Produces(MimeTypes.ApplicationJson)]
+        [ProducesResponseType(typeof(TagTypeAdapter), StatusCodes.Status200OK)]
+        public async Task<IActionResult> UpdateTagTypeAsync([FromRoute] string id, TagTypeAdapter entity, CancellationToken cancellationToken)
+        {
+            if (id != entity.Id?.ToString())
+            {
+                return BadRequest("TagType ID mismatch");
+            }
+
+            var result = await service.UpdateTagType(entity, cancellationToken).ConfigureAwait(false);
+
+            return Ok(result);
+        }
+
+        /// <summary>
+        /// Changes the status of the TagType.
+        /// </summary>
+        /// <param name="id">The TagType identifier.</param>
+        /// <param name="newStatus">The new status of the TagType.</param>
+        /// <returns>The <see cref="TagTypeAdapter"/> updated entity.</returns>
+        /// <response code="200">The TagType updates.</response>
+        /// <response code="404">The TagType not found.</response>
+        /// <response code="422">The TagType could not be deleted.</response>
+        /// <response code="500">The service internal error.</response>
+        [HttpPatch]
+        [Route("{id}/{newStatus}/ChangeStatus")]
+        [Consumes(MimeTypes.ApplicationJson)]
+        [Produces(MimeTypes.ApplicationJson)]
+        [ProducesResponseType(typeof(TagTypeAdapter), StatusCodes.Status200OK)]
+        public async Task<IActionResult> ChangeTagTypeStatus([FromRoute] string id, [FromRoute] StatusEnum newStatus, CancellationToken cancellationToken)
+        {
+            var result = await service.ChangeTagTypeStatus(id, newStatus, cancellationToken).ConfigureAwait(false);
+            return Ok(result);
+        }
+    }
+}

Core.Inventory.DAL.API/appsettings.Development.json

@@ -12,7 +12,7 @@
   },
   "MongoDb": {
     "DatabaseName": "Inventory",
-    "LocalAudience": ""
+    "LocalAudience": "InventotyDev"
   },
   "DetailedErrors": true,
   "UseRedisCache": true,

Core.Inventory.DAL.API/appsettings.Local.json

@@ -12,7 +12,7 @@
   },
   "MongoDb": {
     "DatabaseName": "Inventory",
-    "LocalAudience": ""
+    "LocalAudience": "InventotyLocal"
   },
   "DetailedErrors": true,
   "UseRedisCache": true,

Core.Inventory.Domain/Contexts/Inventory/Request/InventoryItemRequestBase.cs

@@ -37,7 +37,7 @@ namespace Core.Inventory.Domain.Contexts.Inventory.Request
         [BsonElement("currency")]
         [BsonRepresentation(BsonType.String)]
         [JsonPropertyName("currency")]
-        public string Currency { get; set; } = "MXN";
+        public string Currency { get; set; } = "USD";
 
         /// <summary>
         /// Gets or sets the category identifier the item belongs to.
@@ -45,7 +45,7 @@ namespace Core.Inventory.Domain.Contexts.Inventory.Request
         [BsonElement("categoryId")]
         [BsonRepresentation(BsonType.String)]
         [JsonPropertyName("categoryId")]
-        public Guid CategoryId { get; set; }
+        public string CategoryId { get; set; } = string.Empty;
 
         /// <summary>
         /// Gets or sets the provider or vendor identifier of the item.
@@ -53,7 +53,7 @@ namespace Core.Inventory.Domain.Contexts.Inventory.Request
         [BsonElement("providerId")]
         [BsonRepresentation(BsonType.String)]
         [JsonPropertyName("providerId")]
-        public Guid ProviderId { get; set; }
+        public string ProviderId { get; set; } = string.Empty;
 
         /// <summary>
         /// Gets or sets additional customizable attributes.
@@ -61,6 +61,6 @@ namespace Core.Inventory.Domain.Contexts.Inventory.Request
         /// </summary>
         [BsonElement("attributes")]
         [JsonPropertyName("attributes")]
-        public Dictionary<string, object> Attributes { get; set; } = [];
+        public Dictionary<string, string> Attributes { get; set; } = [];
     }
 }

Core.Inventory.Domain/Contexts/Inventory/Request/TagTypeRequest.cs

@@ -0,0 +1,44 @@
+using MongoDB.Bson;
+using MongoDB.Bson.Serialization.Attributes;
+using System.Text.Json.Serialization;
+
+namespace Core.Inventory.Domain.Contexts.Inventory.Request
+{
+    /// <summary>
+    /// Data transfer object (DTO) for adding tagType.
+    /// </summary>
+    public class TagTypeRequest
+    {
+        /// <summary>
+        /// Gets or sets the tenantId of the tagType.
+        /// </summary>
+        [BsonElement("tenantId")]
+        [BsonRepresentation(BsonType.String)]
+        [JsonPropertyName("tenantId")]
+        public string TenantId { get; set; } = null!;
+
+        /// <summary>
+        /// Gets or sets the typeName of the tagType.
+        /// </summary>
+        [BsonElement("typeName")]
+        [BsonRepresentation(BsonType.String)]
+        [JsonPropertyName("typeName")]
+        public string TypeName { get; set; } = null!;
+
+        /// <summary>
+        /// Gets or sets the level of the tagType.
+        /// </summary>
+        [BsonElement("level")]
+        [BsonRepresentation(BsonType.Int32)]
+        [JsonPropertyName("level")]
+        public int Level { get; set; }
+
+        /// <summary>
+        /// Gets or sets the parentTypeId of the tagType.
+        /// </summary>
+        [BsonElement("parentTypeId")]
+        [BsonRepresentation(BsonType.String)]
+        [JsonPropertyName("parentTypeId")]
+        public string ParentTypeId { get; set; } = null!;
+    }
+}

Core.Inventory.Provider/Contracts/IFurnitureBaseProvider.cs

@@ -25,10 +25,10 @@ namespace Core.Inventory.Provider.Contracts
         /// <summary>
         /// Gets a furniture base entity by its ID.
         /// </summary>
-        /// <param name="id">The unique identifier (_id) of the furniture base.</param>
+        /// <param name="_id">The unique identifier (_id) of the furniture base.</param>
         /// <param name="cancellationToken">Cancellation token.</param>
         /// <returns>The corresponding <see cref="FurnitureBase"/>.</returns>
-        ValueTask<FurnitureBase> GetByIdAsync(string id, CancellationToken cancellationToken);
+        ValueTask<FurnitureBase> GetByIdAsync(string _id, CancellationToken cancellationToken);
 
         /// <summary>
         /// Retrieves all furniture base entries.
@@ -49,10 +49,10 @@ namespace Core.Inventory.Provider.Contracts
         /// <summary>
         /// Changes the status of a furniture base entity.
         /// </summary>
-        /// <param name="id">The entity identifier.</param>
+        /// <param name="_id">The entity identifier.</param>
         /// <param name="newStatus">The new status to apply.</param>
         /// <param name="cancellationToken">Cancellation token.</param>
         /// <returns>The updated <see cref="FurnitureBase"/>.</returns>
-        ValueTask<FurnitureBase> ChangeStatusAsync(string id, StatusEnum newStatus, CancellationToken cancellationToken);
+        ValueTask<FurnitureBase> ChangeStatusAsync(string _id, StatusEnum newStatus, CancellationToken cancellationToken);
     }
 }

Core.Inventory.Provider/Contracts/IFurnitureVariantProvider.cs

@@ -25,10 +25,18 @@ namespace Core.Inventory.Provider.Contracts
         /// <summary>
         /// Gets a furniture variant entity by its ID.
         /// </summary>
-        /// <param name="id">The unique identifier (_id) of the furniture variant.</param>
+        /// <param name="_id">The unique identifier (_id) of the furniture variant.</param>
         /// <param name="cancellationToken">Cancellation token.</param>
         /// <returns>The corresponding <see cref="FurnitureVariant"/>.</returns>
-        ValueTask<FurnitureVariant> GetByIdAsync(string id, CancellationToken cancellationToken);
+        ValueTask<FurnitureVariant> GetByIdAsync(string _id, CancellationToken cancellationToken);
+
+        /// <summary>
+        /// Retrieves all furniture variants by a list of variant IDs.
+        /// </summary>
+        /// <param name="ids">Array of variant IDs.</param>
+        /// <param name="cancellationToken">Cancellation token.</param>
+        /// <returns>A list of <see cref="FurnitureVariant"/> matching the specified IDs.</returns>
+        ValueTask<IEnumerable<FurnitureVariant>> GetAllByIdsAsync(string[] ids, CancellationToken cancellationToken);
 
         /// <summary>
         /// Retrieves all furniture variants associated with a base model.
@@ -50,10 +58,17 @@ namespace Core.Inventory.Provider.Contracts
         /// <summary>
         /// Changes the status of a furniture variant entity.
         /// </summary>
-        /// <param name="id">The entity identifier.</param>
+        /// <param name="_id">The entity identifier.</param>
         /// <param name="newStatus">The new status to apply.</param>
         /// <param name="cancellationToken">Cancellation token.</param>
         /// <returns>The updated <see cref="FurnitureVariant"/>.</returns>
-        ValueTask<FurnitureVariant> ChangeStatusAsync(string id, StatusEnum newStatus, CancellationToken cancellationToken);
+        ValueTask<FurnitureVariant> ChangeStatusAsync(string _id, StatusEnum newStatus, CancellationToken cancellationToken);
+
+        /// <summary>
+        /// Retrieves all furniture variant entities.
+        /// </summary>
+        /// <param name="cancellationToken">Cancellation token.</param>
+        /// <returns>A list of all <see cref="FurnitureVariant"/> entities.</returns>
+        ValueTask<IEnumerable<FurnitureVariant>> GetAllAsync(CancellationToken cancellationToken);
     }
 }

Core.Inventory.Provider/Contracts/ITagTypeProvider.cs

@@ -0,0 +1,59 @@
+using Core.Adapters.Lib;
+using Core.Blueprint.Mongo;
+using Core.Inventory.Domain.Contexts.Inventory.Request;
+
+namespace Core.Inventory.Provider.Contracts
+{
+    public interface ITagTypeProvider
+    {
+        /// <summary>
+        /// Creates a new TagType.
+        /// </summary>
+        /// <param name="entity">The TagType to be created.</param>
+        /// <returns>A <see cref="{Task{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        ValueTask<TagTypeAdapter> CreateTagType(TagTypeRequest newTagType, CancellationToken cancellationToken);
+
+        /// <summary>
+        /// Gets an TagType by identifier.
+        /// </summary>
+        /// <param name="id">The TagType identifier.</param>
+        /// <returns>A <see cref="{Task{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        ValueTask<TagTypeAdapter> GetTagTypeById(string _id, CancellationToken cancellationToken);
+
+        /// <summary>
+        /// Gets all the tagTypes.
+        /// </summary>
+        /// <returns>A <see cref="{Task{IEnumerbale{TagTypeAdapter}}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        ValueTask<IEnumerable<TagTypeAdapter>> GetAllTagTypes(CancellationToken cancellationToken);
+
+        /// <summary>
+        /// Gets all the tagTypes by tagTypes identifier list.
+        /// </summary>
+        /// <param name="tagTypes">The list of tagTypes identifiers.</param>
+        /// <returns>A <see cref="Task{IEnumerable{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        ValueTask<IEnumerable<TagTypeAdapter>> GetAllTagTypesByList(string[] TagTypes, CancellationToken cancellationToken);
+
+        /// <summary>
+        /// Changes the status of the tagType.
+        /// </summary>
+        /// <param name="id">The tagType identifier.</param>
+        /// <param name="newStatus">The new status of the tagType.</param>
+        /// <returns>The <see cref="TagTypeAdapter"/> updated entity.</returns>
+        /// <returns>A <see cref="{Task{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        ValueTask<TagTypeAdapter> ChangeTagTypeStatus(string id, StatusEnum newStatus, CancellationToken cancellationToken);
+
+        /// <summary>
+        /// Updates a TagType by id.
+        /// </summary>
+        /// <param name="entity">The TagType to be updated.</param>
+        /// <param name="id">The TagType identifier.</param>
+        /// <returns>A <see cref="{Task{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        ValueTask<TagTypeAdapter> UpdateTagType(TagTypeAdapter entity, CancellationToken cancellationToken);
+    }
+}

Core.Inventory.Provider/Core.Inventory.Provider.csproj

@@ -7,9 +7,9 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Adapters.Lib" Version="1.0.3" />
+    <PackageReference Include="Adapters.Lib" Version="1.0.9" />
     <PackageReference Include="Core.Blueprint.Mongo" Version="1.0.0" />
-    <PackageReference Include="Core.Blueprint.Redis" Version="1.0.1" />
+    <PackageReference Include="Core.Blueprint.Redis" Version="1.0.2" />
     <PackageReference Include="Mapster" Version="7.4.0" />
   </ItemGroup>
 

Core.Inventory.Provider/Providers/Inventory/FurnitureBaseProvider.cs

@@ -22,6 +22,7 @@ namespace Core.Inventory.Provider.Providers.Inventory
         private readonly CollectionRepository<FurnitureBase> repository;
         private readonly IRedisCacheProvider cacheProvider;
         private readonly CacheSettings cacheSettings;
+        private const string getAllCache = "GetAllFurnitureBases";
 
         public FurnitureBaseProvider(
             CollectionRepository<FurnitureBase> repository,
@@ -38,15 +39,16 @@ namespace Core.Inventory.Provider.Providers.Inventory
         /// <summary>
         /// Changes the status of a FurnitureBase entity.
         /// </summary>
-        /// <param name="id">The furniture base identifier.</param>
+        /// <param name="mongoId">The furniture base identifier.</param>
         /// <param name="newStatus">The new status to apply.</param>
         /// <param name="cancellationToken">Cancellation token.</param>
         /// <returns>The updated <see cref="FurnitureBase"/>.</returns>
-        public async ValueTask<FurnitureBase> ChangeStatusAsync(string id, StatusEnum newStatus, CancellationToken cancellationToken)
+        public async ValueTask<FurnitureBase> ChangeStatusAsync(string mongoId, StatusEnum newStatus, CancellationToken cancellationToken)
         {
-            var entity = await repository.FindByIdAsync(id);
+            var entity = await repository.FindByIdAsync(mongoId);
             entity.Status = newStatus;
             await repository.ReplaceOneAsync(entity);
+            await ResetCollectionCache();
             return entity;
         }
 
@@ -60,6 +62,7 @@ namespace Core.Inventory.Provider.Providers.Inventory
         {
             var furnitureCollection = newFurniture.Adapt<FurnitureBase>();
             await repository.InsertOneAsync(furnitureCollection);
+            await ResetCollectionCache();
             return furnitureCollection;
         }
 
@@ -70,7 +73,7 @@ namespace Core.Inventory.Provider.Providers.Inventory
         /// <returns>A list of <see cref="FurnitureBase"/>.</returns>
         public async ValueTask<IEnumerable<FurnitureBase>> GetAllAsync(CancellationToken cancellationToken)
         {
-            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, nameof(GetAllAsync));
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, getAllCache);
             var cachedData = await cacheProvider.GetAsync<IEnumerable<FurnitureBase>>(cacheKey) ?? [];
 
             if (cachedData.Any()) return cachedData;
@@ -83,17 +86,17 @@ namespace Core.Inventory.Provider.Providers.Inventory
         /// <summary>
         /// Gets a FurnitureBase entity by its ID.
         /// </summary>
-        /// <param name="id">The furniture base identifier.</param>
+        /// <param name="mongoId">The furniture base identifier.</param>
         /// <param name="cancellationToken">Cancellation token.</param>
         /// <returns>The corresponding <see cref="FurnitureBase"/>.</returns>
-        public async ValueTask<FurnitureBase> GetByIdAsync(string id, CancellationToken cancellationToken)
+        public async ValueTask<FurnitureBase> GetByIdAsync(string mongoId, CancellationToken cancellationToken)
         {
-            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, nameof(GetByIdAsync), id);
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, nameof(GetByIdAsync), mongoId);
             var cached = await cacheProvider.GetAsync<FurnitureBase>(cacheKey);
 
             if (cached is not null) return cached;
 
-            var result = await repository.FindByIdAsync(id);
+            var result = await repository.FindByIdAsync(mongoId);
             await cacheProvider.SetAsync(cacheKey, result);
             return result;
         }
@@ -108,7 +111,20 @@ namespace Core.Inventory.Provider.Providers.Inventory
         public async ValueTask<FurnitureBase> UpdateAsync(string id, FurnitureBase entity, CancellationToken cancellationToken)
         {
             await repository.ReplaceOneAsync(entity);
+            await ResetCollectionCache();
             return entity;
         }
+
+        /// <summary>
+        /// Temporary method to "reset" collections cache
+        /// </summary>
+        /// <returns></returns>
+        private async Task ResetCollectionCache()
+        {
+            //TODO: remove this method when necessary.
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, getAllCache);
+
+            await cacheProvider.SetAsync(cacheKey, Enumerable.Empty<FurnitureBase>(), null);
+        }
     }
 }

Core.Inventory.Provider/Providers/Inventory/FurnitureVariantProvider.cs

@@ -11,6 +11,7 @@ using Core.Inventory.Domain.Contexts.Inventory.Request;
 using Core.Inventory.Provider.Contracts;
 using Mapster;
 using Microsoft.Extensions.Options;
+using MongoDB.Driver;
 
 namespace Core.Inventory.Provider.Providers.Inventory
 {
@@ -22,6 +23,7 @@ namespace Core.Inventory.Provider.Providers.Inventory
         private readonly CollectionRepository<FurnitureVariant> repository;
         private readonly IRedisCacheProvider cacheProvider;
         private readonly CacheSettings cacheSettings;
+        private const string getAllVariantsCache = "GetAllFurnitureVariants";
 
         public FurnitureVariantProvider(
             CollectionRepository<FurnitureVariant> repository,
@@ -38,15 +40,16 @@ namespace Core.Inventory.Provider.Providers.Inventory
         /// <summary>
         /// Changes the status of a FurnitureVariant entity.
         /// </summary>
-        /// <param name="id">The furniture variant identifier.</param>
+        /// <param name="mongoId">The furniture variant identifier.</param>
         /// <param name="newStatus">The new status to apply.</param>
         /// <param name="cancellationToken">Cancellation token.</param>
         /// <returns>The updated <see cref="FurnitureVariant"/>.</returns>
-        public async ValueTask<FurnitureVariant> ChangeStatusAsync(string id, StatusEnum newStatus, CancellationToken cancellationToken)
+        public async ValueTask<FurnitureVariant> ChangeStatusAsync(string mongoId, StatusEnum newStatus, CancellationToken cancellationToken)
         {
-            var entity = await repository.FindByIdAsync(id);
+            var entity = await repository.FindByIdAsync(mongoId);
             entity.Status = newStatus;
             await repository.ReplaceOneAsync(entity);
+            await ResetCollectionCache();
             return entity;
         }
 
@@ -60,6 +63,7 @@ namespace Core.Inventory.Provider.Providers.Inventory
         {
             var variantCollection = newVariant.Adapt<FurnitureVariant>();
             await repository.InsertOneAsync(variantCollection);
+            await ResetCollectionCache();
             return variantCollection;
         }
 
@@ -70,34 +74,62 @@ namespace Core.Inventory.Provider.Providers.Inventory
         /// <returns>A list of <see cref="FurnitureVariant"/>.</returns>
         public async ValueTask<IEnumerable<FurnitureVariant>> GetAllByModelIdAsync(string modelId, CancellationToken cancellationToken)
         {
-            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, nameof(GetAllByModelIdAsync));
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, nameof(GetAllByModelIdAsync), modelId);
+
             var cachedData = await cacheProvider.GetAsync<IEnumerable<FurnitureVariant>>(cacheKey);
+            if (cachedData is not null && cachedData.Any())
+                return cachedData;
 
-            if (cachedData.Any()) return cachedData;
+            var filter = Builders<FurnitureVariant>.Filter.Eq(x => x.ModelId, modelId);
+            var variants = await repository.FilterByMongoFilterAsync(filter);
 
-            var data = await repository.AsQueryable();
+            if (variants is not null && variants.Any())
-            await cacheProvider.SetAsync(cacheKey, data);
+                await cacheProvider.SetAsync(cacheKey, variants);
-            return data;
+
+            return variants ?? [];
         }
 
         /// <summary>
         /// Gets a FurnitureVariant entity by its ID.
         /// </summary>
-        /// <param name="id">The furniture variant identifier.</param>
+        /// <param name="mongoId">The furniture variant identifier.</param>
         /// <param name="cancellationToken">Cancellation token.</param>
         /// <returns>The corresponding <see cref="FurnitureVariant"/>.</returns>
-        public async ValueTask<FurnitureVariant> GetByIdAsync(string id, CancellationToken cancellationToken)
+        public async ValueTask<FurnitureVariant> GetByIdAsync(string mongoId, CancellationToken cancellationToken)
         {
-            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, nameof(GetByIdAsync), id);
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, nameof(GetByIdAsync), mongoId);
             var cached = await cacheProvider.GetAsync<FurnitureVariant>(cacheKey);
 
             if (cached is not null) return cached;
 
-            var result = await repository.FindByIdAsync(id);
+            var result = await repository.FindByIdAsync(mongoId);
             await cacheProvider.SetAsync(cacheKey, result);
             return result;
         }
 
+        /// <summary>
+        /// Retrieves all furniture variants by a list of variant IDs.
+        /// </summary>
+        /// <param name="ids">Array of variant IDs.</param>
+        /// <param name="cancellationToken">Cancellation token.</param>
+        /// <returns>A list of <see cref="FurnitureVariant"/> matching the specified IDs.</returns>
+        public async ValueTask<IEnumerable<FurnitureVariant>> GetAllByIdsAsync(string[] ids, CancellationToken cancellationToken)
+        {
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, nameof(GetAllByIdsAsync), ids);
+
+            var cachedData = await cacheProvider.GetAsync<IEnumerable<FurnitureVariant>>(cacheKey);
+            if (cachedData is not null && cachedData.Any())
+                return cachedData;
+
+            var filter = Builders<FurnitureVariant>.Filter.In(x => x.Id, ids);
+            var variants = await repository.FilterByMongoFilterAsync(filter);
+
+            if (variants is not null && variants.Any())
+                await cacheProvider.SetAsync(cacheKey, variants);
+
+            return variants ?? [];
+        }
+
         /// <summary>
         /// Updates a FurnitureVariant entity by ID.
         /// </summary>
@@ -108,7 +140,37 @@ namespace Core.Inventory.Provider.Providers.Inventory
         public async ValueTask<FurnitureVariant> UpdateAsync(string id, FurnitureVariant entity, CancellationToken cancellationToken)
         {
             await repository.ReplaceOneAsync(entity);
+            await ResetCollectionCache();
             return entity;
         }
+
+        /// <summary>
+        /// Retrieves all FurnitureVariant entries.
+        /// </summary>
+        /// <param name="cancellationToken">Cancellation token.</param>
+        /// <returns>A list of <see cref="FurnitureVariant"/>.</returns>
+        public async ValueTask<IEnumerable<FurnitureVariant>> GetAllAsync(CancellationToken cancellationToken)
+        {
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, getAllVariantsCache);
+            var cachedData = await cacheProvider.GetAsync<IEnumerable<FurnitureVariant>>(cacheKey) ?? [];
+
+            if (cachedData.Any()) return cachedData;
+
+            var data = await repository.AsQueryable();
+            await cacheProvider.SetAsync(cacheKey, data);
+            return data;
+        }
+
+        /// <summary>
+        /// Temporary method to "reset" collections cache
+        /// </summary>
+        /// <returns></returns>
+        private async Task ResetCollectionCache()
+        {
+            //TODO: remove this method when necessary.
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, getAllVariantsCache);
+
+            await cacheProvider.SetAsync(cacheKey, Enumerable.Empty<FurnitureVariant>(), null);
+        }
     }
 }

Core.Inventory.Provider/Providers/Inventory/TagTypeProvider.cs

@@ -0,0 +1,149 @@
+using Core.Adapters.Lib;
+using Core.Blueprint.Mongo;
+using Core.Blueprint.Redis;
+using Core.Blueprint.Redis.Helpers;
+using Core.Inventory.Domain.Contexts.Inventory.Request;
+using Core.Inventory.Provider.Contracts;
+using Mapster;
+using Microsoft.Extensions.Options;
+using MongoDB.Driver;
+
+namespace Core.Inventory.Provider.Providers.Inventory
+{
+    /// <summary>
+    /// Handles all services and business rules related to <see cref="TagTypeAdapter"/>.
+    /// </summary>
+    public class TagTypeProvider : ITagTypeProvider
+    {
+        private readonly CollectionRepository<TagTypeAdapter> repository;
+        private readonly CacheSettings cacheSettings;
+        private readonly IRedisCacheProvider cacheProvider;
+
+        public TagTypeProvider(CollectionRepository<TagTypeAdapter> repository,
+            IRedisCacheProvider cacheProvider,
+            IOptions<CacheSettings> cacheSettings)
+        {
+            this.repository = repository;
+            this.repository.CollectionInitialization();
+            this.cacheSettings = cacheSettings.Value;
+            this.cacheProvider = cacheProvider;
+        }
+
+        /// <summary>
+        /// Creates a new TagType.
+        /// </summary>
+        /// <param name="entity">The TagType to be created.</param>
+        /// <returns>A <see cref="{Task{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        public async ValueTask<TagTypeAdapter> CreateTagType(TagTypeRequest newTagType, CancellationToken cancellationToken)
+        {
+            var tagTypeCollection = newTagType.Adapt<TagTypeAdapter>();
+
+            await repository.InsertOneAsync(tagTypeCollection);
+
+            return tagTypeCollection;
+        }
+
+        /// <summary>
+        /// Gets an TagType by identifier.
+        /// </summary>
+        /// <param name="id">The TagType identifier.</param>
+        /// <returns>A <see cref="{Task{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>0
+        public async ValueTask<TagTypeAdapter> GetTagTypeById(string _id, CancellationToken cancellationToken)
+        {
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, "GetTagTypeById", _id);
+            var cachedData = await cacheProvider.GetAsync<TagTypeAdapter>(cacheKey);
+
+            if (cachedData is not null) { return cachedData; }
+
+            var tagType = await repository.FindByIdAsync(_id);
+
+            await cacheProvider.SetAsync(cacheKey, tagType);
+
+            return tagType;
+        }
+
+        /// <summary>
+        /// Gets all the TagTypes.
+        /// </summary>
+        /// <returns>A <see cref="{Task{IEnumerbale{TagTypeAdapter}}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        public async ValueTask<IEnumerable<TagTypeAdapter>> GetAllTagTypes(CancellationToken cancellationToken)
+        {
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, "GetTagTypes");
+            var cachedData = await cacheProvider.GetAsync<IEnumerable<TagTypeAdapter>>(cacheKey) ?? [];
+
+            if (cachedData.Any()) return cachedData;
+
+            var tagTypes = await repository.AsQueryable();
+
+            await cacheProvider.SetAsync(cacheKey, tagTypes);
+
+            return tagTypes;
+        }
+
+        /// <summary>
+        /// Gets all the TagTypes by TagTypes identifier list.
+        /// </summary>
+        /// <param name="TagTypes">The list of TagTypes identifiers.</param>
+        /// <returns>A <see cref="Task{IEnumerable{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        public async ValueTask<IEnumerable<TagTypeAdapter>> GetAllTagTypesByList(string[] tagTypes, CancellationToken cancellationToken)
+        {
+            var cacheKey = CacheKeyHelper.GenerateCacheKey(this, "GetAllTagTypesByList", tagTypes);
+
+            var cachedData = await cacheProvider.GetAsync<IEnumerable<TagTypeAdapter>>(cacheKey) ?? [];
+
+            if (cachedData.Any()) return cachedData;
+
+            var builder = Builders<TagTypeAdapter>.Filter;
+            var filters = new List<FilterDefinition<TagTypeAdapter>>();
+
+            if (tagTypes != null || !tagTypes.Any())
+            {
+                filters.Add(builder.In(x => x._Id, tagTypes));
+            }
+
+            var finalFilter = filters.Any() ? builder.And(filters) : builder.Empty;
+
+            var tagTypesList = await repository.FilterByMongoFilterAsync(finalFilter);
+
+            await cacheProvider.SetAsync(cacheKey, tagTypesList);
+
+            return tagTypesList;
+        }
+
+
+        /// <summary>
+        /// Changes the status of the TagType.
+        /// </summary>
+        /// <param name="id">The TagType identifier.</param>
+        /// <param name="newStatus">The new status of the TagType.</param>
+        /// <returns>A <see cref="{Task{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        public async ValueTask<TagTypeAdapter> ChangeTagTypeStatus(string id, StatusEnum newStatus, CancellationToken cancellationToken)
+        {
+            var entity = await repository.FindByIdAsync(id);
+            entity.Status = newStatus;
+
+            await repository.ReplaceOneAsync(entity);
+
+            return entity;
+        }
+
+        /// <summary>
+        /// Updates a TagType by id.
+        /// </summary>
+        /// <param name="entity">The TagType to be updated.</param>
+        /// <param name="id">The TagType identifier.</param>
+        /// <returns>A <see cref="{Task{TagTypeAdapter}}"/> representing
+        /// the asynchronous execution of the service.</returns>
+        public async ValueTask<TagTypeAdapter> UpdateTagType(TagTypeAdapter entity, CancellationToken cancellationToken)
+        {
+            await repository.ReplaceOneAsync(entity);
+
+            return entity;
+        }
+    }
+}

Core.Inventory.Provider/ServiceCollectionExtensions.cs

@@ -17,6 +17,9 @@ namespace Core.Inventory.Provider
             services.AddScoped<IFurnitureVariantProvider, FurnitureVariantProvider>();
             services.AddScoped<CollectionRepository<FurnitureVariant>>();
 
+            services.AddScoped<ITagTypeProvider, TagTypeProvider>();
+            services.AddScoped<CollectionRepository<TagTypeAdapter>>();
+
             return services;
 
         }