Refactor URL coverage documentation and update StoreService for color variants

- Updated `url-coverage.md` to clarify the behavior of the `api/rooms/v2/myRecent` endpoint.
- Enhanced `StoreService.cs` to include new properties for color variants: `combination_id` and `descriptor`.
- Modified logic in `StoreService` to validate color variants based on the new descriptor instead of swatch GUID.
- Updated database bootstrap scripts to create new tables for `RoomConsumables` and `RoomConsumableOwnership`, including necessary indexes.
- Revised README to reflect changes in debugging options and the introduction of `DorkNet.DebugMod`.
- Updated documentation on request expectations to clarify server-side behavior for room visibility.
- Enhanced installation script to provide clearer instructions for enabling the debug console.
- Added a new document detailing the process for dumping avatar items and color variants from the Rec Room client.

DorkNet.Server/Startup/DatabaseBootstrap.cs

@@ -829,6 +829,37 @@ public static class DatabaseBootstrap
                 @"CREATE UNIQUE INDEX IF NOT EXISTS ""IX_UgcPurchasables_PublicId"" ON ""UgcPurchasables"" (""PublicId"");",
                 @"CREATE INDEX IF NOT EXISTS ""IX_UgcPurchasables_RoomId"" ON ""UgcPurchasables"" (""RoomId"");",
                 @"CREATE INDEX IF NOT EXISTS ""IX_UgcPurchasables_CreatorPlayerId"" ON ""UgcPurchasables"" (""CreatorPlayerId"");",
+                """
+                CREATE TABLE IF NOT EXISTS "RoomConsumables" (
+                    "Id" bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+                    "PublicId" uuid NOT NULL,
+                    "RoomId" bigint NOT NULL,
+                    "CreatorPlayerId" bigint NOT NULL,
+                    "Name" character varying(128) NOT NULL DEFAULT '',
+                    "Description" character varying(1024) NOT NULL DEFAULT '',
+                    "ImageName" character varying(256) NOT NULL DEFAULT '',
+                    "Price" bigint NOT NULL DEFAULT 0,
+                    "CurrencyId" uuid NULL,
+                    "IsDeleted" boolean NOT NULL DEFAULT false,
+                    "CreatedAt" timestamp with time zone NOT NULL DEFAULT now(),
+                    "UpdatedAt" timestamp with time zone NOT NULL DEFAULT now()
+                );
+                """,
+                @"CREATE UNIQUE INDEX IF NOT EXISTS ""IX_RoomConsumables_PublicId"" ON ""RoomConsumables"" (""PublicId"");",
+                @"CREATE INDEX IF NOT EXISTS ""IX_RoomConsumables_RoomId"" ON ""RoomConsumables"" (""RoomId"");",
+                @"CREATE INDEX IF NOT EXISTS ""IX_RoomConsumables_CreatorPlayerId"" ON ""RoomConsumables"" (""CreatorPlayerId"");",
+                """
+                CREATE TABLE IF NOT EXISTS "RoomConsumableOwnership" (
+                    "Id" bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+                    "PlayerId" bigint NOT NULL,
+                    "RoomConsumableId" bigint NOT NULL,
+                    "Count" integer NOT NULL DEFAULT 0,
+                    "ConcurrencyCode" uuid NOT NULL,
+                    "ModifiedAt" timestamp with time zone NOT NULL DEFAULT now()
+                );
+                """,
+                @"CREATE UNIQUE INDEX IF NOT EXISTS ""IX_RoomConsumableOwnership_PlayerId_RoomConsumableId"" ON ""RoomConsumableOwnership"" (""PlayerId"", ""RoomConsumableId"");",
+                @"CREATE INDEX IF NOT EXISTS ""IX_RoomConsumableOwnership_RoomConsumableId"" ON ""RoomConsumableOwnership"" (""RoomConsumableId"");",
             };
 
             foreach (var sql in statements)
@@ -964,6 +995,37 @@ public static class DatabaseBootstrap
             @"CREATE UNIQUE INDEX IF NOT EXISTS ""IX_UgcPurchasables_PublicId"" ON ""UgcPurchasables"" (""PublicId"");",
             @"CREATE INDEX IF NOT EXISTS ""IX_UgcPurchasables_RoomId"" ON ""UgcPurchasables"" (""RoomId"");",
             @"CREATE INDEX IF NOT EXISTS ""IX_UgcPurchasables_CreatorPlayerId"" ON ""UgcPurchasables"" (""CreatorPlayerId"");",
+            """
+            CREATE TABLE IF NOT EXISTS "RoomConsumables" (
+                "Id" INTEGER NOT NULL CONSTRAINT "PK_RoomConsumables" PRIMARY KEY AUTOINCREMENT,
+                "PublicId" TEXT NOT NULL,
+                "RoomId" INTEGER NOT NULL,
+                "CreatorPlayerId" INTEGER NOT NULL,
+                "Name" TEXT NOT NULL DEFAULT '',
+                "Description" TEXT NOT NULL DEFAULT '',
+                "ImageName" TEXT NOT NULL DEFAULT '',
+                "Price" INTEGER NOT NULL DEFAULT 0,
+                "CurrencyId" TEXT NULL,
+                "IsDeleted" INTEGER NOT NULL DEFAULT 0,
+                "CreatedAt" TEXT NOT NULL,
+                "UpdatedAt" TEXT NOT NULL
+            );
+            """,
+            @"CREATE UNIQUE INDEX IF NOT EXISTS ""IX_RoomConsumables_PublicId"" ON ""RoomConsumables"" (""PublicId"");",
+            @"CREATE INDEX IF NOT EXISTS ""IX_RoomConsumables_RoomId"" ON ""RoomConsumables"" (""RoomId"");",
+            @"CREATE INDEX IF NOT EXISTS ""IX_RoomConsumables_CreatorPlayerId"" ON ""RoomConsumables"" (""CreatorPlayerId"");",
+            """
+            CREATE TABLE IF NOT EXISTS "RoomConsumableOwnership" (
+                "Id" INTEGER NOT NULL CONSTRAINT "PK_RoomConsumableOwnership" PRIMARY KEY AUTOINCREMENT,
+                "PlayerId" INTEGER NOT NULL,
+                "RoomConsumableId" INTEGER NOT NULL,
+                "Count" INTEGER NOT NULL DEFAULT 0,
+                "ConcurrencyCode" TEXT NOT NULL,
+                "ModifiedAt" TEXT NOT NULL
+            );
+            """,
+            @"CREATE UNIQUE INDEX IF NOT EXISTS ""IX_RoomConsumableOwnership_PlayerId_RoomConsumableId"" ON ""RoomConsumableOwnership"" (""PlayerId"", ""RoomConsumableId"");",
+            @"CREATE INDEX IF NOT EXISTS ""IX_RoomConsumableOwnership_RoomConsumableId"" ON ""RoomConsumableOwnership"" (""RoomConsumableId"");",
         };
 
         foreach (var sql in sqliteStatements)