@nospt/plugin-tech-radar-ng-backend 0.9.0

package/migrations/002_add_segments.js

@@ -0,0 +1,124 @@
+/**
+ * Migration: add default segments
+ *
+ * Stores segment entries — categories for the Tech Radar NG.
+ *
+ * NOTE: Migrations must be plain JS (not TS). Backstage runs them
+ * at runtime without a TypeScript loader.
+ */
+
+const { id } = require('zod/v4/locales');
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.up = async function (knex) {
+  // Seed default segments
+  await knex('segments').insert([
+    {
+      id: 'ai-code-development',
+      name: 'AI Code Development',
+      description:
+        'AI tools and assistants that support software development workflows.',
+      search_params: JSON.stringify([
+        'code',
+        'coding',
+        'programming',
+        'copilot',
+        'code-generation',
+        'developer',
+        'ide',
+        'autocomplete',
+        'code generation',
+      ]),
+    },
+    {
+      id: 'infrastructure',
+      name: 'Infrastructure',
+      description:
+        'Platforms, runtimes, and cloud services powering AI workloads.',
+      search_params: JSON.stringify([
+        'infrastructure',
+        'api',
+        'platform',
+        'runtime',
+        'pipeline',
+        'orchestration',
+        'vector',
+        'database',
+        'deployment',
+        'serving',
+        'gateway',
+      ]),
+    },
+    {
+      id: 'llm-techniques',
+      name: 'LLM Techniques',
+      description:
+        'Large language model architectures, fine-tuning, and prompting strategies.',
+      search_params: JSON.stringify([
+        'llm',
+        'language model',
+        'gpt',
+        'transformer',
+        'prompt',
+        'rag',
+        'embedding',
+        'fine-tuning',
+        'agent',
+        'chatbot',
+        'assistant',
+        'reasoning',
+        'inference',
+      ]),
+    },
+    {
+      id: 'standards-protocols',
+      name: 'Standards & Protocols',
+      description:
+        'Emerging standards, APIs, and interoperability protocols for AI systems.',
+      search_params: JSON.stringify([
+        'standard',
+        'protocol',
+        'specification',
+        'mcp',
+        'openapi',
+        'schema',
+        'format',
+        'interoperability',
+      ]),
+    },
+    {
+      id: 'ai-low-code-no-code',
+      name: 'AI Low-Code/No-Code',
+      description:
+        'AI-powered low-code and no-code platforms for building applications.',
+      search_params: JSON.stringify([
+        'no-code',
+        'low-code',
+        'nocode',
+        'lowcode',
+        'visual',
+        'builder',
+        'workflow',
+        'automation',
+        'drag',
+      ]),
+    },
+  ]);
+};
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.down = async function (knex) {
+  await knex('segments')
+    .whereIn('id', [
+      'ai-code-development',
+      'infrastructure',
+      'llm-techniques',
+      'standards-protocols',
+      'ai-low-code-no-code',
+    ])
+    .delete();
+};

package/migrations/003_create_rings_table.js

@@ -0,0 +1,46 @@
+/**
+ * Migration: create rings table
+ *
+ * Stores GenAITechCandidate entries — technologies discovered and
+ * proposed for the Tech Radar NG.
+ *
+ * NOTE: Migrations must be plain JS (not TS). Backstage runs them
+ * at runtime without a TypeScript loader.
+ */
+
+/**
+ * Returns a DB-level default expression that generates a UUID v4.
+ * Works with PostgreSQL (gen_random_uuid) and SQLite (randomblob).
+ * @param {import('knex').Knex} knex
+ */
+function uuidDefault(knex) {
+  if (knex.client.config.client === 'pg') {
+    return knex.raw('gen_random_uuid()');
+  }
+  return knex.raw(
+    "(lower(hex(randomblob(4))) || '-' || lower(hex(randomblob(2))) || '-' || '4' || substr(lower(hex(randomblob(2))),2) || '-' || substr('89ab', abs(random()) % 4 + 1, 1) || substr(lower(hex(randomblob(2))),2) || '-' || lower(hex(randomblob(6))))",
+  );
+}
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.up = async function (knex) {
+  await knex.schema.createTable('rings', table => {
+    table.uuid('id').primary().defaultTo(uuidDefault(knex));
+
+    // Core identity
+    table.string('name').notNullable().unique();
+    table.string('color').notNullable().defaultTo('#000000');
+
+    table.timestamp('created_at').defaultTo(knex.fn.now());
+    table.timestamp('updated_at').defaultTo(knex.fn.now());
+  });
+};
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.down = async function (knex) {
+  await knex.schema.dropTable('rings');
+};

package/migrations/004_add_rings.js

