feat(api): add override fields to softwares table

JeromeBu · claude · JeromeBu · commit f95271220a9c · 2026-03-19T16:49:30.000+01:00
Allow manually curated values in softwares to override external source
data for 6 fields: isLibreSoftware, url, codeRepositoryUrl, softwareHelp,
latestVersion, and programmingLanguages.

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/api/src/core/adapters/dbApi/kysely/createPgSoftwareRepository.ts b/api/src/core/adapters/dbApi/kysely/createPgSoftwareRepository.ts
@@ -158,17 +158,18 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
             // Combine all data
             return softwareRows.map(software => {
                 const extData = externalDataRecord[software.id];
+                const resolvedLatestVersion = software.latestVersion ?? extData?.latestVersion;
                 return {
                     id: software.id,
                     name: software.name,
                     description: software.description,
                     image: extData?.image ?? software.image ?? undefined,
-                    latestVersion: extData?.latestVersion
+                    latestVersion: resolvedLatestVersion
                         ? {
-                              version: extData.latestVersion.version ?? undefined,
+                              version: resolvedLatestVersion.version ?? undefined,
                               releaseDate:
-                                  extData.latestVersion.releaseDate ??
-                                  (extData.dateCreated ? extData.dateCreated.toISOString().slice(0, 10) : undefined)
+                                  resolvedLatestVersion.releaseDate ??
+                                  (extData?.dateCreated ? extData.dateCreated.toISOString().slice(0, 10) : undefined)
                           }
                         : undefined,
                     addedTime: software.addedTime,
@@ -181,7 +182,7 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
                     operatingSystems: (software.operatingSystems ?? {}) as Partial<Record<Os, boolean>>,
                     runtimePlatforms: (software.runtimePlatforms ?? []) as RuntimePlatform[],
                     customAttributes: software.customAttributes ?? undefined,
-                    programmingLanguages: extData?.programmingLanguages ?? [],
+                    programmingLanguages: software.programmingLanguages ?? extData?.programmingLanguages ?? [],
                     authors: extData?.authors ?? [],
                     userAndReferentCountByOrganization: countsMap[software.id] ?? {},
                     similarSoftwares: similarMap[software.id] ?? []
@@ -274,17 +275,18 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
             return softwareRows.map(softwareRow => {
                 const extData = externalDataRecord[softwareRow.id];
                 const deref = softwareRow.dereferencing;
+                const resolvedLatestVersion = softwareRow.latestVersion ?? extData?.latestVersion;
                 return {
                     id: softwareRow.id,
                     name: softwareRow.name,
                     description: softwareRow.description,
                     image: extData?.image ?? softwareRow.image ?? undefined,
-                    latestVersion: extData?.latestVersion
+                    latestVersion: resolvedLatestVersion
                         ? {
-                              version: extData.latestVersion.version ?? undefined,
+                              version: resolvedLatestVersion.version ?? undefined,
                               releaseDate:
-                                  extData.latestVersion.releaseDate ??
-                                  (extData.dateCreated ? extData.dateCreated.toISOString().slice(0, 10) : undefined)
+                                  resolvedLatestVersion.releaseDate ??
+                                  (extData?.dateCreated ? extData.dateCreated.toISOString().slice(0, 10) : undefined)
                           }
                         : undefined,
                     addedTime: softwareRow.addedTime,
@@ -303,17 +305,17 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
                     customAttributes: softwareRow.customAttributes ?? undefined,
                     userAndReferentCountByOrganization: countsMap[softwareRow.id] ?? {},
                     authors: extData?.authors ?? [],
-                    url: extData?.url ?? undefined,
-                    codeRepositoryUrl: extData?.codeRepositoryUrl ?? undefined,
-                    softwareHelp: extData?.softwareHelp ?? undefined,
+                    url: softwareRow.url ?? extData?.url ?? undefined,
+                    codeRepositoryUrl: softwareRow.codeRepositoryUrl ?? extData?.codeRepositoryUrl ?? undefined,
+                    softwareHelp: softwareRow.softwareHelp ?? extData?.softwareHelp ?? undefined,
                     license: extData?.license ?? softwareRow.license,
                     externalId: extData?.externalId,
                     sourceSlug: extData?.sourceSlug,
                     operatingSystems: (softwareRow.operatingSystems ?? {}) as Partial<Record<Os, boolean>>,
                     runtimePlatforms: (softwareRow.runtimePlatforms ?? []) as RuntimePlatform[],
                     similarSoftwares: similarMap[softwareRow.id] ?? [],
                     keywords: softwareRow.keywords ?? [],
-                    programmingLanguages: extData?.programmingLanguages ?? [],
+                    programmingLanguages: softwareRow.programmingLanguages ?? extData?.programmingLanguages ?? [],
                     providers: extData?.providers ?? [],
                     referencePublications: extData?.referencePublications,
                     identifiers: extData?.identifiers,
@@ -403,17 +405,19 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
 
             const deref = softwareRow.dereferencing;
 
+            const resolvedLatestVersion = softwareRow.latestVersion ?? extData?.latestVersion;
+
             return {
                 id: softwareRow.id,
                 name: softwareRow.name,
                 description: softwareRow.description,
                 image: extData?.image ?? softwareRow.image ?? undefined,
-                latestVersion: extData?.latestVersion
+                latestVersion: resolvedLatestVersion
                     ? {
-                          version: extData.latestVersion.version ?? undefined,
+                          version: resolvedLatestVersion.version ?? undefined,
                           releaseDate:
-                              extData.latestVersion.releaseDate ??
-                              (extData.dateCreated ? extData.dateCreated.toISOString().slice(0, 10) : undefined)
+                              resolvedLatestVersion.releaseDate ??
+                              (extData?.dateCreated ? extData.dateCreated.toISOString().slice(0, 10) : undefined)
                       }
                     : undefined,
                 addedTime: softwareRow.addedTime,
@@ -432,17 +436,17 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
                 customAttributes: softwareRow.customAttributes ?? undefined,
                 userAndReferentCountByOrganization,
                 authors: extData?.authors ?? [],
-                url: extData?.url ?? undefined,
-                codeRepositoryUrl: extData?.codeRepositoryUrl ?? undefined,
-                softwareHelp: extData?.softwareHelp ?? undefined,
+                url: softwareRow.url ?? extData?.url ?? undefined,
+                codeRepositoryUrl: softwareRow.codeRepositoryUrl ?? extData?.codeRepositoryUrl ?? undefined,
+                softwareHelp: softwareRow.softwareHelp ?? extData?.softwareHelp ?? undefined,
                 license: extData?.license ?? softwareRow.license,
                 externalId: extData?.externalId,
                 sourceSlug: extData?.sourceSlug,
                 operatingSystems: (softwareRow.operatingSystems ?? {}) as Partial<Record<Os, boolean>>,
                 runtimePlatforms: (softwareRow.runtimePlatforms ?? []) as RuntimePlatform[],
                 similarSoftwares,
                 keywords: softwareRow.keywords ?? [],
-                programmingLanguages: extData?.programmingLanguages ?? [],
+                programmingLanguages: softwareRow.programmingLanguages ?? extData?.programmingLanguages ?? [],
                 providers: extData?.providers ?? [],
                 referencePublications: extData?.referencePublications,
                 identifiers: extData?.identifiers,
@@ -477,6 +481,12 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
                 applicationCategories,
                 keywords,
                 addedByUserId,
+                isLibreSoftware,
+                url,
+                codeRepositoryUrl,
+                softwareHelp,
+                latestVersion,
+                programmingLanguages,
                 ...rest
             } = software;
 
@@ -501,7 +511,13 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
                         runtimePlatforms: JSON.stringify(runtimePlatforms),
                         applicationCategories: JSON.stringify(applicationCategories),
                         addedByUserId,
-                        keywords: JSON.stringify(keywords)
+                        keywords: JSON.stringify(keywords),
+                        isLibreSoftware: isLibreSoftware ?? null,
+                        url: url ?? null,
+                        codeRepositoryUrl: codeRepositoryUrl ?? null,
+                        softwareHelp: softwareHelp ?? null,
+                        latestVersion: latestVersion ? JSON.stringify(latestVersion) : null,
+                        programmingLanguages: programmingLanguages ? JSON.stringify(programmingLanguages) : null
                     })
                     .returning("id as softwareId")
                     .executeTakeFirstOrThrow();
@@ -523,6 +539,12 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
                 applicationCategories,
                 keywords,
                 addedByUserId,
+                isLibreSoftware,
+                url,
+                codeRepositoryUrl,
+                softwareHelp,
+                latestVersion,
+                programmingLanguages,
                 ...rest
             } = software;
 
@@ -544,7 +566,13 @@ export const createPgSoftwareRepository = (db: Kysely<Database>): SoftwareReposi
                     runtimePlatforms: JSON.stringify(runtimePlatforms),
                     applicationCategories: JSON.stringify(applicationCategories),
                     addedByUserId,
-                    keywords: JSON.stringify(keywords)
+                    keywords: JSON.stringify(keywords),
+                    isLibreSoftware: isLibreSoftware ?? null,
+                    url: url ?? null,
+                    codeRepositoryUrl: codeRepositoryUrl ?? null,
+                    softwareHelp: softwareHelp ?? null,
+                    latestVersion: latestVersion ? JSON.stringify(latestVersion) : null,
+                    programmingLanguages: programmingLanguages ? JSON.stringify(programmingLanguages) : null
                 })
                 .where("id", "=", softwareId)
                 .execute();
diff --git a/api/src/core/adapters/dbApi/kysely/kysely.database.ts b/api/src/core/adapters/dbApi/kysely/kysely.database.ts
@@ -212,6 +212,12 @@ type SoftwaresTable = {
     addedByUserId: number;
     image: string | null;
     keywords: JSONColumnType<string[]>;
+    isLibreSoftware: boolean | null;
+    url: string | null;
+    codeRepositoryUrl: string | null;
+    softwareHelp: string | null;
+    latestVersion: JSONColumnType<{ version: string | null; releaseDate: string | null }> | null;
+    programmingLanguages: JSONColumnType<string[]> | null;
 };
 
 export namespace DatabaseRowOutput {
diff --git a/api/src/core/adapters/dbApi/kysely/migrations/1773933947738_add-override-fields-to-softwares.ts b/api/src/core/adapters/dbApi/kysely/migrations/1773933947738_add-override-fields-to-softwares.ts
@@ -0,0 +1,25 @@
+import type { Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+    await db.schema
+        .alterTable("softwares")
+        .addColumn("isLibreSoftware", "boolean")
+        .addColumn("url", "text")
+        .addColumn("codeRepositoryUrl", "text")
+        .addColumn("softwareHelp", "text")
+        .addColumn("latestVersion", "jsonb")
+        .addColumn("programmingLanguages", "jsonb")
+        .execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+    await db.schema
+        .alterTable("softwares")
+        .dropColumn("isLibreSoftware")
+        .dropColumn("url")
+        .dropColumn("codeRepositoryUrl")
+        .dropColumn("softwareHelp")
+        .dropColumn("latestVersion")
+        .dropColumn("programmingLanguages")
+        .execute();
+}
diff --git a/api/src/core/ports/DbApiV2.ts b/api/src/core/ports/DbApiV2.ts
@@ -36,6 +36,12 @@ export type SoftwareExtrinsicRow = Pick<
     | "applicationCategories"
     | "keywords"
     | "addedByUserId"
+    | "isLibreSoftware"
+    | "url"
+    | "codeRepositoryUrl"
+    | "softwareHelp"
+    | "latestVersion"
+    | "programmingLanguages"
 >;
 
 export namespace DatabaseDataType {
diff --git a/api/src/core/usecases/createSoftware.ts b/api/src/core/usecases/createSoftware.ts
@@ -25,7 +25,18 @@ export const formDataToSoftwareRow = (softwareForm: SoftwareFormData, userId: nu
         applicationCategories: [],
         addedByUserId: userId,
         keywords: softwareForm.keywords,
-        customAttributes: softwareForm.customAttributes
+        customAttributes: softwareForm.customAttributes,
+        isLibreSoftware: softwareForm.isLibreSoftware,
+        url: softwareForm.url,
+        codeRepositoryUrl: softwareForm.codeRepositoryUrl,
+        softwareHelp: softwareForm.softwareHelp,
+        latestVersion: softwareForm.latestVersion
+            ? {
+                  version: softwareForm.latestVersion.version ?? null,
+                  releaseDate: softwareForm.latestVersion.releaseDate ?? null
+              }
+            : undefined,
+        programmingLanguages: softwareForm.programmingLanguages
     };
 };
 
diff --git a/api/src/core/usecases/readWriteSillData/types.ts b/api/src/core/usecases/readWriteSillData/types.ts
@@ -111,6 +111,12 @@ export type SoftwareFormData = {
     image: string | undefined;
     keywords: string[];
     customAttributes: CustomAttributes | undefined;
+    isLibreSoftware?: boolean | undefined;
+    url?: string | undefined;
+    codeRepositoryUrl?: string | undefined;
+    softwareHelp?: string | undefined;
+    latestVersion?: { version: string | undefined; releaseDate: string | undefined } | undefined;
+    programmingLanguages?: string[] | undefined;
 };
 
 export type DeclarationFormData = DeclarationFormData.User | DeclarationFormData.Referent;
diff --git a/api/src/core/usecases/updateSoftware.ts b/api/src/core/usecases/updateSoftware.ts
@@ -30,7 +30,18 @@ export const makeUpdateSoftware: (dbApi: DbApiV2) => UpdateSoftware =
                 runtimePlatforms: formFields.runtimePlatforms,
                 applicationCategories: [],
                 addedByUserId: userId,
-                keywords: formFields.keywords
+                keywords: formFields.keywords,
+                isLibreSoftware: formFields.isLibreSoftware,
+                url: formFields.url,
+                codeRepositoryUrl: formFields.codeRepositoryUrl,
+                softwareHelp: formFields.softwareHelp,
+                latestVersion: formFields.latestVersion
+                    ? {
+                          version: formFields.latestVersion.version ?? null,
+                          releaseDate: formFields.latestVersion.releaseDate ?? null
+                      }
+                    : undefined,
+                programmingLanguages: formFields.programmingLanguages
             },
             softwareId
         });
