Merge pull request 'Populated README' (#14) from develop into master

Reviewed-on: #14

.drone.yml

@@ -13,8 +13,7 @@ steps:
   - name: pack-and-publish
     image: mcr.microsoft.com/dotnet/sdk:10.0
     environment:
-      NEXUS_KEY:
+      NEXUS_KEY: { from_secret: nexus_api_key }
-        from_secret: nexus_api_key
       NEXUS_URL: https://nexus.khongisa.co.za/repository/nuget-hosted/
       VERSION: 1.${DRONE_BUILD_NUMBER}.0
     commands:
@@ -42,6 +41,31 @@ steps:
       - dotnet pack LiteCharms.Entities/LiteCharms.Entities.csproj -c Release -p:PackageVersion=$VERSION -o dist/
       - dotnet nuget push dist/LiteCharms.Entities.$VERSION.nupkg --api-key $NEXUS_KEY --source $NEXUS_URL
 
+  - name: gitea-tag-release
+    image: alpine/git
+    environment:
+      GITEA_TOKEN: { from_secret: git_token }
+      GITEA_USER: { from_secret: git_username }
+      GITEA_PASS: { from_secret: git_password }
+      VERSION: 1.${DRONE_BUILD_NUMBER}.0
+    commands:
+      - apk add --no-cache curl
+      - git remote set-url origin https://$${GITEA_USER}:$${GITEA_PASS}@gitea.khongisa.co.za/litecharms/components.git
+      - git tag $VERSION
+      - git push origin $VERSION
+      - |
+        curl -X POST "https://gitea.khongisa.co.za/api/v1/repos/litecharms/components/releases" \
+             -H "Authorization: token $${GITEA_TOKEN}" \
+             -H "Content-Type: application/json" \
+             -d "{
+               \"tag_name\": \"$VERSION\",
+               \"target_commitish\": \"${DRONE_COMMIT_SHA}\",
+               \"name\": \"Library Suite $VERSION\",
+               \"body\": \"### Published NuGet Packages\nAll packages versioned as **$VERSION**:\n* LiteCharms.Abstractions\n* LiteCharms.Models\n* LiteCharms.Infrastructure\n* LiteCharms.Features\n* LiteCharms.Extensions\n* LiteCharms.Entities\n\n[View in Nexus](https://nexus.khongisa.co.za/repository/nuget-group/)\",
+               \"draft\": false,
+               \"prerelease\": false
+             }"
+
 trigger:
-  branch:
+  event:
-    - master
+    - pull_request

LiteCharms.Abstractions/Constants.cs

@@ -5,7 +5,6 @@ public static class Constants
     public const int QueueBounds = 100000;
 
     public const string ShopSchedulerName = "shop";
-    public const string ShopSchedulerInstanceId = "golden-dawn";
 
     public const string EmailServiceBus = nameof(EmailServiceBus);
     public const string GeneralServiceBus = nameof(GeneralServiceBus);

LiteCharms.Extensions/Quartz.cs

@@ -7,7 +7,7 @@ public static class Quartz
 {
     private const string databaseConfigName = "PostgresScheduler";
 
-    public static IServiceCollection AddQuartzSchedulerClient(this IServiceCollection services, string schedulerName, string schedulerId, IConfiguration configuration)
+    public static IServiceCollection AddQuartzSchedulerClient(this IServiceCollection services, string schedulerName, IConfiguration configuration)
     {
         var connectionString = configuration.GetConnectionString(databaseConfigName);
 
@@ -16,7 +16,7 @@ public static class Quartz
         services.AddQuartz(config =>
         {
             config.SchedulerName = schedulerName;
-            config.SchedulerId = schedulerId;
+            config.SchedulerId = "AUTO";
                         
             config.UseSimpleTypeLoader();
             config.UseDefaultThreadPool(options => options.MaxConcurrency = 0);
@@ -42,7 +42,7 @@ public static class Quartz
         return services;
     }
 
-    public static IServiceCollection AddQuartzScheduler(this IServiceCollection services, string schedulerName, string schedulerId, IConfiguration configuration)
+    public static IServiceCollection AddQuartzScheduler(this IServiceCollection services, string schedulerName, IConfiguration configuration)
     {
         var connectionString = configuration.GetConnectionString(databaseConfigName);
 
@@ -51,7 +51,7 @@ public static class Quartz
         services.AddQuartz(config =>
         {
             config.SchedulerName = schedulerName;
-            config.SchedulerId = schedulerId;
+            config.SchedulerId = "AUTO";
             config.InterruptJobsOnShutdown = true;
             config.InterruptJobsOnShutdownWithWait = true;
             config.MaxBatchSize = 5;

README.md

@@ -1 +1,23 @@
-# LiteCharmsShared
+# LiteCharms.Components
+
+A suite of shared libraries providing core logic, models, and infrastructure for the LiteCharms ecosystem.
+
+## 📦 Published Packages
+All packages are versioned and pushed to [Nexus](https://nexus.khongisa.co.za) automatically via CI/CD.
+
+* **Abstractions:** Interfaces and base contracts.
+* **Models:** Shared DTOs and Request/Response objects.
+* **Entities:** Database schema definitions.
+* **Infrastructure:** Persistence and external service clients.
+* **Features:** Core business logic modules.
+* **Extensions:** Shared helper methods and DI configurations.
+
+## 🚀 CI/CD Workflow
+1. Create a **Pull Request** to `master`.
+2. Drone CI builds, tests, and packs the suite as `1.${DRONE_BUILD_NUMBER}.0`.
+3. Packages are pushed to the Nexus `nuget-hosted` repository.
+4. A formal **Gitea Release** is created with the versioned "Bill of Materials."
+
+## 🛠 Usage
+Add the Nexus NuGet source to your local environment and reference the version listed in the latest Gitea Release:
+`dotnet add package LiteCharms.Models -v 1.XX.0`