[CPDNPQ-2346] Cohort + schedule management

app/components/npq_separation/navigation_structures/admin_navigation_structure.rb

@@ -2,6 +2,7 @@ module NpqSeparation
   module NavigationStructures
     class AdminNavigationStructure < NpqSeparation::NavigationStructure
       include Rails.application.routes.url_helpers
+      include AdminHelper
 
     private
 
@@ -19,6 +20,11 @@ def structure
             href: npq_separation_admin_applications_path,
             prefix: "/npq-separation/admin/applications",
           ) => [],
+          Node.new(
+            name: "Cohorts",
+            href: npq_separation_admin_cohorts_path,
+            prefix: "/npq-separation/admin/cohorts",
+          ) => cohort_nodes,
           Node.new(
             name: "Courses",
             href: npq_separation_admin_courses_path,
@@ -63,6 +69,22 @@ def structure
           ) => [],
         }
       end
+
+      def cohort_nodes
+        [
+          Node.new(
+            name: "All cohorts",
+            href: npq_separation_admin_cohorts_path,
+            prefix: /\/npq-separation\/admin\/cohorts$/,
+          ),
+        ] + Cohort.order(start_year: :desc).map do |cohort|
+          Node.new(
+            name: "Cohort #{format_cohort(cohort)}",
+            href: npq_separation_admin_cohort_path(cohort),
+            prefix: "/npq-separation/admin/cohorts/#{cohort.id}",
+          )
+        end
+      end
     end
   end
 end

app/controllers/npq_separation/admin/cohorts_controller.rb

@@ -0,0 +1,78 @@
+class NpqSeparation::Admin::CohortsController < NpqSeparation::AdminController
+  before_action :ensure_super_admin, except: %i[index show]
+  before_action :ensure_editable, only: %i[edit update destroy]
+
+  def index
+    @pagy, @cohorts = pagy(Cohort.all.order(start_year: :desc))
+  end
+
+  def show
+    @cohort = cohort
+  end
+
+  def new
+    @cohort = Cohort.new
+    render :form
+  end
+
+  def create
+    @cohort = Cohort.new(cohort_params)
+
+    if @cohort.save
+      flash[:success] = "Cohort created"
+      redirect_to action: :index
+    else
+      render :form, status: :unprocessable_entity
+    end
+  end
+
+  def edit
+    @cohort = cohort
+    render :form
+  end
+
+  def update
+    if cohort.update(cohort_params)
+      flash[:success] = "Cohort updated"
+      redirect_to npq_separation_admin_cohort_path(cohort)
+    else
+      @cohort = cohort
+      render :form, status: :unprocessable_entity
+    end
+  end
+
+  def destroy
+    if params[:confirm].present?
+      cohort.destroy!
+      flash[:success] = "Cohort deleted"
+      redirect_to action: :index
+    else
+      @cohort = cohort
+      render :destroy
+    end
+  end
+
+private
+
+  def cohort_params
+    params.require(:cohort).permit(:start_year, :registration_start_date, :funding_cap)
+  end
+
+  def cohort
+    @cohort ||= Cohort.find(params[:id])
+  end
+
+  def ensure_super_admin
+    unless current_admin.super_admin?
+      flash[:error] = "You must be a super admin to change cohorts"
+      redirect_to action: :index
+    end
+  end
+
+  def ensure_editable
+    unless cohort.editable?
+      flash[:error] = "This cohort is not editable"
+      redirect_to npq_separation_admin_cohort_path(cohort)
+    end
+  end
+end

app/controllers/npq_separation/admin/schedules_controller.rb