@@ -0,0 +1,30 @@
+/**
+ * Migration: create rings table
+ *
+ * Stores ring entries — categories for the Tech Radar NG.
+ *
+ * NOTE: Migrations must be plain JS (not TS). Backstage runs them
+ * at runtime without a TypeScript loader.
+ */
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.up = async function (knex) {
+  // Seed default rings
+  await knex('rings').insert([
+    { name: 'Adopt', color: '#5ba300' },
+    { name: 'Trial', color: '#009eb0' },
+    { name: 'Assess', color: '#c7ba00' },
+    { name: 'Hold', color: '#e09b96' },
+  ]);
+};
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.down = async function (knex) {
+  await knex('rings')
+    .whereIn('name', ['Adopt', 'Trial', 'Assess', 'Hold'])
+    .delete();
+};

package/migrations/005_create_radar_candidates_table.js

@@ -0,0 +1,43 @@
+/**
+ * Migration: create radar_candidates table
+ *
+ * Stores Tech radar candidate entries — candidates discovered and
+ * proposed for the Tech Radar.
+ *
+ * NOTE: Migrations must be plain JS (not TS). Backstage runs them
+ * at runtime without a TypeScript loader.
+ */
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.up = async function (knex) {
+  await knex.schema.createTable('radar_candidates', table => {
+    table.uuid('id').primary();
+
+    // Core identity
+    table.string('platform_id').notNullable().unique(); // GitHub node_id, HuggingFace repo id, etc.
+    table.string('full_name').notNullable().unique();
+    table.string('name').notNullable();
+    table.text('description').nullable();
+    table.text('url').notNullable();
+    table.text('homepage').nullable();
+    table.string('primary_language').nullable();
+    table.text('license').nullable();
+    table.uuid('ring').nullable().references('id').inTable('rings');
+    table.string('segment').nullable().references('id').inTable('segments');
+    table.boolean('in_radar').notNullable().defaultTo(false);
+    table.boolean('is_active').notNullable().defaultTo(true);
+    table.enum('platform', ['github', 'hugging_face']).notNullable();
+    table.timestamp('last_activity_at').notNullable();
+    table.timestamp('created_at').notNullable();
+    table.timestamp('last_synced_at').notNullable().defaultTo(knex.fn.now());
+  });
+};
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.down = async function (knex) {
+  await knex.schema.dropTable('radar_candidates');
+};

package/migrations/006_create_radar_candidates_snapshot_table.js

@@ -0,0 +1,35 @@
+/**
+ * Migration: create radar_candidates_snapshots table
+ *
+ * Stores AI radar candidate snapshot entries — snapshots of candidates discovered and
+ * proposed for the Tech Radar NG.
+ *
+ * NOTE: Migrations must be plain JS (not TS). Backstage runs them
+ * at runtime without a TypeScript loader.
+ */
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.up = async function (knex) {
+  await knex.schema.createTable('radar_candidates_snapshots', table => {
+    table.uuid('id').primary();
+    table
+      .uuid('candidate_id')
+      .notNullable()
+      .references('id')
+      .inTable('radar_candidates')
+      .onDelete('CASCADE');
+    // Core identity
+    table.integer('popularity_score').notNullable();
+    table.integer('usage_score').notNullable();
+    table.timestamp('snapshot_at').notNullable().defaultTo(knex.fn.now());
+  });
+};
+
+/**
+ * @param {import('knex').Knex} knex
+ */
+exports.down = async function (knex) {
+  await knex.schema.dropTable('radar_candidates_snapshots');
+};

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@nospt/plugin-tech-radar-ng-backend",
+  "version": "0.9.0",
+  "license": "UNLICENSED",
+  "main": "dist/index.cjs.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
+  },
+  "backstage": {
+    "role": "backend-plugin",
+    "pluginId": "tech-radar-ng",
+    "pluginPackages": [
+      "@nospt/plugin-tech-radar-ng",
+      "@nospt/plugin-tech-radar-ng-backend",
+      "@nospt/plugin-tech-radar-ng-common"
+    ],
+    "features": {
+      ".": "@backstage/BackendFeature"
+    }
+  },
+  "scripts": {
+    "start": "backstage-cli package start",
+    "build": "backstage-cli package build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
+    "clean": "backstage-cli package clean",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack"
+  },
+  "dependencies": {
+    "@backstage/backend-defaults": "^0.15.2",
+    "@backstage/backend-plugin-api": "^1.7.0",
+    "@backstage/catalog-client": "^1.13.0",
+    "@backstage/errors": "^1.2.7",
+    "@backstage/integration": "^1.20.1",
+    "@backstage/plugin-catalog-node": "^2.0.0",
+    "@backstage/types": "^1.2.2",
+    "@nospt/plugin-tech-radar-ng-common": "workspace:^",
+    "better-sqlite3": "^12.6.2",
+    "express": "^4.17.1",
+    "express-promise-router": "^4.1.0",
+    "uuid": "^13.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@backstage/backend-test-utils": "^1.11.0",
+    "@backstage/cli": "^0.35.4",
+    "@types/express": "^4.17.6",
+    "@types/jest": "^30.0.0",
+    "@types/supertest": "^2.0.12",
+    "supertest": "^6.2.4"
+  },
+  "files": [
+    "dist",
+    "migrations"
+  ],
+  "typesVersions": {
+    "*": {
+      "package.json": [
+        "package.json"
+      ]
+    }
+  }
+}