feat: project links

pujitm · pujitm · commit b69e7ccca38b · 2025-11-21T10:42:21.000-05:00
diff --git a/api/generated-schema.graphql b/api/generated-schema.graphql
@@ -1174,6 +1174,18 @@ type DockerContainer implements Node {
   autoStartWait: Int
   templatePath: String
 
+  """Project/Product homepage URL"""
+  projectUrl: String
+
+  """Registry/Docker Hub URL"""
+  registryUrl: String
+
+  """Support page/thread URL"""
+  supportUrl: String
+
+  """Icon URL"""
+  iconUrl: String
+
   """Whether the container is orphaned (no template found)"""
   isOrphaned: Boolean!
   isUpdateAvailable: Boolean
diff --git a/api/src/unraid-api/graph/resolvers/docker/docker-container.resolver.ts b/api/src/unraid-api/graph/resolvers/docker/docker-container.resolver.ts
@@ -7,12 +7,16 @@ import { AuthAction, UsePermissions } from '@unraid/shared/use-permissions.direc
 import { AppError } from '@app/core/errors/app-error.js';
 import { UseFeatureFlag } from '@app/unraid-api/decorators/use-feature-flag.decorator.js';
 import { DockerManifestService } from '@app/unraid-api/graph/resolvers/docker/docker-manifest.service.js';
+import { DockerTemplateScannerService } from '@app/unraid-api/graph/resolvers/docker/docker-template-scanner.service.js';
 import { DockerContainer } from '@app/unraid-api/graph/resolvers/docker/docker.model.js';
 
 @Resolver(() => DockerContainer)
 export class DockerContainerResolver {
     private readonly logger = new Logger(DockerContainerResolver.name);
-    constructor(private readonly dockerManifestService: DockerManifestService) {}
+    constructor(
+        private readonly dockerManifestService: DockerManifestService,
+        private readonly dockerTemplateScannerService: DockerTemplateScannerService
+    ) {}
 
     @UseFeatureFlag('ENABLE_NEXT_DOCKER_RELEASE')
     @UsePermissions({
@@ -39,6 +43,65 @@ export class DockerContainerResolver {
         return this.dockerManifestService.isRebuildReady(container.hostConfig?.networkMode);
     }
 
+    @UseFeatureFlag('ENABLE_NEXT_DOCKER_RELEASE')
+    @UsePermissions({
+        action: AuthAction.READ_ANY,
+        resource: Resource.DOCKER,
+    })
+    @ResolveField(() => String, { nullable: true })
+    public async projectUrl(@Parent() container: DockerContainer) {
+        if (!container.templatePath) return null;
+        const details = await this.dockerTemplateScannerService.getTemplateDetails(
+            container.templatePath
+        );
+        return details?.project || null;
+    }
+
+    @UseFeatureFlag('ENABLE_NEXT_DOCKER_RELEASE')
+    @UsePermissions({
+        action: AuthAction.READ_ANY,
+        resource: Resource.DOCKER,
+    })
+    @ResolveField(() => String, { nullable: true })
+    public async registryUrl(@Parent() container: DockerContainer) {
+        if (!container.templatePath) return null;
+        const details = await this.dockerTemplateScannerService.getTemplateDetails(
+            container.templatePath
+        );
+        return details?.registry || null;
+    }
+
+    @UseFeatureFlag('ENABLE_NEXT_DOCKER_RELEASE')
+    @UsePermissions({
+        action: AuthAction.READ_ANY,
+        resource: Resource.DOCKER,
+    })
+    @ResolveField(() => String, { nullable: true })
+    public async supportUrl(@Parent() container: DockerContainer) {
+        if (!container.templatePath) return null;
+        const details = await this.dockerTemplateScannerService.getTemplateDetails(
+            container.templatePath
+        );
+        return details?.support || null;
+    }
+
+    @UseFeatureFlag('ENABLE_NEXT_DOCKER_RELEASE')
+    @UsePermissions({
+        action: AuthAction.READ_ANY,
+        resource: Resource.DOCKER,
+    })
+    @ResolveField(() => String, { nullable: true })
+    public async iconUrl(@Parent() container: DockerContainer) {
+        if (container.labels?.['net.unraid.docker.icon']) {
+            return container.labels['net.unraid.docker.icon'];
+        }
+        if (!container.templatePath) return null;
+        const details = await this.dockerTemplateScannerService.getTemplateDetails(
+            container.templatePath
+        );
+        return details?.icon || null;
+    }
+
     @UseFeatureFlag('ENABLE_NEXT_DOCKER_RELEASE')
     @UsePermissions({
         action: AuthAction.UPDATE_ANY,
diff --git a/api/src/unraid-api/graph/resolvers/docker/docker-template-scanner.service.ts b/api/src/unraid-api/graph/resolvers/docker/docker-template-scanner.service.ts
@@ -120,6 +120,37 @@ export class DockerTemplateScannerService {
         return result;
     }
 
+    async getTemplateDetails(filePath: string): Promise<{
+        project?: string;
+        registry?: string;
+        support?: string;
+        overview?: string;
+        icon?: string;
+    } | null> {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const parsed = this.xmlParser.parse(content);
+
+            if (!parsed.Container) {
+                return null;
+            }
+
+            const container = parsed.Container;
+            return {
+                project: container.Project,
+                registry: container.Registry,
+                support: container.Support,
+                overview: container.ReadMe || container.Overview,
+                icon: container.Icon,
+            };
+        } catch (error) {
+            this.logger.warn(
+                `Failed to parse template ${filePath}: ${error instanceof Error ? error.message : 'Unknown error'}`
+            );
+            return null;
+        }
+    }
+
     private async loadAllTemplates(result: DockerTemplateSyncResult): Promise<ParsedTemplate[]> {
         const allTemplates: ParsedTemplate[] = [];
 
diff --git a/api/src/unraid-api/graph/resolvers/docker/docker.model.ts b/api/src/unraid-api/graph/resolvers/docker/docker.model.ts
@@ -202,6 +202,18 @@ export class DockerContainer extends Node {
     @Field(() => String, { nullable: true })
     templatePath?: string;
 
+    @Field(() => String, { nullable: true, description: 'Project/Product homepage URL' })
+    projectUrl?: string;
+
+    @Field(() => String, { nullable: true, description: 'Registry/Docker Hub URL' })
+    registryUrl?: string;
+
+    @Field(() => String, { nullable: true, description: 'Support page/thread URL' })
+    supportUrl?: string;
+
+    @Field(() => String, { nullable: true, description: 'Icon URL' })
+    iconUrl?: string;
+
     @Field(() => Boolean, { description: 'Whether the container is orphaned (no template found)' })
     isOrphaned!: boolean;
 }
diff --git a/api/src/unraid-api/graph/resolvers/docker/docker.mutations.resolver.spec.ts b/api/src/unraid-api/graph/resolvers/docker/docker.mutations.resolver.spec.ts
@@ -45,6 +45,7 @@ describe('DockerMutationsResolver', () => {
             state: ContainerState.RUNNING,
             status: 'Up 2 hours',
             names: ['test-container'],
+            isOrphaned: false,
         };
         vi.mocked(dockerService.start).mockResolvedValue(mockContainer);
 
@@ -65,6 +66,7 @@ describe('DockerMutationsResolver', () => {
             state: ContainerState.EXITED,
             status: 'Exited',
             names: ['test-container'],
+            isOrphaned: false,
         };
         vi.mocked(dockerService.stop).mockResolvedValue(mockContainer);
 
diff --git a/api/src/unraid-api/graph/resolvers/docker/docker.resolver.spec.ts b/api/src/unraid-api/graph/resolvers/docker/docker.resolver.spec.ts
@@ -127,6 +127,7 @@ describe('DockerResolver', () => {
                 ports: [],
                 state: ContainerState.EXITED,
                 status: 'Exited',
+                isOrphaned: false,
             },
             {
                 id: '2',
@@ -139,6 +140,7 @@ describe('DockerResolver', () => {
                 ports: [],
                 state: ContainerState.RUNNING,
                 status: 'Up 2 hours',
+                isOrphaned: false,
             },
         ];
         vi.mocked(dockerService.getContainers).mockResolvedValue(mockContainers);
@@ -168,6 +170,7 @@ describe('DockerResolver', () => {
                 sizeRootFs: 1024000,
                 state: ContainerState.EXITED,
                 status: 'Exited',
+                isOrphaned: false,
             },
         ];
         vi.mocked(dockerService.getContainers).mockResolvedValue(mockContainers);
@@ -210,6 +213,7 @@ describe('DockerResolver', () => {
                 ports: [],
                 state: ContainerState.EXITED,
                 status: 'Exited',
+                isOrphaned: false,
             },
         ];
         vi.mocked(dockerService.getContainers).mockResolvedValue(mockContainers);
diff --git a/api/src/unraid-api/graph/resolvers/docker/docker.service.ts b/api/src/unraid-api/graph/resolvers/docker/docker.service.ts
@@ -83,7 +83,7 @@ export class DockerService {
         return this.autostartService.getAutoStarts();
     }
 
-    public transformContainer(container: Docker.ContainerInfo): DockerContainer {
+    public transformContainer(container: Docker.ContainerInfo): Omit<DockerContainer, 'isOrphaned'> {
         const sizeValue = (container as Docker.ContainerInfo & { SizeRootFs?: number }).SizeRootFs;
         const primaryName = this.autostartService.getContainerPrimaryName(container) ?? '';
         const autoStartEntry = primaryName
@@ -110,7 +110,7 @@ export class DockerService {
             };
         });
 
-        const transformed: DockerContainer = {
+        const transformed: Omit<DockerContainer, 'isOrphaned'> = {
             id: container.Id,
             names: container.Names,
             image: container.Image,
diff --git a/api/src/unraid-api/graph/resolvers/docker/organizer/docker-organizer.service.spec.ts b/api/src/unraid-api/graph/resolvers/docker/organizer/docker-organizer.service.spec.ts
@@ -39,6 +39,7 @@ describe('containerToResource', () => {
             labels: {
                 'com.docker.compose.service': 'web',
             },
+            isOrphaned: false,
         };
 
         const result = containerToResource(container);
@@ -63,6 +64,7 @@ describe('containerToResource', () => {
             state: ContainerState.EXITED,
             status: 'Exited (0) 1 hour ago',
             autoStart: false,
+            isOrphaned: false,
         };
 
         const result = containerToResource(container);
@@ -84,6 +86,7 @@ describe('containerToResource', () => {
             state: ContainerState.EXITED,
             status: 'Exited (0) 5 minutes ago',
             autoStart: false,
+            isOrphaned: false,
         };
 
         const result = containerToResource(container);
@@ -125,6 +128,7 @@ describe('containerToResource', () => {
                 maintainer: 'dev-team',
                 version: '1.0.0',
             },
+            isOrphaned: false,
         };
 
         const result = containerToResource(container);
diff --git a/web/src/components/Docker/DockerContainersTable.vue b/web/src/components/Docker/DockerContainersTable.vue
@@ -70,6 +70,7 @@ const UInput = resolveComponent('UInput');
 const UDropdownMenu = resolveComponent('UDropdownMenu');
 const UModal = resolveComponent('UModal');
 const USkeleton = resolveComponent('USkeleton') as Component;
+const UIcon = resolveComponent('UIcon');
 const rowActionDropdownUi = {
   content: 'overflow-x-hidden z-50',
   item: 'bg-transparent hover:bg-transparent focus:bg-transparent border-0 ring-0 outline-none shadow-none data-[state=checked]:bg-transparent',
@@ -349,6 +350,61 @@ const columns = computed<TableColumn<TreeRow<DockerContainer>>[]>(() => {
       cell: ({ row }) =>
         row.original.type === 'folder' ? '' : h('span', null, String(row.getValue('version') || '')),
     },
+    {
+      accessorKey: 'links',
+      header: 'Links',
+      cell: ({ row }) => {
+        if (row.original.type === 'folder') return '';
+        const meta = row.original.meta;
+        const projectUrl = meta?.projectUrl;
+        const registryUrl = meta?.registryUrl;
+        const supportUrl = meta?.supportUrl;
+
+        if (!projectUrl && !registryUrl && !supportUrl) return '';
+
+        return h('div', { class: 'flex gap-2 items-center' }, [
+          projectUrl
+            ? h(
+                'a',
+                {
+                  href: projectUrl,
+                  target: '_blank',
+                  title: 'Project Page',
+                  class:
+                    'text-gray-500 hover:text-primary-500 dark:text-gray-400 dark:hover:text-primary-400',
+                },
+                h(UIcon, { name: 'i-lucide-globe', class: 'w-4 h-4' })
+              )
+            : null,
+          registryUrl
+            ? h(
+                'a',
+                {
+                  href: registryUrl,
+                  target: '_blank',
+                  title: 'Registry',
+                  class:
+                    'text-gray-500 hover:text-primary-500 dark:text-gray-400 dark:hover:text-primary-400',
+                },
+                h(UIcon, { name: 'i-lucide-external-link', class: 'w-4 h-4' })
+              )
+            : null,
+          supportUrl
+            ? h(
+                'a',
+                {
+                  href: supportUrl,
+                  target: '_blank',
+                  title: 'Support',
+                  class:
+                    'text-gray-500 hover:text-primary-500 dark:text-gray-400 dark:hover:text-primary-400',
+                },
+                h(UIcon, { name: 'i-lucide-life-buoy', class: 'w-4 h-4' })
+              )
+            : null,
+        ]);
+      },
+    },
     {
       accessorKey: 'network',
       header: 'Network',
@@ -428,6 +484,7 @@ function getDefaultColumnVisibility(isCompact: boolean): Record<string, boolean>
       cpu: false,
       memory: false,
       version: false,
+      links: true,
       network: false,
       containerIp: false,
       containerPort: false,
@@ -443,6 +500,7 @@ function getDefaultColumnVisibility(isCompact: boolean): Record<string, boolean>
       cpu: true,
       memory: true,
       version: false,
+      links: true,
       network: false,
       containerIp: false,
       containerPort: false,
diff --git a/web/src/components/Docker/DockerOrphanedAlert.vue b/web/src/components/Docker/DockerOrphanedAlert.vue
@@ -9,7 +9,7 @@ interface Props {
   orphanedContainers: DockerContainer[];
 }
 
-const props = withDefaults(defineProps<Props>(), {
+withDefaults(defineProps<Props>(), {
   orphanedContainers: () => [],
 });
 
diff --git a/web/src/components/Docker/docker-containers.query.ts b/web/src/components/Docker/docker-containers.query.ts
@@ -45,6 +45,10 @@ export const GET_DOCKER_CONTAINERS = gql`
         networkSettings
         mounts
         isOrphaned
+        projectUrl
+        registryUrl
+        supportUrl
+        iconUrl
       }
       organizer(skipCache: $skipCache) {
         version
@@ -87,6 +91,10 @@ export const GET_DOCKER_CONTAINERS = gql`
               isRebuildReady
               templatePath
               isOrphaned
+              projectUrl
+              registryUrl
+              supportUrl
+              iconUrl
             }
           }
         }
diff --git a/web/src/composables/gql/gql.ts b/web/src/composables/gql/gql.ts
diff --git a/web/src/composables/gql/graphql.ts b/web/src/composables/gql/graphql.ts

Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@ interface Props {`
`9`	`9`	`orphanedContainers: DockerContainer[];`
`10`	`10`	`}`
`11`	`11`
`12`		`-const props = withDefaults(defineProps<Props>(), {`
	`12`	`+withDefaults(defineProps<Props>(), {`
`13`	`13`	`orphanedContainers: () => [],`
`14`	`14`	`});`
`15`	`15`