@@ -0,0 +1,78 @@
+class NpqSeparation::Admin::SchedulesController < NpqSeparation::AdminController
+  before_action :ensure_super_admin, except: :show
+  before_action :ensure_editable, only: %i[edit update destroy]
+
+  def show
+    @schedule = schedule
+  end
+
+  def new
+    @schedule = cohort.schedules.new
+    render :form
+  end
+
+  def create
+    @schedule = cohort.schedules.new(schedule_params)
+
+    if @schedule.save
+      flash[:success] = "Schedule created"
+      redirect_to npq_separation_admin_cohort_path(cohort)
+    else
+      render :form, status: :unprocessable_entity
+    end
+  end
+
+  def edit
+    @schedule = schedule
+    render :form
+  end
+
+  def update
+    if schedule.update(schedule_params)
+      flash[:success] = "Schedule updated"
+      redirect_to npq_separation_admin_cohort_path(cohort)
+    else
+      @schedule = schedule
+      render :form, status: :unprocessable_entity
+    end
+  end
+
+  def destroy
+    if params[:confirm].present?
+      schedule.destroy!
+      flash[:success] = "Schedule deleted"
+      redirect_to npq_separation_admin_cohort_path(schedule.cohort)
+    else
+      @schedule = schedule
+      render :destroy
+    end
+  end
+
+private
+
+  def schedule_params
+    params.require(:schedule).permit(:course_group_id, :name, :identifier, :applies_from, :applies_to, allowed_declaration_types: [])
+  end
+
+  def schedule
+    @schedule ||= cohort.schedules.find(params[:id])
+  end
+
+  def cohort
+    @cohort ||= Cohort.find(params[:cohort_id])
+  end
+
+  def ensure_super_admin
+    unless current_admin.super_admin?
+      flash[:error] = "You must be a super admin to change schedules"
+      redirect_to npq_separation_admin_cohort_path(cohort)
+    end
+  end
+
+  def ensure_editable
+    unless schedule.editable?
+      flash[:error] = "This schedule is not editable"
+      redirect_to npq_separation_admin_cohort_schedule_path(cohort, schedule)
+    end
+  end
+end

app/models/cohort.rb

@@ -1,4 +1,8 @@
 class Cohort < ApplicationRecord
+  has_many :declarations, dependent: :restrict_with_exception
+  has_many :schedules, dependent: :destroy
+  has_many :statements, dependent: :restrict_with_exception
+
   validates :start_year,
             presence: true,
             numericality: {
@@ -16,15 +20,19 @@ class Cohort < ApplicationRecord
             }
   validates :ecf_id, uniqueness: { case_sensitive: false }, allow_nil: true
 
+  def self.current(timestamp = Time.zone.today)
+    where(registration_start_date: ..timestamp)
+      .order(start_year: :desc)
+      .first!
+  end
+
   def registration_start_date_matches_start_year
     return if registration_start_date.blank?
 
     errors.add(:registration_start_date, "year must match the start year") if registration_start_date.year != start_year
   end
 
-  def self.current(timestamp = Time.zone.today)
-    where(registration_start_date: ..timestamp)
-      .order(start_year: :desc)
-      .first!
+  def editable?
+    registration_start_date.future? && statements.none? && declarations.none?
   end
 end

app/models/schedule.rb

@@ -17,9 +17,17 @@ class Schedule < ApplicationRecord
   belongs_to :cohort
   has_many :courses, through: :course_group
 
+  delegate :editable?, to: :cohort
+
+  normalizes :allowed_declaration_types, with: ->(value) { value.reject(&:blank?) }
+
   validates :name, presence: true
   validates :identifier, presence: true, uniqueness: { scope: :cohort_id }
   validates :ecf_id, uniqueness: { case_sensitive: false }, allow_nil: true
   validates :applies_from, presence: true
   validates :applies_to, presence: true
+
+  def self.allowed_declaration_types
+    connection.execute("SELECT unnest(enum_range(NULL::declaration_types))").values.flatten
+  end
 end

app/views/npq_separation/admin/cohorts/destroy.html.erb

@@ -0,0 +1,9 @@
+<h1 class="govuk-heading-l">Delete cohort <%= format_cohort @cohort %></h1>
+
+<p class="govuk-body">Are you sure you want to delete this cohort and <%= pluralize @cohort.schedules.count, 'associated schedule' %>? There is no way to undo this action.</p>
+
+<%= form_with model: [:npq_separation, :admin, @cohort], method: 'delete' do |f| %>
+  <%= hidden_field_tag :confirm, 1 %>
+  <%= f.govuk_submit 'Confirm delete cohort', warning: true %>
+  <%= govuk_button_link_to('Cancel', npq_separation_admin_cohort_path(@cohort), secondary: true) %>
+<% end %>

app/views/npq_separation/admin/cohorts/form.html.erb

@@ -0,0 +1,26 @@
+<h1 class="govuk-heading-l">
+  <% if @cohort.new_record? %>
+    New cohort
+  <% else %>
+    Edit cohort
+  <% end %>
+</h1>
+
+<%= form_with model: [:npq_separation, :admin, @cohort] do |f| %>
+  <%= f.govuk_number_field :start_year,
+                           label: { text: "Start year" },
+                           class: 'govuk-input--width-4' %>
+
+  <%= f.govuk_check_box :funding_cap,
+                        1,
+                        0,
+                        multiple: false,
+                        link_errors: true,
+                        label: { text: "Funding cap" } %>
+
+  <%= f.govuk_date_field :registration_start_date,
+                         legend: { text: 'Registration start date' },
+                         class: 'govuk-!-margin-top-5' %>
+
+  <%= f.govuk_submit @cohort.new_record? ? 'Create cohort' : 'Update cohort' %>
+<% end %>

