#-- encoding: UTF-8 #-- copyright # OpenProject is a project management system. # Copyright (C) 2012-2018 the OpenProject Foundation (OPF) # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License version 3. # # OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows: # Copyright (C) 2006-2017 Jean-Philippe Lang # Copyright (C) 2010-2013 the ChiliProject Team # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License # as published by the Free Software Foundation; either version 2 # of the License, or (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. # # See docs/COPYRIGHT.rdoc for more details. #++ require 'roar/decorator' require 'roar/json/hal' module API module V3 module Projects class ProjectRepresenter < ::API::Decorators::Single include API::Decorators::LinkedResource include API::Decorators::DateProperty include ::API::Caching::CachedRepresenter include API::Decorators::FormattableProperty extend ::API::V3::Utilities::CustomFieldInjector::RepresenterClass cached_representer key_parts: %i(status), disabled: false self_link link :createWorkPackage, cache_if: -> { current_user_allowed_to(:add_work_packages, context: represented) } do { href: api_v3_paths.create_project_work_package_form(represented.id), method: :post } end link :createWorkPackageImmediately, cache_if: -> { current_user_allowed_to(:add_work_packages, context: represented) } do { href: api_v3_paths.work_packages_by_project(represented.id), method: :post } end link :workPackages, cache_if: -> { current_user_allowed_to(:view_work_packages, context: represented) } do {href: api_v3_paths.work_packages_by_project(represented.id)} end link :categories do {href: api_v3_paths.categories_by_project(represented.id)} end link :versions, cache_if: -> { current_user_allowed_to(:view_work_packages, context: represented) || current_user_allowed_to(:manage_versions, context: represented) } do {href: api_v3_paths.versions_by_project(represented.id)} end link :memberships, cache_if: -> { current_user_allowed_to(:view_members, context: represented) } do { href: api_v3_paths.path_for(:memberships, filters: [{project: {operator: "=", values: [represented.id.to_s]}}]), } end link :types, cache_if: -> { current_user_allowed_to(:view_work_packages, context: represented) || current_user_allowed_to(:manage_types, context: represented) } do {href: api_v3_paths.types_by_project(represented.id)} end link :update, cache_if: -> { current_user_allowed_to(:edit_project, context: represented) } do { href: api_v3_paths.project_form(represented.id), method: :post } end link :updateImmediately, cache_if: -> { current_user_allowed_to(:edit_project, context: represented) } do { href: api_v3_paths.project(represented.id), method: :patch } end link :delete, cache_if: -> { current_user.admin? } do { href: api_v3_paths.project(represented.id), method: :delete } end link :schema do { href: api_v3_paths.projects_schema } end associated_resource :parent, v3_path: :project, representer: ::API::V3::Projects::ProjectRepresenter, uncacheable_link: true, link: ->(*) { if represented.parent&.visible? { href: api_v3_paths.project(represented.parent.id), title: represented.parent.name } else { href: nil, title: nil } end } property :id property :identifier property :name property :active property :public formattable_property :description date_time_property :created_at date_time_property :updated_at property :status, render_nil: true, getter: ->(*) { next unless status&.code status.code.to_s.tr('_', ' ') }, setter: ->(fragment:, **) { self.status ||= {} status[:code] = if fragment.nil? nil else fragment.strip.tr(' ', '_').underscore.to_sym end } property :status_explanation, writable: -> do represented.writable?(:status) end, getter: ->(*) { ::API::Decorators::Formattable.new(status&.explanation, object: self, plain: false) }, setter: ->(fragment:, **) { self.status ||= {} status[:explanation] = fragment["raw"] } def _type 'Project' end self.checked_permissions = [:add_work_packages] end end end end