ROAD-536 Add VersionJump model and admin integration

app/assets/stylesheets/3-atoms/_badges.scss

@@ -10,7 +10,7 @@
   font-size: 11px;
 
   &.archived {
-    background-color: rgba(29,78,216,0.2);
+    background-color: rgba(29, 78, 216, 0.2);
     border-color: #1d4ed8;
   }
 
@@ -19,4 +19,7 @@
     border-color: #d77e72;
   }
 
+  &.version-jump {
+    background-color: #57ce81;
+  }
 }

app/controllers/madmin/application_controller.rb

@@ -1,5 +1,6 @@
 module Madmin
   class ApplicationController < Madmin::BaseController
+    include Pundit::Authorization
     before_action :ensure_admin
 
     def ensure_admin

app/controllers/madmin/version_jumps_controller.rb

@@ -0,0 +1,4 @@
+module Madmin
+  class VersionJumpsController < Madmin::ResourceController
+  end
+end

app/controllers/projects_controller.rb

@@ -43,7 +43,7 @@ def toggle_locked
   end
 
   def new_clone
-    @original = Project.includes(:projects, stories: :estimates).find(params[:id])
+    @original = Project.includes(:projects, :version_jump, stories: :estimates).find(params[:id])
   end
 
   def clone
@@ -111,11 +111,11 @@ def find_project
   end
 
   def projects_params
-    params.require(:project).permit(:title, :status, :parent_id)
+    params.require(:project).permit(:title, :status, :parent_id, :version_jump_id)
   end
 
   def clone_params
-    params.require(:project).permit(:title, :parent_id)
+    params.require(:project).permit(:title, :parent_id, :version_jump_id)
   end
 
   def parent_id

app/helpers/projects_helper.rb