app/views/npq_separation/admin/cohorts/index.html.erb

@@ -0,0 +1,27 @@
+<h1 class="govuk-heading-l">All cohorts</h1>
+
+<%= govuk_button_link_to('New cohort', new_npq_separation_admin_cohort_path) if current_admin.super_admin? %>
+
+<%=
+  govuk_table do |table|
+    table.with_head do |header|
+      header.with_row do |row|
+        row.with_cell(text: "Start year")
+        row.with_cell(text: "Registration start date")
+        row.with_cell(text: "Funding cap")
+      end
+    end
+
+    table.with_body do |body|
+      @cohorts.each do |cohort|
+        body.with_row do |row|
+          row.with_cell(text: govuk_link_to(format_cohort(cohort), npq_separation_admin_cohort_path(cohort)))
+          row.with_cell(text: cohort.registration_start_date.to_date.to_fs(:govuk))
+          row.with_cell(text: boolean_red_green_tag(cohort.funding_cap))
+        end
+      end
+    end
+  end
+%>
+
+<%= govuk_pagination(pagy: @pagy) %>

app/views/npq_separation/admin/cohorts/show.html.erb

@@ -0,0 +1,57 @@
+<h1 class="govuk-heading-l">Cohort <%= format_cohort @cohort %></h1>
+
+<%=
+  govuk_summary_list do |sl|
+    sl.with_row do |row|
+      row.with_key(text: "Start year")
+      row.with_value(text: @cohort.start_year)
+    end
+
+    sl.with_row do |row|
+      row.with_key(text: "Registration start date")
+      row.with_value(text: @cohort.registration_start_date.to_date.to_fs(:govuk))
+    end
+
+    sl.with_row do |row|
+      row.with_key(text: "Funding cap")
+      row.with_value(text: boolean_red_green_tag(@cohort.funding_cap))
+    end
+  end
+%>
+
+<% if current_admin.super_admin? && @cohort.editable? %>
+  <%= govuk_button_link_to('Edit cohort details', edit_npq_separation_admin_cohort_path(@cohort)) %>
+  <%= govuk_button_link_to('Delete cohort', npq_separation_admin_cohort_path(@cohort), method: :delete, warning: true) %>
+<% end %>
+
+<hr class="govuk-section-break govuk-section-break--l">
+
+<h2 class="govuk-heading-m">Schedules</h1>
+
+<% if current_admin.super_admin? && @cohort.editable? %>
+  <%= govuk_button_link_to('New schedule', new_npq_separation_admin_cohort_schedule_path(@cohort)) %>
+<% end %>
+
+<%=
+  govuk_table do |table|
+    table.with_head do |head|
+      head.with_row do |row|
+        row.with_cell(text: 'Name')
+        row.with_cell(text: 'Applies from')
+        row.with_cell(text: 'Applies to')
+        row.with_cell(text: 'Declaration types')
+      end
+    end
+
+    table.with_body do |body|
+      @cohort.schedules.order(:name).each do |schedule|
+        body.with_row do |row|
+          row.with_cell(text: govuk_link_to(schedule.name, npq_separation_admin_cohort_schedule_path(@cohort, schedule)))
+          row.with_cell(text: schedule.applies_from.to_fs(:govuk_short))
+          row.with_cell(text: schedule.applies_to.to_fs(:govuk_short))
+          row.with_cell(text: schedule.allowed_declaration_types.count)
+        end
+      end
+    end
+  end
+%>

app/views/npq_separation/admin/schedules/destroy.html.erb

@@ -0,0 +1,9 @@
+<h1 class="govuk-heading-l">Delete schedule <%= @schedule.name %></h1>
+
+<p class="govuk-body">Are you sure you want to delete this schedule? There is no way to undo this action.</p>
+
+<%= form_with model: [:npq_separation, :admin, @schedule.cohort, @schedule], method: 'delete' do |f| %>
+  <%= hidden_field_tag :confirm, 1 %>
+  <%= f.govuk_submit 'Confirm delete schedule', warning: true %>
+  <%= govuk_button_link_to('Cancel', npq_separation_admin_cohort_schedule_path(@schedule.cohort, @schedule), secondary: true) %>
+<% end %>