From d0efb8c068a86436359b3c20950d427c7a6a27cd Mon Sep 17 00:00:00 2001
From: hellekin <hellekin@cepheide.org>
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