@@ -17,6 +17,13 @@ def link_unless_archived(project, text, url, classes: nil, method: :get, remote:
     end
   end
 
+  def version_jump_badge(project)
+    return "" unless project.version_jump
+
+    jump = project.version_jump
+    content_tag(:span, jump.to_label, class: "status-badge version-jump")
+  end
+
   private
 
   def text_content(icon, text)

app/madmin/resources/version_jump_resource.rb

@@ -0,0 +1,24 @@
+class VersionJumpResource < Madmin::Resource
+  # Attributes
+  attribute :id, form: false
+  attribute :technology
+  attribute :initial_version
+  attribute :target_version
+
+  # Associations
+  attribute :projects, form: false
+
+  # Uncomment this to customize the display name of records in the admin area.
+  def self.display_name(record)
+    record.to_label
+  end
+
+  # Uncomment this to customize the default sort column and direction.
+  # def self.default_sort_column
+  #   "created_at"
+  # end
+  #
+  # def self.default_sort_direction
+  #   "desc"
+  # end
+end

app/models/project.rb

@@ -4,6 +4,7 @@ class Project < ApplicationRecord
   has_many :stories
   has_many :estimates, through: :stories
   has_many :users, through: :estimates
+  belongs_to :version_jump, optional: true
 
   belongs_to :parent, class_name: "Project", required: false
   has_many :projects, class_name: "Project", foreign_key: :parent_id, dependent: :destroy
@@ -52,6 +53,10 @@ def archived?
     status == "archived"
   end
 
+  def locked?
+    locked_at.present?
+  end
+
   def breadcrumb
     parent.present? ? "#{parent.breadcrumb} » #{title}" : title
   end

app/models/version_jump.rb

@@ -0,0 +1,9 @@
+class VersionJump < ApplicationRecord
+  has_many :projects
+
+  validates :technology, :initial_version, :target_version, presence: true
+
+  def to_label
+    "#{technology} / #{initial_version} - #{target_version}"
+  end
+end

app/policies/estimate_policy.rb

@@ -0,0 +1,2 @@
+class EstimatePolicy < ApplicationPolicy
+end

app/policies/project_policy.rb

@@ -7,6 +7,8 @@ def initialize(user, project)
   end
 
   def update?
+    return false unless project.is_a?(Project)
+
     return !project.locked_at? if project.parent_id.nil?
 
     !project.parent.locked_at?

app/policies/story_policy.rb

@@ -0,0 +1,2 @@
+class StoryPolicy < ApplicationPolicy
+end

app/policies/user_policy.rb

@@ -0,0 +1,2 @@
+class UserPolicy < ApplicationPolicy
+end

app/policies/version_jump_policy.rb

@@ -0,0 +1,9 @@
+class VersionJumpPolicy < ApplicationPolicy
+  def update?
+    true
+  end
+
+  def create?
+    true
+  end
+end

app/views/madmin/application/index.html.erb

@@ -11,6 +11,12 @@
         </svg>
       <% end %>
     </form>
+
+    <% if policy(resource).create? %>
+      <%= link_to resource.new_path, class: "bg-white hover:bg-gray-100 text-gray-800 font-semibold py-2 px-4 border border-gray-400 rounded shadow" do %>
+        New <span class="hidden md:inline"><%= resource.friendly_name %></span>
+      <% end %>
+    <% end %>
   </div>
 </div>
 
@@ -48,7 +54,9 @@
 
           <td class="px-4 py-2 text-center">
             <%= link_to "View", resource.show_path(record), class: "text-indigo-500" %>
-            <%# = link_to "Edit", resource.edit_path(record), class: "text-indigo-500" %>
+            <% if policy(resource).update? %>
+              <%= link_to "Edit", resource.edit_path(record), class: "text-indigo-500" %>
+            <% end %>
           </td>
         </tr>
       <% end %>

app/views/madmin/application/show.html.erb

@@ -7,9 +7,13 @@
 
   <div class="flex items-center px-4">
     <div class="mr-2">
-      <%# = link_to "Edit", resource.edit_path(@record), class: "block bg-white hover:bg-gray-100 text-gray-800 font-semibold py-2 px-4 border border-gray-400 rounded shadow" %>
+      <% if policy(resource).update? %>
+        <%= link_to "Edit", resource.edit_path(@record), class: "block bg-white hover:bg-gray-100 text-gray-800 font-semibold py-2 px-4 border border-gray-400 rounded shadow" %>
+      <% end %>
     </div>
-    <%# = button_to "Delete", resource.show_path(@record), method: :delete, data: { turbo_confirm: "Are you sure?" }, class: "bg-white hover:bg-gray-100 text-red-500 font-semibold py-2 px-4 border border-red-500 rounded shadow pointer-cursor" %>
+    <% if policy(resource).destroy? %>
+      <%= button_to "Delete", resource.show_path(@record), method: :delete, data: { turbo_confirm: "Are you sure?" }, class: "bg-white hover:bg-gray-100 text-red-500 font-semibold py-2 px-4 border border-red-500 rounded shadow pointer-cursor" %>
+    <% end %>
   </div>
 </div>
 

app/views/projects/_form.html.erb

@@ -16,6 +16,11 @@
     <%= f.text_field :title, placeholder: "Project Title", class: "project-story-title", autofocus: true %>
   </div>
 
+  <div class="select">
+    <%= f.label :version_jump_id %>
+    <%= f.select :version_jump_id, options_from_collection_for_select(VersionJump.all, :id, :to_label) %>
+  </div>
+
   <div class="btn-group">
     <%= f.submit yield(:button_text), class: "button green", id: "edit" %>
   </div>

app/views/projects/_sub_project_form.html.erb

@@ -17,6 +17,11 @@
     <%= f.hidden_field :parent_id, value: parent.id %>
   </div>
 
+  <div class="select">
+    <%= f.label :version_jump_id %>
+    <%= f.select :version_jump_id, options_from_collection_for_select(VersionJump.all, :id, :to_label) %>
+  </div>
+
   <div class="btn-group">
     <%= f.submit yield(:button_text), class: "button green", id: "edit" %>
   </div>

app/views/projects/index.html.erb

@@ -9,8 +9,13 @@
             <%= link_to project_path(project.id) do %>
               <div>
                 <h2><%= project.title %></h2>
-                <span class="status-badge locked <%= "hide" if project.locked_at.nil? %>">Locked</span>
-                <span class="status-badge <%= project.status %>"><%= project.status %></span>
+                <% if project.locked? %>
+                  <span class="status-badge locked">Locked</span>
+                <% end %>
+                <% if project.status.present? %>
+                  <span class="status-badge <%= project.status %>"><%= project.status %></span>
+                <% end %>
+                <%= version_jump_badge(project) %>
               </div>
             <% end %>
             <div class="sortable-projects" data-url="<%= sort_project_path(project.id) %>">

app/views/projects/new_clone.html.erb

@@ -12,6 +12,11 @@
       <%= f.select :parent_id, options_from_collection_for_select(Project.active.parents, :id, :title, selected: @original.parent_id), include_blank: "None" %>
     </div>
 
+    <div class="select">
+      <%= f.label :version_jump_id %>
+      <%= f.select :version_jump_id, options_from_collection_for_select(VersionJump.all, :id, :to_label) %>
+    </div>
+
     <% if @original.projects.any? %>
       <div id="sub-projects-to-clone">
         <h4>Sub-projects to clone</h4>

app/views/projects/show.html.erb

@@ -108,6 +108,7 @@
     <% end %>
 
     <%= link_to 'Clone Project', new_clone_project_path(@project.id), class: "button green" %>
+    <%= link_to 'Edit Project', edit_project_path(@project.id), class: "button green" %>
 
     <% if is_unlocked?(@project) %>
       <%= link_unless_archived(@project, "Add Sub-Project", project_new_sub_project_path(@project), classes: :green) unless @project.parent_id.present? %>

app/views/shared/_project_title.html.erb

@@ -20,6 +20,7 @@
 <% end %>
 
 <div>
+  <%= version_jump_badge(project) %>
   <span class="status-badge locked <%= "hide" if project.locked_at.nil? %>">Locked</span>
   <span class="status-badge <%= project.status %> <%= "hide" if project.status.nil? %>"><%= project.status %></span>
 </div>

config/routes/madmin.rb

@@ -4,5 +4,6 @@
   resources :stories
   resources :estimates, except: [:update, :edit, :create]
   resources :users, except: [:update, :edit, :create]
+  resources :version_jumps
   root to: "dashboard#show"
 end

db/migrate/20230830143908_create_version_jumps.rb

@@ -0,0 +1,11 @@
+class CreateVersionJumps < ActiveRecord::Migration[7.0]
+  def change
+    create_table :version_jumps do |t|
+      t.string :technology
+      t.string :initial_version
+      t.string :target_version
+
+      t.timestamps
+    end
+  end
+end

db/migrate/20230831175732_add_version_jump_to_projects.rb

@@ -0,0 +1,5 @@
+class AddVersionJumpToProjects < ActiveRecord::Migration[7.0]
+  def change
+    add_reference :projects, :version_jump
+  end
+end

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[7.0].define(version: 2022_06_21_141342) do
+ActiveRecord::Schema[7.0].define(version: 2023_08_31_175732) do
   # These are extensions that must be enabled in order to support this database
   enable_extension "plpgsql"
 
@@ -31,6 +31,8 @@
     t.integer "parent_id"
     t.integer "position"
     t.datetime "locked_at", precision: nil
+    t.bigint "version_jump_id"
+    t.index ["version_jump_id"], name: "index_projects_on_version_jump_id"
   end
 
   create_table "stories", force: :cascade do |t|
@@ -65,4 +67,12 @@
     t.index ["reset_password_token"], name: "index_users_on_reset_password_token", unique: true
   end
 
+  create_table "version_jumps", force: :cascade do |t|
+    t.string "technology"
+    t.string "initial_version"
+    t.string "target_version"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+  end
+
 end

spec/factories/projects.rb

@@ -1,6 +1,7 @@
 FactoryBot.define do
   factory :project do
     title { Faker::Company.name }
+    version_jump
     trait :locked do
       locked_at { Time.current }
     end

spec/factories/version_jump.rb

@@ -0,0 +1,7 @@
+FactoryBot.define do
+  factory :version_jump do
+    technology { ["Rails", "Ruby", "Node", "React"].sample }
+    initial_version { ["2.3", "3.0", "3.1", "3.2"].sample }
+    target_version { ["5.0", "5.1", "5.2", "6.0"].sample }
+  end
+end

spec/features/projects_manage_spec.rb

@@ -3,6 +3,7 @@
 RSpec.describe "managing projects", js: true do
   let(:user) { FactoryBot.create(:user) }
   let(:project) { FactoryBot.create(:project) }
+  let!(:version_jump) { VersionJump.create(technology: "Rails", initial_version: "4.2", target_version: "5.0") }
 
   before do
     login_as(user, scope: :user)
@@ -16,9 +17,16 @@
   it "allows me to add a project" do
     visit root_path
     click_link "Add a Project"
-    fill_in "project[title]", with: "Super Project"
-    click_button "Create"
-    expect(Project.count).to eq 1
+    fill_in "Title", with: "Super Project"
+    select "Rails / 4.2 - 5.0", from: "Version jump"
+
+    expect {
+      click_button "Create"
+    }.to change(Project, :count).by 1
+
+    project = Project.last
+    expect(project.title).to eq "Super Project"
+    expect(project.version_jump.to_label).to eq "Rails / 4.2 - 5.0"
   end
 
   context "when the project is archived" do
@@ -84,10 +92,14 @@
       it "allows me to add sub projects" do
         visit project_path(id: project.id)
         click_link "Add Sub-Project"
-        fill_in "project[title]", with: "Super Sub Project"
-        click_button "Create"
-        expect(page).to have_content "Project created!"
+        fill_in "Title", with: "Super Sub Project"
+        expect {
+          click_button "Create"
+        }.to change(Project, :count).by 1
         expect(current_path).to eq project_path(id: project.id)
+
+        sub = project.projects.last
+        expect(sub.title).to eq "Super Sub Project"
       end
 
       it "lists available sub projects with a link" do
@@ -203,7 +215,7 @@
 
         expect(page).to have_text("Clone project #{project.title}")
 
-        fill_in :project_title, with: "Cloned Project"
+        fill_in "Title", with: "Cloned Project"
 
         expect {
           click_button "Clone"