From d0efb8c068a86436359b3c20950d427c7a6a27cd Mon Sep 17 00:00:00 2001 From: hellekin Date: Mon, 5 Oct 2020 21:59:34 +0200 Subject: Add Agent and Agency models Since IN COMMON is about collective management of data we're using the concept of Agent to describe a group of users acting together. In ActivityPub terms, Agent will be the Actor when manipulating data, so that any individual User (or application) member of this Agent will be able to manipulate data on behalf of this Agent. Therefore a User has many Agencies, and an Agent as well: the Agency model allows not only to create a joint table between Agents and Users, but also to manage User roles within the related Agent. Roles are defined as: - observer: one who can read and review or flag data - editor: one who create or edit data - maintainer: one who can edit data and manage maps - leader: one who can manage roles A User may have zero or more roles in an Agent. A User without a Agency record for a specific Agent will only be able to 'observe' public data from this Agent. (Note that this is not currently specified, but matches existing reflection on Agents) https://doc.incommon.cc/#agents --- app/models/agency.rb | 22 ++++++++++++++++++++++ app/models/agent.rb | 4 ++++ 2 files changed, 26 insertions(+) create mode 100644 app/models/agency.rb create mode 100644 app/models/agent.rb (limited to 'app/models') diff --git a/app/models/agency.rb b/app/models/agency.rb new file mode 100644 index 0000000..fe81687 --- /dev/null +++ b/app/models/agency.rb @@ -0,0 +1,22 @@ +class Agency < ApplicationRecord + include Bitfields + + belongs_to :agent + belongs_to :user + + bitfield :roles, :observer, :editor, :maintainer, :leader + + class << self + # Grant role in agent to user + def grant(agent, user, role) + r = find_or_create_by(agent: agent, user: user) + r&.public_send("#{role}=", true) && r&.save + end + + # Revoke role in agent from user + def revoke(agent, user, role) + r = find_by(agent: agent, user: user) + r&.public_send("#{role}=", false) && r&.save + end + end +end diff --git a/app/models/agent.rb b/app/models/agent.rb new file mode 100644 index 0000000..bb33c1b --- /dev/null +++ b/app/models/agent.rb @@ -0,0 +1,4 @@ +class Agent < ApplicationRecord + has_many :agencies + has_many :members, through: :agencies, source: :user +end -- cgit v1.2.3