Add slug to namespace projects

Author: Knerio

app/graphql/mutations/namespaces/projects/create.rb

@@ -13,6 +13,7 @@ class Create < BaseMutation
 
         argument :description, String, required: false, description: 'Description for the new project.'
         argument :name, String, required: true, description: 'Name for the new project.'
+        argument :slug, String, required: false, description: 'Slug for the new project.'
 
         def resolve(namespace_id:, **params)
           namespace = SagittariusSchema.object_from_id(namespace_id)

app/graphql/mutations/namespaces/projects/update.rb

@@ -15,6 +15,7 @@ class Update < BaseMutation
         argument :name, String, required: false, description: 'Name for the updated project.'
         argument :primary_runtime_id, Types::GlobalIdType[::Runtime],
                  required: false, description: 'The primary runtime for the updated project.'
+        argument :slug, String, required: false, description: 'Slug for the updated project.'
 
         def resolve(namespace_project_id:, **params)
           project = SagittariusSchema.object_from_id(namespace_project_id)

app/graphql/types/namespace_project_type.rb

@@ -10,6 +10,8 @@ class NamespaceProjectType < Types::BaseObject
 
     field :name, String, null: false, description: 'Name of the project'
 
+    field :slug, String, null: false, description: 'Slug of the project used in URLs to identify flows'
+
     field :runtimes, Types::RuntimeType.connection_type, null: false, description: 'Runtimes assigned to this project'
 
     field :roles, Types::NamespaceRoleType.connection_type, null: false,

app/models/flow.rb

@@ -18,6 +18,7 @@ def to_grpc
     Tucana::Shared::ValidationFlow.new(
       flow_id: id,
       project_id: project.id,
+      project_slug: project.slug,
       type: flow_type.identifier,
       data_types: [], # TODO: when data types are creatable
       input_type_identifier: input_type&.identifier,

app/models/namespace_project.rb

@@ -14,6 +14,12 @@ class NamespaceProject < ApplicationRecord
                             source: :role
   has_many :flows, class_name: 'Flow', inverse_of: :project
 
+  validates :slug, presence: true,
+                   length: { minimum: 3, maximum: 50 },
+                   allow_blank: false,
+                   uniqueness: { case_sensitive: true },
+                   format: { with: /\A[a-zA-Z0-9_-]+\z/ }
+
   validates :name, presence: true,
                    length: { minimum: 3, maximum: 50 },
                    allow_blank: false,

app/services/namespaces/projects/create_service.rb

@@ -20,6 +20,17 @@ def execute
         end
 
         transactional do |t|
+          unless params.key?(:slug)
+            slug = name.parameterize
+
+            tries_left = 5
+            while NamespaceProject.exists?(slug: slug) && tries_left.positive?
+              slug = "#{slug}-#{SecureRandom.hex(4)}"
+              tries_left -= 1
+            end
+            params[:slug] = slug
+          end
+
           project = NamespaceProject.create(namespace: namespace, name: name, **params)
           unless project.persisted?
             t.rollback_and_return! ServiceResponse.error(

db/fixtures/development/06_namespace_projects.rb

@@ -3,6 +3,7 @@
 NamespaceProject.seed_once :namespace_id, :name do |np|
   np.namespace_id = Organization.find_by(name: 'Code1').ensure_namespace.id
   np.name = 'First Project'
+  np.slug = 'first-project'
   np.description = 'A sample project for Code1 organization.'
   np.primary_runtime = Runtime.find_by(name: 'Code1-Runtime')
   np.runtimes = [Runtime.find_by(name: 'Code1-Runtime')]

db/migrate/20251215200029_add_slug_to_projects.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+class AddSlugToProjects < Code0::ZeroTrack::Database::Migration[1.0]
+  def change
+    # rubocop:disable Rails/NotNullColumn -- backwards compatibility intentionally ignored
+    add_column :namespace_projects, :slug, :text, null: false
+    add_index :namespace_projects, :slug, unique: true
+    # rubocop:enable Rails/NotNullColumn
+  end
+end

db/schema_migrations/20251215200029

@@ -0,0 +1 @@
+10c61a28b25b5ae26834648b6b679e8946f8558faa5e4f18d909398495af654b

db/structure.sql

@@ -486,6 +486,7 @@ CREATE TABLE namespace_projects (
     updated_at timestamp with time zone NOT NULL,
     namespace_id bigint NOT NULL,
     primary_runtime_id bigint,
+    slug text NOT NULL,
     CONSTRAINT check_09e881e641 CHECK ((char_length(name) <= 50)),
     CONSTRAINT check_a77bf7c685 CHECK ((char_length(description) <= 500))
 );
@@ -1175,6 +1176,8 @@ CREATE INDEX index_namespace_projects_on_namespace_id ON namespace_projects USIN
 
 CREATE INDEX index_namespace_projects_on_primary_runtime_id ON namespace_projects USING btree (primary_runtime_id);
 
+CREATE UNIQUE INDEX index_namespace_projects_on_slug ON namespace_projects USING btree (slug);
+
 CREATE INDEX index_namespace_role_project_assignments_on_project_id ON namespace_role_project_assignments USING btree (project_id);
 
 CREATE UNIQUE INDEX "index_namespace_roles_on_namespace_id_LOWER_name" ON namespace_roles USING btree (namespace_id, lower(name));