liquid_feedback_core
view core.sql @ 576:eb5f4e4f17d8
Removed comment on hidden applications in "system_application" table
| author | jbe |
|---|---|
| date | Mon Oct 23 15:14:11 2017 +0200 (2017-10-23) |
| parents | 8771e783d898 |
| children | 3536fb4148dc |
line source
2 -- NOTE: In PostgreSQL every UNIQUE constraint implies creation of an index
4 BEGIN;
6 CREATE EXTENSION IF NOT EXISTS latlon; -- load pgLatLon extenstion
8 CREATE VIEW "liquid_feedback_version" AS
9 SELECT * FROM (VALUES ('4.0-dev', 4, 0, -1))
10 AS "subquery"("string", "major", "minor", "revision");
14 ----------------------
15 -- Full text search --
16 ----------------------
19 CREATE FUNCTION "text_search_query"("query_text_p" TEXT)
20 RETURNS TSQUERY
21 LANGUAGE 'plpgsql' IMMUTABLE AS $$
22 BEGIN
23 RETURN plainto_tsquery('pg_catalog.simple', "query_text_p");
24 END;
25 $$;
27 COMMENT ON FUNCTION "text_search_query"(TEXT) IS 'Usage: WHERE "text_search_data" @@ "text_search_query"(''<user query>'')';
30 CREATE FUNCTION "highlight"
31 ( "body_p" TEXT,
32 "query_text_p" TEXT )
33 RETURNS TEXT
34 LANGUAGE 'plpgsql' IMMUTABLE AS $$
35 BEGIN
36 RETURN ts_headline(
37 'pg_catalog.simple',
38 replace(replace("body_p", e'\\', e'\\\\'), '*', e'\\*'),
39 "text_search_query"("query_text_p"),
40 'StartSel=* StopSel=* HighlightAll=TRUE' );
41 END;
42 $$;
44 COMMENT ON FUNCTION "highlight"
45 ( "body_p" TEXT,
46 "query_text_p" TEXT )
47 IS 'For a given a user query this function encapsulates all matches with asterisks. Asterisks and backslashes being already present are preceeded with one extra backslash.';
51 -------------------------
52 -- Tables and indicies --
53 -------------------------
56 CREATE TABLE "temporary_transaction_data" (
57 PRIMARY KEY ("txid", "key"),
58 "txid" INT8 DEFAULT txid_current(),
59 "key" TEXT,
60 "value" TEXT NOT NULL );
62 COMMENT ON TABLE "temporary_transaction_data" IS 'Table to store temporary transaction data; shall be emptied before a transaction is committed';
64 COMMENT ON COLUMN "temporary_transaction_data"."txid" IS 'Value returned by function txid_current(); should be added to WHERE clause, when doing SELECT on this table, but ignored when doing DELETE on this table';
67 CREATE TABLE "system_setting" (
68 "member_ttl" INTERVAL,
69 "snapshot_retention" INTERVAL );
70 CREATE UNIQUE INDEX "system_setting_singleton_idx" ON "system_setting" ((1));
72 COMMENT ON TABLE "system_setting" IS 'This table contains only one row with different settings in each column.';
73 COMMENT ON INDEX "system_setting_singleton_idx" IS 'This index ensures that "system_setting" only contains one row maximum.';
75 COMMENT ON COLUMN "system_setting"."member_ttl" IS 'Time after members get their "active" flag set to FALSE, if they do not show any activity.';
76 COMMENT ON COLUMN "system_setting"."snapshot_retention" IS 'Unreferenced snapshots are retained for the given period of time after creation; set to NULL for infinite retention.';
79 CREATE TABLE "contingent" (
80 PRIMARY KEY ("polling", "time_frame"),
81 "polling" BOOLEAN,
82 "time_frame" INTERVAL,
83 "text_entry_limit" INT4,
84 "initiative_limit" INT4 );
86 COMMENT ON TABLE "contingent" IS 'Amount of text entries or initiatives a user may create within a given time frame. Only one row needs to be fulfilled for a member to be allowed to post. This table must not be empty.';
88 COMMENT ON COLUMN "contingent"."polling" IS 'Determines if settings are for creating initiatives and new drafts of initiatives with "polling" flag set';
89 COMMENT ON COLUMN "contingent"."text_entry_limit" IS 'Number of new drafts or suggestions to be submitted by each member within the given time frame';
90 COMMENT ON COLUMN "contingent"."initiative_limit" IS 'Number of new initiatives to be opened by each member within a given time frame';
93 CREATE TABLE "member" (
94 "id" SERIAL4 PRIMARY KEY,
95 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
96 "deleted" TIMESTAMPTZ,
97 "invite_code" TEXT UNIQUE,
98 "invite_code_expiry" TIMESTAMPTZ,
99 "admin_comment" TEXT,
100 "activated" TIMESTAMPTZ,
101 "last_activity" DATE,
102 "last_login" TIMESTAMPTZ,
103 "last_delegation_check" TIMESTAMPTZ,
104 "login" TEXT UNIQUE,
105 "password" TEXT,
106 "authority" TEXT,
107 "authority_uid" TEXT,
108 "authority_login" TEXT,
109 "locked" BOOLEAN NOT NULL DEFAULT FALSE,
110 "active" BOOLEAN NOT NULL DEFAULT FALSE,
111 "admin" BOOLEAN NOT NULL DEFAULT FALSE,
112 "lang" TEXT,
113 "notify_email" TEXT,
114 "notify_email_unconfirmed" TEXT,
115 "notify_email_secret" TEXT UNIQUE,
116 "notify_email_secret_expiry" TIMESTAMPTZ,
117 "notify_email_lock_expiry" TIMESTAMPTZ,
118 "disable_notifications" BOOLEAN NOT NULL DEFAULT FALSE,
119 "notification_counter" INT4 NOT NULL DEFAULT 1,
120 "notification_sample_size" INT4 NOT NULL DEFAULT 3,
121 "notification_dow" INT4 CHECK ("notification_dow" BETWEEN 0 AND 6),
122 "notification_hour" INT4 DEFAULT floor(random() * 24) CHECK ("notification_hour" BETWEEN 0 AND 23),
123 "notification_sent" TIMESTAMP,
124 "login_recovery_expiry" TIMESTAMPTZ,
125 "password_reset_secret" TEXT UNIQUE,
126 "password_reset_secret_expiry" TIMESTAMPTZ,
127 "name" TEXT UNIQUE,
128 "identification" TEXT UNIQUE,
129 "authentication" TEXT,
130 "location" JSONB,
131 "text_search_data" TSVECTOR,
132 CONSTRAINT "deleted_requires_locked"
133 CHECK ("deleted" ISNULL OR "locked" = TRUE),
134 CONSTRAINT "active_requires_activated_and_last_activity"
135 CHECK ("active" = FALSE OR ("activated" NOTNULL AND "last_activity" NOTNULL)),
136 CONSTRAINT "authority_requires_uid_and_vice_versa"
137 CHECK (("authority" NOTNULL) = ("authority_uid" NOTNULL)),
138 CONSTRAINT "authority_uid_unique_per_authority"
139 UNIQUE ("authority", "authority_uid"),
140 CONSTRAINT "authority_login_requires_authority"
141 CHECK ("authority" NOTNULL OR "authority_login" ISNULL),
142 CONSTRAINT "notification_dow_requires_notification_hour"
143 CHECK ("notification_dow" ISNULL OR "notification_hour" NOTNULL),
144 CONSTRAINT "name_not_null_if_activated"
145 CHECK ("activated" ISNULL OR "name" NOTNULL) );
146 CREATE INDEX "member_authority_login_idx" ON "member" ("authority_login");
147 CREATE INDEX "member_active_idx" ON "member" ("active");
148 CREATE INDEX "member_location_idx" ON "member" USING gist ((GeoJSON_to_ecluster("location")));
149 CREATE INDEX "member_text_search_data_idx" ON "member" USING gin ("text_search_data");
150 CREATE TRIGGER "update_text_search_data"
151 BEFORE INSERT OR UPDATE ON "member"
152 FOR EACH ROW EXECUTE PROCEDURE
153 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
154 "name", "identification");
156 COMMENT ON TABLE "member" IS 'Users of the system, e.g. members of an organization';
158 COMMENT ON COLUMN "member"."created" IS 'Creation of member record and/or invite code';
159 COMMENT ON COLUMN "member"."invite_code" IS 'Optional invite code, to allow a member to initialize his/her account the first time';
160 COMMENT ON COLUMN "member"."invite_code_expiry" IS 'Expiry data/time for "invite_code"';
161 COMMENT ON COLUMN "member"."admin_comment" IS 'Hidden comment for administrative purposes';
162 COMMENT ON COLUMN "member"."activated" IS 'Timestamp of first activation of account (i.e. usage of "invite_code"); required to be set for "active" members';
163 COMMENT ON COLUMN "member"."last_activity" IS 'Date of last activity of member; required to be set for "active" members';
164 COMMENT ON COLUMN "member"."last_login" IS 'Timestamp of last login';
165 COMMENT ON COLUMN "member"."last_delegation_check" IS 'Timestamp of last delegation check (i.e. confirmation of all unit and area delegations)';
166 COMMENT ON COLUMN "member"."login" IS 'Login name';
167 COMMENT ON COLUMN "member"."password" IS 'Password (preferably as crypto-hash, depending on the frontend or access layer)';
168 COMMENT ON COLUMN "member"."authority" IS 'NULL if LiquidFeedback Core is authoritative for the member account; otherwise a string that indicates the source/authority of the external account (e.g. ''LDAP'' for an LDAP account)';
169 COMMENT ON COLUMN "member"."authority_uid" IS 'Unique identifier (unique per "authority") that allows to identify an external account (e.g. even if the login name changes)';
170 COMMENT ON COLUMN "member"."authority_login" IS 'Login name for external accounts (field is not unique!)';
171 COMMENT ON COLUMN "member"."deleted" IS 'Timestamp of deletion (set by "delete_member" function)';
172 COMMENT ON COLUMN "member"."locked" IS 'Locked members can not log in.';
173 COMMENT ON COLUMN "member"."active" IS 'Memberships, support and votes are taken into account when corresponding members are marked as active. Automatically set to FALSE, if "last_activity" is older than "system_setting"."member_ttl".';
174 COMMENT ON COLUMN "member"."admin" IS 'TRUE for admins, which can administrate other users and setup policies and areas';
175 COMMENT ON COLUMN "member"."lang" IS 'Language code of the preferred language of the member';
176 COMMENT ON COLUMN "member"."notify_email" IS 'Email address where notifications of the system are sent to';
177 COMMENT ON COLUMN "member"."notify_email_unconfirmed" IS 'Unconfirmed email address provided by the member to be copied into "notify_email" field after verification';
178 COMMENT ON COLUMN "member"."notify_email_secret" IS 'Secret sent to the address in "notify_email_unconformed"';
179 COMMENT ON COLUMN "member"."notify_email_secret_expiry" IS 'Expiry date/time for "notify_email_secret"';
180 COMMENT ON COLUMN "member"."notify_email_lock_expiry" IS 'Date/time until no further email confirmation mails may be sent (abuse protection)';
181 COMMENT ON COLUMN "member"."disable_notifications" IS 'TRUE if member does not want to receive notifications';
182 COMMENT ON COLUMN "member"."notification_counter" IS 'Sequential number of next scheduled notification message (used as a seed for pseudo-random initiative selection algorithm)';
183 COMMENT ON COLUMN "member"."notification_sample_size" IS 'Number of featured initiatives per issue in scheduled notification messages';
184 COMMENT ON COLUMN "member"."notification_dow" IS 'Day of week for scheduled notifications (NULL to receive a daily digest)';
185 COMMENT ON COLUMN "member"."notification_hour" IS 'Time of day when scheduled notifications are sent out';
186 COMMENT ON COLUMN "member"."notification_sent" IS 'Timestamp of last scheduled notification mail that has been sent out';
187 COMMENT ON COLUMN "member"."login_recovery_expiry" IS 'Date/time after which another login recovery attempt is allowed';
188 COMMENT ON COLUMN "member"."password_reset_secret" IS 'Secret string sent via e-mail for password recovery';
189 COMMENT ON COLUMN "member"."password_reset_secret_expiry" IS 'Date/time until the password recovery secret is valid, and date/time after which another password recovery attempt is allowed';
190 COMMENT ON COLUMN "member"."name" IS 'Distinct name of the member, may be NULL if account has not been activated yet';
191 COMMENT ON COLUMN "member"."identification" IS 'Optional identification number or code of the member';
192 COMMENT ON COLUMN "member"."authentication" IS 'Information about how this member was authenticated';
193 COMMENT ON COLUMN "member"."location" IS 'Geographic location on earth as GeoJSON object';
196 CREATE TABLE "member_history" ( -- TODO: redundancy with new "event" table
197 "id" SERIAL8 PRIMARY KEY,
198 "member_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
199 "until" TIMESTAMPTZ NOT NULL DEFAULT now(),
200 "active" BOOLEAN NOT NULL,
201 "name" TEXT NOT NULL );
202 CREATE INDEX "member_history_member_id_idx" ON "member_history" ("member_id");
204 COMMENT ON TABLE "member_history" IS 'Filled by trigger; keeps information about old names and active flag of members';
206 COMMENT ON COLUMN "member_history"."id" IS 'Primary key, which can be used to sort entries correctly (and time warp resistant)';
207 COMMENT ON COLUMN "member_history"."until" IS 'Timestamp until the data was valid';
210 CREATE TABLE "verification" (
211 "id" SERIAL8 PRIMARY KEY,
212 "requested" TIMESTAMPTZ,
213 "request_origin" JSONB,
214 "request_data" JSONB,
215 "requesting_member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
216 "verifying_member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
217 "verified_member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
218 "verified" TIMESTAMPTZ,
219 "verification_data" JSONB,
220 "denied" TIMESTAMPTZ,
221 "comment" TEXT,
222 CONSTRAINT "verified_and_denied_conflict" CHECK (
223 "verified" ISNULL OR "denied" ISNULL ) );
224 CREATE INDEX "verification_requested_idx" ON "verification" ("requested");
225 CREATE INDEX "verification_open_request_idx" ON "verification" ("requested") WHERE "verified" ISNULL AND "denied" ISNULL;
226 CREATE INDEX "verification_requesting_member_id_idx" ON "verification" ("requesting_member_id");
227 CREATE INDEX "verification_verified_member_id_idx" ON "verification" ("verified_member_id");
228 CREATE INDEX "verification_verified_idx" ON "verification" ("verified");
229 CREATE INDEX "verification_denied_idx" ON "verification" ("denied");
231 COMMENT ON TABLE "verification" IS 'Request to verify a participant';
233 COMMENT ON COLUMN "verification"."requested" IS 'Timestamp when request for verification has been submitted';
234 COMMENT ON COLUMN "verification"."request_origin" IS 'JSON data containing information about the origin of the request (e.g. IP address or hostname)';
235 COMMENT ON COLUMN "verification"."request_data" IS 'JSON data containing information about the entity to be verified (e.g. real name, address, etc.)';
236 COMMENT ON COLUMN "verification"."requesting_member_id" IS 'Member who requested verification';
237 COMMENT ON COLUMN "verification"."verifying_member_id" IS 'Member who processed the verification request (i.e. who accepted or denied the request)';
238 COMMENT ON COLUMN "verification"."verified_member_id" IS 'Member entry containing verified information (not necessarily equal to "requesting_member_id" but may be merged with requesting member later)';
239 COMMENT ON COLUMN "verification"."verified" IS 'Timestamp when request for verification has been accepted by authority';
240 COMMENT ON COLUMN "verification"."verification_data" IS 'JSON data containing additional verified data or information about the authority or operator who accepted or denied the request, but all public information shall be copied to "member"."identification", "member"."verification" and/or "member"."name" if applicable for setup';
241 COMMENT ON COLUMN "verification"."denied" IS 'Timestamp when request for verification has been denied by authority';
242 COMMENT ON COLUMN "verification"."comment" IS 'Administrative comment';
245 CREATE TABLE "member_settings" (
246 "member_id" INT4 PRIMARY KEY REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
247 "settings" JSONB NOT NULL CHECK (jsonb_typeof("settings") = 'object') );
249 COMMENT ON TABLE "member_settings" IS 'Stores a JSON document for each member containing optional (additional) settings for the respective member';
252 CREATE TABLE "member_useterms" (
253 "id" SERIAL8 PRIMARY KEY,
254 "member_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
255 "accepted" TIMESTAMPTZ NOT NULL DEFAULT now(),
256 "contract_identifier" TEXT NOT NULL );
258 COMMENT ON TABLE "member_useterms" IS 'Keeps record of accepted terms of use; may contain multiple rows per member';
260 COMMENT ON COLUMN "member_useterms"."accepted" IS 'Point in time when user accepted the terms of use';
261 COMMENT ON COLUMN "member_useterms"."contract_identifier" IS 'String identifier to denote the accepted terms of use, including their version or revision';
264 CREATE TABLE "member_profile" (
265 "member_id" INT4 PRIMARY KEY REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
266 "formatting_engine" TEXT,
267 "statement" TEXT,
268 "profile" JSONB NOT NULL DEFAULT '{}' CHECK (jsonb_typeof("profile") = 'object'),
269 "profile_text_data" TEXT,
270 "text_search_data" TSVECTOR );
271 CREATE INDEX "member_profile_text_search_data_idx" ON "member_profile" USING gin ("text_search_data");
272 CREATE TRIGGER "update_text_search_data"
273 BEFORE INSERT OR UPDATE ON "member_profile"
274 FOR EACH ROW EXECUTE PROCEDURE
275 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
276 'statement', 'profile_text_data');
278 COMMENT ON COLUMN "member_profile"."formatting_engine" IS 'Allows different formatting engines (i.e. wiki formats) to be used for "member_profile"."statement"';
279 COMMENT ON COLUMN "member_profile"."statement" IS 'Freely chosen text of the member for his/her profile';
280 COMMENT ON COLUMN "member_profile"."profile" IS 'Additional profile data as JSON document';
281 COMMENT ON COLUMN "member_profile"."profile_text_data" IS 'Text data from "profile" field for full text search';
284 CREATE TABLE "rendered_member_statement" (
285 PRIMARY KEY ("member_id", "format"),
286 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
287 "format" TEXT,
288 "content" TEXT NOT NULL );
290 COMMENT ON TABLE "rendered_member_statement" IS 'This table may be used by frontends to cache "rendered" member statements (e.g. HTML output generated from wiki text)';
293 CREATE TYPE "member_image_type" AS ENUM ('photo', 'avatar');
295 COMMENT ON TYPE "member_image_type" IS 'Types of images for a member';
298 CREATE TABLE "member_image" (
299 PRIMARY KEY ("member_id", "image_type", "scaled"),
300 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
301 "image_type" "member_image_type",
302 "scaled" BOOLEAN,
303 "content_type" TEXT,
304 "data" BYTEA NOT NULL );
306 COMMENT ON TABLE "member_image" IS 'Images of members';
308 COMMENT ON COLUMN "member_image"."scaled" IS 'FALSE for original image, TRUE for scaled version of the image';
311 CREATE TABLE "member_count" (
312 "calculated" TIMESTAMPTZ NOT NULL DEFAULT now(),
313 "total_count" INT4 NOT NULL );
315 COMMENT ON TABLE "member_count" IS 'Contains one row which contains the total count of active(!) members and a timestamp indicating when the total member count and area member counts were calculated';
317 COMMENT ON COLUMN "member_count"."calculated" IS 'timestamp indicating when the total member count and area member counts were calculated';
318 COMMENT ON COLUMN "member_count"."total_count" IS 'Total count of active(!) members';
321 CREATE TABLE "contact" (
322 PRIMARY KEY ("member_id", "other_member_id"),
323 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
324 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
325 "public" BOOLEAN NOT NULL DEFAULT FALSE,
326 CONSTRAINT "cant_save_yourself_as_contact"
327 CHECK ("member_id" != "other_member_id") );
328 CREATE INDEX "contact_other_member_id_idx" ON "contact" ("other_member_id");
330 COMMENT ON TABLE "contact" IS 'Contact lists';
332 COMMENT ON COLUMN "contact"."member_id" IS 'Member having the contact list';
333 COMMENT ON COLUMN "contact"."other_member_id" IS 'Member referenced in the contact list';
334 COMMENT ON COLUMN "contact"."public" IS 'TRUE = display contact publically';
337 CREATE TABLE "ignored_member" (
338 PRIMARY KEY ("member_id", "other_member_id"),
339 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
340 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
341 CREATE INDEX "ignored_member_other_member_id_idx" ON "ignored_member" ("other_member_id");
343 COMMENT ON TABLE "ignored_member" IS 'Possibility to filter other members';
345 COMMENT ON COLUMN "ignored_member"."member_id" IS 'Member ignoring someone';
346 COMMENT ON COLUMN "ignored_member"."other_member_id" IS 'Member being ignored';
349 CREATE TABLE "session" (
350 UNIQUE ("member_id", "id"), -- index needed for foreign-key on table "token"
351 "id" SERIAL8 PRIMARY KEY,
352 "ident" TEXT NOT NULL UNIQUE,
353 "additional_secret" TEXT,
354 "logout_token" TEXT,
355 "expiry" TIMESTAMPTZ NOT NULL DEFAULT now() + '24 hours',
356 "member_id" INT4 REFERENCES "member" ("id") ON DELETE SET NULL,
357 "authority" TEXT,
358 "authority_uid" TEXT,
359 "authority_login" TEXT,
360 "needs_delegation_check" BOOLEAN NOT NULL DEFAULT FALSE,
361 "lang" TEXT );
362 CREATE INDEX "session_expiry_idx" ON "session" ("expiry");
364 COMMENT ON TABLE "session" IS 'Sessions, i.e. for a web-frontend or API layer';
366 COMMENT ON COLUMN "session"."ident" IS 'Secret session identifier (i.e. random string)';
367 COMMENT ON COLUMN "session"."additional_secret" IS 'Additional field to store a secret, which can be used against CSRF attacks';
368 COMMENT ON COLUMN "session"."logout_token" IS 'Optional token to authorize logout through external component';
369 COMMENT ON COLUMN "session"."member_id" IS 'Reference to member, who is logged in';
370 COMMENT ON COLUMN "session"."authority" IS 'Temporary store for "member"."authority" during member account creation';
371 COMMENT ON COLUMN "session"."authority_uid" IS 'Temporary store for "member"."authority_uid" during member account creation';
372 COMMENT ON COLUMN "session"."authority_login" IS 'Temporary store for "member"."authority_login" during member account creation';
373 COMMENT ON COLUMN "session"."needs_delegation_check" IS 'Set to TRUE, if member must perform a delegation check to proceed with login; see column "last_delegation_check" in "member" table';
374 COMMENT ON COLUMN "session"."lang" IS 'Language code of the selected language';
377 CREATE TYPE "authflow" AS ENUM ('code', 'token');
379 COMMENT ON TYPE "authflow" IS 'OAuth 2.0 flows: ''code'' = Authorization Code flow, ''token'' = Implicit flow';
382 CREATE TABLE "system_application" (
383 "id" SERIAL4 PRIMARY KEY,
384 "name" TEXT NOT NULL,
385 "base_url" TEXT,
386 "manifest_url" TEXT,
387 "client_id" TEXT NOT NULL UNIQUE,
388 "default_redirect_uri" TEXT NOT NULL,
389 "cert_common_name" TEXT,
390 "client_cred_scope" TEXT,
391 "flow" "authflow",
392 "automatic_scope" TEXT,
393 "permitted_scope" TEXT,
394 "forbidden_scope" TEXT );
396 COMMENT ON TABLE "system_application" IS 'OAuth 2.0 clients that are registered by the system administrator';
398 COMMENT ON COLUMN "system_application"."name" IS 'Human readable name of application';
399 COMMENT ON COLUMN "system_application"."base_url" IS 'Base URL for users';
400 COMMENT ON COLUMN "system_application"."manifest_url" IS 'URL referring to a manifest that can be used for application (type/version) discovery';
401 COMMENT ON COLUMN "system_application"."client_id" IS 'OAuth 2.0 "client_id"';
402 COMMENT ON COLUMN "system_application"."cert_common_name" IS 'Value for CN field of TLS client certificate';
403 COMMENT ON COLUMN "system_application"."client_cred_scope" IS 'Space-separated list of scopes; If set, Client Credentials Grant is allowed; value determines scope';
404 COMMENT ON COLUMN "system_application"."flow" IS 'If set to ''code'' or ''token'', then Authorization Code or Implicit flow is allowed respectively';
405 COMMENT ON COLUMN "system_application"."automatic_scope" IS 'Space-separated list of scopes; Automatically granted scope for Authorization Code or Implicit flow';
406 COMMENT ON COLUMN "system_application"."permitted_scope" IS 'Space-separated list of scopes; If set, scope that members may grant to the application is limited to the given value';
407 COMMENT ON COLUMN "system_application"."forbidden_scope" IS 'Space-separated list of scopes that may not be granted to the application by a member';
410 CREATE TABLE "system_application_redirect_uri" (
411 PRIMARY KEY ("system_application_id", "redirect_uri"),
412 "system_application_id" INT4 REFERENCES "system_application" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
413 "redirect_uri" TEXT );
415 COMMENT ON TABLE "system_application_redirect_uri" IS 'Additional OAuth 2.0 redirection endpoints, which may be selected through the "redirect_uri" GET parameter';
418 CREATE TABLE "dynamic_application_scope" (
419 PRIMARY KEY ("redirect_uri", "flow", "scope"),
420 "redirect_uri" TEXT,
421 "flow" TEXT,
422 "scope" TEXT,
423 "expiry" TIMESTAMPTZ NOT NULL DEFAULT now() + '24 hours' );
424 CREATE INDEX "dynamic_application_scope_redirect_uri_scope_idx" ON "dynamic_application_scope" ("redirect_uri", "flow", "scope");
425 CREATE INDEX "dynamic_application_scope_expiry_idx" ON "dynamic_application_scope" ("expiry");
427 COMMENT ON TABLE "dynamic_application_scope" IS 'Dynamic OAuth 2.0 client registration data';
429 COMMENT ON COLUMN "dynamic_application_scope"."redirect_uri" IS 'Redirection endpoint for which the registration has been done';
430 COMMENT ON COLUMN "dynamic_application_scope"."flow" IS 'OAuth 2.0 flow for which the registration has been done (see also "system_application"."flow")';
431 COMMENT ON COLUMN "dynamic_application_scope"."scope" IS 'Single scope without space characters (use multiple rows for more scopes)';
432 COMMENT ON COLUMN "dynamic_application_scope"."expiry" IS 'Expiry unless renewed';
435 CREATE TABLE "member_application" (
436 "id" SERIAL4 PRIMARY KEY,
437 UNIQUE ("system_application_id", "member_id"),
438 UNIQUE ("domain", "member_id"),
439 "member_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
440 "system_application_id" INT4 REFERENCES "system_application" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
441 "domain" TEXT,
442 "session_id" INT8,
443 FOREIGN KEY ("member_id", "session_id") REFERENCES "session" ("member_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
444 "scope" TEXT NOT NULL,
445 CONSTRAINT "system_application_or_domain_but_not_both" CHECK (
446 ("system_application_id" NOTNULL AND "domain" ISNULL) OR
447 ("system_application_id" ISNULL AND "domain" NOTNULL) ) );
448 CREATE INDEX "member_application_member_id_idx" ON "member_application" ("member_id");
450 COMMENT ON TABLE "member_application" IS 'Application authorized by a member';
452 COMMENT ON COLUMN "member_application"."system_application_id" IS 'If set, then application is a system application';
453 COMMENT ON COLUMN "member_application"."domain" IS 'If set, then application is a dynamically registered OAuth 2.0 client; value is set to client''s domain';
454 COMMENT ON COLUMN "member_application"."session_id" IS 'If set, registration ends with session';
455 COMMENT ON COLUMN "member_application"."scope" IS 'Granted scope as space-separated list of strings';
458 CREATE TYPE "token_type" AS ENUM ('authorization', 'refresh', 'access');
460 COMMENT ON TYPE "token_type" IS 'Types for entries in "token" table';
463 CREATE TABLE "token" (
464 "id" SERIAL8 PRIMARY KEY,
465 "token" TEXT NOT NULL UNIQUE,
466 "token_type" "token_type" NOT NULL,
467 "authorization_token_id" INT8 REFERENCES "token" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
468 "member_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
469 "system_application_id" INT4 REFERENCES "system_application" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
470 "domain" TEXT,
471 FOREIGN KEY ("member_id", "domain") REFERENCES "member_application" ("member_id", "domain") ON DELETE CASCADE ON UPDATE CASCADE,
472 "session_id" INT8,
473 FOREIGN KEY ("member_id", "session_id") REFERENCES "session" ("member_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE, -- NOTE: deletion through "detach_token_from_session" trigger on table "session"
474 "redirect_uri" TEXT,
475 "redirect_uri_explicit" BOOLEAN,
476 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
477 "expiry" TIMESTAMPTZ DEFAULT now() + '1 hour',
478 "used" BOOLEAN NOT NULL DEFAULT FALSE,
479 "scope" TEXT NOT NULL,
480 CONSTRAINT "access_token_needs_expiry"
481 CHECK ("token_type" != 'access'::"token_type" OR "expiry" NOTNULL),
482 CONSTRAINT "authorization_token_needs_redirect_uri"
483 CHECK ("token_type" != 'authorization'::"token_type" OR ("redirect_uri" NOTNULL AND "redirect_uri_explicit" NOTNULL) ) );
484 CREATE INDEX "token_member_id_idx" ON "token" ("member_id");
485 CREATE INDEX "token_authorization_token_id_idx" ON "token" ("authorization_token_id");
486 CREATE INDEX "token_expiry_idx" ON "token" ("expiry");
488 COMMENT ON TABLE "token" IS 'Issued OAuth 2.0 authorization codes and access/refresh tokens';
490 COMMENT ON COLUMN "token"."token" IS 'String secret (the actual token)';
491 COMMENT ON COLUMN "token"."authorization_token_id" IS 'Reference to authorization token if tokens were originally created by Authorization Code flow (allows deletion if code is used twice)';
492 COMMENT ON COLUMN "token"."system_application_id" IS 'If set, then application is a system application';
493 COMMENT ON COLUMN "token"."domain" IS 'If set, then application is a dynamically registered OAuth 2.0 client; value is set to client''s domain';
494 COMMENT ON COLUMN "token"."session_id" IS 'If set, then token is tied to a session; Deletion of session sets value to NULL (via trigger) and removes all scopes without suffix ''_detached''';
495 COMMENT ON COLUMN "token"."redirect_uri" IS 'Authorization codes must be bound to a specific redirect URI';
496 COMMENT ON COLUMN "token"."redirect_uri_explicit" IS 'True if ''redirect_uri'' parameter was explicitly specified during authorization request of the Authorization Code flow (since RFC 6749 requires it to be included in the access token request in this case)';
497 COMMENT ON COLUMN "token"."expiry" IS 'Point in time when code or token expired; In case of "used" authorization codes, authorization code must not be deleted as long as tokens exist which refer to the authorization code';
498 COMMENT ON COLUMN "token"."used" IS 'Can be set to TRUE for authorization codes that have been used (enables deletion of authorization codes that were used twice)';
499 COMMENT ON COLUMN "token"."scope" IS 'Scope as space-separated list of strings (detached scopes are marked with ''_detached'' suffix)';
502 CREATE TABLE "token_scope" (
503 PRIMARY KEY ("token_id", "index"),
504 "token_id" INT8 REFERENCES "token" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
505 "index" INT4,
506 "scope" TEXT NOT NULL );
508 COMMENT ON TABLE "token_scope" IS 'Additional scopes for an authorization code if ''scope1'', ''scope2'', etc. parameters were used during Authorization Code flow to request several access and refresh tokens at once';
511 CREATE TYPE "defeat_strength" AS ENUM ('simple', 'tuple');
513 COMMENT ON TYPE "defeat_strength" IS 'How pairwise defeats are measured for the Schulze method: ''simple'' = only the number of winning votes, ''tuple'' = primarily the number of winning votes, secondarily the number of losing votes';
516 CREATE TYPE "tie_breaking" AS ENUM ('simple', 'variant1', 'variant2');
518 COMMENT ON TYPE "tie_breaking" IS 'Tie-breaker for the Schulze method: ''simple'' = only initiative ids are used, ''variant1'' = use initiative ids in variant 1 for tie breaking of the links (TBRL) and sequentially forbid shared links, ''variant2'' = use initiative ids in variant 2 for tie breaking of the links (TBRL) and sequentially forbid shared links';
521 CREATE TABLE "policy" (
522 "id" SERIAL4 PRIMARY KEY,
523 "index" INT4 NOT NULL,
524 "active" BOOLEAN NOT NULL DEFAULT TRUE,
525 "name" TEXT NOT NULL UNIQUE,
526 "description" TEXT NOT NULL DEFAULT '',
527 "polling" BOOLEAN NOT NULL DEFAULT FALSE,
528 "min_admission_time" INTERVAL,
529 "max_admission_time" INTERVAL,
530 "discussion_time" INTERVAL,
531 "verification_time" INTERVAL,
532 "voting_time" INTERVAL,
533 "issue_quorum" INT4 CHECK ("issue_quorum" >= 1),
534 "issue_quorum_num" INT4,
535 "issue_quorum_den" INT4,
536 "initiative_quorum" INT4 NOT NULL CHECK ("initiative_quorum" >= 1),
537 "initiative_quorum_num" INT4 NOT NULL,
538 "initiative_quorum_den" INT4 NOT NULL,
539 "defeat_strength" "defeat_strength" NOT NULL DEFAULT 'tuple',
540 "tie_breaking" "tie_breaking" NOT NULL DEFAULT 'variant1',
541 "direct_majority_num" INT4 NOT NULL DEFAULT 1,
542 "direct_majority_den" INT4 NOT NULL DEFAULT 2,
543 "direct_majority_strict" BOOLEAN NOT NULL DEFAULT TRUE,
544 "direct_majority_positive" INT4 NOT NULL DEFAULT 0,
545 "direct_majority_non_negative" INT4 NOT NULL DEFAULT 0,
546 "indirect_majority_num" INT4 NOT NULL DEFAULT 1,
547 "indirect_majority_den" INT4 NOT NULL DEFAULT 2,
548 "indirect_majority_strict" BOOLEAN NOT NULL DEFAULT TRUE,
549 "indirect_majority_positive" INT4 NOT NULL DEFAULT 0,
550 "indirect_majority_non_negative" INT4 NOT NULL DEFAULT 0,
551 "no_reverse_beat_path" BOOLEAN NOT NULL DEFAULT FALSE,
552 "no_multistage_majority" BOOLEAN NOT NULL DEFAULT FALSE,
553 CONSTRAINT "issue_quorum_if_and_only_if_not_polling" CHECK (
554 "polling" = ("issue_quorum" ISNULL) AND
555 "polling" = ("issue_quorum_num" ISNULL) AND
556 "polling" = ("issue_quorum_den" ISNULL) ),
557 CONSTRAINT "min_admission_time_smaller_than_max_admission_time" CHECK (
558 "min_admission_time" < "max_admission_time" ),
559 CONSTRAINT "timing_null_or_not_null_constraints" CHECK (
560 ( "polling" = FALSE AND
561 "min_admission_time" NOTNULL AND "max_admission_time" NOTNULL AND
562 "discussion_time" NOTNULL AND
563 "verification_time" NOTNULL AND
564 "voting_time" NOTNULL ) OR
565 ( "polling" = TRUE AND
566 "min_admission_time" ISNULL AND "max_admission_time" ISNULL AND
567 "discussion_time" NOTNULL AND
568 "verification_time" NOTNULL AND
569 "voting_time" NOTNULL ) OR
570 ( "polling" = TRUE AND
571 "min_admission_time" ISNULL AND "max_admission_time" ISNULL AND
572 "discussion_time" ISNULL AND
573 "verification_time" ISNULL AND
574 "voting_time" ISNULL ) ),
575 CONSTRAINT "no_reverse_beat_path_requires_tuple_defeat_strength" CHECK (
576 "defeat_strength" = 'tuple'::"defeat_strength" OR
577 "no_reverse_beat_path" = FALSE ) );
578 CREATE INDEX "policy_active_idx" ON "policy" ("active");
580 COMMENT ON TABLE "policy" IS 'Policies for a particular proceeding type (timelimits, quorum)';
582 COMMENT ON COLUMN "policy"."index" IS 'Determines the order in listings';
583 COMMENT ON COLUMN "policy"."active" IS 'TRUE = policy can be used for new issues';
584 COMMENT ON COLUMN "policy"."polling" IS 'TRUE = special policy for non-user-generated issues without issue quorum, where certain initiatives (those having the "polling" flag set) do not need to pass the initiative quorum; "min_admission_time" and "max_admission_time" MUST be set to NULL, the other timings may be set to NULL altogether, allowing individual timing for those issues';
585 COMMENT ON COLUMN "policy"."min_admission_time" IS 'Minimum duration of issue state ''admission''; Minimum time an issue stays open; Note: should be considerably smaller than "max_admission_time"';
586 COMMENT ON COLUMN "policy"."max_admission_time" IS 'Maximum duration of issue state ''admission''; Maximum time an issue stays open without being "accepted"';
587 COMMENT ON COLUMN "policy"."discussion_time" IS 'Duration of issue state ''discussion''; Regular time until an issue is "half_frozen" after being "accepted"';
588 COMMENT ON COLUMN "policy"."verification_time" IS 'Duration of issue state ''verification''; Regular time until an issue is "fully_frozen" (e.g. entering issue state ''voting'') after being "half_frozen"';
589 COMMENT ON COLUMN "policy"."voting_time" IS 'Duration of issue state ''voting''; Time after an issue is "fully_frozen" but not "closed" (duration of issue state ''voting'')';
590 COMMENT ON COLUMN "policy"."issue_quorum" IS 'Absolute number of supporters needed by an initiative to be "accepted", i.e. pass from ''admission'' to ''discussion'' state';
591 COMMENT ON COLUMN "policy"."issue_quorum_num" IS 'Numerator of supporter quorum to be reached by an initiative to be "accepted", i.e. pass from ''admission'' to ''discussion'' state (Note: further requirements apply, see quorum columns of "area" table)';
592 COMMENT ON COLUMN "policy"."issue_quorum_den" IS 'Denominator of supporter quorum to be reached by an initiative to be "accepted", i.e. pass from ''admission'' to ''discussion'' state (Note: further requirements apply, see quorum columns of "area" table)';
593 COMMENT ON COLUMN "policy"."initiative_quorum" IS 'Absolute number of satisfied supporters to be reached by an initiative to be "admitted" for voting';
594 COMMENT ON COLUMN "policy"."initiative_quorum_num" IS 'Numerator of satisfied supporter quorum to be reached by an initiative to be "admitted" for voting';
595 COMMENT ON COLUMN "policy"."initiative_quorum_den" IS 'Denominator of satisfied supporter quorum to be reached by an initiative to be "admitted" for voting';
596 COMMENT ON COLUMN "policy"."defeat_strength" IS 'How pairwise defeats are measured for the Schulze method; see type "defeat_strength"; ''tuple'' is the recommended setting';
597 COMMENT ON COLUMN "policy"."tie_breaking" IS 'Tie-breaker for the Schulze method; see type "tie_breaking"; ''variant1'' or ''variant2'' are recommended';
598 COMMENT ON COLUMN "policy"."direct_majority_num" IS 'Numerator of fraction of neccessary direct majority for initiatives to be attainable as winner';
599 COMMENT ON COLUMN "policy"."direct_majority_den" IS 'Denominator of fraction of neccessary direct majority for initaitives to be attainable as winner';
600 COMMENT ON COLUMN "policy"."direct_majority_strict" IS 'If TRUE, then the direct majority must be strictly greater than "direct_majority_num"/"direct_majority_den", otherwise it may also be equal.';
601 COMMENT ON COLUMN "policy"."direct_majority_positive" IS 'Absolute number of "positive_votes" neccessary for an initiative to be attainable as winner';
602 COMMENT ON COLUMN "policy"."direct_majority_non_negative" IS 'Absolute number of sum of "positive_votes" and abstentions neccessary for an initiative to be attainable as winner';
603 COMMENT ON COLUMN "policy"."indirect_majority_num" IS 'Numerator of fraction of neccessary indirect majority (through beat path) for initiatives to be attainable as winner';
604 COMMENT ON COLUMN "policy"."indirect_majority_den" IS 'Denominator of fraction of neccessary indirect majority (through beat path) for initiatives to be attainable as winner';
605 COMMENT ON COLUMN "policy"."indirect_majority_strict" IS 'If TRUE, then the indirect majority must be strictly greater than "indirect_majority_num"/"indirect_majority_den", otherwise it may also be equal.';
606 COMMENT ON COLUMN "policy"."indirect_majority_positive" IS 'Absolute number of votes in favor of the winner neccessary in a beat path to the status quo for an initaitive to be attainable as winner';
607 COMMENT ON COLUMN "policy"."indirect_majority_non_negative" IS 'Absolute number of sum of votes in favor and abstentions in a beat path to the status quo for an initiative to be attainable as winner';
608 COMMENT ON COLUMN "policy"."no_reverse_beat_path" IS 'EXPERIMENTAL FEATURE: Causes initiatives with "reverse_beat_path" flag to not be "eligible", thus disallowing them to be winner. See comment on column "initiative"."reverse_beat_path". This option ensures both that a winning initiative is never tied in a (weak) condorcet paradox with the status quo and a winning initiative always beats the status quo directly with a simple majority.';
609 COMMENT ON COLUMN "policy"."no_multistage_majority" IS 'EXPERIMENTAL FEATURE: Causes initiatives with "multistage_majority" flag to not be "eligible", thus disallowing them to be winner. See comment on column "initiative"."multistage_majority". This disqualifies initiatives which could cause an instable result. An instable result in this meaning is a result such that repeating the ballot with same preferences but with the winner of the first ballot as status quo would lead to a different winner in the second ballot. If there are no direct majorities required for the winner, or if in direct comparison only simple majorities are required and "no_reverse_beat_path" is true, then results are always stable and this flag does not have any effect on the winner (but still affects the "eligible" flag of an "initiative").';
612 CREATE TABLE "unit" (
613 "id" SERIAL4 PRIMARY KEY,
614 "parent_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
615 "active" BOOLEAN NOT NULL DEFAULT TRUE,
616 "name" TEXT NOT NULL,
617 "description" TEXT NOT NULL DEFAULT '',
618 "external_reference" TEXT,
619 "member_count" INT4,
620 "location" JSONB,
621 "text_search_data" TSVECTOR );
622 CREATE INDEX "unit_root_idx" ON "unit" ("id") WHERE "parent_id" ISNULL;
623 CREATE INDEX "unit_parent_id_idx" ON "unit" ("parent_id");
624 CREATE INDEX "unit_active_idx" ON "unit" ("active");
625 CREATE INDEX "unit_location_idx" ON "unit" USING gist ((GeoJSON_to_ecluster("location")));
626 CREATE INDEX "unit_text_search_data_idx" ON "unit" USING gin ("text_search_data");
627 CREATE TRIGGER "update_text_search_data"
628 BEFORE INSERT OR UPDATE ON "unit"
629 FOR EACH ROW EXECUTE PROCEDURE
630 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
631 "name", "description" );
633 COMMENT ON TABLE "unit" IS 'Organizational units organized as trees; Delegations are not inherited through these trees.';
635 COMMENT ON COLUMN "unit"."parent_id" IS 'Parent id of tree node; Multiple roots allowed';
636 COMMENT ON COLUMN "unit"."active" IS 'TRUE means new issues can be created in areas of this unit';
637 COMMENT ON COLUMN "unit"."external_reference" IS 'Opaque data field to store an external reference';
638 COMMENT ON COLUMN "unit"."member_count" IS 'Count of members as determined by column "voting_right" in table "privilege" (only active members counted)';
639 COMMENT ON COLUMN "unit"."location" IS 'Geographic location on earth as GeoJSON object indicating valid coordinates for initiatives of issues with this policy';
642 CREATE TABLE "subscription" (
643 PRIMARY KEY ("member_id", "unit_id"),
644 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
645 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
646 CREATE INDEX "subscription_unit_id_idx" ON "subscription" ("unit_id");
648 COMMENT ON TABLE "subscription" IS 'An entry in this table denotes that the member wishes to receive notifications regardless of his/her privileges in the given unit';
651 CREATE TABLE "area" (
652 UNIQUE ("unit_id", "id"), -- index needed for foreign-key on table "event"
653 "id" SERIAL4 PRIMARY KEY,
654 "unit_id" INT4 NOT NULL REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
655 "active" BOOLEAN NOT NULL DEFAULT TRUE,
656 "name" TEXT NOT NULL,
657 "description" TEXT NOT NULL DEFAULT '',
658 "quorum_standard" NUMERIC NOT NULL DEFAULT 2 CHECK ("quorum_standard" >= 0),
659 "quorum_issues" NUMERIC NOT NULL DEFAULT 1 CHECK ("quorum_issues" > 0),
660 "quorum_time" INTERVAL NOT NULL DEFAULT '1 day' CHECK ("quorum_time" > '0'::INTERVAL),
661 "quorum_exponent" NUMERIC NOT NULL DEFAULT 0.5 CHECK ("quorum_exponent" BETWEEN 0 AND 1),
662 "quorum_factor" NUMERIC NOT NULL DEFAULT 2 CHECK ("quorum_factor" >= 1),
663 "quorum_den" INT4 CHECK ("quorum_den" > 0),
664 "issue_quorum" INT4,
665 "external_reference" TEXT,
666 "location" JSONB,
667 "text_search_data" TSVECTOR );
668 CREATE INDEX "area_active_idx" ON "area" ("active");
669 CREATE INDEX "area_location_idx" ON "area" USING gist ((GeoJSON_to_ecluster("location")));
670 CREATE INDEX "area_text_search_data_idx" ON "area" USING gin ("text_search_data");
671 CREATE TRIGGER "update_text_search_data"
672 BEFORE INSERT OR UPDATE ON "area"
673 FOR EACH ROW EXECUTE PROCEDURE
674 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
675 "name", "description" );
677 COMMENT ON TABLE "area" IS 'Subject areas';
679 COMMENT ON COLUMN "area"."active" IS 'TRUE means new issues can be created in this area';
680 COMMENT ON COLUMN "area"."quorum_standard" IS 'Parameter for dynamic issue quorum: default quorum';
681 COMMENT ON COLUMN "area"."quorum_issues" IS 'Parameter for dynamic issue quorum: number of open issues for default quorum';
682 COMMENT ON COLUMN "area"."quorum_time" IS 'Parameter for dynamic issue quorum: discussion, verification, and voting time of open issues to result in the given default quorum (open issues with shorter time will increase quorum and open issues with longer time will reduce quorum if "quorum_exponent" is greater than zero)';
683 COMMENT ON COLUMN "area"."quorum_exponent" IS 'Parameter for dynamic issue quorum: set to zero to ignore duration of open issues, set to one to fully take duration of open issues into account; defaults to 0.5';
684 COMMENT ON COLUMN "area"."quorum_factor" IS 'Parameter for dynamic issue quorum: factor to increase dynamic quorum when a number of "quorum_issues" issues with "quorum_time" duration of discussion, verification, and voting phase are added to the number of open admitted issues';
685 COMMENT ON COLUMN "area"."quorum_den" IS 'Parameter for dynamic issue quorum: when set, dynamic quorum is multiplied with "issue"."population" and divided by "quorum_den" (and then rounded up)';
686 COMMENT ON COLUMN "area"."issue_quorum" IS 'Additional dynamic issue quorum based on the number of open accepted issues; automatically calculated by function "issue_admission"';
687 COMMENT ON COLUMN "area"."external_reference" IS 'Opaque data field to store an external reference';
688 COMMENT ON COLUMN "area"."location" IS 'Geographic location on earth as GeoJSON object indicating valid coordinates for initiatives of issues with this policy';
691 CREATE TABLE "ignored_area" (
692 PRIMARY KEY ("member_id", "area_id"),
693 "member_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
694 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
695 CREATE INDEX "ignored_area_area_id_idx" ON "ignored_area" ("area_id");
697 COMMENT ON TABLE "ignored_area" IS 'An entry in this table denotes that the member does not wish to receive notifications for the given subject area unless he/she declared interested in a particular issue';
700 CREATE TABLE "allowed_policy" (
701 PRIMARY KEY ("area_id", "policy_id"),
702 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
703 "policy_id" INT4 NOT NULL REFERENCES "policy" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
704 "default_policy" BOOLEAN NOT NULL DEFAULT FALSE );
705 CREATE UNIQUE INDEX "allowed_policy_one_default_per_area_idx" ON "allowed_policy" ("area_id") WHERE "default_policy";
707 COMMENT ON TABLE "allowed_policy" IS 'Selects which policies can be used in each area';
709 COMMENT ON COLUMN "allowed_policy"."default_policy" IS 'One policy per area can be set as default.';
712 CREATE TABLE "snapshot" (
713 UNIQUE ("issue_id", "id"), -- index needed for foreign-key on table "issue"
714 "id" SERIAL8 PRIMARY KEY,
715 "calculated" TIMESTAMPTZ NOT NULL DEFAULT now(),
716 "population" INT4,
717 "area_id" INT4 NOT NULL REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
718 "issue_id" INT4 ); -- NOTE: following (cyclic) reference is added later through ALTER command: REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE
720 COMMENT ON TABLE "snapshot" IS 'Point in time when a snapshot of one or more issues (see table "snapshot_issue") and their supporter situation is taken';
723 CREATE TABLE "snapshot_population" (
724 PRIMARY KEY ("snapshot_id", "member_id"),
725 "snapshot_id" INT8 REFERENCES "snapshot" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
726 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE );
728 COMMENT ON TABLE "snapshot_population" IS 'Members with voting right relevant for a snapshot';
731 CREATE TYPE "issue_state" AS ENUM (
732 'admission', 'discussion', 'verification', 'voting',
733 'canceled_by_admin',
734 'canceled_revoked_before_accepted',
735 'canceled_issue_not_accepted',
736 'canceled_after_revocation_during_discussion',
737 'canceled_after_revocation_during_verification',
738 'canceled_no_initiative_admitted',
739 'finished_without_winner', 'finished_with_winner');
741 COMMENT ON TYPE "issue_state" IS 'State of issues';
744 CREATE TABLE "issue" (
745 UNIQUE ("area_id", "id"), -- index needed for foreign-key on table "event"
746 UNIQUE ("policy_id", "id"), -- index needed for foreign-key on table "event"
747 "id" SERIAL4 PRIMARY KEY,
748 "area_id" INT4 NOT NULL REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
749 "policy_id" INT4 NOT NULL REFERENCES "policy" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
750 "admin_notice" TEXT,
751 "external_reference" TEXT,
752 "state" "issue_state" NOT NULL DEFAULT 'admission',
753 "phase_finished" TIMESTAMPTZ,
754 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
755 "accepted" TIMESTAMPTZ,
756 "half_frozen" TIMESTAMPTZ,
757 "fully_frozen" TIMESTAMPTZ,
758 "closed" TIMESTAMPTZ,
759 "cleaned" TIMESTAMPTZ,
760 "min_admission_time" INTERVAL,
761 "max_admission_time" INTERVAL,
762 "discussion_time" INTERVAL NOT NULL,
763 "verification_time" INTERVAL NOT NULL,
764 "voting_time" INTERVAL NOT NULL,
765 "calculated" TIMESTAMPTZ, -- NOTE: copy of "calculated" column of latest snapshot, but no referential integrity to avoid overhead
766 "latest_snapshot_id" INT8 REFERENCES "snapshot" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
767 "admission_snapshot_id" INT8 REFERENCES "snapshot" ("id") ON DELETE SET NULL ON UPDATE CASCADE,
768 "half_freeze_snapshot_id" INT8,
769 FOREIGN KEY ("id", "half_freeze_snapshot_id")
770 REFERENCES "snapshot" ("issue_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE,
771 "full_freeze_snapshot_id" INT8,
772 FOREIGN KEY ("id", "full_freeze_snapshot_id")
773 REFERENCES "snapshot" ("issue_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE,
774 "issue_quorum" INT4,
775 "initiative_quorum" INT4,
776 "population" INT4,
777 "voter_count" INT4,
778 "status_quo_schulze_rank" INT4,
779 CONSTRAINT "admission_time_not_null_unless_instantly_accepted" CHECK (
780 ("min_admission_time" NOTNULL) = ("max_admission_time" NOTNULL) AND
781 ("min_admission_time" NOTNULL OR ("accepted" NOTNULL AND "accepted" = "created")) ),
782 CONSTRAINT "valid_state" CHECK (
783 (
784 ("accepted" ISNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL ) OR
785 ("accepted" NOTNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL ) OR
786 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" ISNULL ) OR
787 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" NOTNULL)
788 ) AND (
789 ("state" = 'admission' AND "closed" ISNULL AND "accepted" ISNULL) OR
790 ("state" = 'discussion' AND "closed" ISNULL AND "accepted" NOTNULL AND "half_frozen" ISNULL) OR
791 ("state" = 'verification' AND "closed" ISNULL AND "half_frozen" NOTNULL AND "fully_frozen" ISNULL) OR
792 ("state" = 'voting' AND "closed" ISNULL AND "fully_frozen" NOTNULL) OR
793 ("state" = 'canceled_by_admin' AND "closed" NOTNULL) OR
794 ("state" = 'canceled_revoked_before_accepted' AND "closed" NOTNULL AND "accepted" ISNULL) OR
795 ("state" = 'canceled_issue_not_accepted' AND "closed" NOTNULL AND "accepted" ISNULL) OR
796 ("state" = 'canceled_after_revocation_during_discussion' AND "closed" NOTNULL AND "half_frozen" ISNULL) OR
797 ("state" = 'canceled_after_revocation_during_verification' AND "closed" NOTNULL AND "fully_frozen" ISNULL) OR
798 ("state" = 'canceled_no_initiative_admitted' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" = "fully_frozen") OR
799 ("state" = 'finished_without_winner' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" != "fully_frozen") OR
800 ("state" = 'finished_with_winner' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" != "fully_frozen")
801 )),
802 CONSTRAINT "phase_finished_only_when_not_closed" CHECK (
803 "phase_finished" ISNULL OR "closed" ISNULL ),
804 CONSTRAINT "state_change_order" CHECK (
805 "created" <= "accepted" AND
806 "accepted" <= "half_frozen" AND
807 "half_frozen" <= "fully_frozen" AND
808 "fully_frozen" <= "closed" ),
809 CONSTRAINT "only_closed_issues_may_be_cleaned" CHECK (
810 "cleaned" ISNULL OR "closed" NOTNULL ),
811 CONSTRAINT "snapshot_required" CHECK (
812 --("accepted" ISNULL OR "admission_snapshot_id" NOTNULL) AND
813 ("half_frozen" ISNULL OR "half_freeze_snapshot_id" NOTNULL) AND
814 ("fully_frozen" ISNULL OR "full_freeze_snapshot_id" NOTNULL) ) );
815 CREATE INDEX "issue_state_idx" ON "issue" ("state");
816 CREATE INDEX "issue_created_idx" ON "issue" ("created");
817 CREATE INDEX "issue_accepted_idx" ON "issue" ("accepted");
818 CREATE INDEX "issue_half_frozen_idx" ON "issue" ("half_frozen");
819 CREATE INDEX "issue_fully_frozen_idx" ON "issue" ("fully_frozen");
820 CREATE INDEX "issue_closed_idx" ON "issue" ("closed");
821 CREATE INDEX "issue_created_idx_open" ON "issue" ("created") WHERE "closed" ISNULL;
822 CREATE INDEX "issue_closed_idx_canceled" ON "issue" ("closed") WHERE "fully_frozen" ISNULL;
823 CREATE INDEX "issue_latest_snapshot_id" ON "issue" ("latest_snapshot_id");
824 CREATE INDEX "issue_admission_snapshot_id" ON "issue" ("admission_snapshot_id");
825 CREATE INDEX "issue_half_freeze_snapshot_id" ON "issue" ("half_freeze_snapshot_id");
826 CREATE INDEX "issue_full_freeze_snapshot_id" ON "issue" ("full_freeze_snapshot_id");
828 COMMENT ON TABLE "issue" IS 'Groups of initiatives';
830 COMMENT ON COLUMN "issue"."admin_notice" IS 'Public notice by admin to explain manual interventions, or to announce corrections';
831 COMMENT ON COLUMN "issue"."external_reference" IS 'Opaque data field to store an external reference';
832 COMMENT ON COLUMN "issue"."phase_finished" IS 'Set to a value NOTNULL, if the current phase has finished, but calculations are pending; No changes in this issue shall be made by the frontend or API when this value is set';
833 COMMENT ON COLUMN "issue"."accepted" IS 'Point in time, when the issue was accepted for further discussion (see columns "issue_quorum_num" and "issue_quorum_den" of table "policy" and quorum columns of table "area")';
834 COMMENT ON COLUMN "issue"."half_frozen" IS 'Point in time, when "discussion_time" has elapsed; Frontends must ensure that for half_frozen issues a) initiatives are not revoked, b) no new drafts are created, c) no initiators are added or removed.';
835 COMMENT ON COLUMN "issue"."fully_frozen" IS 'Point in time, when "verification_time" has elapsed and voting has started; Frontends must ensure that for fully_frozen issues additionally to the restrictions for half_frozen issues a) initiatives are not created, b) no interest is created or removed, c) no supporters are added or removed, d) no opinions are created, changed or deleted.';
836 COMMENT ON COLUMN "issue"."closed" IS 'Point in time, when "max_admission_time" or "voting_time" have elapsed, and issue is no longer active; Frontends must ensure that for closed issues additionally to the restrictions for half_frozen and fully_frozen issues a) no voter is added or removed to/from the direct_voter table, b) no votes are added, modified or removed.';
837 COMMENT ON COLUMN "issue"."cleaned" IS 'Point in time, when discussion data and votes had been deleted';
838 COMMENT ON COLUMN "issue"."min_admission_time" IS 'Copied from "policy" table at creation of issue';
839 COMMENT ON COLUMN "issue"."max_admission_time" IS 'Copied from "policy" table at creation of issue';
840 COMMENT ON COLUMN "issue"."discussion_time" IS 'Copied from "policy" table at creation of issue';
841 COMMENT ON COLUMN "issue"."verification_time" IS 'Copied from "policy" table at creation of issue';
842 COMMENT ON COLUMN "issue"."voting_time" IS 'Copied from "policy" table at creation of issue';
843 COMMENT ON COLUMN "issue"."calculated" IS 'Point in time, when most recent snapshot and "population" and *_count values were calculated (NOTE: value is equal to "snapshot"."calculated" of snapshot with "id"="issue"."latest_snapshot_id")';
844 COMMENT ON COLUMN "issue"."latest_snapshot_id" IS 'Snapshot id of most recent snapshot';
845 COMMENT ON COLUMN "issue"."admission_snapshot_id" IS 'Snapshot id when issue as accepted or canceled in admission phase';
846 COMMENT ON COLUMN "issue"."half_freeze_snapshot_id" IS 'Snapshot id at end of discussion phase';
847 COMMENT ON COLUMN "issue"."full_freeze_snapshot_id" IS 'Snapshot id at end of verification phase';
848 COMMENT ON COLUMN "issue"."issue_quorum" IS 'Calculated number of supporters needed by an initiative of the issue to be "accepted", i.e. pass from ''admission'' to ''discussion'' state';
849 COMMENT ON COLUMN "issue"."initiative_quorum" IS 'Calculated number of satisfied supporters to be reached by an initiative to be "admitted" for voting';
850 COMMENT ON COLUMN "issue"."population" IS 'Count of members in "snapshot_population" table with "snapshot_id" equal to "issue"."latest_snapshot_id"';
851 COMMENT ON COLUMN "issue"."voter_count" IS 'Total number of direct and delegating voters; This value is related to the final voting, while "population" is related to snapshots before the final voting';
852 COMMENT ON COLUMN "issue"."status_quo_schulze_rank" IS 'Schulze rank of status quo, as calculated by "calculate_ranks" function';
855 ALTER TABLE "snapshot" ADD FOREIGN KEY ("issue_id") REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE;
858 CREATE TABLE "issue_order_in_admission_state" (
859 "id" INT8 PRIMARY KEY, -- NOTE: no referential integrity due to performans/locking issues; REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
860 "order_in_area" INT4,
861 "order_in_unit" INT4 );
863 COMMENT ON TABLE "issue_order_in_admission_state" IS 'Ordering information for issues that are not stored in the "issue" table to avoid locking of multiple issues at once; Filled/updated by "lf_update_issue_order"';
865 COMMENT ON COLUMN "issue_order_in_admission_state"."id" IS 'References "issue" ("id") but has no referential integrity trigger associated, due to performance/locking issues';
866 COMMENT ON COLUMN "issue_order_in_admission_state"."order_in_area" IS 'Order of issues in admission state within a single area; NULL values sort last';
867 COMMENT ON COLUMN "issue_order_in_admission_state"."order_in_unit" IS 'Order of issues in admission state within all areas of a unit; NULL values sort last';
870 CREATE TABLE "initiative" (
871 UNIQUE ("issue_id", "id"), -- index needed for foreign-key on table "vote"
872 "issue_id" INT4 NOT NULL REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
873 "id" SERIAL4 PRIMARY KEY,
874 "name" TEXT NOT NULL,
875 "polling" BOOLEAN NOT NULL DEFAULT FALSE,
876 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
877 "revoked" TIMESTAMPTZ,
878 "revoked_by_member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
879 "suggested_initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE SET NULL ON UPDATE CASCADE,
880 "location" JSONB,
881 "external_reference" TEXT,
882 "admitted" BOOLEAN,
883 "supporter_count" INT4,
884 "informed_supporter_count" INT4,
885 "satisfied_supporter_count" INT4,
886 "satisfied_informed_supporter_count" INT4,
887 "harmonic_weight" NUMERIC(12, 3),
888 "final_suggestion_order_calculated" BOOLEAN NOT NULL DEFAULT FALSE,
889 "first_preference_votes" INT4,
890 "positive_votes" INT4,
891 "negative_votes" INT4,
892 "direct_majority" BOOLEAN,
893 "indirect_majority" BOOLEAN,
894 "schulze_rank" INT4,
895 "better_than_status_quo" BOOLEAN,
896 "worse_than_status_quo" BOOLEAN,
897 "reverse_beat_path" BOOLEAN,
898 "multistage_majority" BOOLEAN,
899 "eligible" BOOLEAN,
900 "winner" BOOLEAN,
901 "rank" INT4,
902 "text_search_data" TSVECTOR,
903 "draft_text_search_data" TSVECTOR,
904 CONSTRAINT "all_or_none_of_revoked_and_revoked_by_member_id_must_be_null"
905 CHECK (("revoked" NOTNULL) = ("revoked_by_member_id" NOTNULL)),
906 CONSTRAINT "non_revoked_initiatives_cant_suggest_other"
907 CHECK ("revoked" NOTNULL OR "suggested_initiative_id" ISNULL),
908 CONSTRAINT "revoked_initiatives_cant_be_admitted"
909 CHECK ("revoked" ISNULL OR "admitted" ISNULL),
910 CONSTRAINT "non_admitted_initiatives_cant_contain_voting_results" CHECK (
911 ( "admitted" NOTNULL AND "admitted" = TRUE ) OR
912 ( "first_preference_votes" ISNULL AND
913 "positive_votes" ISNULL AND "negative_votes" ISNULL AND
914 "direct_majority" ISNULL AND "indirect_majority" ISNULL AND
915 "schulze_rank" ISNULL AND
916 "better_than_status_quo" ISNULL AND "worse_than_status_quo" ISNULL AND
917 "reverse_beat_path" ISNULL AND "multistage_majority" ISNULL AND
918 "eligible" ISNULL AND "winner" ISNULL AND "rank" ISNULL ) ),
919 CONSTRAINT "better_excludes_worse" CHECK (NOT ("better_than_status_quo" AND "worse_than_status_quo")),
920 CONSTRAINT "minimum_requirement_to_be_eligible" CHECK (
921 "eligible" = FALSE OR
922 ("direct_majority" AND "indirect_majority" AND "better_than_status_quo") ),
923 CONSTRAINT "winner_must_be_eligible" CHECK ("winner"=FALSE OR "eligible"=TRUE),
924 CONSTRAINT "winner_must_have_first_rank" CHECK ("winner"=FALSE OR "rank"=1),
925 CONSTRAINT "eligible_at_first_rank_is_winner" CHECK ("eligible"=FALSE OR "rank"!=1 OR "winner"=TRUE),
926 CONSTRAINT "unique_rank_per_issue" UNIQUE ("issue_id", "rank") );
927 CREATE INDEX "initiative_created_idx" ON "initiative" ("created");
928 CREATE INDEX "initiative_revoked_idx" ON "initiative" ("revoked");
929 CREATE INDEX "initiative_location_idx" ON "initiative" USING gist ((GeoJSON_to_ecluster("location")));
930 CREATE INDEX "initiative_text_search_data_idx" ON "initiative" USING gin ("text_search_data");
931 CREATE INDEX "initiative_draft_text_search_data_idx" ON "initiative" USING gin ("draft_text_search_data");
932 CREATE TRIGGER "update_text_search_data"
933 BEFORE INSERT OR UPDATE ON "initiative"
934 FOR EACH ROW EXECUTE PROCEDURE
935 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "name");
937 COMMENT ON TABLE "initiative" IS 'Group of members publishing drafts for resolutions to be passed; Frontends must ensure that initiatives of half_frozen issues are not revoked, and that initiatives of fully_frozen or closed issues are neither revoked nor created.';
939 COMMENT ON COLUMN "initiative"."polling" IS 'Initiative does not need to pass the initiative quorum (see "policy"."polling")';
940 COMMENT ON COLUMN "initiative"."revoked" IS 'Point in time, when one initiator decided to revoke the initiative';
941 COMMENT ON COLUMN "initiative"."revoked_by_member_id" IS 'Member, who decided to revoke the initiative';
942 COMMENT ON COLUMN "initiative"."location" IS 'Geographic location of initiative as GeoJSON object (automatically copied from most recent draft)';
943 COMMENT ON COLUMN "initiative"."external_reference" IS 'Opaque data field to store an external reference';
944 COMMENT ON COLUMN "initiative"."admitted" IS 'TRUE, if initiative reaches the "initiative_quorum" when freezing the issue';
945 COMMENT ON COLUMN "initiative"."supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
946 COMMENT ON COLUMN "initiative"."informed_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
947 COMMENT ON COLUMN "initiative"."satisfied_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
948 COMMENT ON COLUMN "initiative"."satisfied_informed_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
949 COMMENT ON COLUMN "initiative"."harmonic_weight" IS 'Indicates the relevancy of the initiative, calculated from the potential supporters weighted with the harmonic series to avoid a large number of clones affecting other initiative''s sorting positions too much; shall be used as secondary sorting key after "admitted" as primary sorting key';
950 COMMENT ON COLUMN "initiative"."final_suggestion_order_calculated" IS 'Set to TRUE, when "proportional_order" of suggestions has been calculated the last time';
951 COMMENT ON COLUMN "initiative"."first_preference_votes" IS 'Number of direct and delegating voters who ranked this initiative as their first choice';
952 COMMENT ON COLUMN "initiative"."positive_votes" IS 'Number of direct and delegating voters who ranked this initiative better than the status quo';
953 COMMENT ON COLUMN "initiative"."negative_votes" IS 'Number of direct and delegating voters who ranked this initiative worse than the status quo';
954 COMMENT ON COLUMN "initiative"."direct_majority" IS 'TRUE, if "positive_votes"/("positive_votes"+"negative_votes") is strictly greater or greater-equal than "direct_majority_num"/"direct_majority_den", and "positive_votes" is greater-equal than "direct_majority_positive", and ("positive_votes"+abstentions) is greater-equal than "direct_majority_non_negative"';
955 COMMENT ON COLUMN "initiative"."indirect_majority" IS 'Same as "direct_majority", but also considering indirect beat paths';
956 COMMENT ON COLUMN "initiative"."schulze_rank" IS 'Schulze-Ranking';
957 COMMENT ON COLUMN "initiative"."better_than_status_quo" IS 'TRUE, if initiative has a schulze-ranking better than the status quo';
958 COMMENT ON COLUMN "initiative"."worse_than_status_quo" IS 'TRUE, if initiative has a schulze-ranking worse than the status quo (DEPRECATED, since schulze-ranking is unique per issue; use "better_than_status_quo"=FALSE)';
959 COMMENT ON COLUMN "initiative"."reverse_beat_path" IS 'TRUE, if there is a beat path (may include ties) from this initiative to the status quo; set to NULL if "policy"."defeat_strength" is set to ''simple''';
960 COMMENT ON COLUMN "initiative"."multistage_majority" IS 'TRUE, if either (a) this initiative has no better rank than the status quo, or (b) there exists a better ranked initiative X, which directly beats this initiative, and either more voters prefer X to this initiative than voters preferring X to the status quo or less voters prefer this initiative to X than voters preferring the status quo to X';
961 COMMENT ON COLUMN "initiative"."eligible" IS 'Initiative has a "direct_majority" and an "indirect_majority", is "better_than_status_quo" and depending on selected policy the initiative has no "reverse_beat_path" or "multistage_majority"';
962 COMMENT ON COLUMN "initiative"."winner" IS 'Winner is the "eligible" initiative with best "schulze_rank"';
963 COMMENT ON COLUMN "initiative"."rank" IS 'Unique ranking for all "admitted" initiatives per issue; lower rank is better; a winner always has rank 1, but rank 1 does not imply that an initiative is winner; initiatives with "direct_majority" AND "indirect_majority" always have a better (lower) rank than other initiatives';
966 CREATE TABLE "battle" (
967 "issue_id" INT4 NOT NULL,
968 "winning_initiative_id" INT4,
969 FOREIGN KEY ("issue_id", "winning_initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
970 "losing_initiative_id" INT4,
971 FOREIGN KEY ("issue_id", "losing_initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
972 "count" INT4 NOT NULL,
973 CONSTRAINT "initiative_ids_not_equal" CHECK (
974 "winning_initiative_id" != "losing_initiative_id" OR
975 ( ("winning_initiative_id" NOTNULL AND "losing_initiative_id" ISNULL) OR
976 ("winning_initiative_id" ISNULL AND "losing_initiative_id" NOTNULL) ) ) );
977 CREATE UNIQUE INDEX "battle_winning_losing_idx" ON "battle" ("issue_id", "winning_initiative_id", "losing_initiative_id");
978 CREATE UNIQUE INDEX "battle_winning_null_idx" ON "battle" ("issue_id", "winning_initiative_id") WHERE "losing_initiative_id" ISNULL;
979 CREATE UNIQUE INDEX "battle_null_losing_idx" ON "battle" ("issue_id", "losing_initiative_id") WHERE "winning_initiative_id" ISNULL;
981 COMMENT ON TABLE "battle" IS 'Number of members preferring one initiative to another; Filled by "battle_view" when closing an issue; NULL as initiative_id denotes virtual "status-quo" initiative';
984 CREATE TABLE "ignored_initiative" (
985 PRIMARY KEY ("member_id", "initiative_id"),
986 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
987 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
988 CREATE INDEX "ignored_initiative_initiative_id_idx" ON "ignored_initiative" ("initiative_id");
990 COMMENT ON TABLE "ignored_initiative" IS 'An entry in this table denotes that the member does not wish to receive notifications for the given initiative';
993 CREATE TABLE "draft" (
994 UNIQUE ("initiative_id", "id"), -- index needed for foreign-key on table "supporter"
995 "initiative_id" INT4 NOT NULL REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
996 "id" SERIAL8 PRIMARY KEY,
997 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
998 "author_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
999 "formatting_engine" TEXT,
1000 "content" TEXT NOT NULL,
1001 "location" JSONB,
1002 "external_reference" TEXT,
1003 "text_search_data" TSVECTOR );
1004 CREATE INDEX "draft_created_idx" ON "draft" ("created");
1005 CREATE INDEX "draft_author_id_created_idx" ON "draft" ("author_id", "created");
1006 CREATE INDEX "draft_location_idx" ON "draft" USING gist ((GeoJSON_to_ecluster("location")));
1007 CREATE INDEX "draft_text_search_data_idx" ON "draft" USING gin ("text_search_data");
1008 CREATE TRIGGER "update_text_search_data"
1009 BEFORE INSERT OR UPDATE ON "draft"
1010 FOR EACH ROW EXECUTE PROCEDURE
1011 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "content");
1013 COMMENT ON TABLE "draft" IS 'Drafts of initiatives to solve issues; Frontends must ensure that new drafts for initiatives of half_frozen, fully_frozen or closed issues can''t be created.';
1015 COMMENT ON COLUMN "draft"."formatting_engine" IS 'Allows different formatting engines (i.e. wiki formats) to be used';
1016 COMMENT ON COLUMN "draft"."content" IS 'Text of the draft in a format depending on the field "formatting_engine"';
1017 COMMENT ON COLUMN "draft"."location" IS 'Geographic location of initiative as GeoJSON object (automatically copied to "initiative" table if draft is most recent)';
1018 COMMENT ON COLUMN "draft"."external_reference" IS 'Opaque data field to store an external reference';
1021 CREATE TABLE "rendered_draft" (
1022 PRIMARY KEY ("draft_id", "format"),
1023 "draft_id" INT8 REFERENCES "draft" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1024 "format" TEXT,
1025 "content" TEXT NOT NULL );
1027 COMMENT ON TABLE "rendered_draft" IS 'This table may be used by frontends to cache "rendered" drafts (e.g. HTML output generated from wiki text)';
1030 CREATE TABLE "suggestion" (
1031 UNIQUE ("initiative_id", "id"), -- index needed for foreign-key on table "opinion"
1032 "initiative_id" INT4 NOT NULL REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1033 "id" SERIAL8 PRIMARY KEY,
1034 "draft_id" INT8 NOT NULL,
1035 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE,
1036 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
1037 "author_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1038 "name" TEXT NOT NULL,
1039 "formatting_engine" TEXT,
1040 "content" TEXT NOT NULL DEFAULT '',
1041 "location" JSONB,
1042 "external_reference" TEXT,
1043 "text_search_data" TSVECTOR,
1044 "minus2_unfulfilled_count" INT4,
1045 "minus2_fulfilled_count" INT4,
1046 "minus1_unfulfilled_count" INT4,
1047 "minus1_fulfilled_count" INT4,
1048 "plus1_unfulfilled_count" INT4,
1049 "plus1_fulfilled_count" INT4,
1050 "plus2_unfulfilled_count" INT4,
1051 "plus2_fulfilled_count" INT4,
1052 "proportional_order" INT4 );
1053 CREATE INDEX "suggestion_created_idx" ON "suggestion" ("created");
1054 CREATE INDEX "suggestion_author_id_created_idx" ON "suggestion" ("author_id", "created");
1055 CREATE INDEX "suggestion_location_idx" ON "suggestion" USING gist ((GeoJSON_to_ecluster("location")));
1056 CREATE INDEX "suggestion_text_search_data_idx" ON "suggestion" USING gin ("text_search_data");
1057 CREATE TRIGGER "update_text_search_data"
1058 BEFORE INSERT OR UPDATE ON "suggestion"
1059 FOR EACH ROW EXECUTE PROCEDURE
1060 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
1061 "name", "content");
1063 COMMENT ON TABLE "suggestion" IS 'Suggestions to initiators, to change the current draft; must not be deleted explicitly, as they vanish automatically if the last opinion is deleted';
1065 COMMENT ON COLUMN "suggestion"."draft_id" IS 'Draft, which the author has seen when composing the suggestion; should always be set by a frontend, but defaults to current draft of the initiative (implemented by trigger "default_for_draft_id")';
1066 COMMENT ON COLUMN "suggestion"."location" IS 'Geographic location of suggestion as GeoJSON object';
1067 COMMENT ON COLUMN "suggestion"."external_reference" IS 'Opaque data field to store an external reference';
1068 COMMENT ON COLUMN "suggestion"."minus2_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1069 COMMENT ON COLUMN "suggestion"."minus2_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1070 COMMENT ON COLUMN "suggestion"."minus1_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1071 COMMENT ON COLUMN "suggestion"."minus1_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1072 COMMENT ON COLUMN "suggestion"."plus1_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1073 COMMENT ON COLUMN "suggestion"."plus1_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1074 COMMENT ON COLUMN "suggestion"."plus2_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1075 COMMENT ON COLUMN "suggestion"."plus2_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1076 COMMENT ON COLUMN "suggestion"."proportional_order" IS 'To be used for sorting suggestions within an initiative; NULL values sort last; updated by "lf_update_suggestion_order"';
1079 CREATE TABLE "rendered_suggestion" (
1080 PRIMARY KEY ("suggestion_id", "format"),
1081 "suggestion_id" INT8 REFERENCES "suggestion" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1082 "format" TEXT,
1083 "content" TEXT NOT NULL );
1085 COMMENT ON TABLE "rendered_suggestion" IS 'This table may be used by frontends to cache "rendered" drafts (e.g. HTML output generated from wiki text)';
1088 CREATE TABLE "temporary_suggestion_counts" (
1089 "id" INT8 PRIMARY KEY, -- NOTE: no referential integrity due to performance/locking issues; REFERENCES "suggestion" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1090 "minus2_unfulfilled_count" INT4 NOT NULL,
1091 "minus2_fulfilled_count" INT4 NOT NULL,
1092 "minus1_unfulfilled_count" INT4 NOT NULL,
1093 "minus1_fulfilled_count" INT4 NOT NULL,
1094 "plus1_unfulfilled_count" INT4 NOT NULL,
1095 "plus1_fulfilled_count" INT4 NOT NULL,
1096 "plus2_unfulfilled_count" INT4 NOT NULL,
1097 "plus2_fulfilled_count" INT4 NOT NULL );
1099 COMMENT ON TABLE "temporary_suggestion_counts" IS 'Holds certain calculated values (suggestion counts) temporarily until they can be copied into table "suggestion"';
1101 COMMENT ON COLUMN "temporary_suggestion_counts"."id" IS 'References "suggestion" ("id") but has no referential integrity trigger associated, due to performance/locking issues';
1104 CREATE TABLE "privilege" (
1105 PRIMARY KEY ("unit_id", "member_id"),
1106 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1107 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1108 "admin_manager" BOOLEAN NOT NULL DEFAULT FALSE,
1109 "unit_manager" BOOLEAN NOT NULL DEFAULT FALSE,
1110 "area_manager" BOOLEAN NOT NULL DEFAULT FALSE,
1111 "member_manager" BOOLEAN NOT NULL DEFAULT FALSE,
1112 "initiative_right" BOOLEAN NOT NULL DEFAULT TRUE,
1113 "voting_right" BOOLEAN NOT NULL DEFAULT TRUE,
1114 "polling_right" BOOLEAN NOT NULL DEFAULT FALSE );
1116 COMMENT ON TABLE "privilege" IS 'Members rights related to each unit';
1118 COMMENT ON COLUMN "privilege"."admin_manager" IS 'Grant/revoke any privileges to/from other members';
1119 COMMENT ON COLUMN "privilege"."unit_manager" IS 'Create and disable sub units';
1120 COMMENT ON COLUMN "privilege"."area_manager" IS 'Create and disable areas and set area parameters';
1121 COMMENT ON COLUMN "privilege"."member_manager" IS 'Adding/removing members from the unit, granting or revoking "initiative_right" and "voting_right"';
1122 COMMENT ON COLUMN "privilege"."initiative_right" IS 'Right to create an initiative';
1123 COMMENT ON COLUMN "privilege"."voting_right" IS 'Right to support initiatives, create and rate suggestions, and to vote';
1124 COMMENT ON COLUMN "privilege"."polling_right" IS 'Right to create issues with policies having the "policy"."polling" flag set, and to add initiatives having the "initiative"."polling" flag set to those issues';
1127 CREATE TABLE "interest" (
1128 PRIMARY KEY ("issue_id", "member_id"),
1129 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1130 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE );
1131 CREATE INDEX "interest_member_id_idx" ON "interest" ("member_id");
1133 COMMENT ON TABLE "interest" IS 'Interest of members in a particular issue; Frontends must ensure that interest for fully_frozen or closed issues is not added or removed.';
1136 CREATE TABLE "initiator" (
1137 PRIMARY KEY ("initiative_id", "member_id"),
1138 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1139 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1140 "accepted" BOOLEAN );
1141 CREATE INDEX "initiator_member_id_idx" ON "initiator" ("member_id");
1143 COMMENT ON TABLE "initiator" IS 'Members who are allowed to post new drafts; Frontends must ensure that initiators are not added or removed from half_frozen, fully_frozen or closed initiatives.';
1145 COMMENT ON COLUMN "initiator"."accepted" IS 'If "accepted" is NULL, then the member was invited to be a co-initiator, but has not answered yet. If it is TRUE, the member has accepted the invitation, if it is FALSE, the member has rejected the invitation.';
1148 CREATE TABLE "supporter" (
1149 "issue_id" INT4 NOT NULL,
1150 PRIMARY KEY ("initiative_id", "member_id"),
1151 "initiative_id" INT4,
1152 "member_id" INT4,
1153 "draft_id" INT8 NOT NULL,
1154 FOREIGN KEY ("issue_id", "member_id") REFERENCES "interest" ("issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE,
1155 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE );
1156 CREATE INDEX "supporter_member_id_idx" ON "supporter" ("member_id");
1158 COMMENT ON TABLE "supporter" IS 'Members who support an initiative (conditionally); Frontends must ensure that supporters are not added or removed from fully_frozen or closed initiatives.';
1160 COMMENT ON COLUMN "supporter"."issue_id" IS 'WARNING: No index: For selections use column "initiative_id" and join via table "initiative" where neccessary';
1161 COMMENT ON COLUMN "supporter"."draft_id" IS 'Latest seen draft; should always be set by a frontend, but defaults to current draft of the initiative (implemented by trigger "default_for_draft_id")';
1164 CREATE TABLE "opinion" (
1165 "initiative_id" INT4 NOT NULL,
1166 PRIMARY KEY ("suggestion_id", "member_id"),
1167 "suggestion_id" INT8,
1168 "member_id" INT4,
1169 "degree" INT2 NOT NULL CHECK ("degree" >= -2 AND "degree" <= 2 AND "degree" != 0),
1170 "fulfilled" BOOLEAN NOT NULL DEFAULT FALSE,
1171 FOREIGN KEY ("initiative_id", "suggestion_id") REFERENCES "suggestion" ("initiative_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1172 FOREIGN KEY ("initiative_id", "member_id") REFERENCES "supporter" ("initiative_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
1173 CREATE INDEX "opinion_member_id_initiative_id_idx" ON "opinion" ("member_id", "initiative_id");
1175 COMMENT ON TABLE "opinion" IS 'Opinion on suggestions (criticism related to initiatives); Frontends must ensure that opinions are not created modified or deleted when related to fully_frozen or closed issues.';
1177 COMMENT ON COLUMN "opinion"."degree" IS '2 = fulfillment required for support; 1 = fulfillment desired; -1 = fulfillment unwanted; -2 = fulfillment cancels support';
1180 CREATE TYPE "delegation_scope" AS ENUM ('unit', 'area', 'issue');
1182 COMMENT ON TYPE "delegation_scope" IS 'Scope for delegations: ''unit'', ''area'', or ''issue'' (order is relevant)';
1185 CREATE TABLE "delegation" (
1186 "id" SERIAL8 PRIMARY KEY,
1187 "truster_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1188 "trustee_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1189 "scope" "delegation_scope" NOT NULL,
1190 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1191 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1192 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1193 CONSTRAINT "cant_delegate_to_yourself" CHECK ("truster_id" != "trustee_id"),
1194 CONSTRAINT "no_unit_delegation_to_null"
1195 CHECK ("trustee_id" NOTNULL OR "scope" != 'unit'),
1196 CONSTRAINT "area_id_and_issue_id_set_according_to_scope" CHECK (
1197 ("scope" = 'unit' AND "unit_id" NOTNULL AND "area_id" ISNULL AND "issue_id" ISNULL ) OR
1198 ("scope" = 'area' AND "unit_id" ISNULL AND "area_id" NOTNULL AND "issue_id" ISNULL ) OR
1199 ("scope" = 'issue' AND "unit_id" ISNULL AND "area_id" ISNULL AND "issue_id" NOTNULL) ),
1200 UNIQUE ("unit_id", "truster_id"),
1201 UNIQUE ("area_id", "truster_id"),
1202 UNIQUE ("issue_id", "truster_id") );
1203 CREATE INDEX "delegation_truster_id_idx" ON "delegation" ("truster_id");
1204 CREATE INDEX "delegation_trustee_id_idx" ON "delegation" ("trustee_id");
1206 COMMENT ON TABLE "delegation" IS 'Delegation of vote-weight to other members';
1208 COMMENT ON COLUMN "delegation"."unit_id" IS 'Reference to unit, if delegation is unit-wide, otherwise NULL';
1209 COMMENT ON COLUMN "delegation"."area_id" IS 'Reference to area, if delegation is area-wide, otherwise NULL';
1210 COMMENT ON COLUMN "delegation"."issue_id" IS 'Reference to issue, if delegation is issue-wide, otherwise NULL';
1213 CREATE TABLE "snapshot_issue" (
1214 PRIMARY KEY ("snapshot_id", "issue_id"),
1215 "snapshot_id" INT8 REFERENCES "snapshot" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1216 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE ); -- NOTE: trigger "delete_snapshot_on_partial_delete" will delete whole "snapshot"
1217 CREATE INDEX "snapshot_issue_issue_id_idx" ON "snapshot_issue" ("issue_id");
1219 COMMENT ON TABLE "snapshot_issue" IS 'List of issues included in a snapshot';
1221 COMMENT ON COLUMN "snapshot_issue"."issue_id" IS 'Issue being part of the snapshot; Trigger "delete_snapshot_on_partial_delete" on "snapshot_issue" table will delete snapshot if an issue of the snapshot is deleted.';
1224 CREATE TABLE "direct_interest_snapshot" (
1225 PRIMARY KEY ("snapshot_id", "issue_id", "member_id"),
1226 "snapshot_id" INT8,
1227 "issue_id" INT4,
1228 FOREIGN KEY ("snapshot_id", "issue_id")
1229 REFERENCES "snapshot_issue" ("snapshot_id", "issue_id") ON DELETE CASCADE ON UPDATE CASCADE,
1230 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1231 "weight" INT4 );
1232 CREATE INDEX "direct_interest_snapshot_member_id_idx" ON "direct_interest_snapshot" ("member_id");
1234 COMMENT ON TABLE "direct_interest_snapshot" IS 'Snapshot of active members having an "interest" in the "issue"; for corrections refer to column "issue_notice" of "issue" table';
1236 COMMENT ON COLUMN "direct_interest_snapshot"."weight" IS 'Weight of member (1 or higher) according to "delegating_interest_snapshot"';
1239 CREATE TABLE "delegating_interest_snapshot" (
1240 PRIMARY KEY ("snapshot_id", "issue_id", "member_id"),
1241 "snapshot_id" INT8,
1242 "issue_id" INT4,
1243 FOREIGN KEY ("snapshot_id", "issue_id")
1244 REFERENCES "snapshot_issue" ("snapshot_id", "issue_id") ON DELETE CASCADE ON UPDATE CASCADE,
1245 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1246 "weight" INT4,
1247 "scope" "delegation_scope" NOT NULL,
1248 "delegate_member_ids" INT4[] NOT NULL );
1249 CREATE INDEX "delegating_interest_snapshot_member_id_idx" ON "delegating_interest_snapshot" ("member_id");
1251 COMMENT ON TABLE "delegating_interest_snapshot" IS 'Delegations increasing the weight of entries in the "direct_interest_snapshot" table; for corrections refer to column "issue_notice" of "issue" table';
1253 COMMENT ON COLUMN "delegating_interest_snapshot"."member_id" IS 'Delegating member';
1254 COMMENT ON COLUMN "delegating_interest_snapshot"."weight" IS 'Intermediate weight';
1255 COMMENT ON COLUMN "delegating_interest_snapshot"."delegate_member_ids" IS 'Chain of members who act as delegates; last entry referes to "member_id" column of table "direct_interest_snapshot"';
1258 CREATE TABLE "direct_supporter_snapshot" (
1259 PRIMARY KEY ("snapshot_id", "initiative_id", "member_id"),
1260 "snapshot_id" INT8,
1261 "issue_id" INT4 NOT NULL,
1262 FOREIGN KEY ("snapshot_id", "issue_id")
1263 REFERENCES "snapshot_issue" ("snapshot_id", "issue_id") ON DELETE CASCADE ON UPDATE CASCADE,
1264 "initiative_id" INT4,
1265 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1266 "draft_id" INT8 NOT NULL,
1267 "informed" BOOLEAN NOT NULL,
1268 "satisfied" BOOLEAN NOT NULL,
1269 FOREIGN KEY ("issue_id", "initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1270 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE,
1271 FOREIGN KEY ("snapshot_id", "issue_id", "member_id") REFERENCES "direct_interest_snapshot" ("snapshot_id", "issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
1272 CREATE INDEX "direct_supporter_snapshot_member_id_idx" ON "direct_supporter_snapshot" ("member_id");
1274 COMMENT ON TABLE "direct_supporter_snapshot" IS 'Snapshot of supporters of initiatives (weight is stored in "direct_interest_snapshot"); for corrections refer to column "issue_notice" of "issue" table';
1276 COMMENT ON COLUMN "direct_supporter_snapshot"."issue_id" IS 'WARNING: No index: For selections use column "initiative_id" and join via table "initiative" where neccessary';
1277 COMMENT ON COLUMN "direct_supporter_snapshot"."informed" IS 'Supporter has seen the latest draft of the initiative';
1278 COMMENT ON COLUMN "direct_supporter_snapshot"."satisfied" IS 'Supporter has no "critical_opinion"s';
1281 CREATE TABLE "non_voter" (
1282 PRIMARY KEY ("member_id", "issue_id"),
1283 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1284 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
1285 CREATE INDEX "non_voter_issue_id_idx" ON "non_voter" ("issue_id");
1287 COMMENT ON TABLE "non_voter" IS 'Members who decided to not vote directly on an issue';
1290 CREATE TABLE "direct_voter" (
1291 PRIMARY KEY ("issue_id", "member_id"),
1292 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1293 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1294 "weight" INT4,
1295 "comment_changed" TIMESTAMPTZ,
1296 "formatting_engine" TEXT,
1297 "comment" TEXT,
1298 "text_search_data" TSVECTOR );
1299 CREATE INDEX "direct_voter_member_id_idx" ON "direct_voter" ("member_id");
1300 CREATE INDEX "direct_voter_text_search_data_idx" ON "direct_voter" USING gin ("text_search_data");
1301 CREATE TRIGGER "update_text_search_data"
1302 BEFORE INSERT OR UPDATE ON "direct_voter"
1303 FOR EACH ROW EXECUTE PROCEDURE
1304 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "comment");
1306 COMMENT ON TABLE "direct_voter" IS 'Members having directly voted for/against initiatives of an issue; frontends must ensure that no voters are added or removed to/from this table when the issue has been closed; for corrections refer to column "issue_notice" of "issue" table';
1308 COMMENT ON COLUMN "direct_voter"."weight" IS 'Weight of member (1 or higher) according to "delegating_voter" table';
1309 COMMENT ON COLUMN "direct_voter"."comment_changed" IS 'Shall be set on comment change, to indicate a comment being modified after voting has been finished; Automatically set to NULL after voting phase; Automatically set to NULL by trigger, if "comment" is set to NULL';
1310 COMMENT ON COLUMN "direct_voter"."formatting_engine" IS 'Allows different formatting engines (i.e. wiki formats) to be used for "direct_voter"."comment"; Automatically set to NULL by trigger, if "comment" is set to NULL';
1311 COMMENT ON COLUMN "direct_voter"."comment" IS 'Is to be set or updated by the frontend, if comment was inserted or updated AFTER the issue has been closed. Otherwise it shall be set to NULL.';
1314 CREATE TABLE "rendered_voter_comment" (
1315 PRIMARY KEY ("issue_id", "member_id", "format"),
1316 FOREIGN KEY ("issue_id", "member_id")
1317 REFERENCES "direct_voter" ("issue_id", "member_id")
1318 ON DELETE CASCADE ON UPDATE CASCADE,
1319 "issue_id" INT4,
1320 "member_id" INT4,
1321 "format" TEXT,
1322 "content" TEXT NOT NULL );
1324 COMMENT ON TABLE "rendered_voter_comment" IS 'This table may be used by frontends to cache "rendered" voter comments (e.g. HTML output generated from wiki text)';
1327 CREATE TABLE "delegating_voter" (
1328 PRIMARY KEY ("issue_id", "member_id"),
1329 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1330 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1331 "weight" INT4,
1332 "scope" "delegation_scope" NOT NULL,
1333 "delegate_member_ids" INT4[] NOT NULL );
1334 CREATE INDEX "delegating_voter_member_id_idx" ON "delegating_voter" ("member_id");
1336 COMMENT ON TABLE "delegating_voter" IS 'Delegations increasing the weight of entries in the "direct_voter" table; for corrections refer to column "issue_notice" of "issue" table';
1338 COMMENT ON COLUMN "delegating_voter"."member_id" IS 'Delegating member';
1339 COMMENT ON COLUMN "delegating_voter"."weight" IS 'Intermediate weight';
1340 COMMENT ON COLUMN "delegating_voter"."delegate_member_ids" IS 'Chain of members who act as delegates; last entry referes to "member_id" column of table "direct_voter"';
1343 CREATE TABLE "vote" (
1344 "issue_id" INT4 NOT NULL,
1345 PRIMARY KEY ("initiative_id", "member_id"),
1346 "initiative_id" INT4,
1347 "member_id" INT4,
1348 "grade" INT4 NOT NULL,
1349 "first_preference" BOOLEAN,
1350 FOREIGN KEY ("issue_id", "initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1351 FOREIGN KEY ("issue_id", "member_id") REFERENCES "direct_voter" ("issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE,
1352 CONSTRAINT "first_preference_flag_only_set_on_positive_grades"
1353 CHECK ("grade" > 0 OR "first_preference" ISNULL) );
1354 CREATE INDEX "vote_member_id_idx" ON "vote" ("member_id");
1356 COMMENT ON TABLE "vote" IS 'Manual and delegated votes without abstentions; frontends must ensure that no votes are added modified or removed when the issue has been closed; for corrections refer to column "issue_notice" of "issue" table';
1358 COMMENT ON COLUMN "vote"."issue_id" IS 'WARNING: No index: For selections use column "initiative_id" and join via table "initiative" where neccessary';
1359 COMMENT ON COLUMN "vote"."grade" IS 'Values smaller than zero mean reject, values greater than zero mean acceptance, zero or missing row means abstention. Preferences are expressed by different positive or negative numbers.';
1360 COMMENT ON COLUMN "vote"."first_preference" IS 'Value is automatically set after voting is finished. For positive grades, this value is set to true for the highest (i.e. best) grade.';
1363 CREATE TYPE "event_type" AS ENUM (
1364 'unit_created',
1365 'unit_updated',
1366 'area_created',
1367 'area_updated',
1368 'policy_created',
1369 'policy_updated',
1370 'issue_state_changed',
1371 'initiative_created_in_new_issue',
1372 'initiative_created_in_existing_issue',
1373 'initiative_revoked',
1374 'new_draft_created',
1375 'suggestion_created',
1376 'suggestion_deleted',
1377 'member_activated',
1378 'member_deleted',
1379 'member_active',
1380 'member_name_updated',
1381 'member_profile_updated',
1382 'member_image_updated',
1383 'interest',
1384 'initiator',
1385 'support',
1386 'support_updated',
1387 'suggestion_rated',
1388 'delegation',
1389 'contact' );
1391 COMMENT ON TYPE "event_type" IS 'Type used for column "event" of table "event"';
1394 CREATE TABLE "event" (
1395 "id" SERIAL8 PRIMARY KEY,
1396 "occurrence" TIMESTAMPTZ NOT NULL DEFAULT now(),
1397 "event" "event_type" NOT NULL,
1398 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1399 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1400 "scope" "delegation_scope",
1401 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1402 "area_id" INT4,
1403 FOREIGN KEY ("unit_id", "area_id") REFERENCES "area" ("unit_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1404 "policy_id" INT4 REFERENCES "policy" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1405 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1406 FOREIGN KEY ("area_id", "issue_id") REFERENCES "issue" ("area_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1407 FOREIGN KEY ("policy_id", "issue_id") REFERENCES "issue" ("policy_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1408 "state" "issue_state",
1409 "initiative_id" INT4,
1410 "draft_id" INT8,
1411 "suggestion_id" INT8,
1412 "boolean_value" BOOLEAN,
1413 "numeric_value" INT4,
1414 "text_value" TEXT,
1415 "old_text_value" TEXT,
1416 FOREIGN KEY ("issue_id", "initiative_id")
1417 REFERENCES "initiative" ("issue_id", "id")
1418 ON DELETE CASCADE ON UPDATE CASCADE,
1419 FOREIGN KEY ("initiative_id", "draft_id")
1420 REFERENCES "draft" ("initiative_id", "id")
1421 ON DELETE CASCADE ON UPDATE CASCADE,
1422 -- NOTE: no referential integrity for suggestions because those are
1423 -- actually deleted
1424 -- FOREIGN KEY ("initiative_id", "suggestion_id")
1425 -- REFERENCES "suggestion" ("initiative_id", "id")
1426 -- ON DELETE CASCADE ON UPDATE CASCADE,
1427 CONSTRAINT "constr_for_issue_state_changed" CHECK (
1428 "event" != 'issue_state_changed' OR (
1429 "member_id" ISNULL AND
1430 "other_member_id" ISNULL AND
1431 "scope" ISNULL AND
1432 "unit_id" NOTNULL AND
1433 "area_id" NOTNULL AND
1434 "policy_id" NOTNULL AND
1435 "issue_id" NOTNULL AND
1436 "state" NOTNULL AND
1437 "initiative_id" ISNULL AND
1438 "draft_id" ISNULL AND
1439 "suggestion_id" ISNULL AND
1440 "boolean_value" ISNULL AND
1441 "numeric_value" ISNULL AND
1442 "text_value" ISNULL AND
1443 "old_text_value" ISNULL )),
1444 CONSTRAINT "constr_for_initiative_creation_or_revocation_or_new_draft" CHECK (
1445 "event" NOT IN (
1446 'initiative_created_in_new_issue',
1447 'initiative_created_in_existing_issue',
1448 'initiative_revoked',
1449 'new_draft_created'
1450 ) OR (
1451 "member_id" NOTNULL AND
1452 "other_member_id" ISNULL AND
1453 "scope" ISNULL AND
1454 "unit_id" NOTNULL AND
1455 "area_id" NOTNULL AND
1456 "policy_id" NOTNULL AND
1457 "issue_id" NOTNULL AND
1458 "state" NOTNULL AND
1459 "initiative_id" NOTNULL AND
1460 "draft_id" NOTNULL AND
1461 "suggestion_id" ISNULL AND
1462 "boolean_value" ISNULL AND
1463 "numeric_value" ISNULL AND
1464 "text_value" ISNULL AND
1465 "old_text_value" ISNULL )),
1466 CONSTRAINT "constr_for_suggestion_creation" CHECK (
1467 "event" != 'suggestion_created' OR (
1468 "member_id" NOTNULL AND
1469 "other_member_id" ISNULL AND
1470 "scope" ISNULL AND
1471 "unit_id" NOTNULL AND
1472 "area_id" NOTNULL AND
1473 "policy_id" NOTNULL AND
1474 "issue_id" NOTNULL AND
1475 "state" NOTNULL AND
1476 "initiative_id" NOTNULL AND
1477 "draft_id" ISNULL AND
1478 "suggestion_id" NOTNULL AND
1479 "boolean_value" ISNULL AND
1480 "numeric_value" ISNULL AND
1481 "text_value" ISNULL AND
1482 "old_text_value" ISNULL )),
1483 CONSTRAINT "constr_for_suggestion_removal" CHECK (
1484 "event" != 'suggestion_deleted' OR (
1485 "member_id" ISNULL AND
1486 "other_member_id" ISNULL AND
1487 "scope" ISNULL AND
1488 "unit_id" NOTNULL AND
1489 "area_id" NOTNULL AND
1490 "policy_id" NOTNULL AND
1491 "issue_id" NOTNULL AND
1492 "state" NOTNULL AND
1493 "initiative_id" NOTNULL AND
1494 "draft_id" ISNULL AND
1495 "suggestion_id" NOTNULL AND
1496 "boolean_value" ISNULL AND
1497 "numeric_value" ISNULL AND
1498 "text_value" ISNULL AND
1499 "old_text_value" ISNULL )),
1500 CONSTRAINT "constr_for_value_less_member_event" CHECK (
1501 "event" NOT IN (
1502 'member_activated',
1503 'member_deleted',
1504 'member_profile_updated',
1505 'member_image_updated'
1506 ) OR (
1507 "member_id" NOTNULL AND
1508 "other_member_id" ISNULL AND
1509 "scope" ISNULL AND
1510 "unit_id" ISNULL AND
1511 "area_id" ISNULL AND
1512 "policy_id" ISNULL AND
1513 "issue_id" ISNULL AND
1514 "state" ISNULL AND
1515 "initiative_id" ISNULL AND
1516 "draft_id" ISNULL AND
1517 "suggestion_id" ISNULL AND
1518 "boolean_value" ISNULL AND
1519 "numeric_value" ISNULL AND
1520 "text_value" ISNULL AND
1521 "old_text_value" ISNULL )),
1522 CONSTRAINT "constr_for_member_active" CHECK (
1523 "event" != 'member_active' OR (
1524 "member_id" NOTNULL AND
1525 "other_member_id" ISNULL AND
1526 "scope" ISNULL AND
1527 "unit_id" ISNULL AND
1528 "area_id" ISNULL AND
1529 "policy_id" ISNULL AND
1530 "issue_id" ISNULL AND
1531 "state" ISNULL AND
1532 "initiative_id" ISNULL AND
1533 "draft_id" ISNULL AND
1534 "suggestion_id" ISNULL AND
1535 "boolean_value" NOTNULL AND
1536 "numeric_value" ISNULL AND
1537 "text_value" ISNULL AND
1538 "old_text_value" ISNULL )),
1539 CONSTRAINT "constr_for_member_name_updated" CHECK (
1540 "event" != 'member_name_updated' OR (
1541 "member_id" NOTNULL AND
1542 "other_member_id" ISNULL AND
1543 "scope" ISNULL AND
1544 "unit_id" ISNULL AND
1545 "area_id" ISNULL AND
1546 "policy_id" ISNULL AND
1547 "issue_id" ISNULL AND
1548 "state" ISNULL AND
1549 "initiative_id" ISNULL AND
1550 "draft_id" ISNULL AND
1551 "suggestion_id" ISNULL AND
1552 "boolean_value" ISNULL AND
1553 "numeric_value" ISNULL AND
1554 "text_value" NOTNULL AND
1555 "old_text_value" NOTNULL )),
1556 CONSTRAINT "constr_for_interest" CHECK (
1557 "event" != 'interest' OR (
1558 "member_id" NOTNULL AND
1559 "other_member_id" ISNULL AND
1560 "scope" ISNULL AND
1561 "unit_id" NOTNULL AND
1562 "area_id" NOTNULL AND
1563 "policy_id" NOTNULL AND
1564 "issue_id" NOTNULL AND
1565 "state" NOTNULL AND
1566 "initiative_id" ISNULL AND
1567 "draft_id" ISNULL AND
1568 "suggestion_id" ISNULL AND
1569 "boolean_value" NOTNULL AND
1570 "numeric_value" ISNULL AND
1571 "text_value" ISNULL AND
1572 "old_text_value" ISNULL )),
1573 CONSTRAINT "constr_for_initiator" CHECK (
1574 "event" != 'initiator' OR (
1575 "member_id" NOTNULL AND
1576 "other_member_id" ISNULL AND
1577 "scope" ISNULL AND
1578 "unit_id" NOTNULL AND
1579 "area_id" NOTNULL AND
1580 "policy_id" NOTNULL AND
1581 "issue_id" NOTNULL AND
1582 "state" NOTNULL AND
1583 "initiative_id" NOTNULL AND
1584 "draft_id" ISNULL AND
1585 "suggestion_id" ISNULL AND
1586 "boolean_value" NOTNULL AND
1587 "numeric_value" ISNULL AND
1588 "text_value" ISNULL AND
1589 "old_text_value" ISNULL )),
1590 CONSTRAINT "constr_for_support" CHECK (
1591 "event" != 'support' OR (
1592 "member_id" NOTNULL AND
1593 "other_member_id" ISNULL AND
1594 "scope" ISNULL AND
1595 "unit_id" NOTNULL AND
1596 "area_id" NOTNULL AND
1597 "policy_id" NOTNULL AND
1598 "issue_id" NOTNULL AND
1599 "state" NOTNULL AND
1600 "initiative_id" NOTNULL AND
1601 ("draft_id" NOTNULL) = ("boolean_value" = TRUE) AND
1602 "suggestion_id" ISNULL AND
1603 "boolean_value" NOTNULL AND
1604 "numeric_value" ISNULL AND
1605 "text_value" ISNULL AND
1606 "old_text_value" ISNULL )),
1607 CONSTRAINT "constr_for_support_updated" CHECK (
1608 "event" != 'support_updated' OR (
1609 "member_id" NOTNULL AND
1610 "other_member_id" ISNULL AND
1611 "scope" ISNULL AND
1612 "unit_id" NOTNULL AND
1613 "area_id" NOTNULL AND
1614 "policy_id" NOTNULL AND
1615 "issue_id" NOTNULL AND
1616 "state" NOTNULL AND
1617 "initiative_id" NOTNULL AND
1618 "draft_id" NOTNULL AND
1619 "suggestion_id" ISNULL AND
1620 "boolean_value" ISNULL AND
1621 "numeric_value" ISNULL AND
1622 "text_value" ISNULL AND
1623 "old_text_value" ISNULL )),
1624 CONSTRAINT "constr_for_suggestion_rated" CHECK (
1625 "event" != 'suggestion_rated' OR (
1626 "member_id" NOTNULL AND
1627 "other_member_id" ISNULL AND
1628 "scope" ISNULL AND
1629 "unit_id" NOTNULL AND
1630 "area_id" NOTNULL AND
1631 "policy_id" NOTNULL AND
1632 "issue_id" NOTNULL AND
1633 "state" NOTNULL AND
1634 "initiative_id" NOTNULL AND
1635 "draft_id" ISNULL AND
1636 "suggestion_id" NOTNULL AND
1637 ("boolean_value" NOTNULL) = ("numeric_value" != 0) AND
1638 "numeric_value" NOTNULL AND
1639 "numeric_value" IN (-2, -1, 0, 1, 2) AND
1640 "text_value" ISNULL AND
1641 "old_text_value" ISNULL )),
1642 CONSTRAINT "constr_for_delegation" CHECK (
1643 "event" != 'delegation' OR (
1644 "member_id" NOTNULL AND
1645 (("other_member_id" ISNULL) OR ("boolean_value" = TRUE)) AND
1646 "scope" NOTNULL AND
1647 "unit_id" NOTNULL AND
1648 ("area_id" NOTNULL) = ("scope" != 'unit'::"delegation_scope") AND
1649 "policy_id" ISNULL AND
1650 ("issue_id" NOTNULL) = ("scope" = 'issue'::"delegation_scope") AND
1651 ("state" NOTNULL) = ("scope" = 'issue'::"delegation_scope") AND
1652 "initiative_id" ISNULL AND
1653 "draft_id" ISNULL AND
1654 "suggestion_id" ISNULL AND
1655 "boolean_value" NOTNULL AND
1656 "numeric_value" ISNULL AND
1657 "text_value" ISNULL AND
1658 "old_text_value" ISNULL )),
1659 CONSTRAINT "constr_for_contact" CHECK (
1660 "event" != 'contact' OR (
1661 "member_id" NOTNULL AND
1662 "other_member_id" NOTNULL AND
1663 "scope" ISNULL AND
1664 "unit_id" ISNULL AND
1665 "area_id" ISNULL AND
1666 "policy_id" ISNULL AND
1667 "issue_id" ISNULL AND
1668 "state" ISNULL AND
1669 "initiative_id" ISNULL AND
1670 "draft_id" ISNULL AND
1671 "suggestion_id" ISNULL AND
1672 "boolean_value" NOTNULL AND
1673 "numeric_value" ISNULL AND
1674 "text_value" ISNULL AND
1675 "old_text_value" ISNULL )) );
1676 CREATE INDEX "event_occurrence_idx" ON "event" ("occurrence");
1678 COMMENT ON TABLE "event" IS 'Event table, automatically filled by triggers';
1680 COMMENT ON COLUMN "event"."occurrence" IS 'Point in time, when event occurred';
1681 COMMENT ON COLUMN "event"."event" IS 'Type of event (see TYPE "event_type")';
1682 COMMENT ON COLUMN "event"."member_id" IS 'Member who caused the event, if applicable';
1683 COMMENT ON COLUMN "event"."state" IS 'If issue_id is set: state of affected issue; If state changed: new state';
1686 CREATE TABLE "event_processed" (
1687 "event_id" INT8 NOT NULL );
1688 CREATE UNIQUE INDEX "event_processed_singleton_idx" ON "event_processed" ((1));
1690 COMMENT ON TABLE "event_processed" IS 'This table stores one row with the last event_id, for which event handlers have been executed (e.g. notifications having been sent out)';
1691 COMMENT ON INDEX "event_processed_singleton_idx" IS 'This index ensures that "event_processed" only contains one row maximum.';
1694 CREATE TABLE "notification_initiative_sent" (
1695 PRIMARY KEY ("member_id", "initiative_id"),
1696 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1697 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1698 "last_draft_id" INT8 NOT NULL,
1699 "last_suggestion_id" INT8 );
1700 CREATE INDEX "notification_initiative_sent_initiative_idx" ON "notification_initiative_sent" ("initiative_id");
1702 COMMENT ON TABLE "notification_initiative_sent" IS 'Information which initiatives have been promoted to a member in a scheduled notification mail';
1704 COMMENT ON COLUMN "notification_initiative_sent"."last_draft_id" IS 'Current (i.e. last) draft_id when initiative had been promoted';
1705 COMMENT ON COLUMN "notification_initiative_sent"."last_suggestion_id" IS 'Current (i.e. last) draft_id when initiative had been promoted';
1708 CREATE TABLE "newsletter" (
1709 "id" SERIAL4 PRIMARY KEY,
1710 "published" TIMESTAMPTZ NOT NULL,
1711 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1712 "include_all_members" BOOLEAN NOT NULL,
1713 "sent" TIMESTAMPTZ,
1714 "subject" TEXT NOT NULL,
1715 "content" TEXT NOT NULL );
1716 CREATE INDEX "newsletter_unit_id_idx" ON "newsletter" ("unit_id", "published");
1717 CREATE INDEX "newsletter_all_units_published_idx" ON "newsletter" ("published") WHERE "unit_id" ISNULL;
1718 CREATE INDEX "newsletter_published_idx" ON "newsletter" ("published");
1720 COMMENT ON TABLE "newsletter" IS 'Contains newsletters created by administrators to be sent out and for further reference';
1722 COMMENT ON COLUMN "newsletter"."published" IS 'Timestamp when the newsletter is to be sent out (and made available in the frontend)';
1723 COMMENT ON COLUMN "newsletter"."unit_id" IS 'If set, only members with voting right in the given unit are considered to be recipients';
1724 COMMENT ON COLUMN "newsletter"."include_all_members" IS 'TRUE = include all members regardless of their ''disable_notifications'' setting';
1725 COMMENT ON COLUMN "newsletter"."sent" IS 'Timestamp when the newsletter has been mailed out';
1726 COMMENT ON COLUMN "newsletter"."subject" IS 'Subject line (e.g. to be used for the email)';
1727 COMMENT ON COLUMN "newsletter"."content" IS 'Plain text content of the newsletter';
1731 ----------------------------------------------
1732 -- Writing of history entries and event log --
1733 ----------------------------------------------
1736 CREATE FUNCTION "write_member_history_trigger"()
1737 RETURNS TRIGGER
1738 LANGUAGE 'plpgsql' VOLATILE AS $$
1739 BEGIN
1740 IF
1741 ( NEW."active" != OLD."active" OR
1742 NEW."name" != OLD."name" ) AND
1743 OLD."activated" NOTNULL
1744 THEN
1745 INSERT INTO "member_history"
1746 ("member_id", "active", "name")
1747 VALUES (NEW."id", OLD."active", OLD."name");
1748 END IF;
1749 RETURN NULL;
1750 END;
1751 $$;
1753 CREATE TRIGGER "write_member_history"
1754 AFTER UPDATE ON "member" FOR EACH ROW EXECUTE PROCEDURE
1755 "write_member_history_trigger"();
1757 COMMENT ON FUNCTION "write_member_history_trigger"() IS 'Implementation of trigger "write_member_history" on table "member"';
1758 COMMENT ON TRIGGER "write_member_history" ON "member" IS 'When changing certain fields of a member, create a history entry in "member_history" table';
1761 CREATE FUNCTION "write_event_unit_trigger"()
1762 RETURNS TRIGGER
1763 LANGUAGE 'plpgsql' VOLATILE AS $$
1764 DECLARE
1765 "event_v" "event_type";
1766 BEGIN
1767 IF TG_OP = 'UPDATE' THEN
1768 IF OLD."active" = FALSE AND NEW."active" = FALSE THEN
1769 RETURN NULL;
1770 --ELSIF OLD."active" = FALSE AND NEW."active" = TRUE THEN
1771 -- "event_v" := 'unit_created';
1772 --ELSIF OLD."active" = TRUE AND NEW."active" = FALSE THEN
1773 -- "event_v" := 'unit_deleted';
1774 ELSIF OLD != NEW THEN
1775 "event_v" := 'unit_updated';
1776 ELSE
1777 RETURN NULL;
1778 END IF;
1779 ELSE
1780 "event_v" := 'unit_created';
1781 END IF;
1782 INSERT INTO "event" ("event", "unit_id") VALUES ("event_v", NEW."id");
1783 RETURN NULL;
1784 END;
1785 $$;
1787 CREATE TRIGGER "write_event_unit" AFTER INSERT OR UPDATE ON "unit"
1788 FOR EACH ROW EXECUTE PROCEDURE "write_event_unit_trigger"();
1790 COMMENT ON FUNCTION "write_event_unit_trigger"() IS 'Implementation of trigger "write_event_unit" on table "unit"';
1791 COMMENT ON TRIGGER "write_event_unit" ON "unit" IS 'Create entry in "event" table on new or changed/disabled units';
1794 CREATE FUNCTION "write_event_area_trigger"()
1795 RETURNS TRIGGER
1796 LANGUAGE 'plpgsql' VOLATILE AS $$
1797 DECLARE
1798 "event_v" "event_type";
1799 BEGIN
1800 IF TG_OP = 'UPDATE' THEN
1801 IF OLD."active" = FALSE AND NEW."active" = FALSE THEN
1802 RETURN NULL;
1803 --ELSIF OLD."active" = FALSE AND NEW."active" = TRUE THEN
1804 -- "event_v" := 'area_created';
1805 --ELSIF OLD."active" = TRUE AND NEW."active" = FALSE THEN
1806 -- "event_v" := 'area_deleted';
1807 ELSIF OLD != NEW THEN
1808 "event_v" := 'area_updated';
1809 ELSE
1810 RETURN NULL;
1811 END IF;
1812 ELSE
1813 "event_v" := 'area_created';
1814 END IF;
1815 INSERT INTO "event" ("event", "area_id") VALUES ("event_v", NEW."id");
1816 RETURN NULL;
1817 END;
1818 $$;
1820 CREATE TRIGGER "write_event_area" AFTER INSERT OR UPDATE ON "area"
1821 FOR EACH ROW EXECUTE PROCEDURE "write_event_area_trigger"();
1823 COMMENT ON FUNCTION "write_event_area_trigger"() IS 'Implementation of trigger "write_event_area" on table "area"';
1824 COMMENT ON TRIGGER "write_event_area" ON "area" IS 'Create entry in "event" table on new or changed/disabled areas';
1827 CREATE FUNCTION "write_event_policy_trigger"()
1828 RETURNS TRIGGER
1829 LANGUAGE 'plpgsql' VOLATILE AS $$
1830 DECLARE
1831 "event_v" "event_type";
1832 BEGIN
1833 IF TG_OP = 'UPDATE' THEN
1834 IF OLD."active" = FALSE AND NEW."active" = FALSE THEN
1835 RETURN NULL;
1836 --ELSIF OLD."active" = FALSE AND NEW."active" = TRUE THEN
1837 -- "event_v" := 'policy_created';
1838 --ELSIF OLD."active" = TRUE AND NEW."active" = FALSE THEN
1839 -- "event_v" := 'policy_deleted';
1840 ELSIF OLD != NEW THEN
1841 "event_v" := 'policy_updated';
1842 ELSE
1843 RETURN NULL;
1844 END IF;
1845 ELSE
1846 "event_v" := 'policy_created';
1847 END IF;
1848 INSERT INTO "event" ("event", "policy_id") VALUES ("event_v", NEW."id");
1849 RETURN NULL;
1850 END;
1851 $$;
1853 CREATE TRIGGER "write_event_policy" AFTER INSERT OR UPDATE ON "policy"
1854 FOR EACH ROW EXECUTE PROCEDURE "write_event_policy_trigger"();
1856 COMMENT ON FUNCTION "write_event_policy_trigger"() IS 'Implementation of trigger "write_event_policy" on table "policy"';
1857 COMMENT ON TRIGGER "write_event_policy" ON "policy" IS 'Create entry in "event" table on new or changed/disabled policies';
1860 CREATE FUNCTION "write_event_issue_state_changed_trigger"()
1861 RETURNS TRIGGER
1862 LANGUAGE 'plpgsql' VOLATILE AS $$
1863 DECLARE
1864 "area_row" "area"%ROWTYPE;
1865 BEGIN
1866 IF NEW."state" != OLD."state" THEN
1867 SELECT * INTO "area_row" FROM "area" WHERE "id" = NEW."area_id"
1868 FOR SHARE;
1869 INSERT INTO "event" (
1870 "event",
1871 "unit_id", "area_id", "policy_id", "issue_id", "state"
1872 ) VALUES (
1873 'issue_state_changed',
1874 "area_row"."unit_id", NEW."area_id", NEW."policy_id",
1875 NEW."id", NEW."state"
1876 );
1877 END IF;
1878 RETURN NULL;
1879 END;
1880 $$;
1882 CREATE TRIGGER "write_event_issue_state_changed"
1883 AFTER UPDATE ON "issue" FOR EACH ROW EXECUTE PROCEDURE
1884 "write_event_issue_state_changed_trigger"();
1886 COMMENT ON FUNCTION "write_event_issue_state_changed_trigger"() IS 'Implementation of trigger "write_event_issue_state_changed" on table "issue"';
1887 COMMENT ON TRIGGER "write_event_issue_state_changed" ON "issue" IS 'Create entry in "event" table on "state" change';
1890 CREATE FUNCTION "write_event_initiative_or_draft_created_trigger"()
1891 RETURNS TRIGGER
1892 LANGUAGE 'plpgsql' VOLATILE AS $$
1893 DECLARE
1894 "initiative_row" "initiative"%ROWTYPE;
1895 "issue_row" "issue"%ROWTYPE;
1896 "area_row" "area"%ROWTYPE;
1897 "event_v" "event_type";
1898 BEGIN
1899 SELECT * INTO "initiative_row" FROM "initiative"
1900 WHERE "id" = NEW."initiative_id" FOR SHARE;
1901 SELECT * INTO "issue_row" FROM "issue"
1902 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
1903 SELECT * INTO "area_row" FROM "area"
1904 WHERE "id" = "issue_row"."area_id" FOR SHARE;
1905 IF EXISTS (
1906 SELECT NULL FROM "draft"
1907 WHERE "initiative_id" = NEW."initiative_id" AND "id" != NEW."id"
1908 FOR SHARE
1909 ) THEN
1910 "event_v" := 'new_draft_created';
1911 ELSE
1912 IF EXISTS (
1913 SELECT NULL FROM "initiative"
1914 WHERE "issue_id" = "initiative_row"."issue_id"
1915 AND "id" != "initiative_row"."id"
1916 FOR SHARE
1917 ) THEN
1918 "event_v" := 'initiative_created_in_existing_issue';
1919 ELSE
1920 "event_v" := 'initiative_created_in_new_issue';
1921 END IF;
1922 END IF;
1923 INSERT INTO "event" (
1924 "event", "member_id",
1925 "unit_id", "area_id", "policy_id", "issue_id", "state",
1926 "initiative_id", "draft_id"
1927 ) VALUES (
1928 "event_v", NEW."author_id",
1929 "area_row"."unit_id", "issue_row"."area_id", "issue_row"."policy_id",
1930 "initiative_row"."issue_id", "issue_row"."state",
1931 NEW."initiative_id", NEW."id"
1932 );
1933 RETURN NULL;
1934 END;
1935 $$;
1937 CREATE TRIGGER "write_event_initiative_or_draft_created"
1938 AFTER INSERT ON "draft" FOR EACH ROW EXECUTE PROCEDURE
1939 "write_event_initiative_or_draft_created_trigger"();
1941 COMMENT ON FUNCTION "write_event_initiative_or_draft_created_trigger"() IS 'Implementation of trigger "write_event_initiative_or_draft_created" on table "issue"';
1942 COMMENT ON TRIGGER "write_event_initiative_or_draft_created" ON "draft" IS 'Create entry in "event" table on draft creation';
1945 CREATE FUNCTION "write_event_initiative_revoked_trigger"()
1946 RETURNS TRIGGER
1947 LANGUAGE 'plpgsql' VOLATILE AS $$
1948 DECLARE
1949 "issue_row" "issue"%ROWTYPE;
1950 "area_row" "area"%ROWTYPE;
1951 "draft_id_v" "draft"."id"%TYPE;
1952 BEGIN
1953 IF OLD."revoked" ISNULL AND NEW."revoked" NOTNULL THEN
1954 -- NOTE: lock for primary key update to avoid new drafts
1955 SELECT NULL FROM "initiative" WHERE "id" = NEW."id" FOR UPDATE;
1956 SELECT * INTO "issue_row" FROM "issue"
1957 WHERE "id" = NEW."issue_id" FOR SHARE;
1958 SELECT * INTO "area_row" FROM "area"
1959 WHERE "id" = "issue_row"."area_id" FOR SHARE;
1960 -- NOTE: FOR SHARE cannot be used with DISTINCT in view "current_draft"
1961 SELECT NULL FROM "draft" WHERE "initiative_id" = NEW."id" FOR SHARE;
1962 SELECT "id" INTO "draft_id_v" FROM "current_draft"
1963 WHERE "initiative_id" = NEW."id";
1964 INSERT INTO "event" (
1965 "event", "member_id",
1966 "unit_id", "area_id", "policy_id", "issue_id", "state",
1967 "initiative_id", "draft_id"
1968 ) VALUES (
1969 'initiative_revoked', NEW."revoked_by_member_id",
1970 "area_row"."unit_id", "issue_row"."area_id",
1971 "issue_row"."policy_id",
1972 NEW."issue_id", "issue_row"."state",
1973 NEW."id", "draft_id_v"
1974 );
1975 END IF;
1976 RETURN NULL;
1977 END;
1978 $$;
1980 CREATE TRIGGER "write_event_initiative_revoked"
1981 AFTER UPDATE ON "initiative" FOR EACH ROW EXECUTE PROCEDURE
1982 "write_event_initiative_revoked_trigger"();
1984 COMMENT ON FUNCTION "write_event_initiative_revoked_trigger"() IS 'Implementation of trigger "write_event_initiative_revoked" on table "issue"';
1985 COMMENT ON TRIGGER "write_event_initiative_revoked" ON "initiative" IS 'Create entry in "event" table, when an initiative is revoked';
1988 CREATE FUNCTION "write_event_suggestion_created_trigger"()
1989 RETURNS TRIGGER
1990 LANGUAGE 'plpgsql' VOLATILE AS $$
1991 DECLARE
1992 "initiative_row" "initiative"%ROWTYPE;
1993 "issue_row" "issue"%ROWTYPE;
1994 "area_row" "area"%ROWTYPE;
1995 BEGIN
1996 SELECT * INTO "initiative_row" FROM "initiative"
1997 WHERE "id" = NEW."initiative_id" FOR SHARE;
1998 SELECT * INTO "issue_row" FROM "issue"
1999 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2000 SELECT * INTO "area_row" FROM "area"
2001 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2002 INSERT INTO "event" (
2003 "event", "member_id",
2004 "unit_id", "area_id", "policy_id", "issue_id", "state",
2005 "initiative_id", "suggestion_id"
2006 ) VALUES (
2007 'suggestion_created', NEW."author_id",
2008 "area_row"."unit_id", "issue_row"."area_id", "issue_row"."policy_id",
2009 "initiative_row"."issue_id", "issue_row"."state",
2010 NEW."initiative_id", NEW."id"
2011 );
2012 RETURN NULL;
2013 END;
2014 $$;
2016 CREATE TRIGGER "write_event_suggestion_created"
2017 AFTER INSERT ON "suggestion" FOR EACH ROW EXECUTE PROCEDURE
2018 "write_event_suggestion_created_trigger"();
2020 COMMENT ON FUNCTION "write_event_suggestion_created_trigger"() IS 'Implementation of trigger "write_event_suggestion_created" on table "issue"';
2021 COMMENT ON TRIGGER "write_event_suggestion_created" ON "suggestion" IS 'Create entry in "event" table on suggestion creation';
2024 CREATE FUNCTION "write_event_suggestion_removed_trigger"()
2025 RETURNS TRIGGER
2026 LANGUAGE 'plpgsql' VOLATILE AS $$
2027 DECLARE
2028 "initiative_row" "initiative"%ROWTYPE;
2029 "issue_row" "issue"%ROWTYPE;
2030 "area_row" "area"%ROWTYPE;
2031 BEGIN
2032 SELECT * INTO "initiative_row" FROM "initiative"
2033 WHERE "id" = OLD."initiative_id" FOR SHARE;
2034 IF "initiative_row"."id" NOTNULL THEN
2035 SELECT * INTO "issue_row" FROM "issue"
2036 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2037 SELECT * INTO "area_row" FROM "area"
2038 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2039 INSERT INTO "event" (
2040 "event",
2041 "unit_id", "area_id", "policy_id", "issue_id", "state",
2042 "initiative_id", "suggestion_id"
2043 ) VALUES (
2044 'suggestion_deleted',
2045 "area_row"."unit_id", "issue_row"."area_id",
2046 "issue_row"."policy_id",
2047 "initiative_row"."issue_id", "issue_row"."state",
2048 OLD."initiative_id", OLD."id"
2049 );
2050 END IF;
2051 RETURN NULL;
2052 END;
2053 $$;
2055 CREATE TRIGGER "write_event_suggestion_removed"
2056 AFTER DELETE ON "suggestion" FOR EACH ROW EXECUTE PROCEDURE
2057 "write_event_suggestion_removed_trigger"();
2059 COMMENT ON FUNCTION "write_event_suggestion_removed_trigger"() IS 'Implementation of trigger "write_event_suggestion_removed" on table "issue"';
2060 COMMENT ON TRIGGER "write_event_suggestion_removed" ON "suggestion" IS 'Create entry in "event" table on suggestion creation';
2063 CREATE FUNCTION "write_event_member_trigger"()
2064 RETURNS TRIGGER
2065 LANGUAGE 'plpgsql' VOLATILE AS $$
2066 BEGIN
2067 IF TG_OP = 'INSERT' THEN
2068 IF NEW."activated" NOTNULL AND NEW."deleted" ISNULL THEN
2069 INSERT INTO "event" ("event", "member_id")
2070 VALUES ('member_activated', NEW."id");
2071 END IF;
2072 IF NEW."active" THEN
2073 INSERT INTO "event" ("event", "member_id", "boolean_value")
2074 VALUES ('member_active', NEW."id", TRUE);
2075 END IF;
2076 ELSIF TG_OP = 'UPDATE' THEN
2077 IF OLD."id" != NEW."id" THEN
2078 RAISE EXCEPTION 'Cannot change member ID';
2079 END IF;
2080 IF
2081 (OLD."activated" ISNULL OR OLD."deleted" NOTNULL) AND
2082 NEW."activated" NOTNULL AND NEW."deleted" ISNULL
2083 THEN
2084 INSERT INTO "event" ("event", "member_id")
2085 VALUES ('member_activated', NEW."id");
2086 END IF;
2087 IF OLD."active" != NEW."active" THEN
2088 INSERT INTO "event" ("event", "member_id", "boolean_value") VALUES (
2089 'member_active', NEW."id", NEW."active"
2090 );
2091 END IF;
2092 IF OLD."name" != NEW."name" THEN
2093 INSERT INTO "event" (
2094 "event", "member_id", "text_value", "old_text_value"
2095 ) VALUES (
2096 'member_name_updated', NEW."id", NEW."name", OLD."name"
2097 );
2098 END IF;
2099 IF
2100 OLD."activated" NOTNULL AND OLD."deleted" ISNULL AND
2101 (NEW."activated" ISNULL OR NEW."deleted" NOTNULL)
2102 THEN
2103 INSERT INTO "event" ("event", "member_id")
2104 VALUES ('member_deleted', NEW."id");
2105 END IF;
2106 END IF;
2107 RETURN NULL;
2108 END;
2109 $$;
2111 CREATE TRIGGER "write_event_member"
2112 AFTER INSERT OR UPDATE ON "member" FOR EACH ROW EXECUTE PROCEDURE
2113 "write_event_member_trigger"();
2115 COMMENT ON FUNCTION "write_event_member_trigger"() IS 'Implementation of trigger "write_event_member" on table "member"';
2116 COMMENT ON TRIGGER "write_event_member" ON "member" IS 'Create entries in "event" table on insertion to member table';
2119 CREATE FUNCTION "write_event_member_profile_updated_trigger"()
2120 RETURNS TRIGGER
2121 LANGUAGE 'plpgsql' VOLATILE AS $$
2122 BEGIN
2123 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2124 IF EXISTS (SELECT NULL FROM "member" WHERE "id" = OLD."member_id") THEN
2125 INSERT INTO "event" ("event", "member_id") VALUES (
2126 'member_profile_updated', OLD."member_id"
2127 );
2128 END IF;
2129 END IF;
2130 IF TG_OP = 'UPDATE' THEN
2131 IF OLD."member_id" = NEW."member_id" THEN
2132 RETURN NULL;
2133 END IF;
2134 END IF;
2135 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2136 INSERT INTO "event" ("event", "member_id") VALUES (
2137 'member_profile_updated', NEW."member_id"
2138 );
2139 END IF;
2140 RETURN NULL;
2141 END;
2142 $$;
2144 CREATE TRIGGER "write_event_member_profile_updated"
2145 AFTER INSERT OR UPDATE OR DELETE ON "member_profile"
2146 FOR EACH ROW EXECUTE PROCEDURE
2147 "write_event_member_profile_updated_trigger"();
2149 COMMENT ON FUNCTION "write_event_member_profile_updated_trigger"() IS 'Implementation of trigger "write_event_member_profile_updated" on table "member_profile"';
2150 COMMENT ON TRIGGER "write_event_member_profile_updated" ON "member_profile" IS 'Creates entries in "event" table on member profile update';
2153 CREATE FUNCTION "write_event_member_image_updated_trigger"()
2154 RETURNS TRIGGER
2155 LANGUAGE 'plpgsql' VOLATILE AS $$
2156 BEGIN
2157 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2158 IF NOT OLD."scaled" THEN
2159 IF EXISTS (SELECT NULL FROM "member" WHERE "id" = OLD."member_id") THEN
2160 INSERT INTO "event" ("event", "member_id") VALUES (
2161 'member_image_updated', OLD."member_id"
2162 );
2163 END IF;
2164 END IF;
2165 END IF;
2166 IF TG_OP = 'UPDATE' THEN
2167 IF
2168 OLD."member_id" = NEW."member_id" AND
2169 OLD."scaled" = NEW."scaled"
2170 THEN
2171 RETURN NULL;
2172 END IF;
2173 END IF;
2174 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2175 IF NOT NEW."scaled" THEN
2176 INSERT INTO "event" ("event", "member_id") VALUES (
2177 'member_image_updated', NEW."member_id"
2178 );
2179 END IF;
2180 END IF;
2181 RETURN NULL;
2182 END;
2183 $$;
2185 CREATE TRIGGER "write_event_member_image_updated"
2186 AFTER INSERT OR UPDATE OR DELETE ON "member_image"
2187 FOR EACH ROW EXECUTE PROCEDURE
2188 "write_event_member_image_updated_trigger"();
2190 COMMENT ON FUNCTION "write_event_member_image_updated_trigger"() IS 'Implementation of trigger "write_event_member_image_updated" on table "member_image"';
2191 COMMENT ON TRIGGER "write_event_member_image_updated" ON "member_image" IS 'Creates entries in "event" table on member image update';
2194 CREATE FUNCTION "write_event_interest_trigger"()
2195 RETURNS TRIGGER
2196 LANGUAGE 'plpgsql' VOLATILE AS $$
2197 DECLARE
2198 "issue_row" "issue"%ROWTYPE;
2199 "area_row" "area"%ROWTYPE;
2200 BEGIN
2201 IF TG_OP = 'UPDATE' THEN
2202 IF OLD = NEW THEN
2203 RETURN NULL;
2204 END IF;
2205 END IF;
2206 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2207 SELECT * INTO "issue_row" FROM "issue"
2208 WHERE "id" = OLD."issue_id" FOR SHARE;
2209 SELECT * INTO "area_row" FROM "area"
2210 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2211 IF "issue_row"."id" NOTNULL THEN
2212 INSERT INTO "event" (
2213 "event", "member_id",
2214 "unit_id", "area_id", "policy_id", "issue_id", "state",
2215 "boolean_value"
2216 ) VALUES (
2217 'interest', OLD."member_id",
2218 "area_row"."unit_id", "issue_row"."area_id",
2219 "issue_row"."policy_id",
2220 OLD."issue_id", "issue_row"."state",
2221 FALSE
2222 );
2223 END IF;
2224 END IF;
2225 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2226 SELECT * INTO "issue_row" FROM "issue"
2227 WHERE "id" = NEW."issue_id" FOR SHARE;
2228 SELECT * INTO "area_row" FROM "area"
2229 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2230 INSERT INTO "event" (
2231 "event", "member_id",
2232 "unit_id", "area_id", "policy_id", "issue_id", "state",
2233 "boolean_value"
2234 ) VALUES (
2235 'interest', NEW."member_id",
2236 "area_row"."unit_id", "issue_row"."area_id",
2237 "issue_row"."policy_id",
2238 NEW."issue_id", "issue_row"."state",
2239 TRUE
2240 );
2241 END IF;
2242 RETURN NULL;
2243 END;
2244 $$;
2246 CREATE TRIGGER "write_event_interest"
2247 AFTER INSERT OR UPDATE OR DELETE ON "interest" FOR EACH ROW EXECUTE PROCEDURE
2248 "write_event_interest_trigger"();
2250 COMMENT ON FUNCTION "write_event_interest_trigger"() IS 'Implementation of trigger "write_event_interest_inserted" on table "interest"';
2251 COMMENT ON TRIGGER "write_event_interest" ON "interest" IS 'Create entry in "event" table on adding or removing interest';
2254 CREATE FUNCTION "write_event_initiator_trigger"()
2255 RETURNS TRIGGER
2256 LANGUAGE 'plpgsql' VOLATILE AS $$
2257 DECLARE
2258 "initiative_row" "initiative"%ROWTYPE;
2259 "issue_row" "issue"%ROWTYPE;
2260 "area_row" "area"%ROWTYPE;
2261 "accepted_v" BOOLEAN = FALSE;
2262 "rejected_v" BOOLEAN = FALSE;
2263 BEGIN
2264 IF TG_OP = 'UPDATE' THEN
2265 IF
2266 OLD."initiative_id" = NEW."initiative_id" AND
2267 OLD."member_id" = NEW."member_id"
2268 THEN
2269 IF
2270 coalesce(OLD."accepted", FALSE) = coalesce(NEW."accepted", FALSE)
2271 THEN
2272 RETURN NULL;
2273 END IF;
2274 IF coalesce(NEW."accepted", FALSE) = TRUE THEN
2275 "accepted_v" := TRUE;
2276 ELSE
2277 "rejected_v" := TRUE;
2278 END IF;
2279 END IF;
2280 END IF;
2281 IF (TG_OP = 'DELETE' OR TG_OP = 'UPDATE') AND NOT "accepted_v" THEN
2282 IF coalesce(OLD."accepted", FALSE) = TRUE THEN
2283 SELECT * INTO "initiative_row" FROM "initiative"
2284 WHERE "id" = OLD."initiative_id" FOR SHARE;
2285 IF "initiative_row"."id" NOTNULL THEN
2286 SELECT * INTO "issue_row" FROM "issue"
2287 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2288 SELECT * INTO "area_row" FROM "area"
2289 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2290 INSERT INTO "event" (
2291 "event", "member_id",
2292 "unit_id", "area_id", "policy_id", "issue_id", "state",
2293 "initiative_id", "boolean_value"
2294 ) VALUES (
2295 'initiator', OLD."member_id",
2296 "area_row"."unit_id", "issue_row"."area_id",
2297 "issue_row"."policy_id",
2298 "issue_row"."id", "issue_row"."state",
2299 OLD."initiative_id", FALSE
2300 );
2301 END IF;
2302 END IF;
2303 END IF;
2304 IF TG_OP = 'UPDATE' AND NOT "rejected_v" THEN
2305 IF coalesce(NEW."accepted", FALSE) = TRUE THEN
2306 SELECT * INTO "initiative_row" FROM "initiative"
2307 WHERE "id" = NEW."initiative_id" FOR SHARE;
2308 SELECT * INTO "issue_row" FROM "issue"
2309 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2310 SELECT * INTO "area_row" FROM "area"
2311 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2312 INSERT INTO "event" (
2313 "event", "member_id",
2314 "unit_id", "area_id", "policy_id", "issue_id", "state",
2315 "initiative_id", "boolean_value"
2316 ) VALUES (
2317 'initiator', NEW."member_id",
2318 "area_row"."unit_id", "issue_row"."area_id",
2319 "issue_row"."policy_id",
2320 "issue_row"."id", "issue_row"."state",
2321 NEW."initiative_id", TRUE
2322 );
2323 END IF;
2324 END IF;
2325 RETURN NULL;
2326 END;
2327 $$;
2329 CREATE TRIGGER "write_event_initiator"
2330 AFTER UPDATE OR DELETE ON "initiator" FOR EACH ROW EXECUTE PROCEDURE
2331 "write_event_initiator_trigger"();
2333 COMMENT ON FUNCTION "write_event_initiator_trigger"() IS 'Implementation of trigger "write_event_initiator" on table "initiator"';
2334 COMMENT ON TRIGGER "write_event_initiator" ON "initiator" IS 'Create entry in "event" table when accepting or removing initiatorship (NOTE: trigger does not fire on INSERT to avoid events on initiative creation)';
2337 CREATE FUNCTION "write_event_support_trigger"()
2338 RETURNS TRIGGER
2339 LANGUAGE 'plpgsql' VOLATILE AS $$
2340 DECLARE
2341 "issue_row" "issue"%ROWTYPE;
2342 "area_row" "area"%ROWTYPE;
2343 BEGIN
2344 IF TG_OP = 'UPDATE' THEN
2345 IF
2346 OLD."initiative_id" = NEW."initiative_id" AND
2347 OLD."member_id" = NEW."member_id"
2348 THEN
2349 IF OLD."draft_id" != NEW."draft_id" THEN
2350 SELECT * INTO "issue_row" FROM "issue"
2351 WHERE "id" = NEW."issue_id" FOR SHARE;
2352 SELECT * INTO "area_row" FROM "area"
2353 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2354 INSERT INTO "event" (
2355 "event", "member_id",
2356 "unit_id", "area_id", "policy_id", "issue_id", "state",
2357 "initiative_id", "draft_id"
2358 ) VALUES (
2359 'support_updated', NEW."member_id",
2360 "area_row"."unit_id", "issue_row"."area_id",
2361 "issue_row"."policy_id",
2362 "issue_row"."id", "issue_row"."state",
2363 NEW."initiative_id", NEW."draft_id"
2364 );
2365 END IF;
2366 RETURN NULL;
2367 END IF;
2368 END IF;
2369 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2370 IF EXISTS (
2371 SELECT NULL FROM "initiative" WHERE "id" = OLD."initiative_id"
2372 FOR SHARE
2373 ) THEN
2374 SELECT * INTO "issue_row" FROM "issue"
2375 WHERE "id" = OLD."issue_id" FOR SHARE;
2376 SELECT * INTO "area_row" FROM "area"
2377 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2378 INSERT INTO "event" (
2379 "event", "member_id",
2380 "unit_id", "area_id", "policy_id", "issue_id", "state",
2381 "initiative_id", "boolean_value"
2382 ) VALUES (
2383 'support', OLD."member_id",
2384 "area_row"."unit_id", "issue_row"."area_id",
2385 "issue_row"."policy_id",
2386 "issue_row"."id", "issue_row"."state",
2387 OLD."initiative_id", FALSE
2388 );
2389 END IF;
2390 END IF;
2391 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2392 SELECT * INTO "issue_row" FROM "issue"
2393 WHERE "id" = NEW."issue_id" FOR SHARE;
2394 SELECT * INTO "area_row" FROM "area"
2395 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2396 INSERT INTO "event" (
2397 "event", "member_id",
2398 "unit_id", "area_id", "policy_id", "issue_id", "state",
2399 "initiative_id", "draft_id", "boolean_value"
2400 ) VALUES (
2401 'support', NEW."member_id",
2402 "area_row"."unit_id", "issue_row"."area_id",
2403 "issue_row"."policy_id",
2404 "issue_row"."id", "issue_row"."state",
2405 NEW."initiative_id", NEW."draft_id", TRUE
2406 );
2407 END IF;
2408 RETURN NULL;
2409 END;
2410 $$;
2412 CREATE TRIGGER "write_event_support"
2413 AFTER INSERT OR UPDATE OR DELETE ON "supporter" FOR EACH ROW EXECUTE PROCEDURE
2414 "write_event_support_trigger"();
2416 COMMENT ON FUNCTION "write_event_support_trigger"() IS 'Implementation of trigger "write_event_support" on table "supporter"';
2417 COMMENT ON TRIGGER "write_event_support" ON "supporter" IS 'Create entry in "event" table when adding, updating, or removing support';
2420 CREATE FUNCTION "write_event_suggestion_rated_trigger"()
2421 RETURNS TRIGGER
2422 LANGUAGE 'plpgsql' VOLATILE AS $$
2423 DECLARE
2424 "same_pkey_v" BOOLEAN = FALSE;
2425 "initiative_row" "initiative"%ROWTYPE;
2426 "issue_row" "issue"%ROWTYPE;
2427 "area_row" "area"%ROWTYPE;
2428 BEGIN
2429 IF TG_OP = 'UPDATE' THEN
2430 IF
2431 OLD."suggestion_id" = NEW."suggestion_id" AND
2432 OLD."member_id" = NEW."member_id"
2433 THEN
2434 IF
2435 OLD."degree" = NEW."degree" AND
2436 OLD."fulfilled" = NEW."fulfilled"
2437 THEN
2438 RETURN NULL;
2439 END IF;
2440 "same_pkey_v" := TRUE;
2441 END IF;
2442 END IF;
2443 IF (TG_OP = 'DELETE' OR TG_OP = 'UPDATE') AND NOT "same_pkey_v" THEN
2444 IF EXISTS (
2445 SELECT NULL FROM "suggestion" WHERE "id" = OLD."suggestion_id"
2446 FOR SHARE
2447 ) THEN
2448 SELECT * INTO "initiative_row" FROM "initiative"
2449 WHERE "id" = OLD."initiative_id" FOR SHARE;
2450 SELECT * INTO "issue_row" FROM "issue"
2451 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2452 SELECT * INTO "area_row" FROM "area"
2453 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2454 INSERT INTO "event" (
2455 "event", "member_id",
2456 "unit_id", "area_id", "policy_id", "issue_id", "state",
2457 "initiative_id", "suggestion_id",
2458 "boolean_value", "numeric_value"
2459 ) VALUES (
2460 'suggestion_rated', OLD."member_id",
2461 "area_row"."unit_id", "issue_row"."area_id",
2462 "issue_row"."policy_id",
2463 "initiative_row"."issue_id", "issue_row"."state",
2464 OLD."initiative_id", OLD."suggestion_id",
2465 NULL, 0
2466 );
2467 END IF;
2468 END IF;
2469 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2470 SELECT * INTO "initiative_row" FROM "initiative"
2471 WHERE "id" = NEW."initiative_id" FOR SHARE;
2472 SELECT * INTO "issue_row" FROM "issue"
2473 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2474 SELECT * INTO "area_row" FROM "area"
2475 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2476 INSERT INTO "event" (
2477 "event", "member_id",
2478 "unit_id", "area_id", "policy_id", "issue_id", "state",
2479 "initiative_id", "suggestion_id",
2480 "boolean_value", "numeric_value"
2481 ) VALUES (
2482 'suggestion_rated', NEW."member_id",
2483 "area_row"."unit_id", "issue_row"."area_id",
2484 "issue_row"."policy_id",
2485 "initiative_row"."issue_id", "issue_row"."state",
2486 NEW."initiative_id", NEW."suggestion_id",
2487 NEW."fulfilled", NEW."degree"
2488 );
2489 END IF;
2490 RETURN NULL;
2491 END;
2492 $$;
2494 CREATE TRIGGER "write_event_suggestion_rated"
2495 AFTER INSERT OR UPDATE OR DELETE ON "opinion" FOR EACH ROW EXECUTE PROCEDURE
2496 "write_event_suggestion_rated_trigger"();
2498 COMMENT ON FUNCTION "write_event_suggestion_rated_trigger"() IS 'Implementation of trigger "write_event_suggestion_rated" on table "opinion"';
2499 COMMENT ON TRIGGER "write_event_suggestion_rated" ON "opinion" IS 'Create entry in "event" table when adding, updating, or removing support';
2502 CREATE FUNCTION "write_event_delegation_trigger"()
2503 RETURNS TRIGGER
2504 LANGUAGE 'plpgsql' VOLATILE AS $$
2505 DECLARE
2506 "issue_row" "issue"%ROWTYPE;
2507 "area_row" "area"%ROWTYPE;
2508 BEGIN
2509 IF TG_OP = 'DELETE' THEN
2510 IF EXISTS (
2511 SELECT NULL FROM "member" WHERE "id" = OLD."truster_id"
2512 ) AND (CASE OLD."scope"
2513 WHEN 'unit'::"delegation_scope" THEN EXISTS (
2514 SELECT NULL FROM "unit" WHERE "id" = OLD."unit_id"
2515 )
2516 WHEN 'area'::"delegation_scope" THEN EXISTS (
2517 SELECT NULL FROM "area" WHERE "id" = OLD."area_id"
2518 )
2519 WHEN 'issue'::"delegation_scope" THEN EXISTS (
2520 SELECT NULL FROM "issue" WHERE "id" = OLD."issue_id"
2521 )
2522 END) THEN
2523 SELECT * INTO "issue_row" FROM "issue"
2524 WHERE "id" = OLD."issue_id" FOR SHARE;
2525 SELECT * INTO "area_row" FROM "area"
2526 WHERE "id" = COALESCE(OLD."area_id", "issue_row"."area_id")
2527 FOR SHARE;
2528 INSERT INTO "event" (
2529 "event", "member_id", "scope",
2530 "unit_id", "area_id", "issue_id", "state",
2531 "boolean_value"
2532 ) VALUES (
2533 'delegation', OLD."truster_id", OLD."scope",
2534 COALESCE(OLD."unit_id", "area_row"."unit_id"), "area_row"."id",
2535 OLD."issue_id", "issue_row"."state",
2536 FALSE
2537 );
2538 END IF;
2539 ELSE
2540 SELECT * INTO "issue_row" FROM "issue"
2541 WHERE "id" = NEW."issue_id" FOR SHARE;
2542 SELECT * INTO "area_row" FROM "area"
2543 WHERE "id" = COALESCE(NEW."area_id", "issue_row"."area_id")
2544 FOR SHARE;
2545 INSERT INTO "event" (
2546 "event", "member_id", "other_member_id", "scope",
2547 "unit_id", "area_id", "issue_id", "state",
2548 "boolean_value"
2549 ) VALUES (
2550 'delegation', NEW."truster_id", NEW."trustee_id", NEW."scope",
2551 COALESCE(NEW."unit_id", "area_row"."unit_id"), "area_row"."id",
2552 NEW."issue_id", "issue_row"."state",
2553 TRUE
2554 );
2555 END IF;
2556 RETURN NULL;
2557 END;
2558 $$;
2560 CREATE TRIGGER "write_event_delegation"
2561 AFTER INSERT OR UPDATE OR DELETE ON "delegation" FOR EACH ROW EXECUTE PROCEDURE
2562 "write_event_delegation_trigger"();
2564 COMMENT ON FUNCTION "write_event_delegation_trigger"() IS 'Implementation of trigger "write_event_delegation" on table "delegation"';
2565 COMMENT ON TRIGGER "write_event_delegation" ON "delegation" IS 'Create entry in "event" table when adding, updating, or removing a delegation';
2568 CREATE FUNCTION "write_event_contact_trigger"()
2569 RETURNS TRIGGER
2570 LANGUAGE 'plpgsql' VOLATILE AS $$
2571 BEGIN
2572 IF TG_OP = 'UPDATE' THEN
2573 IF
2574 OLD."member_id" = NEW."member_id" AND
2575 OLD."other_member_id" = NEW."other_member_id" AND
2576 OLD."public" = NEW."public"
2577 THEN
2578 RETURN NULL;
2579 END IF;
2580 END IF;
2581 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2582 IF OLD."public" THEN
2583 IF EXISTS (
2584 SELECT NULL FROM "member" WHERE "id" = OLD."member_id"
2585 FOR SHARE
2586 ) AND EXISTS (
2587 SELECT NULL FROM "member" WHERE "id" = OLD."other_member_id"
2588 FOR SHARE
2589 ) THEN
2590 INSERT INTO "event" (
2591 "event", "member_id", "other_member_id", "boolean_value"
2592 ) VALUES (
2593 'contact', OLD."member_id", OLD."other_member_id", FALSE
2594 );
2595 END IF;
2596 END IF;
2597 END IF;
2598 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2599 IF NEW."public" THEN
2600 INSERT INTO "event" (
2601 "event", "member_id", "other_member_id", "boolean_value"
2602 ) VALUES (
2603 'contact', NEW."member_id", NEW."other_member_id", TRUE
2604 );
2605 END IF;
2606 END IF;
2607 RETURN NULL;
2608 END;
2609 $$;
2611 CREATE TRIGGER "write_event_contact"
2612 AFTER INSERT OR UPDATE OR DELETE ON "contact" FOR EACH ROW EXECUTE PROCEDURE
2613 "write_event_contact_trigger"();
2615 COMMENT ON FUNCTION "write_event_contact_trigger"() IS 'Implementation of trigger "write_event_contact" on table "contact"';
2616 COMMENT ON TRIGGER "write_event_contact" ON "contact" IS 'Create entry in "event" table when adding or removing public contacts';
2619 CREATE FUNCTION "send_event_notify_trigger"()
2620 RETURNS TRIGGER
2621 LANGUAGE 'plpgsql' VOLATILE AS $$
2622 BEGIN
2623 EXECUTE 'NOTIFY "event", ''' || NEW."event" || '''';
2624 RETURN NULL;
2625 END;
2626 $$;
2628 CREATE TRIGGER "send_notify"
2629 AFTER INSERT OR UPDATE ON "event" FOR EACH ROW EXECUTE PROCEDURE
2630 "send_event_notify_trigger"();
2634 ----------------------------
2635 -- Additional constraints --
2636 ----------------------------
2639 CREATE FUNCTION "delete_extended_scope_tokens_trigger"()
2640 RETURNS TRIGGER
2641 LANGUAGE 'plpgsql' VOLATILE AS $$
2642 DECLARE
2643 "system_application_row" "system_application"%ROWTYPE;
2644 BEGIN
2645 IF OLD."system_application_id" NOTNULL THEN
2646 SELECT * FROM "system_application" INTO "system_application_row"
2647 WHERE "id" = OLD."system_application_id";
2648 DELETE FROM "token"
2649 WHERE "member_id" = OLD."member_id"
2650 AND "system_application_id" = OLD."system_application_id"
2651 AND NOT COALESCE(
2652 regexp_split_to_array("scope", E'\\s+') <@
2653 regexp_split_to_array(
2654 "system_application_row"."automatic_scope", E'\\s+'
2655 ),
2656 FALSE
2657 );
2658 END IF;
2659 RETURN OLD;
2660 END;
2661 $$;
2663 CREATE TRIGGER "delete_extended_scope_tokens"
2664 BEFORE DELETE ON "member_application" FOR EACH ROW EXECUTE PROCEDURE
2665 "delete_extended_scope_tokens_trigger"();
2668 CREATE FUNCTION "detach_token_from_session_trigger"()
2669 RETURNS TRIGGER
2670 LANGUAGE 'plpgsql' VOLATILE AS $$
2671 BEGIN
2672 UPDATE "token" SET "session_id" = NULL
2673 WHERE "session_id" = OLD."id";
2674 RETURN OLD;
2675 END;
2676 $$;
2678 CREATE TRIGGER "detach_token_from_session"
2679 BEFORE DELETE ON "session" FOR EACH ROW EXECUTE PROCEDURE
2680 "detach_token_from_session_trigger"();
2683 CREATE FUNCTION "delete_non_detached_scope_with_session_trigger"()
2684 RETURNS TRIGGER
2685 LANGUAGE 'plpgsql' VOLATILE AS $$
2686 BEGIN
2687 IF NEW."session_id" ISNULL THEN
2688 SELECT coalesce(string_agg("element", ' '), '') INTO NEW."scope"
2689 FROM unnest(regexp_split_to_array(NEW."scope", E'\\s+')) AS "element"
2690 WHERE "element" LIKE '%_detached';
2691 END IF;
2692 RETURN NEW;
2693 END;
2694 $$;
2696 CREATE TRIGGER "delete_non_detached_scope_with_session"
2697 BEFORE INSERT OR UPDATE ON "token" FOR EACH ROW EXECUTE PROCEDURE
2698 "delete_non_detached_scope_with_session_trigger"();
2701 CREATE FUNCTION "delete_token_with_empty_scope_trigger"()
2702 RETURNS TRIGGER
2703 LANGUAGE 'plpgsql' VOLATILE AS $$
2704 BEGIN
2705 IF NEW."scope" = '' THEN
2706 DELETE FROM "token" WHERE "id" = NEW."id";
2707 END IF;
2708 RETURN NULL;
2709 END;
2710 $$;
2712 CREATE TRIGGER "delete_token_with_empty_scope"
2713 AFTER INSERT OR UPDATE ON "token" FOR EACH ROW EXECUTE PROCEDURE
2714 "delete_token_with_empty_scope_trigger"();
2717 CREATE FUNCTION "issue_requires_first_initiative_trigger"()
2718 RETURNS TRIGGER
2719 LANGUAGE 'plpgsql' VOLATILE AS $$
2720 BEGIN
2721 IF NOT EXISTS (
2722 SELECT NULL FROM "initiative" WHERE "issue_id" = NEW."id"
2723 ) THEN
2724 RAISE EXCEPTION 'Cannot create issue without an initial initiative.' USING
2725 ERRCODE = 'integrity_constraint_violation',
2726 HINT = 'Create issue, initiative, and draft within the same transaction.';
2727 END IF;
2728 RETURN NULL;
2729 END;
2730 $$;
2732 CREATE CONSTRAINT TRIGGER "issue_requires_first_initiative"
2733 AFTER INSERT OR UPDATE ON "issue" DEFERRABLE INITIALLY DEFERRED
2734 FOR EACH ROW EXECUTE PROCEDURE
2735 "issue_requires_first_initiative_trigger"();
2737 COMMENT ON FUNCTION "issue_requires_first_initiative_trigger"() IS 'Implementation of trigger "issue_requires_first_initiative" on table "issue"';
2738 COMMENT ON TRIGGER "issue_requires_first_initiative" ON "issue" IS 'Ensure that new issues have at least one initiative';
2741 CREATE FUNCTION "last_initiative_deletes_issue_trigger"()
2742 RETURNS TRIGGER
2743 LANGUAGE 'plpgsql' VOLATILE AS $$
2744 DECLARE
2745 "reference_lost" BOOLEAN;
2746 BEGIN
2747 IF TG_OP = 'DELETE' THEN
2748 "reference_lost" := TRUE;
2749 ELSE
2750 "reference_lost" := NEW."issue_id" != OLD."issue_id";
2751 END IF;
2752 IF
2753 "reference_lost" AND NOT EXISTS (
2754 SELECT NULL FROM "initiative" WHERE "issue_id" = OLD."issue_id"
2755 )
2756 THEN
2757 DELETE FROM "issue" WHERE "id" = OLD."issue_id";
2758 END IF;
2759 RETURN NULL;
2760 END;
2761 $$;
2763 CREATE CONSTRAINT TRIGGER "last_initiative_deletes_issue"
2764 AFTER UPDATE OR DELETE ON "initiative" DEFERRABLE INITIALLY DEFERRED
2765 FOR EACH ROW EXECUTE PROCEDURE
2766 "last_initiative_deletes_issue_trigger"();
2768 COMMENT ON FUNCTION "last_initiative_deletes_issue_trigger"() IS 'Implementation of trigger "last_initiative_deletes_issue" on table "initiative"';
2769 COMMENT ON TRIGGER "last_initiative_deletes_issue" ON "initiative" IS 'Removing the last initiative of an issue deletes the issue';
2772 CREATE FUNCTION "initiative_requires_first_draft_trigger"()
2773 RETURNS TRIGGER
2774 LANGUAGE 'plpgsql' VOLATILE AS $$
2775 BEGIN
2776 IF NOT EXISTS (
2777 SELECT NULL FROM "draft" WHERE "initiative_id" = NEW."id"
2778 ) THEN
2779 RAISE EXCEPTION 'Cannot create initiative without an initial draft.' USING
2780 ERRCODE = 'integrity_constraint_violation',
2781 HINT = 'Create issue, initiative and draft within the same transaction.';
2782 END IF;
2783 RETURN NULL;
2784 END;
2785 $$;
2787 CREATE CONSTRAINT TRIGGER "initiative_requires_first_draft"
2788 AFTER INSERT OR UPDATE ON "initiative" DEFERRABLE INITIALLY DEFERRED
2789 FOR EACH ROW EXECUTE PROCEDURE
2790 "initiative_requires_first_draft_trigger"();
2792 COMMENT ON FUNCTION "initiative_requires_first_draft_trigger"() IS 'Implementation of trigger "initiative_requires_first_draft" on table "initiative"';
2793 COMMENT ON TRIGGER "initiative_requires_first_draft" ON "initiative" IS 'Ensure that new initiatives have at least one draft';
2796 CREATE FUNCTION "last_draft_deletes_initiative_trigger"()
2797 RETURNS TRIGGER
2798 LANGUAGE 'plpgsql' VOLATILE AS $$
2799 DECLARE
2800 "reference_lost" BOOLEAN;
2801 BEGIN
2802 IF TG_OP = 'DELETE' THEN
2803 "reference_lost" := TRUE;
2804 ELSE
2805 "reference_lost" := NEW."initiative_id" != OLD."initiative_id";
2806 END IF;
2807 IF
2808 "reference_lost" AND NOT EXISTS (
2809 SELECT NULL FROM "draft" WHERE "initiative_id" = OLD."initiative_id"
2810 )
2811 THEN
2812 DELETE FROM "initiative" WHERE "id" = OLD."initiative_id";
2813 END IF;
2814 RETURN NULL;
2815 END;
2816 $$;
2818 CREATE CONSTRAINT TRIGGER "last_draft_deletes_initiative"
2819 AFTER UPDATE OR DELETE ON "draft" DEFERRABLE INITIALLY DEFERRED
2820 FOR EACH ROW EXECUTE PROCEDURE
2821 "last_draft_deletes_initiative_trigger"();
2823 COMMENT ON FUNCTION "last_draft_deletes_initiative_trigger"() IS 'Implementation of trigger "last_draft_deletes_initiative" on table "draft"';
2824 COMMENT ON TRIGGER "last_draft_deletes_initiative" ON "draft" IS 'Removing the last draft of an initiative deletes the initiative';
2827 CREATE FUNCTION "suggestion_requires_first_opinion_trigger"()
2828 RETURNS TRIGGER
2829 LANGUAGE 'plpgsql' VOLATILE AS $$
2830 BEGIN
2831 IF NOT EXISTS (
2832 SELECT NULL FROM "opinion" WHERE "suggestion_id" = NEW."id"
2833 ) THEN
2834 RAISE EXCEPTION 'Cannot create a suggestion without an opinion.' USING
2835 ERRCODE = 'integrity_constraint_violation',
2836 HINT = 'Create suggestion and opinion within the same transaction.';
2837 END IF;
2838 RETURN NULL;
2839 END;
2840 $$;
2842 CREATE CONSTRAINT TRIGGER "suggestion_requires_first_opinion"
2843 AFTER INSERT OR UPDATE ON "suggestion" DEFERRABLE INITIALLY DEFERRED
2844 FOR EACH ROW EXECUTE PROCEDURE
2845 "suggestion_requires_first_opinion_trigger"();
2847 COMMENT ON FUNCTION "suggestion_requires_first_opinion_trigger"() IS 'Implementation of trigger "suggestion_requires_first_opinion" on table "suggestion"';
2848 COMMENT ON TRIGGER "suggestion_requires_first_opinion" ON "suggestion" IS 'Ensure that new suggestions have at least one opinion';
2851 CREATE FUNCTION "last_opinion_deletes_suggestion_trigger"()
2852 RETURNS TRIGGER
2853 LANGUAGE 'plpgsql' VOLATILE AS $$
2854 DECLARE
2855 "reference_lost" BOOLEAN;
2856 BEGIN
2857 IF TG_OP = 'DELETE' THEN
2858 "reference_lost" := TRUE;
2859 ELSE
2860 "reference_lost" := NEW."suggestion_id" != OLD."suggestion_id";
2861 END IF;
2862 IF
2863 "reference_lost" AND NOT EXISTS (
2864 SELECT NULL FROM "opinion" WHERE "suggestion_id" = OLD."suggestion_id"
2865 )
2866 THEN
2867 DELETE FROM "suggestion" WHERE "id" = OLD."suggestion_id";
2868 END IF;
2869 RETURN NULL;
2870 END;
2871 $$;
2873 CREATE CONSTRAINT TRIGGER "last_opinion_deletes_suggestion"
2874 AFTER UPDATE OR DELETE ON "opinion" DEFERRABLE INITIALLY DEFERRED
2875 FOR EACH ROW EXECUTE PROCEDURE
2876 "last_opinion_deletes_suggestion_trigger"();
2878 COMMENT ON FUNCTION "last_opinion_deletes_suggestion_trigger"() IS 'Implementation of trigger "last_opinion_deletes_suggestion" on table "opinion"';
2879 COMMENT ON TRIGGER "last_opinion_deletes_suggestion" ON "opinion" IS 'Removing the last opinion of a suggestion deletes the suggestion';
2882 CREATE FUNCTION "non_voter_deletes_direct_voter_trigger"()
2883 RETURNS TRIGGER
2884 LANGUAGE 'plpgsql' VOLATILE AS $$
2885 BEGIN
2886 DELETE FROM "direct_voter"
2887 WHERE "issue_id" = NEW."issue_id" AND "member_id" = NEW."member_id";
2888 RETURN NULL;
2889 END;
2890 $$;
2892 CREATE TRIGGER "non_voter_deletes_direct_voter"
2893 AFTER INSERT OR UPDATE ON "non_voter"
2894 FOR EACH ROW EXECUTE PROCEDURE
2895 "non_voter_deletes_direct_voter_trigger"();
2897 COMMENT ON FUNCTION "non_voter_deletes_direct_voter_trigger"() IS 'Implementation of trigger "non_voter_deletes_direct_voter" on table "non_voter"';
2898 COMMENT ON TRIGGER "non_voter_deletes_direct_voter" ON "non_voter" IS 'An entry in the "non_voter" table deletes an entry in the "direct_voter" table (and vice versa due to trigger "direct_voter_deletes_non_voter" on table "direct_voter")';
2901 CREATE FUNCTION "direct_voter_deletes_non_voter_trigger"()
2902 RETURNS TRIGGER
2903 LANGUAGE 'plpgsql' VOLATILE AS $$
2904 BEGIN
2905 DELETE FROM "non_voter"
2906 WHERE "issue_id" = NEW."issue_id" AND "member_id" = NEW."member_id";
2907 RETURN NULL;
2908 END;
2909 $$;
2911 CREATE TRIGGER "direct_voter_deletes_non_voter"
2912 AFTER INSERT OR UPDATE ON "direct_voter"
2913 FOR EACH ROW EXECUTE PROCEDURE
2914 "direct_voter_deletes_non_voter_trigger"();
2916 COMMENT ON FUNCTION "direct_voter_deletes_non_voter_trigger"() IS 'Implementation of trigger "direct_voter_deletes_non_voter" on table "direct_voter"';
2917 COMMENT ON TRIGGER "direct_voter_deletes_non_voter" ON "direct_voter" IS 'An entry in the "direct_voter" table deletes an entry in the "non_voter" table (and vice versa due to trigger "non_voter_deletes_direct_voter" on table "non_voter")';
2920 CREATE FUNCTION "voter_comment_fields_only_set_when_voter_comment_is_set_trigger"()
2921 RETURNS TRIGGER
2922 LANGUAGE 'plpgsql' VOLATILE AS $$
2923 BEGIN
2924 IF NEW."comment" ISNULL THEN
2925 NEW."comment_changed" := NULL;
2926 NEW."formatting_engine" := NULL;
2927 END IF;
2928 RETURN NEW;
2929 END;
2930 $$;
2932 CREATE TRIGGER "voter_comment_fields_only_set_when_voter_comment_is_set"
2933 BEFORE INSERT OR UPDATE ON "direct_voter"
2934 FOR EACH ROW EXECUTE PROCEDURE
2935 "voter_comment_fields_only_set_when_voter_comment_is_set_trigger"();
2937 COMMENT ON FUNCTION "voter_comment_fields_only_set_when_voter_comment_is_set_trigger"() IS 'Implementation of trigger "voter_comment_fields_only_set_when_voter_comment_is_set" ON table "direct_voter"';
2938 COMMENT ON TRIGGER "voter_comment_fields_only_set_when_voter_comment_is_set" ON "direct_voter" IS 'If "comment" is set to NULL, then other comment related fields are also set to NULL.';
2942 ---------------------------------
2943 -- Delete incomplete snapshots --
2944 ---------------------------------
2947 CREATE FUNCTION "delete_snapshot_on_partial_delete_trigger"()
2948 RETURNS TRIGGER
2949 LANGUAGE 'plpgsql' VOLATILE AS $$
2950 BEGIN
2951 IF TG_OP = 'UPDATE' THEN
2952 IF
2953 OLD."snapshot_id" = NEW."snapshot_id" AND
2954 OLD."issue_id" = NEW."issue_id"
2955 THEN
2956 RETURN NULL;
2957 END IF;
2958 END IF;
2959 DELETE FROM "snapshot" WHERE "id" = OLD."snapshot_id";
2960 RETURN NULL;
2961 END;
2962 $$;
2964 CREATE TRIGGER "delete_snapshot_on_partial_delete"
2965 AFTER UPDATE OR DELETE ON "snapshot_issue"
2966 FOR EACH ROW EXECUTE PROCEDURE
2967 "delete_snapshot_on_partial_delete_trigger"();
2969 COMMENT ON FUNCTION "delete_snapshot_on_partial_delete_trigger"() IS 'Implementation of trigger "delete_snapshot_on_partial_delete" on table "snapshot_issue"';
2970 COMMENT ON TRIGGER "delete_snapshot_on_partial_delete" ON "snapshot_issue" IS 'Deletes whole snapshot if one issue is deleted from the snapshot';
2974 ---------------------------------------------------------------
2975 -- Ensure that votes are not modified when issues are closed --
2976 ---------------------------------------------------------------
2978 -- NOTE: Frontends should ensure this anyway, but in case of programming
2979 -- errors the following triggers ensure data integrity.
2982 CREATE FUNCTION "forbid_changes_on_closed_issue_trigger"()
2983 RETURNS TRIGGER
2984 LANGUAGE 'plpgsql' VOLATILE AS $$
2985 DECLARE
2986 "issue_id_v" "issue"."id"%TYPE;
2987 "issue_row" "issue"%ROWTYPE;
2988 BEGIN
2989 IF EXISTS (
2990 SELECT NULL FROM "temporary_transaction_data"
2991 WHERE "txid" = txid_current()
2992 AND "key" = 'override_protection_triggers'
2993 AND "value" = TRUE::TEXT
2994 ) THEN
2995 RETURN NULL;
2996 END IF;
2997 IF TG_OP = 'DELETE' THEN
2998 "issue_id_v" := OLD."issue_id";
2999 ELSE
3000 "issue_id_v" := NEW."issue_id";
3001 END IF;
3002 SELECT INTO "issue_row" * FROM "issue"
3003 WHERE "id" = "issue_id_v" FOR SHARE;
3004 IF (
3005 "issue_row"."closed" NOTNULL OR (
3006 "issue_row"."state" = 'voting' AND
3007 "issue_row"."phase_finished" NOTNULL
3008 )
3009 ) THEN
3010 IF
3011 TG_RELID = 'direct_voter'::regclass AND
3012 TG_OP = 'UPDATE'
3013 THEN
3014 IF
3015 OLD."issue_id" = NEW."issue_id" AND
3016 OLD."member_id" = NEW."member_id" AND
3017 OLD."weight" = NEW."weight"
3018 THEN
3019 RETURN NULL; -- allows changing of voter comment
3020 END IF;
3021 END IF;
3022 RAISE EXCEPTION 'Tried to modify data after voting has been closed.' USING
3023 ERRCODE = 'integrity_constraint_violation';
3024 END IF;
3025 RETURN NULL;
3026 END;
3027 $$;
3029 CREATE TRIGGER "forbid_changes_on_closed_issue"
3030 AFTER INSERT OR UPDATE OR DELETE ON "direct_voter"
3031 FOR EACH ROW EXECUTE PROCEDURE
3032 "forbid_changes_on_closed_issue_trigger"();
3034 CREATE TRIGGER "forbid_changes_on_closed_issue"
3035 AFTER INSERT OR UPDATE OR DELETE ON "delegating_voter"
3036 FOR EACH ROW EXECUTE PROCEDURE
3037 "forbid_changes_on_closed_issue_trigger"();
3039 CREATE TRIGGER "forbid_changes_on_closed_issue"
3040 AFTER INSERT OR UPDATE OR DELETE ON "vote"
3041 FOR EACH ROW EXECUTE PROCEDURE
3042 "forbid_changes_on_closed_issue_trigger"();
3044 COMMENT ON FUNCTION "forbid_changes_on_closed_issue_trigger"() IS 'Implementation of triggers "forbid_changes_on_closed_issue" on tables "direct_voter", "delegating_voter" and "vote"';
3045 COMMENT ON TRIGGER "forbid_changes_on_closed_issue" ON "direct_voter" IS 'Ensures that frontends can''t tamper with votings of closed issues, in case of programming errors';
3046 COMMENT ON TRIGGER "forbid_changes_on_closed_issue" ON "delegating_voter" IS 'Ensures that frontends can''t tamper with votings of closed issues, in case of programming errors';
3047 COMMENT ON TRIGGER "forbid_changes_on_closed_issue" ON "vote" IS 'Ensures that frontends can''t tamper with votings of closed issues, in case of programming errors';
3051 --------------------------------------------------------------------
3052 -- Auto-retrieval of fields only needed for referential integrity --
3053 --------------------------------------------------------------------
3056 CREATE FUNCTION "autofill_issue_id_trigger"()
3057 RETURNS TRIGGER
3058 LANGUAGE 'plpgsql' VOLATILE AS $$
3059 BEGIN
3060 IF NEW."issue_id" ISNULL THEN
3061 SELECT "issue_id" INTO NEW."issue_id"
3062 FROM "initiative" WHERE "id" = NEW."initiative_id";
3063 END IF;
3064 RETURN NEW;
3065 END;
3066 $$;
3068 CREATE TRIGGER "autofill_issue_id" BEFORE INSERT ON "supporter"
3069 FOR EACH ROW EXECUTE PROCEDURE "autofill_issue_id_trigger"();
3071 CREATE TRIGGER "autofill_issue_id" BEFORE INSERT ON "vote"
3072 FOR EACH ROW EXECUTE PROCEDURE "autofill_issue_id_trigger"();
3074 COMMENT ON FUNCTION "autofill_issue_id_trigger"() IS 'Implementation of triggers "autofill_issue_id" on tables "supporter" and "vote"';
3075 COMMENT ON TRIGGER "autofill_issue_id" ON "supporter" IS 'Set "issue_id" field automatically, if NULL';
3076 COMMENT ON TRIGGER "autofill_issue_id" ON "vote" IS 'Set "issue_id" field automatically, if NULL';
3079 CREATE FUNCTION "autofill_initiative_id_trigger"()
3080 RETURNS TRIGGER
3081 LANGUAGE 'plpgsql' VOLATILE AS $$
3082 BEGIN
3083 IF NEW."initiative_id" ISNULL THEN
3084 SELECT "initiative_id" INTO NEW."initiative_id"
3085 FROM "suggestion" WHERE "id" = NEW."suggestion_id";
3086 END IF;
3087 RETURN NEW;
3088 END;
3089 $$;
3091 CREATE TRIGGER "autofill_initiative_id" BEFORE INSERT ON "opinion"
3092 FOR EACH ROW EXECUTE PROCEDURE "autofill_initiative_id_trigger"();
3094 COMMENT ON FUNCTION "autofill_initiative_id_trigger"() IS 'Implementation of trigger "autofill_initiative_id" on table "opinion"';
3095 COMMENT ON TRIGGER "autofill_initiative_id" ON "opinion" IS 'Set "initiative_id" field automatically, if NULL';
3099 -------------------------------------------------------
3100 -- Automatic copying of values for indexing purposes --
3101 -------------------------------------------------------
3104 CREATE FUNCTION "copy_current_draft_data"
3105 ("initiative_id_p" "initiative"."id"%TYPE )
3106 RETURNS VOID
3107 LANGUAGE 'plpgsql' VOLATILE AS $$
3108 BEGIN
3109 PERFORM NULL FROM "initiative" WHERE "id" = "initiative_id_p"
3110 FOR UPDATE;
3111 UPDATE "initiative" SET
3112 "location" = "draft"."location",
3113 "draft_text_search_data" = "draft"."text_search_data"
3114 FROM "current_draft" AS "draft"
3115 WHERE "initiative"."id" = "initiative_id_p"
3116 AND "draft"."initiative_id" = "initiative_id_p";
3117 END;
3118 $$;
3120 COMMENT ON FUNCTION "copy_current_draft_data"
3121 ( "initiative"."id"%TYPE )
3122 IS 'Helper function for function "copy_current_draft_data_trigger"';
3125 CREATE FUNCTION "copy_current_draft_data_trigger"()
3126 RETURNS TRIGGER
3127 LANGUAGE 'plpgsql' VOLATILE AS $$
3128 BEGIN
3129 IF TG_OP='DELETE' THEN
3130 PERFORM "copy_current_draft_data"(OLD."initiative_id");
3131 ELSE
3132 IF TG_OP='UPDATE' THEN
3133 IF COALESCE(OLD."inititiave_id" != NEW."initiative_id", TRUE) THEN
3134 PERFORM "copy_current_draft_data"(OLD."initiative_id");
3135 END IF;
3136 END IF;
3137 PERFORM "copy_current_draft_data"(NEW."initiative_id");
3138 END IF;
3139 RETURN NULL;
3140 END;
3141 $$;
3143 CREATE TRIGGER "copy_current_draft_data"
3144 AFTER INSERT OR UPDATE OR DELETE ON "draft"
3145 FOR EACH ROW EXECUTE PROCEDURE
3146 "copy_current_draft_data_trigger"();
3148 COMMENT ON FUNCTION "copy_current_draft_data_trigger"() IS 'Implementation of trigger "copy_current_draft_data" on table "draft"';
3149 COMMENT ON TRIGGER "copy_current_draft_data" ON "draft" IS 'Copy certain fields from most recent "draft" to "initiative"';
3153 -----------------------------------------------------
3154 -- Automatic calculation of certain default values --
3155 -----------------------------------------------------
3158 CREATE FUNCTION "copy_timings_trigger"()
3159 RETURNS TRIGGER
3160 LANGUAGE 'plpgsql' VOLATILE AS $$
3161 DECLARE
3162 "policy_row" "policy"%ROWTYPE;
3163 BEGIN
3164 SELECT * INTO "policy_row" FROM "policy"
3165 WHERE "id" = NEW."policy_id";
3166 IF NEW."min_admission_time" ISNULL THEN
3167 NEW."min_admission_time" := "policy_row"."min_admission_time";
3168 END IF;
3169 IF NEW."max_admission_time" ISNULL THEN
3170 NEW."max_admission_time" := "policy_row"."max_admission_time";
3171 END IF;
3172 IF NEW."discussion_time" ISNULL THEN
3173 NEW."discussion_time" := "policy_row"."discussion_time";
3174 END IF;
3175 IF NEW."verification_time" ISNULL THEN
3176 NEW."verification_time" := "policy_row"."verification_time";
3177 END IF;
3178 IF NEW."voting_time" ISNULL THEN
3179 NEW."voting_time" := "policy_row"."voting_time";
3180 END IF;
3181 RETURN NEW;
3182 END;
3183 $$;
3185 CREATE TRIGGER "copy_timings" BEFORE INSERT OR UPDATE ON "issue"
3186 FOR EACH ROW EXECUTE PROCEDURE "copy_timings_trigger"();
3188 COMMENT ON FUNCTION "copy_timings_trigger"() IS 'Implementation of trigger "copy_timings" on table "issue"';
3189 COMMENT ON TRIGGER "copy_timings" ON "issue" IS 'If timing fields are NULL, copy values from policy.';
3192 CREATE FUNCTION "default_for_draft_id_trigger"()
3193 RETURNS TRIGGER
3194 LANGUAGE 'plpgsql' VOLATILE AS $$
3195 BEGIN
3196 IF NEW."draft_id" ISNULL THEN
3197 SELECT "id" INTO NEW."draft_id" FROM "current_draft"
3198 WHERE "initiative_id" = NEW."initiative_id";
3199 END IF;
3200 RETURN NEW;
3201 END;
3202 $$;
3204 CREATE TRIGGER "default_for_draft_id" BEFORE INSERT OR UPDATE ON "suggestion"
3205 FOR EACH ROW EXECUTE PROCEDURE "default_for_draft_id_trigger"();
3206 CREATE TRIGGER "default_for_draft_id" BEFORE INSERT OR UPDATE ON "supporter"
3207 FOR EACH ROW EXECUTE PROCEDURE "default_for_draft_id_trigger"();
3209 COMMENT ON FUNCTION "default_for_draft_id_trigger"() IS 'Implementation of trigger "default_for_draft" on tables "supporter" and "suggestion"';
3210 COMMENT ON TRIGGER "default_for_draft_id" ON "suggestion" IS 'If "draft_id" is NULL, then use the current draft of the initiative as default';
3211 COMMENT ON TRIGGER "default_for_draft_id" ON "supporter" IS 'If "draft_id" is NULL, then use the current draft of the initiative as default';
3215 ----------------------------------------
3216 -- Automatic creation of dependencies --
3217 ----------------------------------------
3220 CREATE FUNCTION "autocreate_interest_trigger"()
3221 RETURNS TRIGGER
3222 LANGUAGE 'plpgsql' VOLATILE AS $$
3223 BEGIN
3224 IF NOT EXISTS (
3225 SELECT NULL FROM "initiative" JOIN "interest"
3226 ON "initiative"."issue_id" = "interest"."issue_id"
3227 WHERE "initiative"."id" = NEW."initiative_id"
3228 AND "interest"."member_id" = NEW."member_id"
3229 ) THEN
3230 BEGIN
3231 INSERT INTO "interest" ("issue_id", "member_id")
3232 SELECT "issue_id", NEW."member_id"
3233 FROM "initiative" WHERE "id" = NEW."initiative_id";
3234 EXCEPTION WHEN unique_violation THEN END;
3235 END IF;
3236 RETURN NEW;
3237 END;
3238 $$;
3240 CREATE TRIGGER "autocreate_interest" BEFORE INSERT ON "supporter"
3241 FOR EACH ROW EXECUTE PROCEDURE "autocreate_interest_trigger"();
3243 COMMENT ON FUNCTION "autocreate_interest_trigger"() IS 'Implementation of trigger "autocreate_interest" on table "supporter"';
3244 COMMENT ON TRIGGER "autocreate_interest" ON "supporter" IS 'Supporting an initiative implies interest in the issue, thus automatically creates an entry in the "interest" table';
3247 CREATE FUNCTION "autocreate_supporter_trigger"()
3248 RETURNS TRIGGER
3249 LANGUAGE 'plpgsql' VOLATILE AS $$
3250 BEGIN
3251 IF NOT EXISTS (
3252 SELECT NULL FROM "suggestion" JOIN "supporter"
3253 ON "suggestion"."initiative_id" = "supporter"."initiative_id"
3254 WHERE "suggestion"."id" = NEW."suggestion_id"
3255 AND "supporter"."member_id" = NEW."member_id"
3256 ) THEN
3257 BEGIN
3258 INSERT INTO "supporter" ("initiative_id", "member_id")
3259 SELECT "initiative_id", NEW."member_id"
3260 FROM "suggestion" WHERE "id" = NEW."suggestion_id";
3261 EXCEPTION WHEN unique_violation THEN END;
3262 END IF;
3263 RETURN NEW;
3264 END;
3265 $$;
3267 CREATE TRIGGER "autocreate_supporter" BEFORE INSERT ON "opinion"
3268 FOR EACH ROW EXECUTE PROCEDURE "autocreate_supporter_trigger"();
3270 COMMENT ON FUNCTION "autocreate_supporter_trigger"() IS 'Implementation of trigger "autocreate_supporter" on table "opinion"';
3271 COMMENT ON TRIGGER "autocreate_supporter" ON "opinion" IS 'Opinions can only be added for supported initiatives. This trigger automatrically creates an entry in the "supporter" table, if not existent yet.';
3275 ------------------------------------------
3276 -- Views and helper functions for views --
3277 ------------------------------------------
3280 CREATE VIEW "member_eligible_to_be_notified" AS
3281 SELECT * FROM "member"
3282 WHERE "activated" NOTNULL AND "locked" = FALSE;
3284 COMMENT ON VIEW "member_eligible_to_be_notified" IS 'Filtered "member" table containing only activated and non-locked members (used as helper view for "member_to_notify" and "newsletter_to_send")';
3287 CREATE VIEW "member_to_notify" AS
3288 SELECT * FROM "member_eligible_to_be_notified"
3289 WHERE "disable_notifications" = FALSE;
3291 COMMENT ON VIEW "member_to_notify" IS 'Filtered "member" table containing only members that are eligible to and wish to receive notifications; NOTE: "notify_email" may still be NULL and might need to be checked by frontend (this allows other means of messaging)';
3294 CREATE VIEW "area_quorum" AS
3295 SELECT
3296 "area"."id" AS "area_id",
3297 ceil(
3298 "area"."quorum_standard"::FLOAT8 * "quorum_factor"::FLOAT8 ^ (
3299 coalesce(
3300 ( SELECT sum(
3301 ( extract(epoch from "area"."quorum_time")::FLOAT8 /
3302 extract(epoch from
3303 ("issue"."accepted"-"issue"."created") +
3304 "issue"."discussion_time" +
3305 "issue"."verification_time" +
3306 "issue"."voting_time"
3307 )::FLOAT8
3308 ) ^ "area"."quorum_exponent"::FLOAT8
3309 )
3310 FROM "issue" JOIN "policy"
3311 ON "issue"."policy_id" = "policy"."id"
3312 WHERE "issue"."area_id" = "area"."id"
3313 AND "issue"."accepted" NOTNULL
3314 AND "issue"."closed" ISNULL
3315 AND "policy"."polling" = FALSE
3316 )::FLOAT8, 0::FLOAT8
3317 ) / "area"."quorum_issues"::FLOAT8 - 1::FLOAT8
3318 ) * CASE WHEN "area"."quorum_den" ISNULL THEN 1 ELSE (
3319 SELECT "snapshot"."population"
3320 FROM "snapshot"
3321 WHERE "snapshot"."area_id" = "area"."id"
3322 AND "snapshot"."issue_id" ISNULL
3323 ORDER BY "snapshot"."id" DESC
3324 LIMIT 1
3325 ) END / coalesce("area"."quorum_den", 1)
3327 )::INT4 AS "issue_quorum"
3328 FROM "area";
3330 COMMENT ON VIEW "area_quorum" IS 'Area-based quorum considering number of open (accepted) issues';
3333 CREATE VIEW "issue_quorum" AS
3334 SELECT DISTINCT ON ("issue_id")
3335 "issue"."id" AS "issue_id",
3336 "subquery"."issue_quorum"
3337 FROM "issue"
3338 CROSS JOIN LATERAL (
3339 SELECT "area_quorum"."issue_quorum"
3340 FROM "area_quorum" WHERE "area_quorum"."area_id" = "issue"."area_id"
3341 UNION ALL
3342 SELECT "policy"."issue_quorum"
3343 FROM "policy" WHERE "policy"."id" = "issue"."policy_id"
3344 UNION ALL
3345 SELECT
3346 ceil(
3347 ("issue"."population"::INT8 * "policy"."issue_quorum_num"::INT8) /
3348 "policy"."issue_quorum_den"::FLOAT8
3349 )::INT4
3350 FROM "policy" WHERE "policy"."id" = "issue"."policy_id"
3351 ) AS "subquery"
3352 ORDER BY "issue_id", "issue_quorum" DESC;
3354 COMMENT ON VIEW "issue_quorum" IS 'Effective quorum for issue admission';
3357 CREATE VIEW "area_with_unaccepted_issues" AS
3358 SELECT DISTINCT ON ("area"."id") "area".*
3359 FROM "area" JOIN "issue" ON "area"."id" = "issue"."area_id"
3360 WHERE "issue"."state" = 'admission';
3362 COMMENT ON VIEW "area_with_unaccepted_issues" IS 'All areas with unaccepted open issues (needed for issue admission system)';
3365 CREATE VIEW "issue_for_admission" AS
3366 SELECT DISTINCT ON ("issue"."area_id")
3367 "issue".*,
3368 max("initiative"."supporter_count") AS "max_supporter_count"
3369 FROM "issue"
3370 JOIN "policy" ON "issue"."policy_id" = "policy"."id"
3371 JOIN "initiative" ON "issue"."id" = "initiative"."issue_id"
3372 JOIN "area" ON "issue"."area_id" = "area"."id"
3373 WHERE "issue"."state" = 'admission'::"issue_state"
3374 AND now() >= "issue"."created" + "issue"."min_admission_time"
3375 AND "initiative"."supporter_count" >= "policy"."issue_quorum"
3376 AND "initiative"."supporter_count" * "policy"."issue_quorum_den" >=
3377 "issue"."population" * "policy"."issue_quorum_num"
3378 AND "initiative"."supporter_count" >= "area"."issue_quorum"
3379 AND "initiative"."revoked" ISNULL
3380 GROUP BY "issue"."id"
3381 ORDER BY "issue"."area_id", "max_supporter_count" DESC, "issue"."id";
3383 COMMENT ON VIEW "issue_for_admission" IS 'Contains up to 1 issue per area eligible to pass from ''admission'' to ''discussion'' state; needs to be recalculated after admitting the issue in this view';
3386 CREATE VIEW "unit_delegation" AS
3387 SELECT
3388 "unit"."id" AS "unit_id",
3389 "delegation"."id",
3390 "delegation"."truster_id",
3391 "delegation"."trustee_id",
3392 "delegation"."scope"
3393 FROM "unit"
3394 JOIN "delegation"
3395 ON "delegation"."unit_id" = "unit"."id"
3396 JOIN "member"
3397 ON "delegation"."truster_id" = "member"."id"
3398 JOIN "privilege"
3399 ON "delegation"."unit_id" = "privilege"."unit_id"
3400 AND "delegation"."truster_id" = "privilege"."member_id"
3401 WHERE "member"."active" AND "privilege"."voting_right";
3403 COMMENT ON VIEW "unit_delegation" IS 'Unit delegations where trusters are active and have voting right';
3406 CREATE VIEW "area_delegation" AS
3407 SELECT DISTINCT ON ("area"."id", "delegation"."truster_id")
3408 "area"."id" AS "area_id",
3409 "delegation"."id",
3410 "delegation"."truster_id",
3411 "delegation"."trustee_id",
3412 "delegation"."scope"
3413 FROM "area"
3414 JOIN "delegation"
3415 ON "delegation"."unit_id" = "area"."unit_id"
3416 OR "delegation"."area_id" = "area"."id"
3417 JOIN "member"
3418 ON "delegation"."truster_id" = "member"."id"
3419 JOIN "privilege"
3420 ON "area"."unit_id" = "privilege"."unit_id"
3421 AND "delegation"."truster_id" = "privilege"."member_id"
3422 WHERE "member"."active" AND "privilege"."voting_right"
3423 ORDER BY
3424 "area"."id",
3425 "delegation"."truster_id",
3426 "delegation"."scope" DESC;
3428 COMMENT ON VIEW "area_delegation" IS 'Area delegations where trusters are active and have voting right';
3431 CREATE VIEW "issue_delegation" AS
3432 SELECT DISTINCT ON ("issue"."id", "delegation"."truster_id")
3433 "issue"."id" AS "issue_id",
3434 "delegation"."id",
3435 "delegation"."truster_id",
3436 "delegation"."trustee_id",
3437 "delegation"."scope"
3438 FROM "issue"
3439 JOIN "area"
3440 ON "area"."id" = "issue"."area_id"
3441 JOIN "delegation"
3442 ON "delegation"."unit_id" = "area"."unit_id"
3443 OR "delegation"."area_id" = "area"."id"
3444 OR "delegation"."issue_id" = "issue"."id"
3445 JOIN "member"
3446 ON "delegation"."truster_id" = "member"."id"
3447 JOIN "privilege"
3448 ON "area"."unit_id" = "privilege"."unit_id"
3449 AND "delegation"."truster_id" = "privilege"."member_id"
3450 WHERE "member"."active" AND "privilege"."voting_right"
3451 ORDER BY
3452 "issue"."id",
3453 "delegation"."truster_id",
3454 "delegation"."scope" DESC;
3456 COMMENT ON VIEW "issue_delegation" IS 'Issue delegations where trusters are active and have voting right';
3459 CREATE VIEW "member_count_view" AS
3460 SELECT count(1) AS "total_count" FROM "member" WHERE "active";
3462 COMMENT ON VIEW "member_count_view" IS 'View used to update "member_count" table';
3465 CREATE VIEW "unit_member" AS
3466 SELECT
3467 "unit"."id" AS "unit_id",
3468 "member"."id" AS "member_id"
3469 FROM "privilege"
3470 JOIN "unit" ON "unit"."id" = "privilege"."unit_id"
3471 JOIN "member" ON "member"."id" = "privilege"."member_id"
3472 WHERE "privilege"."voting_right" AND "member"."active";
3474 COMMENT ON VIEW "unit_member" IS 'Active members with voting right in a unit';
3477 CREATE VIEW "unit_member_count" AS
3478 SELECT
3479 "unit"."id" AS "unit_id",
3480 count("unit_member"."member_id") AS "member_count"
3481 FROM "unit" LEFT JOIN "unit_member"
3482 ON "unit"."id" = "unit_member"."unit_id"
3483 GROUP BY "unit"."id";
3485 COMMENT ON VIEW "unit_member_count" IS 'View used to update "member_count" column of "unit" table';
3488 CREATE VIEW "opening_draft" AS
3489 SELECT DISTINCT ON ("initiative_id") * FROM "draft"
3490 ORDER BY "initiative_id", "id";
3492 COMMENT ON VIEW "opening_draft" IS 'First drafts of all initiatives';
3495 CREATE VIEW "current_draft" AS
3496 SELECT DISTINCT ON ("initiative_id") * FROM "draft"
3497 ORDER BY "initiative_id", "id" DESC;
3499 COMMENT ON VIEW "current_draft" IS 'All latest drafts for each initiative';
3502 CREATE VIEW "critical_opinion" AS
3503 SELECT * FROM "opinion"
3504 WHERE ("degree" = 2 AND "fulfilled" = FALSE)
3505 OR ("degree" = -2 AND "fulfilled" = TRUE);
3507 COMMENT ON VIEW "critical_opinion" IS 'Opinions currently causing dissatisfaction';
3510 CREATE VIEW "issue_supporter_in_admission_state" AS
3511 SELECT
3512 "area"."unit_id",
3513 "issue"."area_id",
3514 "issue"."id" AS "issue_id",
3515 "supporter"."member_id",
3516 "direct_interest_snapshot"."weight"
3517 FROM "issue"
3518 JOIN "area" ON "area"."id" = "issue"."area_id"
3519 JOIN "supporter" ON "supporter"."issue_id" = "issue"."id"
3520 JOIN "direct_interest_snapshot"
3521 ON "direct_interest_snapshot"."snapshot_id" = "issue"."latest_snapshot_id"
3522 AND "direct_interest_snapshot"."issue_id" = "issue"."id"
3523 AND "direct_interest_snapshot"."member_id" = "supporter"."member_id"
3524 WHERE "issue"."state" = 'admission'::"issue_state";
3526 COMMENT ON VIEW "issue_supporter_in_admission_state" IS 'Helper view for "lf_update_issue_order" to allow a (proportional) ordering of issues within an area';
3529 CREATE VIEW "initiative_suggestion_order_calculation" AS
3530 SELECT
3531 "initiative"."id" AS "initiative_id",
3532 ("issue"."closed" NOTNULL OR "issue"."fully_frozen" NOTNULL) AS "final"
3533 FROM "initiative" JOIN "issue"
3534 ON "initiative"."issue_id" = "issue"."id"
3535 WHERE ("issue"."closed" ISNULL AND "issue"."fully_frozen" ISNULL)
3536 OR ("initiative"."final_suggestion_order_calculated" = FALSE);
3538 COMMENT ON VIEW "initiative_suggestion_order_calculation" IS 'Initiatives, where the "proportional_order" of its suggestions has to be calculated';
3540 COMMENT ON COLUMN "initiative_suggestion_order_calculation"."final" IS 'Set to TRUE, if the issue is fully frozen or closed, and the calculation has to be done only once for one last time';
3543 CREATE VIEW "individual_suggestion_ranking" AS
3544 SELECT
3545 "opinion"."initiative_id",
3546 "opinion"."member_id",
3547 "direct_interest_snapshot"."weight",
3548 CASE WHEN
3549 ("opinion"."degree" = 2 AND "opinion"."fulfilled" = FALSE) OR
3550 ("opinion"."degree" = -2 AND "opinion"."fulfilled" = TRUE)
3551 THEN 1 ELSE
3552 CASE WHEN
3553 ("opinion"."degree" = 1 AND "opinion"."fulfilled" = FALSE) OR
3554 ("opinion"."degree" = -1 AND "opinion"."fulfilled" = TRUE)
3555 THEN 2 ELSE
3556 CASE WHEN
3557 ("opinion"."degree" = 2 AND "opinion"."fulfilled" = TRUE) OR
3558 ("opinion"."degree" = -2 AND "opinion"."fulfilled" = FALSE)
3559 THEN 3 ELSE 4 END
3560 END
3561 END AS "preference",
3562 "opinion"."suggestion_id"
3563 FROM "opinion"
3564 JOIN "initiative" ON "initiative"."id" = "opinion"."initiative_id"
3565 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
3566 JOIN "direct_interest_snapshot"
3567 ON "direct_interest_snapshot"."snapshot_id" = "issue"."latest_snapshot_id"
3568 AND "direct_interest_snapshot"."issue_id" = "issue"."id"
3569 AND "direct_interest_snapshot"."member_id" = "opinion"."member_id";
3571 COMMENT ON VIEW "individual_suggestion_ranking" IS 'Helper view for "lf_update_suggestion_order" to allow a proportional ordering of suggestions within an initiative';
3574 CREATE VIEW "battle_participant" AS
3575 SELECT "initiative"."id", "initiative"."issue_id"
3576 FROM "issue" JOIN "initiative"
3577 ON "issue"."id" = "initiative"."issue_id"
3578 WHERE "initiative"."admitted"
3579 UNION ALL
3580 SELECT NULL, "id" AS "issue_id"
3581 FROM "issue";
3583 COMMENT ON VIEW "battle_participant" IS 'Helper view for "battle_view" containing admitted initiatives plus virtual "status-quo" initiative denoted by NULL reference';
3586 CREATE VIEW "battle_view" AS
3587 SELECT
3588 "issue"."id" AS "issue_id",
3589 "winning_initiative"."id" AS "winning_initiative_id",
3590 "losing_initiative"."id" AS "losing_initiative_id",
3591 sum(
3592 CASE WHEN
3593 coalesce("better_vote"."grade", 0) >
3594 coalesce("worse_vote"."grade", 0)
3595 THEN "direct_voter"."weight" ELSE 0 END
3596 ) AS "count"
3597 FROM "issue"
3598 LEFT JOIN "direct_voter"
3599 ON "issue"."id" = "direct_voter"."issue_id"
3600 JOIN "battle_participant" AS "winning_initiative"
3601 ON "issue"."id" = "winning_initiative"."issue_id"
3602 JOIN "battle_participant" AS "losing_initiative"
3603 ON "issue"."id" = "losing_initiative"."issue_id"
3604 LEFT JOIN "vote" AS "better_vote"
3605 ON "direct_voter"."member_id" = "better_vote"."member_id"
3606 AND "winning_initiative"."id" = "better_vote"."initiative_id"
3607 LEFT JOIN "vote" AS "worse_vote"
3608 ON "direct_voter"."member_id" = "worse_vote"."member_id"
3609 AND "losing_initiative"."id" = "worse_vote"."initiative_id"
3610 WHERE "issue"."state" = 'voting'
3611 AND "issue"."phase_finished" NOTNULL
3612 AND (
3613 "winning_initiative"."id" != "losing_initiative"."id" OR
3614 ( ("winning_initiative"."id" NOTNULL AND "losing_initiative"."id" ISNULL) OR
3615 ("winning_initiative"."id" ISNULL AND "losing_initiative"."id" NOTNULL) ) )
3616 GROUP BY
3617 "issue"."id",
3618 "winning_initiative"."id",
3619 "losing_initiative"."id";
3621 COMMENT ON VIEW "battle_view" IS 'Number of members preferring one initiative (or status-quo) to another initiative (or status-quo); Used to fill "battle" table';
3624 CREATE VIEW "expired_session" AS
3625 SELECT * FROM "session" WHERE now() > "expiry";
3627 CREATE RULE "delete" AS ON DELETE TO "expired_session" DO INSTEAD
3628 DELETE FROM "session" WHERE "id" = OLD."id";
3630 COMMENT ON VIEW "expired_session" IS 'View containing all expired sessions where DELETE is possible';
3631 COMMENT ON RULE "delete" ON "expired_session" IS 'Rule allowing DELETE on rows in "expired_session" view, i.e. DELETE FROM "expired_session"';
3634 CREATE VIEW "expired_token" AS
3635 SELECT * FROM "token" WHERE now() > "expiry" AND NOT (
3636 "token_type" = 'authorization' AND "used" AND EXISTS (
3637 SELECT NULL FROM "token" AS "other"
3638 WHERE "other"."authorization_token_id" = "token"."id" ) );
3640 CREATE RULE "delete" AS ON DELETE TO "expired_token" DO INSTEAD
3641 DELETE FROM "token" WHERE "id" = OLD."id";
3643 COMMENT ON VIEW "expired_token" IS 'View containing all expired tokens where DELETE is possible; Note that used authorization codes must not be deleted if still referred to by other tokens';
3646 CREATE VIEW "unused_snapshot" AS
3647 SELECT "snapshot".* FROM "snapshot"
3648 LEFT JOIN "issue"
3649 ON "snapshot"."id" = "issue"."latest_snapshot_id"
3650 OR "snapshot"."id" = "issue"."admission_snapshot_id"
3651 OR "snapshot"."id" = "issue"."half_freeze_snapshot_id"
3652 OR "snapshot"."id" = "issue"."full_freeze_snapshot_id"
3653 WHERE "issue"."id" ISNULL;
3655 CREATE RULE "delete" AS ON DELETE TO "unused_snapshot" DO INSTEAD
3656 DELETE FROM "snapshot" WHERE "id" = OLD."id";
3658 COMMENT ON VIEW "unused_snapshot" IS 'Snapshots that are not referenced by any issue (either as latest snapshot or as snapshot at phase/state change)';
3661 CREATE VIEW "expired_snapshot" AS
3662 SELECT "unused_snapshot".* FROM "unused_snapshot" CROSS JOIN "system_setting"
3663 WHERE "unused_snapshot"."calculated" <
3664 now() - "system_setting"."snapshot_retention";
3666 CREATE RULE "delete" AS ON DELETE TO "expired_snapshot" DO INSTEAD
3667 DELETE FROM "snapshot" WHERE "id" = OLD."id";
3669 COMMENT ON VIEW "expired_snapshot" IS 'Contains "unused_snapshot"s that are older than "system_setting"."snapshot_retention" (for deletion)';
3672 CREATE VIEW "open_issue" AS
3673 SELECT * FROM "issue" WHERE "closed" ISNULL;
3675 COMMENT ON VIEW "open_issue" IS 'All open issues';
3678 CREATE VIEW "member_contingent" AS
3679 SELECT
3680 "member"."id" AS "member_id",
3681 "contingent"."polling",
3682 "contingent"."time_frame",
3683 CASE WHEN "contingent"."text_entry_limit" NOTNULL THEN
3684 (
3685 SELECT count(1) FROM "draft"
3686 JOIN "initiative" ON "initiative"."id" = "draft"."initiative_id"
3687 WHERE "draft"."author_id" = "member"."id"
3688 AND "initiative"."polling" = "contingent"."polling"
3689 AND "draft"."created" > now() - "contingent"."time_frame"
3690 ) + (
3691 SELECT count(1) FROM "suggestion"
3692 JOIN "initiative" ON "initiative"."id" = "suggestion"."initiative_id"
3693 WHERE "suggestion"."author_id" = "member"."id"
3694 AND "contingent"."polling" = FALSE
3695 AND "suggestion"."created" > now() - "contingent"."time_frame"
3696 )
3697 ELSE NULL END AS "text_entry_count",
3698 "contingent"."text_entry_limit",
3699 CASE WHEN "contingent"."initiative_limit" NOTNULL THEN (
3700 SELECT count(1) FROM "opening_draft" AS "draft"
3701 JOIN "initiative" ON "initiative"."id" = "draft"."initiative_id"
3702 WHERE "draft"."author_id" = "member"."id"
3703 AND "initiative"."polling" = "contingent"."polling"
3704 AND "draft"."created" > now() - "contingent"."time_frame"
3705 ) ELSE NULL END AS "initiative_count",
3706 "contingent"."initiative_limit"
3707 FROM "member" CROSS JOIN "contingent";
3709 COMMENT ON VIEW "member_contingent" IS 'Actual counts of text entries and initiatives are calculated per member for each limit in the "contingent" table.';
3711 COMMENT ON COLUMN "member_contingent"."text_entry_count" IS 'Only calculated when "text_entry_limit" is not null in the same row';
3712 COMMENT ON COLUMN "member_contingent"."initiative_count" IS 'Only calculated when "initiative_limit" is not null in the same row';
3715 CREATE VIEW "member_contingent_left" AS
3716 SELECT
3717 "member_id",
3718 "polling",
3719 max("text_entry_limit" - "text_entry_count") AS "text_entries_left",
3720 max("initiative_limit" - "initiative_count") AS "initiatives_left"
3721 FROM "member_contingent" GROUP BY "member_id", "polling";
3723 COMMENT ON VIEW "member_contingent_left" IS 'Amount of text entries or initiatives which can be posted now instantly by a member. This view should be used by a frontend to determine, if the contingent for posting is exhausted.';
3726 CREATE VIEW "event_for_notification" AS
3727 SELECT
3728 "member"."id" AS "recipient_id",
3729 "event".*
3730 FROM "member" CROSS JOIN "event"
3731 JOIN "issue" ON "issue"."id" = "event"."issue_id"
3732 JOIN "area" ON "area"."id" = "issue"."area_id"
3733 LEFT JOIN "privilege" ON
3734 "privilege"."member_id" = "member"."id" AND
3735 "privilege"."unit_id" = "area"."unit_id" AND
3736 "privilege"."voting_right" = TRUE
3737 LEFT JOIN "subscription" ON
3738 "subscription"."member_id" = "member"."id" AND
3739 "subscription"."unit_id" = "area"."unit_id"
3740 LEFT JOIN "ignored_area" ON
3741 "ignored_area"."member_id" = "member"."id" AND
3742 "ignored_area"."area_id" = "issue"."area_id"
3743 LEFT JOIN "interest" ON
3744 "interest"."member_id" = "member"."id" AND
3745 "interest"."issue_id" = "event"."issue_id"
3746 LEFT JOIN "supporter" ON
3747 "supporter"."member_id" = "member"."id" AND
3748 "supporter"."initiative_id" = "event"."initiative_id"
3749 WHERE ("privilege"."member_id" NOTNULL OR "subscription"."member_id" NOTNULL)
3750 AND ("ignored_area"."member_id" ISNULL OR "interest"."member_id" NOTNULL)
3751 AND (
3752 "event"."event" = 'issue_state_changed'::"event_type" OR
3753 ( "event"."event" = 'initiative_revoked'::"event_type" AND
3754 "supporter"."member_id" NOTNULL ) );
3756 COMMENT ON VIEW "event_for_notification" IS 'Entries of the "event" table which are of interest for a particular notification mail recipient';
3758 COMMENT ON COLUMN "event_for_notification"."recipient_id" IS 'member_id of the recipient of a notification mail';
3761 CREATE VIEW "updated_initiative" AS
3762 SELECT
3763 "supporter"."member_id" AS "recipient_id",
3764 FALSE AS "featured",
3765 "supporter"."initiative_id"
3766 FROM "supporter"
3767 JOIN "initiative" ON "supporter"."initiative_id" = "initiative"."id"
3768 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
3769 LEFT JOIN "notification_initiative_sent" AS "sent" ON
3770 "sent"."member_id" = "supporter"."member_id" AND
3771 "sent"."initiative_id" = "supporter"."initiative_id"
3772 LEFT JOIN "ignored_initiative" ON
3773 "ignored_initiative"."member_id" = "supporter"."member_id" AND
3774 "ignored_initiative"."initiative_id" = "supporter"."initiative_id"
3775 WHERE "issue"."state" IN ('admission', 'discussion')
3776 AND "initiative"."revoked" ISNULL
3777 AND "ignored_initiative"."member_id" ISNULL
3778 AND (
3779 EXISTS (
3780 SELECT NULL FROM "draft"
3781 LEFT JOIN "ignored_member" ON
3782 "ignored_member"."member_id" = "supporter"."member_id" AND
3783 "ignored_member"."other_member_id" = "draft"."author_id"
3784 WHERE "draft"."initiative_id" = "supporter"."initiative_id"
3785 AND "draft"."id" > "supporter"."draft_id"
3786 AND "ignored_member"."member_id" ISNULL
3787 ) OR EXISTS (
3788 SELECT NULL FROM "suggestion"
3789 LEFT JOIN "opinion" ON
3790 "opinion"."member_id" = "supporter"."member_id" AND
3791 "opinion"."suggestion_id" = "suggestion"."id"
3792 LEFT JOIN "ignored_member" ON
3793 "ignored_member"."member_id" = "supporter"."member_id" AND
3794 "ignored_member"."other_member_id" = "suggestion"."author_id"
3795 WHERE "suggestion"."initiative_id" = "supporter"."initiative_id"
3796 AND "opinion"."member_id" ISNULL
3797 AND COALESCE("suggestion"."id" > "sent"."last_suggestion_id", TRUE)
3798 AND "ignored_member"."member_id" ISNULL
3799 )
3800 );
3802 COMMENT ON VIEW "updated_initiative" IS 'Helper view for view "updated_or_featured_initiative"';
3805 CREATE FUNCTION "featured_initiative"
3806 ( "recipient_id_p" "member"."id"%TYPE,
3807 "area_id_p" "area"."id"%TYPE )
3808 RETURNS SETOF "initiative"."id"%TYPE
3809 LANGUAGE 'plpgsql' STABLE AS $$
3810 DECLARE
3811 "counter_v" "member"."notification_counter"%TYPE;
3812 "sample_size_v" "member"."notification_sample_size"%TYPE;
3813 "initiative_id_ary" INT4[]; --"initiative"."id"%TYPE[]
3814 "match_v" BOOLEAN;
3815 "member_id_v" "member"."id"%TYPE;
3816 "seed_v" TEXT;
3817 "initiative_id_v" "initiative"."id"%TYPE;
3818 BEGIN
3819 SELECT "notification_counter", "notification_sample_size"
3820 INTO "counter_v", "sample_size_v"
3821 FROM "member" WHERE "id" = "recipient_id_p";
3822 IF COALESCE("sample_size_v" <= 0, TRUE) THEN
3823 RETURN;
3824 END IF;
3825 "initiative_id_ary" := '{}';
3826 LOOP
3827 "match_v" := FALSE;
3828 FOR "member_id_v", "seed_v" IN
3829 SELECT * FROM (
3830 SELECT DISTINCT
3831 "supporter"."member_id",
3832 md5(
3833 "recipient_id_p" || '-' ||
3834 "counter_v" || '-' ||
3835 "area_id_p" || '-' ||
3836 "supporter"."member_id"
3837 ) AS "seed"
3838 FROM "supporter"
3839 JOIN "initiative" ON "initiative"."id" = "supporter"."initiative_id"
3840 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
3841 WHERE "supporter"."member_id" != "recipient_id_p"
3842 AND "issue"."area_id" = "area_id_p"
3843 AND "issue"."state" IN ('admission', 'discussion', 'verification')
3844 ) AS "subquery"
3845 ORDER BY "seed"
3846 LOOP
3847 SELECT "initiative"."id" INTO "initiative_id_v"
3848 FROM "initiative"
3849 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
3850 JOIN "area" ON "area"."id" = "issue"."area_id"
3851 JOIN "supporter" ON "supporter"."initiative_id" = "initiative"."id"
3852 LEFT JOIN "supporter" AS "self_support" ON
3853 "self_support"."initiative_id" = "initiative"."id" AND
3854 "self_support"."member_id" = "recipient_id_p"
3855 LEFT JOIN "privilege" ON
3856 "privilege"."member_id" = "recipient_id_p" AND
3857 "privilege"."unit_id" = "area"."unit_id" AND
3858 "privilege"."voting_right" = TRUE
3859 LEFT JOIN "subscription" ON
3860 "subscription"."member_id" = "recipient_id_p" AND
3861 "subscription"."unit_id" = "area"."unit_id"
3862 LEFT JOIN "ignored_initiative" ON
3863 "ignored_initiative"."member_id" = "recipient_id_p" AND
3864 "ignored_initiative"."initiative_id" = "initiative"."id"
3865 WHERE "supporter"."member_id" = "member_id_v"
3866 AND "issue"."area_id" = "area_id_p"
3867 AND "issue"."state" IN ('admission', 'discussion', 'verification')
3868 AND "initiative"."revoked" ISNULL
3869 AND "self_support"."member_id" ISNULL
3870 AND NOT "initiative_id_ary" @> ARRAY["initiative"."id"]
3871 AND (
3872 "privilege"."member_id" NOTNULL OR
3873 "subscription"."member_id" NOTNULL )
3874 AND "ignored_initiative"."member_id" ISNULL
3875 AND NOT EXISTS (
3876 SELECT NULL FROM "draft"
3877 JOIN "ignored_member" ON
3878 "ignored_member"."member_id" = "recipient_id_p" AND
3879 "ignored_member"."other_member_id" = "draft"."author_id"
3880 WHERE "draft"."initiative_id" = "initiative"."id"
3881 )
3882 ORDER BY md5("seed_v" || '-' || "initiative"."id")
3883 LIMIT 1;
3884 IF FOUND THEN
3885 "match_v" := TRUE;
3886 RETURN NEXT "initiative_id_v";
3887 IF array_length("initiative_id_ary", 1) + 1 >= "sample_size_v" THEN
3888 RETURN;
3889 END IF;
3890 "initiative_id_ary" := "initiative_id_ary" || "initiative_id_v";
3891 END IF;
3892 END LOOP;
3893 EXIT WHEN NOT "match_v";
3894 END LOOP;
3895 RETURN;
3896 END;
3897 $$;
3899 COMMENT ON FUNCTION "featured_initiative"
3900 ( "recipient_id_p" "member"."id"%TYPE,
3901 "area_id_p" "area"."id"%TYPE )
3902 IS 'Helper function for view "updated_or_featured_initiative"';
3905 CREATE VIEW "updated_or_featured_initiative" AS
3906 SELECT
3907 "subquery".*,
3908 NOT EXISTS (
3909 SELECT NULL FROM "initiative" AS "better_initiative"
3910 WHERE "better_initiative"."issue_id" = "initiative"."issue_id"
3911 AND
3912 ( COALESCE("better_initiative"."supporter_count", -1),
3913 -"better_initiative"."id" ) >
3914 ( COALESCE("initiative"."supporter_count", -1),
3915 -"initiative"."id" )
3916 ) AS "leading"
3917 FROM (
3918 SELECT * FROM "updated_initiative"
3919 UNION ALL
3920 SELECT
3921 "member"."id" AS "recipient_id",
3922 TRUE AS "featured",
3923 "featured_initiative_id" AS "initiative_id"
3924 FROM "member" CROSS JOIN "area"
3925 CROSS JOIN LATERAL
3926 "featured_initiative"("member"."id", "area"."id") AS "featured_initiative_id"
3927 JOIN "initiative" ON "initiative"."id" = "featured_initiative_id"
3928 ) AS "subquery"
3929 JOIN "initiative" ON "initiative"."id" = "subquery"."initiative_id";
3931 COMMENT ON VIEW "updated_or_featured_initiative" IS 'Initiatives to be included in a scheduled notification mail because (a) they have been updated or (b) they are featured';
3933 COMMENT ON COLUMN "updated_or_featured_initiative"."recipient_id" IS '"id" of the member who receives the notification mail';
3934 COMMENT ON COLUMN "updated_or_featured_initiative"."featured" IS 'TRUE if the initiative has been included because it was selected by the "featured_initiative" algorithm (see source of function "featured_initiative")';
3935 COMMENT ON COLUMN "updated_or_featured_initiative"."initiative_id" IS '"id" of the initiative to be included in the notification mail';
3936 COMMENT ON COLUMN "updated_or_featured_initiative"."leading" IS 'TRUE if the initiative has the highest "supporter_count" in the issue';
3939 CREATE VIEW "leading_complement_initiative" AS
3940 SELECT * FROM (
3941 SELECT DISTINCT ON ("uf_initiative"."recipient_id", "initiative"."issue_id")
3942 "uf_initiative"."recipient_id",
3943 FALSE AS "featured",
3944 "uf_initiative"."initiative_id",
3945 TRUE AS "leading"
3946 FROM "updated_or_featured_initiative" AS "uf_initiative"
3947 JOIN "initiative" AS "uf_initiative_full" ON
3948 "uf_initiative_full"."id" = "uf_initiative"."initiative_id"
3949 JOIN "initiative" ON
3950 "initiative"."issue_id" = "uf_initiative_full"."issue_id"
3951 WHERE "initiative"."revoked" ISNULL
3952 ORDER BY
3953 "uf_initiative"."recipient_id",
3954 "initiative"."issue_id",
3955 "initiative"."supporter_count" DESC,
3956 "initiative"."id"
3957 ) AS "subquery"
3958 WHERE NOT EXISTS (
3959 SELECT NULL FROM "updated_or_featured_initiative" AS "other"
3960 WHERE "other"."recipient_id" = "subquery"."recipient_id"
3961 AND "other"."initiative_id" = "subquery"."initiative_id"
3962 );
3964 COMMENT ON VIEW "leading_complement_initiative" IS 'Helper view for view "unfiltered_initiative_for_notification" in order to always include the most supported initiative of an issue';
3965 COMMENT ON COLUMN "leading_complement_initiative"."featured" IS 'Always FALSE in this view';
3966 COMMENT ON COLUMN "leading_complement_initiative"."initiative_id" IS '"id" of the initiative to be included in the notification mail';
3967 COMMENT ON COLUMN "leading_complement_initiative"."leading" IS 'Always TRUE in this view';
3970 CREATE VIEW "unfiltered_initiative_for_notification" AS
3971 SELECT
3972 "subquery".*,
3973 "supporter"."member_id" NOTNULL AS "supported",
3974 CASE WHEN "supporter"."member_id" NOTNULL THEN
3975 EXISTS (
3976 SELECT NULL FROM "draft"
3977 WHERE "draft"."initiative_id" = "subquery"."initiative_id"
3978 AND "draft"."id" > "supporter"."draft_id"
3979 )
3980 ELSE
3981 EXISTS (
3982 SELECT NULL FROM "draft"
3983 WHERE "draft"."initiative_id" = "subquery"."initiative_id"
3984 AND COALESCE("draft"."id" > "sent"."last_draft_id", TRUE)
3985 )
3986 END AS "new_draft",
3987 CASE WHEN "supporter"."member_id" NOTNULL THEN
3988 ( SELECT count(1) FROM "suggestion"
3989 LEFT JOIN "opinion" ON
3990 "opinion"."member_id" = "supporter"."member_id" AND
3991 "opinion"."suggestion_id" = "suggestion"."id"
3992 WHERE "suggestion"."initiative_id" = "subquery"."initiative_id"
3993 AND "opinion"."member_id" ISNULL
3994 AND COALESCE("suggestion"."id" > "sent"."last_suggestion_id", TRUE)
3995 )
3996 ELSE
3997 ( SELECT count(1) FROM "suggestion"
3998 WHERE "suggestion"."initiative_id" = "subquery"."initiative_id"
3999 AND COALESCE("suggestion"."id" > "sent"."last_suggestion_id", TRUE)
4000 )
4001 END AS "new_suggestion_count"
4002 FROM (
4003 SELECT * FROM "updated_or_featured_initiative"
4004 UNION ALL
4005 SELECT * FROM "leading_complement_initiative"
4006 ) AS "subquery"
4007 LEFT JOIN "supporter" ON
4008 "supporter"."member_id" = "subquery"."recipient_id" AND
4009 "supporter"."initiative_id" = "subquery"."initiative_id"
4010 LEFT JOIN "notification_initiative_sent" AS "sent" ON
4011 "sent"."member_id" = "subquery"."recipient_id" AND
4012 "sent"."initiative_id" = "subquery"."initiative_id";
4014 COMMENT ON VIEW "unfiltered_initiative_for_notification" IS 'Helper view which simply combines the views "updated_or_featured_initiative" and "leading_complement_initiative" and adds columns "supported", "new_draft", and "new_suggestion_count';
4016 COMMENT ON COLUMN "unfiltered_initiative_for_notification"."supported" IS 'TRUE if initiative is supported by the recipient';
4017 COMMENT ON COLUMN "unfiltered_initiative_for_notification"."new_draft" IS 'TRUE if a new draft exists (using the "draft_id" column of the "supporter" table in case of "supported" initiatives and the "last_draft_id" column of the "notification_initiative_sent" table in all other cases)';
4018 COMMENT ON COLUMN "unfiltered_initiative_for_notification"."new_suggestion_count" IS 'Number of new suggestions (using the "last_suggestion_id" column of the "notification_initiative_sent" table while ignoring suggestions with an "opinion")';
4021 CREATE VIEW "initiative_for_notification" AS
4022 SELECT "unfiltered1".*
4023 FROM "unfiltered_initiative_for_notification" "unfiltered1"
4024 JOIN "initiative" AS "initiative1" ON
4025 "initiative1"."id" = "unfiltered1"."initiative_id"
4026 JOIN "issue" AS "issue1" ON "issue1"."id" = "initiative1"."issue_id"
4027 WHERE EXISTS (
4028 SELECT NULL
4029 FROM "unfiltered_initiative_for_notification" "unfiltered2"
4030 JOIN "initiative" AS "initiative2" ON
4031 "initiative2"."id" = "unfiltered2"."initiative_id"
4032 JOIN "issue" AS "issue2" ON "issue2"."id" = "initiative2"."issue_id"
4033 WHERE "unfiltered1"."recipient_id" = "unfiltered2"."recipient_id"
4034 AND "issue1"."area_id" = "issue2"."area_id"
4035 AND ("unfiltered2"."new_draft" OR "unfiltered2"."new_suggestion_count" > 0 )
4036 );
4038 COMMENT ON VIEW "initiative_for_notification" IS 'Initiatives to be included in a scheduled notification mail';
4040 COMMENT ON COLUMN "initiative_for_notification"."recipient_id" IS '"id" of the member who receives the notification mail';
4041 COMMENT ON COLUMN "initiative_for_notification"."featured" IS 'TRUE if the initiative has been included because it was selected by the "featured_initiative" algorithm (see source of function "featured_initiative")';
4042 COMMENT ON COLUMN "initiative_for_notification"."initiative_id" IS '"id" of the initiative to be included in the notification mail';
4043 COMMENT ON COLUMN "initiative_for_notification"."leading" IS 'TRUE if the initiative has the highest "supporter_count" in the issue';
4044 COMMENT ON COLUMN "initiative_for_notification"."supported" IS 'TRUE if initiative is supported by the recipient';
4045 COMMENT ON COLUMN "initiative_for_notification"."new_draft" IS 'TRUE if a new draft exists (using the "draft_id" column of the "supporter" table in case of "supported" initiatives and the "last_draft_id" column of the "notification_initiative_sent" table in all other cases)';
4046 COMMENT ON COLUMN "initiative_for_notification"."new_suggestion_count" IS 'Number of new suggestions (using the "last_suggestion_id" column of the "notification_initiative_sent" table while ignoring suggestions with an "opinion")';
4049 CREATE VIEW "scheduled_notification_to_send" AS
4050 SELECT * FROM (
4051 SELECT
4052 "id" AS "recipient_id",
4053 now() - CASE WHEN "notification_dow" ISNULL THEN
4054 ( "notification_sent"::DATE + CASE
4055 WHEN EXTRACT(HOUR FROM "notification_sent") < "notification_hour"
4056 THEN 0 ELSE 1 END
4057 )::TIMESTAMP + '1 hour'::INTERVAL * "notification_hour"
4058 ELSE
4059 ( "notification_sent"::DATE +
4060 ( 7 + "notification_dow" -
4061 EXTRACT(DOW FROM
4062 ( "notification_sent"::DATE + CASE
4063 WHEN EXTRACT(HOUR FROM "notification_sent") < "notification_hour"
4064 THEN 0 ELSE 1 END
4065 )::TIMESTAMP + '1 hour'::INTERVAL * "notification_hour"
4066 )::INTEGER
4067 ) % 7 +
4068 CASE
4069 WHEN EXTRACT(HOUR FROM "notification_sent") < "notification_hour"
4070 THEN 0 ELSE 1
4071 END
4072 )::TIMESTAMP + '1 hour'::INTERVAL * "notification_hour"
4073 END AS "pending"
4074 FROM (
4075 SELECT
4076 "id",
4077 COALESCE("notification_sent", "activated") AS "notification_sent",
4078 "notification_dow",
4079 "notification_hour"
4080 FROM "member_to_notify"
4081 WHERE "notification_hour" NOTNULL
4082 ) AS "subquery1"
4083 ) AS "subquery2"
4084 WHERE "pending" > '0'::INTERVAL;
4086 COMMENT ON VIEW "scheduled_notification_to_send" IS 'Set of members where a scheduled notification mail is pending';
4088 COMMENT ON COLUMN "scheduled_notification_to_send"."recipient_id" IS '"id" of the member who needs to receive a notification mail';
4089 COMMENT ON COLUMN "scheduled_notification_to_send"."pending" IS 'Duration for which the notification mail has already been pending';
4092 CREATE VIEW "newsletter_to_send" AS
4093 SELECT
4094 "member"."id" AS "recipient_id",
4095 "newsletter"."id" AS "newsletter_id",
4096 "newsletter"."published"
4097 FROM "newsletter" CROSS JOIN "member_eligible_to_be_notified" AS "member"
4098 LEFT JOIN "privilege" ON
4099 "privilege"."member_id" = "member"."id" AND
4100 "privilege"."unit_id" = "newsletter"."unit_id" AND
4101 "privilege"."voting_right" = TRUE
4102 LEFT JOIN "subscription" ON
4103 "subscription"."member_id" = "member"."id" AND
4104 "subscription"."unit_id" = "newsletter"."unit_id"
4105 WHERE "newsletter"."published" <= now()
4106 AND "newsletter"."sent" ISNULL
4107 AND (
4108 "member"."disable_notifications" = FALSE OR
4109 "newsletter"."include_all_members" = TRUE )
4110 AND (
4111 "newsletter"."unit_id" ISNULL OR
4112 "privilege"."member_id" NOTNULL OR
4113 "subscription"."member_id" NOTNULL );
4115 COMMENT ON VIEW "newsletter_to_send" IS 'List of "newsletter_id"s for each member that are due to be sent out';
4117 COMMENT ON COLUMN "newsletter"."published" IS 'Timestamp when the newsletter was supposed to be sent out (can be used for ordering)';
4121 ------------------------------------------------------
4122 -- Row set returning function for delegation chains --
4123 ------------------------------------------------------
4126 CREATE TYPE "delegation_chain_loop_tag" AS ENUM
4127 ('first', 'intermediate', 'last', 'repetition');
4129 COMMENT ON TYPE "delegation_chain_loop_tag" IS 'Type for loop tags in "delegation_chain_row" type';
4132 CREATE TYPE "delegation_chain_row" AS (
4133 "index" INT4,
4134 "member_id" INT4,
4135 "member_valid" BOOLEAN,
4136 "participation" BOOLEAN,
4137 "overridden" BOOLEAN,
4138 "scope_in" "delegation_scope",
4139 "scope_out" "delegation_scope",
4140 "disabled_out" BOOLEAN,
4141 "loop" "delegation_chain_loop_tag" );
4143 COMMENT ON TYPE "delegation_chain_row" IS 'Type of rows returned by "delegation_chain" function';
4145 COMMENT ON COLUMN "delegation_chain_row"."index" IS 'Index starting with 0 and counting up';
4146 COMMENT ON COLUMN "delegation_chain_row"."participation" IS 'In case of delegation chains for issues: interest; for area and global delegation chains: always null';
4147 COMMENT ON COLUMN "delegation_chain_row"."overridden" IS 'True, if an entry with lower index has "participation" set to true';
4148 COMMENT ON COLUMN "delegation_chain_row"."scope_in" IS 'Scope of used incoming delegation';
4149 COMMENT ON COLUMN "delegation_chain_row"."scope_out" IS 'Scope of used outgoing delegation';
4150 COMMENT ON COLUMN "delegation_chain_row"."disabled_out" IS 'Outgoing delegation is explicitly disabled by a delegation with trustee_id set to NULL';
4151 COMMENT ON COLUMN "delegation_chain_row"."loop" IS 'Not null, if member is part of a loop, see "delegation_chain_loop_tag" type';
4154 CREATE FUNCTION "delegation_chain_for_closed_issue"
4155 ( "member_id_p" "member"."id"%TYPE,
4156 "issue_id_p" "issue"."id"%TYPE )
4157 RETURNS SETOF "delegation_chain_row"
4158 LANGUAGE 'plpgsql' STABLE AS $$
4159 DECLARE
4160 "output_row" "delegation_chain_row";
4161 "direct_voter_row" "direct_voter"%ROWTYPE;
4162 "delegating_voter_row" "delegating_voter"%ROWTYPE;
4163 BEGIN
4164 "output_row"."index" := 0;
4165 "output_row"."member_id" := "member_id_p";
4166 "output_row"."member_valid" := TRUE;
4167 "output_row"."participation" := FALSE;
4168 "output_row"."overridden" := FALSE;
4169 "output_row"."disabled_out" := FALSE;
4170 LOOP
4171 SELECT INTO "direct_voter_row" * FROM "direct_voter"
4172 WHERE "issue_id" = "issue_id_p"
4173 AND "member_id" = "output_row"."member_id";
4174 IF "direct_voter_row"."member_id" NOTNULL THEN
4175 "output_row"."participation" := TRUE;
4176 "output_row"."scope_out" := NULL;
4177 "output_row"."disabled_out" := NULL;
4178 RETURN NEXT "output_row";
4179 RETURN;
4180 END IF;
4181 SELECT INTO "delegating_voter_row" * FROM "delegating_voter"
4182 WHERE "issue_id" = "issue_id_p"
4183 AND "member_id" = "output_row"."member_id";
4184 IF "delegating_voter_row"."member_id" ISNULL THEN
4185 RETURN;
4186 END IF;
4187 "output_row"."scope_out" := "delegating_voter_row"."scope";
4188 RETURN NEXT "output_row";
4189 "output_row"."member_id" := "delegating_voter_row"."delegate_member_ids"[1];
4190 "output_row"."scope_in" := "output_row"."scope_out";
4191 END LOOP;
4192 END;
4193 $$;
4195 COMMENT ON FUNCTION "delegation_chain_for_closed_issue"
4196 ( "member"."id"%TYPE,
4197 "member"."id"%TYPE )
4198 IS 'Helper function for "delegation_chain" function, handling the special case of closed issues after voting';
4201 CREATE FUNCTION "delegation_chain"
4202 ( "member_id_p" "member"."id"%TYPE,
4203 "unit_id_p" "unit"."id"%TYPE,
4204 "area_id_p" "area"."id"%TYPE,
4205 "issue_id_p" "issue"."id"%TYPE,
4206 "simulate_trustee_id_p" "member"."id"%TYPE DEFAULT NULL,
4207 "simulate_default_p" BOOLEAN DEFAULT FALSE )
4208 RETURNS SETOF "delegation_chain_row"
4209 LANGUAGE 'plpgsql' STABLE AS $$
4210 DECLARE
4211 "scope_v" "delegation_scope";
4212 "unit_id_v" "unit"."id"%TYPE;
4213 "area_id_v" "area"."id"%TYPE;
4214 "issue_row" "issue"%ROWTYPE;
4215 "visited_member_ids" INT4[]; -- "member"."id"%TYPE[]
4216 "loop_member_id_v" "member"."id"%TYPE;
4217 "output_row" "delegation_chain_row";
4218 "output_rows" "delegation_chain_row"[];
4219 "simulate_v" BOOLEAN;
4220 "simulate_here_v" BOOLEAN;
4221 "delegation_row" "delegation"%ROWTYPE;
4222 "row_count" INT4;
4223 "i" INT4;
4224 "loop_v" BOOLEAN;
4225 BEGIN
4226 IF "simulate_trustee_id_p" NOTNULL AND "simulate_default_p" THEN
4227 RAISE EXCEPTION 'Both "simulate_trustee_id_p" is set, and "simulate_default_p" is true';
4228 END IF;
4229 IF "simulate_trustee_id_p" NOTNULL OR "simulate_default_p" THEN
4230 "simulate_v" := TRUE;
4231 ELSE
4232 "simulate_v" := FALSE;
4233 END IF;
4234 IF
4235 "unit_id_p" NOTNULL AND
4236 "area_id_p" ISNULL AND
4237 "issue_id_p" ISNULL
4238 THEN
4239 "scope_v" := 'unit';
4240 "unit_id_v" := "unit_id_p";
4241 ELSIF
4242 "unit_id_p" ISNULL AND
4243 "area_id_p" NOTNULL AND
4244 "issue_id_p" ISNULL
4245 THEN
4246 "scope_v" := 'area';
4247 "area_id_v" := "area_id_p";
4248 SELECT "unit_id" INTO "unit_id_v"
4249 FROM "area" WHERE "id" = "area_id_v";
4250 ELSIF
4251 "unit_id_p" ISNULL AND
4252 "area_id_p" ISNULL AND
4253 "issue_id_p" NOTNULL
4254 THEN
4255 SELECT INTO "issue_row" * FROM "issue" WHERE "id" = "issue_id_p";
4256 IF "issue_row"."id" ISNULL THEN
4257 RETURN;
4258 END IF;
4259 IF "issue_row"."closed" NOTNULL THEN
4260 IF "simulate_v" THEN
4261 RAISE EXCEPTION 'Tried to simulate delegation chain for closed issue.';
4262 END IF;
4263 FOR "output_row" IN
4264 SELECT * FROM
4265 "delegation_chain_for_closed_issue"("member_id_p", "issue_id_p")
4266 LOOP
4267 RETURN NEXT "output_row";
4268 END LOOP;
4269 RETURN;
4270 END IF;
4271 "scope_v" := 'issue';
4272 SELECT "area_id" INTO "area_id_v"
4273 FROM "issue" WHERE "id" = "issue_id_p";
4274 SELECT "unit_id" INTO "unit_id_v"
4275 FROM "area" WHERE "id" = "area_id_v";
4276 ELSE
4277 RAISE EXCEPTION 'Exactly one of unit_id_p, area_id_p, or issue_id_p must be NOTNULL.';
4278 END IF;
4279 "visited_member_ids" := '{}';
4280 "loop_member_id_v" := NULL;
4281 "output_rows" := '{}';
4282 "output_row"."index" := 0;
4283 "output_row"."member_id" := "member_id_p";
4284 "output_row"."member_valid" := TRUE;
4285 "output_row"."participation" := FALSE;
4286 "output_row"."overridden" := FALSE;
4287 "output_row"."disabled_out" := FALSE;
4288 "output_row"."scope_out" := NULL;
4289 LOOP
4290 IF "visited_member_ids" @> ARRAY["output_row"."member_id"] THEN
4291 "loop_member_id_v" := "output_row"."member_id";
4292 ELSE
4293 "visited_member_ids" :=
4294 "visited_member_ids" || "output_row"."member_id";
4295 END IF;
4296 IF "output_row"."participation" ISNULL THEN
4297 "output_row"."overridden" := NULL;
4298 ELSIF "output_row"."participation" THEN
4299 "output_row"."overridden" := TRUE;
4300 END IF;
4301 "output_row"."scope_in" := "output_row"."scope_out";
4302 "output_row"."member_valid" := EXISTS (
4303 SELECT NULL FROM "member" JOIN "privilege"
4304 ON "privilege"."member_id" = "member"."id"
4305 AND "privilege"."unit_id" = "unit_id_v"
4306 WHERE "id" = "output_row"."member_id"
4307 AND "member"."active" AND "privilege"."voting_right"
4308 );
4309 "simulate_here_v" := (
4310 "simulate_v" AND
4311 "output_row"."member_id" = "member_id_p"
4312 );
4313 "delegation_row" := ROW(NULL);
4314 IF "output_row"."member_valid" OR "simulate_here_v" THEN
4315 IF "scope_v" = 'unit' THEN
4316 IF NOT "simulate_here_v" THEN
4317 SELECT * INTO "delegation_row" FROM "delegation"
4318 WHERE "truster_id" = "output_row"."member_id"
4319 AND "unit_id" = "unit_id_v";
4320 END IF;
4321 ELSIF "scope_v" = 'area' THEN
4322 IF "simulate_here_v" THEN
4323 IF "simulate_trustee_id_p" ISNULL THEN
4324 SELECT * INTO "delegation_row" FROM "delegation"
4325 WHERE "truster_id" = "output_row"."member_id"
4326 AND "unit_id" = "unit_id_v";
4327 END IF;
4328 ELSE
4329 SELECT * INTO "delegation_row" FROM "delegation"
4330 WHERE "truster_id" = "output_row"."member_id"
4331 AND (
4332 "unit_id" = "unit_id_v" OR
4333 "area_id" = "area_id_v"
4334 )
4335 ORDER BY "scope" DESC;
4336 END IF;
4337 ELSIF "scope_v" = 'issue' THEN
4338 IF "issue_row"."fully_frozen" ISNULL THEN
4339 "output_row"."participation" := EXISTS (
4340 SELECT NULL FROM "interest"
4341 WHERE "issue_id" = "issue_id_p"
4342 AND "member_id" = "output_row"."member_id"
4343 );
4344 ELSE
4345 IF "output_row"."member_id" = "member_id_p" THEN
4346 "output_row"."participation" := EXISTS (
4347 SELECT NULL FROM "direct_voter"
4348 WHERE "issue_id" = "issue_id_p"
4349 AND "member_id" = "output_row"."member_id"
4350 );
4351 ELSE
4352 "output_row"."participation" := NULL;
4353 END IF;
4354 END IF;
4355 IF "simulate_here_v" THEN
4356 IF "simulate_trustee_id_p" ISNULL THEN
4357 SELECT * INTO "delegation_row" FROM "delegation"
4358 WHERE "truster_id" = "output_row"."member_id"
4359 AND (
4360 "unit_id" = "unit_id_v" OR
4361 "area_id" = "area_id_v"
4362 )
4363 ORDER BY "scope" DESC;
4364 END IF;
4365 ELSE
4366 SELECT * INTO "delegation_row" FROM "delegation"
4367 WHERE "truster_id" = "output_row"."member_id"
4368 AND (
4369 "unit_id" = "unit_id_v" OR
4370 "area_id" = "area_id_v" OR
4371 "issue_id" = "issue_id_p"
4372 )
4373 ORDER BY "scope" DESC;
4374 END IF;
4375 END IF;
4376 ELSE
4377 "output_row"."participation" := FALSE;
4378 END IF;
4379 IF "simulate_here_v" AND "simulate_trustee_id_p" NOTNULL THEN
4380 "output_row"."scope_out" := "scope_v";
4381 "output_rows" := "output_rows" || "output_row";
4382 "output_row"."member_id" := "simulate_trustee_id_p";
4383 ELSIF "delegation_row"."trustee_id" NOTNULL THEN
4384 "output_row"."scope_out" := "delegation_row"."scope";
4385 "output_rows" := "output_rows" || "output_row";
4386 "output_row"."member_id" := "delegation_row"."trustee_id";
4387 ELSIF "delegation_row"."scope" NOTNULL THEN
4388 "output_row"."scope_out" := "delegation_row"."scope";
4389 "output_row"."disabled_out" := TRUE;
4390 "output_rows" := "output_rows" || "output_row";
4391 EXIT;
4392 ELSE
4393 "output_row"."scope_out" := NULL;
4394 "output_rows" := "output_rows" || "output_row";
4395 EXIT;
4396 END IF;
4397 EXIT WHEN "loop_member_id_v" NOTNULL;
4398 "output_row"."index" := "output_row"."index" + 1;
4399 END LOOP;
4400 "row_count" := array_upper("output_rows", 1);
4401 "i" := 1;
4402 "loop_v" := FALSE;
4403 LOOP
4404 "output_row" := "output_rows"["i"];
4405 EXIT WHEN "output_row" ISNULL; -- NOTE: ISNULL and NOT ... NOTNULL produce different results!
4406 IF "loop_v" THEN
4407 IF "i" + 1 = "row_count" THEN
4408 "output_row"."loop" := 'last';
4409 ELSIF "i" = "row_count" THEN
4410 "output_row"."loop" := 'repetition';
4411 ELSE
4412 "output_row"."loop" := 'intermediate';
4413 END IF;
4414 ELSIF "output_row"."member_id" = "loop_member_id_v" THEN
4415 "output_row"."loop" := 'first';
4416 "loop_v" := TRUE;
4417 END IF;
4418 IF "scope_v" = 'unit' THEN
4419 "output_row"."participation" := NULL;
4420 END IF;
4421 RETURN NEXT "output_row";
4422 "i" := "i" + 1;
4423 END LOOP;
4424 RETURN;
4425 END;
4426 $$;
4428 COMMENT ON FUNCTION "delegation_chain"
4429 ( "member"."id"%TYPE,
4430 "unit"."id"%TYPE,
4431 "area"."id"%TYPE,
4432 "issue"."id"%TYPE,
4433 "member"."id"%TYPE,
4434 BOOLEAN )
4435 IS 'Shows a delegation chain for unit, area, or issue; See "delegation_chain_row" type for more information';
4439 ---------------------------------------------------------
4440 -- Single row returning function for delegation chains --
4441 ---------------------------------------------------------
4444 CREATE TYPE "delegation_info_loop_type" AS ENUM
4445 ('own', 'first', 'first_ellipsis', 'other', 'other_ellipsis');
4447 COMMENT ON TYPE "delegation_info_loop_type" IS 'Type of "delegation_loop" in "delegation_info_type"; ''own'' means loop to self, ''first'' means loop to first trustee, ''first_ellipsis'' means loop to ellipsis after first trustee, ''other'' means loop to other trustee, ''other_ellipsis'' means loop to ellipsis after other trustee''';
4450 CREATE TYPE "delegation_info_type" AS (
4451 "own_participation" BOOLEAN,
4452 "own_delegation_scope" "delegation_scope",
4453 "first_trustee_id" INT4,
4454 "first_trustee_participation" BOOLEAN,
4455 "first_trustee_ellipsis" BOOLEAN,
4456 "other_trustee_id" INT4,
4457 "other_trustee_participation" BOOLEAN,
4458 "other_trustee_ellipsis" BOOLEAN,
4459 "delegation_loop" "delegation_info_loop_type",
4460 "participating_member_id" INT4 );
4462 COMMENT ON TYPE "delegation_info_type" IS 'Type of result returned by "delegation_info" function; For meaning of "participation" check comment on "delegation_chain_row" type';
4464 COMMENT ON COLUMN "delegation_info_type"."own_participation" IS 'Member is directly participating';
4465 COMMENT ON COLUMN "delegation_info_type"."own_delegation_scope" IS 'Delegation scope of member';
4466 COMMENT ON COLUMN "delegation_info_type"."first_trustee_id" IS 'Direct trustee of member';
4467 COMMENT ON COLUMN "delegation_info_type"."first_trustee_participation" IS 'Direct trustee of member is participating';
4468 COMMENT ON COLUMN "delegation_info_type"."first_trustee_ellipsis" IS 'Ellipsis in delegation chain after "first_trustee"';
4469 COMMENT ON COLUMN "delegation_info_type"."other_trustee_id" IS 'Another relevant trustee (due to participation)';
4470 COMMENT ON COLUMN "delegation_info_type"."other_trustee_participation" IS 'Another trustee is participating (redundant field: if "other_trustee_id" is set, then "other_trustee_participation" is always TRUE, else "other_trustee_participation" is NULL)';
4471 COMMENT ON COLUMN "delegation_info_type"."other_trustee_ellipsis" IS 'Ellipsis in delegation chain after "other_trustee"';
4472 COMMENT ON COLUMN "delegation_info_type"."delegation_loop" IS 'Non-NULL value, if delegation chain contains a circle; See comment on "delegation_info_loop_type" for details';
4473 COMMENT ON COLUMN "delegation_info_type"."participating_member_id" IS 'First participating member in delegation chain';
4476 CREATE FUNCTION "delegation_info"
4477 ( "member_id_p" "member"."id"%TYPE,
4478 "unit_id_p" "unit"."id"%TYPE,
4479 "area_id_p" "area"."id"%TYPE,
4480 "issue_id_p" "issue"."id"%TYPE,
4481 "simulate_trustee_id_p" "member"."id"%TYPE DEFAULT NULL,
4482 "simulate_default_p" BOOLEAN DEFAULT FALSE )
4483 RETURNS "delegation_info_type"
4484 LANGUAGE 'plpgsql' STABLE AS $$
4485 DECLARE
4486 "current_row" "delegation_chain_row";
4487 "result" "delegation_info_type";
4488 BEGIN
4489 "result"."own_participation" := FALSE;
4490 FOR "current_row" IN
4491 SELECT * FROM "delegation_chain"(
4492 "member_id_p",
4493 "unit_id_p", "area_id_p", "issue_id_p",
4494 "simulate_trustee_id_p", "simulate_default_p")
4495 LOOP
4496 IF
4497 "result"."participating_member_id" ISNULL AND
4498 "current_row"."participation"
4499 THEN
4500 "result"."participating_member_id" := "current_row"."member_id";
4501 END IF;
4502 IF "current_row"."member_id" = "member_id_p" THEN
4503 "result"."own_participation" := "current_row"."participation";
4504 "result"."own_delegation_scope" := "current_row"."scope_out";
4505 IF "current_row"."loop" = 'first' THEN
4506 "result"."delegation_loop" := 'own';
4507 END IF;
4508 ELSIF
4509 "current_row"."member_valid" AND
4510 ( "current_row"."loop" ISNULL OR
4511 "current_row"."loop" != 'repetition' )
4512 THEN
4513 IF "result"."first_trustee_id" ISNULL THEN
4514 "result"."first_trustee_id" := "current_row"."member_id";
4515 "result"."first_trustee_participation" := "current_row"."participation";
4516 "result"."first_trustee_ellipsis" := FALSE;
4517 IF "current_row"."loop" = 'first' THEN
4518 "result"."delegation_loop" := 'first';
4519 END IF;
4520 ELSIF "result"."other_trustee_id" ISNULL THEN
4521 IF "current_row"."participation" AND NOT "current_row"."overridden" THEN
4522 "result"."other_trustee_id" := "current_row"."member_id";
4523 "result"."other_trustee_participation" := TRUE;
4524 "result"."other_trustee_ellipsis" := FALSE;
4525 IF "current_row"."loop" = 'first' THEN
4526 "result"."delegation_loop" := 'other';
4527 END IF;
4528 ELSE
4529 "result"."first_trustee_ellipsis" := TRUE;
4530 IF "current_row"."loop" = 'first' THEN
4531 "result"."delegation_loop" := 'first_ellipsis';
4532 END IF;
4533 END IF;
4534 ELSE
4535 "result"."other_trustee_ellipsis" := TRUE;
4536 IF "current_row"."loop" = 'first' THEN
4537 "result"."delegation_loop" := 'other_ellipsis';
4538 END IF;
4539 END IF;
4540 END IF;
4541 END LOOP;
4542 RETURN "result";
4543 END;
4544 $$;
4546 COMMENT ON FUNCTION "delegation_info"
4547 ( "member"."id"%TYPE,
4548 "unit"."id"%TYPE,
4549 "area"."id"%TYPE,
4550 "issue"."id"%TYPE,
4551 "member"."id"%TYPE,
4552 BOOLEAN )
4553 IS 'Notable information about a delegation chain for unit, area, or issue; See "delegation_info_type" for more information';
4557 ---------------------------
4558 -- Transaction isolation --
4559 ---------------------------
4562 CREATE FUNCTION "require_transaction_isolation"()
4563 RETURNS VOID
4564 LANGUAGE 'plpgsql' VOLATILE AS $$
4565 BEGIN
4566 IF
4567 current_setting('transaction_isolation') NOT IN
4568 ('repeatable read', 'serializable')
4569 THEN
4570 RAISE EXCEPTION 'Insufficient transaction isolation level' USING
4571 HINT = 'Consider using SET TRANSACTION ISOLATION LEVEL REPEATABLE READ.';
4572 END IF;
4573 RETURN;
4574 END;
4575 $$;
4577 COMMENT ON FUNCTION "require_transaction_isolation"() IS 'Throws an exception, if transaction isolation level is too low to provide a consistent snapshot';
4580 CREATE FUNCTION "dont_require_transaction_isolation"()
4581 RETURNS VOID
4582 LANGUAGE 'plpgsql' VOLATILE AS $$
4583 BEGIN
4584 IF
4585 current_setting('transaction_isolation') IN
4586 ('repeatable read', 'serializable')
4587 THEN
4588 RAISE WARNING 'Unneccessary transaction isolation level: %',
4589 current_setting('transaction_isolation');
4590 END IF;
4591 RETURN;
4592 END;
4593 $$;
4595 COMMENT ON FUNCTION "dont_require_transaction_isolation"() IS 'Raises a warning, if transaction isolation level is higher than READ COMMITTED';
4599 -------------------------
4600 -- Notification system --
4601 -------------------------
4603 CREATE FUNCTION "get_initiatives_for_notification"
4604 ( "recipient_id_p" "member"."id"%TYPE )
4605 RETURNS SETOF "initiative_for_notification"
4606 LANGUAGE 'plpgsql' VOLATILE AS $$
4607 DECLARE
4608 "result_row" "initiative_for_notification"%ROWTYPE;
4609 "last_draft_id_v" "draft"."id"%TYPE;
4610 "last_suggestion_id_v" "suggestion"."id"%TYPE;
4611 BEGIN
4612 PERFORM "require_transaction_isolation"();
4613 PERFORM NULL FROM "member" WHERE "id" = "recipient_id_p" FOR UPDATE;
4614 FOR "result_row" IN
4615 SELECT * FROM "initiative_for_notification"
4616 WHERE "recipient_id" = "recipient_id_p"
4617 LOOP
4618 SELECT "id" INTO "last_draft_id_v" FROM "draft"
4619 WHERE "draft"."initiative_id" = "result_row"."initiative_id"
4620 ORDER BY "id" DESC LIMIT 1;
4621 SELECT "id" INTO "last_suggestion_id_v" FROM "suggestion"
4622 WHERE "suggestion"."initiative_id" = "result_row"."initiative_id"
4623 ORDER BY "id" DESC LIMIT 1;
4624 INSERT INTO "notification_initiative_sent"
4625 ("member_id", "initiative_id", "last_draft_id", "last_suggestion_id")
4626 VALUES (
4627 "recipient_id_p",
4628 "result_row"."initiative_id",
4629 "last_draft_id_v",
4630 "last_suggestion_id_v" )
4631 ON CONFLICT ("member_id", "initiative_id") DO UPDATE SET
4632 "last_draft_id" = "last_draft_id_v",
4633 "last_suggestion_id" = "last_suggestion_id_v";
4634 RETURN NEXT "result_row";
4635 END LOOP;
4636 DELETE FROM "notification_initiative_sent"
4637 USING "initiative", "issue"
4638 WHERE "notification_initiative_sent"."member_id" = "recipient_id_p"
4639 AND "initiative"."id" = "notification_initiative_sent"."initiative_id"
4640 AND "issue"."id" = "initiative"."issue_id"
4641 AND ( "issue"."closed" NOTNULL OR "issue"."fully_frozen" NOTNULL );
4642 UPDATE "member" SET
4643 "notification_counter" = "notification_counter" + 1,
4644 "notification_sent" = now()
4645 WHERE "id" = "recipient_id_p";
4646 RETURN;
4647 END;
4648 $$;
4650 COMMENT ON FUNCTION "get_initiatives_for_notification"
4651 ( "member"."id"%TYPE )
4652 IS 'Returns rows from view "initiative_for_notification" for a given recipient while updating table "notification_initiative_sent" and columns "notification_counter" and "notification_sent" of "member" table';
4656 ------------------------------------------------------------------------
4657 -- Regular tasks, except calculcation of snapshots and voting results --
4658 ------------------------------------------------------------------------
4661 CREATE FUNCTION "check_activity"()
4662 RETURNS VOID
4663 LANGUAGE 'plpgsql' VOLATILE AS $$
4664 DECLARE
4665 "system_setting_row" "system_setting"%ROWTYPE;
4666 BEGIN
4667 PERFORM "dont_require_transaction_isolation"();
4668 SELECT * INTO "system_setting_row" FROM "system_setting";
4669 IF "system_setting_row"."member_ttl" NOTNULL THEN
4670 UPDATE "member" SET "active" = FALSE
4671 WHERE "active" = TRUE
4672 AND "last_activity" < (now() - "system_setting_row"."member_ttl")::DATE;
4673 END IF;
4674 RETURN;
4675 END;
4676 $$;
4678 COMMENT ON FUNCTION "check_activity"() IS 'Deactivates members when "last_activity" is older than "system_setting"."member_ttl".';
4681 CREATE FUNCTION "calculate_member_counts"()
4682 RETURNS VOID
4683 LANGUAGE 'plpgsql' VOLATILE AS $$
4684 BEGIN
4685 PERFORM "require_transaction_isolation"();
4686 DELETE FROM "member_count";
4687 INSERT INTO "member_count" ("total_count")
4688 SELECT "total_count" FROM "member_count_view";
4689 UPDATE "unit" SET "member_count" = "view"."member_count"
4690 FROM "unit_member_count" AS "view"
4691 WHERE "view"."unit_id" = "unit"."id";
4692 RETURN;
4693 END;
4694 $$;
4696 COMMENT ON FUNCTION "calculate_member_counts"() IS 'Updates "member_count" table and "member_count" column of table "area" by materializing data from views "member_count_view" and "unit_member_count"';
4700 ------------------------------------
4701 -- Calculation of harmonic weight --
4702 ------------------------------------
4705 CREATE VIEW "remaining_harmonic_supporter_weight" AS
4706 SELECT
4707 "direct_interest_snapshot"."snapshot_id",
4708 "direct_interest_snapshot"."issue_id",
4709 "direct_interest_snapshot"."member_id",
4710 "direct_interest_snapshot"."weight" AS "weight_num",
4711 count("initiative"."id") AS "weight_den"
4712 FROM "issue"
4713 JOIN "direct_interest_snapshot"
4714 ON "issue"."latest_snapshot_id" = "direct_interest_snapshot"."snapshot_id"
4715 AND "issue"."id" = "direct_interest_snapshot"."issue_id"
4716 JOIN "initiative"
4717 ON "issue"."id" = "initiative"."issue_id"
4718 AND "initiative"."harmonic_weight" ISNULL
4719 JOIN "direct_supporter_snapshot"
4720 ON "issue"."latest_snapshot_id" = "direct_supporter_snapshot"."snapshot_id"
4721 AND "initiative"."id" = "direct_supporter_snapshot"."initiative_id"
4722 AND "direct_interest_snapshot"."member_id" = "direct_supporter_snapshot"."member_id"
4723 AND (
4724 "direct_supporter_snapshot"."satisfied" = TRUE OR
4725 coalesce("initiative"."admitted", FALSE) = FALSE
4726 )
4727 GROUP BY
4728 "direct_interest_snapshot"."snapshot_id",
4729 "direct_interest_snapshot"."issue_id",
4730 "direct_interest_snapshot"."member_id",
4731 "direct_interest_snapshot"."weight";
4733 COMMENT ON VIEW "remaining_harmonic_supporter_weight" IS 'Helper view for function "set_harmonic_initiative_weights"';
4736 CREATE VIEW "remaining_harmonic_initiative_weight_summands" AS
4737 SELECT
4738 "initiative"."issue_id",
4739 "initiative"."id" AS "initiative_id",
4740 "initiative"."admitted",
4741 sum("remaining_harmonic_supporter_weight"."weight_num") AS "weight_num",
4742 "remaining_harmonic_supporter_weight"."weight_den"
4743 FROM "remaining_harmonic_supporter_weight"
4744 JOIN "initiative"
4745 ON "remaining_harmonic_supporter_weight"."issue_id" = "initiative"."issue_id"
4746 AND "initiative"."harmonic_weight" ISNULL
4747 JOIN "direct_supporter_snapshot"
4748 ON "remaining_harmonic_supporter_weight"."snapshot_id" = "direct_supporter_snapshot"."snapshot_id"
4749 AND "initiative"."id" = "direct_supporter_snapshot"."initiative_id"
4750 AND "remaining_harmonic_supporter_weight"."member_id" = "direct_supporter_snapshot"."member_id"
4751 AND (
4752 "direct_supporter_snapshot"."satisfied" = TRUE OR
4753 coalesce("initiative"."admitted", FALSE) = FALSE
4754 )
4755 GROUP BY
4756 "initiative"."issue_id",
4757 "initiative"."id",
4758 "initiative"."admitted",
4759 "remaining_harmonic_supporter_weight"."weight_den";
4761 COMMENT ON VIEW "remaining_harmonic_initiative_weight_summands" IS 'Helper view for function "set_harmonic_initiative_weights"';
4764 CREATE VIEW "remaining_harmonic_initiative_weight_dummies" AS
4765 SELECT
4766 "issue_id",
4767 "id" AS "initiative_id",
4768 "admitted",
4769 0 AS "weight_num",
4770 1 AS "weight_den"
4771 FROM "initiative"
4772 WHERE "harmonic_weight" ISNULL;
4774 COMMENT ON VIEW "remaining_harmonic_initiative_weight_dummies" IS 'Helper view for function "set_harmonic_initiative_weights" providing dummy weights of zero value, which are needed for corner cases where there are no supporters for an initiative at all';
4777 CREATE FUNCTION "set_harmonic_initiative_weights"
4778 ( "issue_id_p" "issue"."id"%TYPE )
4779 RETURNS VOID
4780 LANGUAGE 'plpgsql' VOLATILE AS $$
4781 DECLARE
4782 "weight_row" "remaining_harmonic_initiative_weight_summands"%ROWTYPE;
4783 "i" INT4;
4784 "count_v" INT4;
4785 "summand_v" FLOAT;
4786 "id_ary" INT4[];
4787 "weight_ary" FLOAT[];
4788 "min_weight_v" FLOAT;
4789 BEGIN
4790 PERFORM "require_transaction_isolation"();
4791 UPDATE "initiative" SET "harmonic_weight" = NULL
4792 WHERE "issue_id" = "issue_id_p";
4793 LOOP
4794 "min_weight_v" := NULL;
4795 "i" := 0;
4796 "count_v" := 0;
4797 FOR "weight_row" IN
4798 SELECT * FROM "remaining_harmonic_initiative_weight_summands"
4799 WHERE "issue_id" = "issue_id_p"
4800 AND (
4801 coalesce("admitted", FALSE) = FALSE OR NOT EXISTS (
4802 SELECT NULL FROM "initiative"
4803 WHERE "issue_id" = "issue_id_p"
4804 AND "harmonic_weight" ISNULL
4805 AND coalesce("admitted", FALSE) = FALSE
4806 )
4807 )
4808 UNION ALL -- needed for corner cases
4809 SELECT * FROM "remaining_harmonic_initiative_weight_dummies"
4810 WHERE "issue_id" = "issue_id_p"
4811 AND (
4812 coalesce("admitted", FALSE) = FALSE OR NOT EXISTS (
4813 SELECT NULL FROM "initiative"
4814 WHERE "issue_id" = "issue_id_p"
4815 AND "harmonic_weight" ISNULL
4816 AND coalesce("admitted", FALSE) = FALSE
4817 )
4818 )
4819 ORDER BY "initiative_id" DESC, "weight_den" DESC
4820 -- NOTE: non-admitted initiatives placed first (at last positions),
4821 -- latest initiatives treated worse in case of tie
4822 LOOP
4823 "summand_v" := "weight_row"."weight_num"::FLOAT / "weight_row"."weight_den"::FLOAT;
4824 IF "i" = 0 OR "weight_row"."initiative_id" != "id_ary"["i"] THEN
4825 "i" := "i" + 1;
4826 "count_v" := "i";
4827 "id_ary"["i"] := "weight_row"."initiative_id";
4828 "weight_ary"["i"] := "summand_v";
4829 ELSE
4830 "weight_ary"["i"] := "weight_ary"["i"] + "summand_v";
4831 END IF;
4832 END LOOP;
4833 EXIT WHEN "count_v" = 0;
4834 "i" := 1;
4835 LOOP
4836 "weight_ary"["i"] := "weight_ary"["i"]::NUMERIC(18,9)::NUMERIC(12,3);
4837 IF "min_weight_v" ISNULL OR "weight_ary"["i"] < "min_weight_v" THEN
4838 "min_weight_v" := "weight_ary"["i"];
4839 END IF;
4840 "i" := "i" + 1;
4841 EXIT WHEN "i" > "count_v";
4842 END LOOP;
4843 "i" := 1;
4844 LOOP
4845 IF "weight_ary"["i"] = "min_weight_v" THEN
4846 UPDATE "initiative" SET "harmonic_weight" = "min_weight_v"
4847 WHERE "id" = "id_ary"["i"];
4848 EXIT;
4849 END IF;
4850 "i" := "i" + 1;
4851 END LOOP;
4852 END LOOP;
4853 UPDATE "initiative" SET "harmonic_weight" = 0
4854 WHERE "issue_id" = "issue_id_p" AND "harmonic_weight" ISNULL;
4855 END;
4856 $$;
4858 COMMENT ON FUNCTION "set_harmonic_initiative_weights"
4859 ( "issue"."id"%TYPE )
4860 IS 'Calculates and sets "harmonic_weight" of initiatives in a given issue';
4864 ------------------------------
4865 -- Calculation of snapshots --
4866 ------------------------------
4869 CREATE FUNCTION "weight_of_added_delegations_for_snapshot"
4870 ( "snapshot_id_p" "snapshot"."id"%TYPE,
4871 "issue_id_p" "issue"."id"%TYPE,
4872 "member_id_p" "member"."id"%TYPE,
4873 "delegate_member_ids_p" "delegating_interest_snapshot"."delegate_member_ids"%TYPE )
4874 RETURNS "direct_interest_snapshot"."weight"%TYPE
4875 LANGUAGE 'plpgsql' VOLATILE AS $$
4876 DECLARE
4877 "issue_delegation_row" "issue_delegation"%ROWTYPE;
4878 "delegate_member_ids_v" "delegating_interest_snapshot"."delegate_member_ids"%TYPE;
4879 "weight_v" INT4;
4880 "sub_weight_v" INT4;
4881 BEGIN
4882 PERFORM "require_transaction_isolation"();
4883 "weight_v" := 0;
4884 FOR "issue_delegation_row" IN
4885 SELECT * FROM "issue_delegation"
4886 WHERE "trustee_id" = "member_id_p"
4887 AND "issue_id" = "issue_id_p"
4888 LOOP
4889 IF NOT EXISTS (
4890 SELECT NULL FROM "direct_interest_snapshot"
4891 WHERE "snapshot_id" = "snapshot_id_p"
4892 AND "issue_id" = "issue_id_p"
4893 AND "member_id" = "issue_delegation_row"."truster_id"
4894 ) AND NOT EXISTS (
4895 SELECT NULL FROM "delegating_interest_snapshot"
4896 WHERE "snapshot_id" = "snapshot_id_p"
4897 AND "issue_id" = "issue_id_p"
4898 AND "member_id" = "issue_delegation_row"."truster_id"
4899 ) THEN
4900 "delegate_member_ids_v" :=
4901 "member_id_p" || "delegate_member_ids_p";
4902 INSERT INTO "delegating_interest_snapshot" (
4903 "snapshot_id",
4904 "issue_id",
4905 "member_id",
4906 "scope",
4907 "delegate_member_ids"
4908 ) VALUES (
4909 "snapshot_id_p",
4910 "issue_id_p",
4911 "issue_delegation_row"."truster_id",
4912 "issue_delegation_row"."scope",
4913 "delegate_member_ids_v"
4914 );
4915 "sub_weight_v" := 1 +
4916 "weight_of_added_delegations_for_snapshot"(
4917 "snapshot_id_p",
4918 "issue_id_p",
4919 "issue_delegation_row"."truster_id",
4920 "delegate_member_ids_v"
4921 );
4922 UPDATE "delegating_interest_snapshot"
4923 SET "weight" = "sub_weight_v"
4924 WHERE "snapshot_id" = "snapshot_id_p"
4925 AND "issue_id" = "issue_id_p"
4926 AND "member_id" = "issue_delegation_row"."truster_id";
4927 "weight_v" := "weight_v" + "sub_weight_v";
4928 END IF;
4929 END LOOP;
4930 RETURN "weight_v";
4931 END;
4932 $$;
4934 COMMENT ON FUNCTION "weight_of_added_delegations_for_snapshot"
4935 ( "snapshot"."id"%TYPE,
4936 "issue"."id"%TYPE,
4937 "member"."id"%TYPE,
4938 "delegating_interest_snapshot"."delegate_member_ids"%TYPE )
4939 IS 'Helper function for "fill_snapshot" function';
4942 CREATE FUNCTION "take_snapshot"
4943 ( "issue_id_p" "issue"."id"%TYPE,
4944 "area_id_p" "area"."id"%TYPE = NULL )
4945 RETURNS "snapshot"."id"%TYPE
4946 LANGUAGE 'plpgsql' VOLATILE AS $$
4947 DECLARE
4948 "area_id_v" "area"."id"%TYPE;
4949 "unit_id_v" "unit"."id"%TYPE;
4950 "snapshot_id_v" "snapshot"."id"%TYPE;
4951 "issue_id_v" "issue"."id"%TYPE;
4952 "member_id_v" "member"."id"%TYPE;
4953 BEGIN
4954 IF "issue_id_p" NOTNULL AND "area_id_p" NOTNULL THEN
4955 RAISE EXCEPTION 'One of "issue_id_p" and "area_id_p" must be NULL';
4956 END IF;
4957 PERFORM "require_transaction_isolation"();
4958 IF "issue_id_p" ISNULL THEN
4959 "area_id_v" := "area_id_p";
4960 ELSE
4961 SELECT "area_id" INTO "area_id_v"
4962 FROM "issue" WHERE "id" = "issue_id_p";
4963 END IF;
4964 SELECT "unit_id" INTO "unit_id_v" FROM "area" WHERE "id" = "area_id_v";
4965 INSERT INTO "snapshot" ("area_id", "issue_id")
4966 VALUES ("area_id_v", "issue_id_p")
4967 RETURNING "id" INTO "snapshot_id_v";
4968 INSERT INTO "snapshot_population" ("snapshot_id", "member_id")
4969 SELECT "snapshot_id_v", "member_id"
4970 FROM "unit_member" WHERE "unit_id" = "unit_id_v";
4971 UPDATE "snapshot" SET
4972 "population" = (
4973 SELECT count(1) FROM "snapshot_population"
4974 WHERE "snapshot_id" = "snapshot_id_v"
4975 ) WHERE "id" = "snapshot_id_v";
4976 FOR "issue_id_v" IN
4977 SELECT "id" FROM "issue"
4978 WHERE CASE WHEN "issue_id_p" ISNULL THEN
4979 "area_id" = "area_id_p" AND
4980 "state" = 'admission'
4981 ELSE
4982 "id" = "issue_id_p"
4983 END
4984 LOOP
4985 INSERT INTO "snapshot_issue" ("snapshot_id", "issue_id")
4986 VALUES ("snapshot_id_v", "issue_id_v");
4987 INSERT INTO "direct_interest_snapshot"
4988 ("snapshot_id", "issue_id", "member_id")
4989 SELECT
4990 "snapshot_id_v" AS "snapshot_id",
4991 "issue_id_v" AS "issue_id",
4992 "member"."id" AS "member_id"
4993 FROM "issue"
4994 JOIN "area" ON "issue"."area_id" = "area"."id"
4995 JOIN "interest" ON "issue"."id" = "interest"."issue_id"
4996 JOIN "member" ON "interest"."member_id" = "member"."id"
4997 JOIN "privilege"
4998 ON "privilege"."unit_id" = "area"."unit_id"
4999 AND "privilege"."member_id" = "member"."id"
5000 WHERE "issue"."id" = "issue_id_v"
5001 AND "member"."active" AND "privilege"."voting_right";
5002 FOR "member_id_v" IN
5003 SELECT "member_id" FROM "direct_interest_snapshot"
5004 WHERE "snapshot_id" = "snapshot_id_v"
5005 AND "issue_id" = "issue_id_v"
5006 LOOP
5007 UPDATE "direct_interest_snapshot" SET
5008 "weight" = 1 +
5009 "weight_of_added_delegations_for_snapshot"(
5010 "snapshot_id_v",
5011 "issue_id_v",
5012 "member_id_v",
5013 '{}'
5014 )
5015 WHERE "snapshot_id" = "snapshot_id_v"
5016 AND "issue_id" = "issue_id_v"
5017 AND "member_id" = "member_id_v";
5018 END LOOP;
5019 INSERT INTO "direct_supporter_snapshot"
5020 ( "snapshot_id", "issue_id", "initiative_id", "member_id",
5021 "draft_id", "informed", "satisfied" )
5022 SELECT
5023 "snapshot_id_v" AS "snapshot_id",
5024 "issue_id_v" AS "issue_id",
5025 "initiative"."id" AS "initiative_id",
5026 "supporter"."member_id" AS "member_id",
5027 "supporter"."draft_id" AS "draft_id",
5028 "supporter"."draft_id" = "current_draft"."id" AS "informed",
5029 NOT EXISTS (
5030 SELECT NULL FROM "critical_opinion"
5031 WHERE "initiative_id" = "initiative"."id"
5032 AND "member_id" = "supporter"."member_id"
5033 ) AS "satisfied"
5034 FROM "initiative"
5035 JOIN "supporter"
5036 ON "supporter"."initiative_id" = "initiative"."id"
5037 JOIN "current_draft"
5038 ON "initiative"."id" = "current_draft"."initiative_id"
5039 JOIN "direct_interest_snapshot"
5040 ON "snapshot_id_v" = "direct_interest_snapshot"."snapshot_id"
5041 AND "supporter"."member_id" = "direct_interest_snapshot"."member_id"
5042 AND "initiative"."issue_id" = "direct_interest_snapshot"."issue_id"
5043 WHERE "initiative"."issue_id" = "issue_id_v";
5044 DELETE FROM "temporary_suggestion_counts";
5045 INSERT INTO "temporary_suggestion_counts"
5046 ( "id",
5047 "minus2_unfulfilled_count", "minus2_fulfilled_count",
5048 "minus1_unfulfilled_count", "minus1_fulfilled_count",
5049 "plus1_unfulfilled_count", "plus1_fulfilled_count",
5050 "plus2_unfulfilled_count", "plus2_fulfilled_count" )
5051 SELECT
5052 "suggestion"."id",
5053 ( SELECT coalesce(sum("di"."weight"), 0)
5054 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5055 ON "di"."snapshot_id" = "snapshot_id_v"
5056 AND "di"."issue_id" = "issue_id_v"
5057 AND "di"."member_id" = "opinion"."member_id"
5058 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5059 AND "opinion"."degree" = -2
5060 AND "opinion"."fulfilled" = FALSE
5061 ) AS "minus2_unfulfilled_count",
5062 ( SELECT coalesce(sum("di"."weight"), 0)
5063 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5064 ON "di"."snapshot_id" = "snapshot_id_v"
5065 AND "di"."issue_id" = "issue_id_v"
5066 AND "di"."member_id" = "opinion"."member_id"
5067 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5068 AND "opinion"."degree" = -2
5069 AND "opinion"."fulfilled" = TRUE
5070 ) AS "minus2_fulfilled_count",
5071 ( SELECT coalesce(sum("di"."weight"), 0)
5072 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5073 ON "di"."snapshot_id" = "snapshot_id_v"
5074 AND "di"."issue_id" = "issue_id_v"
5075 AND "di"."member_id" = "opinion"."member_id"
5076 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5077 AND "opinion"."degree" = -1
5078 AND "opinion"."fulfilled" = FALSE
5079 ) AS "minus1_unfulfilled_count",
5080 ( SELECT coalesce(sum("di"."weight"), 0)
5081 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5082 ON "di"."snapshot_id" = "snapshot_id_v"
5083 AND "di"."issue_id" = "issue_id_v"
5084 AND "di"."member_id" = "opinion"."member_id"
5085 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5086 AND "opinion"."degree" = -1
5087 AND "opinion"."fulfilled" = TRUE
5088 ) AS "minus1_fulfilled_count",
5089 ( SELECT coalesce(sum("di"."weight"), 0)
5090 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5091 ON "di"."snapshot_id" = "snapshot_id_v"
5092 AND "di"."issue_id" = "issue_id_v"
5093 AND "di"."member_id" = "opinion"."member_id"
5094 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5095 AND "opinion"."degree" = 1
5096 AND "opinion"."fulfilled" = FALSE
5097 ) AS "plus1_unfulfilled_count",
5098 ( SELECT coalesce(sum("di"."weight"), 0)
5099 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5100 ON "di"."snapshot_id" = "snapshot_id_v"
5101 AND "di"."issue_id" = "issue_id_v"
5102 AND "di"."member_id" = "opinion"."member_id"
5103 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5104 AND "opinion"."degree" = 1
5105 AND "opinion"."fulfilled" = TRUE
5106 ) AS "plus1_fulfilled_count",
5107 ( SELECT coalesce(sum("di"."weight"), 0)
5108 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5109 ON "di"."snapshot_id" = "snapshot_id_v"
5110 AND "di"."issue_id" = "issue_id_v"
5111 AND "di"."member_id" = "opinion"."member_id"
5112 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5113 AND "opinion"."degree" = 2
5114 AND "opinion"."fulfilled" = FALSE
5115 ) AS "plus2_unfulfilled_count",
5116 ( SELECT coalesce(sum("di"."weight"), 0)
5117 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5118 ON "di"."snapshot_id" = "snapshot_id_v"
5119 AND "di"."issue_id" = "issue_id_v"
5120 AND "di"."member_id" = "opinion"."member_id"
5121 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5122 AND "opinion"."degree" = 2
5123 AND "opinion"."fulfilled" = TRUE
5124 ) AS "plus2_fulfilled_count"
5125 FROM "suggestion" JOIN "initiative"
5126 ON "suggestion"."initiative_id" = "initiative"."id"
5127 WHERE "initiative"."issue_id" = "issue_id_v";
5128 END LOOP;
5129 RETURN "snapshot_id_v";
5130 END;
5131 $$;
5133 COMMENT ON FUNCTION "take_snapshot"
5134 ( "issue"."id"%TYPE,
5135 "area"."id"%TYPE )
5136 IS 'This function creates a new interest/supporter snapshot of a particular issue, or, if the first argument is NULL, for all issues in ''admission'' phase of the area given as second argument. It must be executed with TRANSACTION ISOLATION LEVEL REPEATABLE READ. The snapshot must later be finished by calling "finish_snapshot" for every issue.';
5139 CREATE FUNCTION "finish_snapshot"
5140 ( "issue_id_p" "issue"."id"%TYPE )
5141 RETURNS VOID
5142 LANGUAGE 'plpgsql' VOLATILE AS $$
5143 DECLARE
5144 "snapshot_id_v" "snapshot"."id"%TYPE;
5145 BEGIN
5146 -- NOTE: function does not require snapshot isolation but we don't call
5147 -- "dont_require_snapshot_isolation" here because this function is
5148 -- also invoked by "check_issue"
5149 LOCK TABLE "snapshot" IN EXCLUSIVE MODE;
5150 SELECT "id" INTO "snapshot_id_v" FROM "snapshot"
5151 ORDER BY "id" DESC LIMIT 1;
5152 UPDATE "issue" SET
5153 "calculated" = "snapshot"."calculated",
5154 "latest_snapshot_id" = "snapshot_id_v",
5155 "population" = "snapshot"."population",
5156 "initiative_quorum" = CASE WHEN
5157 "policy"."initiative_quorum" > ceil(
5158 ( "issue"."population"::INT8 *
5159 "policy"."initiative_quorum_num"::INT8 ) /
5160 "policy"."initiative_quorum_den"::FLOAT8
5161 )::INT4
5162 THEN
5163 "policy"."initiative_quorum"
5164 ELSE
5165 ceil(
5166 ( "issue"."population"::INT8 *
5167 "policy"."initiative_quorum_num"::INT8 ) /
5168 "policy"."initiative_quorum_den"::FLOAT8
5169 )::INT4
5170 END
5171 FROM "snapshot", "policy"
5172 WHERE "issue"."id" = "issue_id_p"
5173 AND "snapshot"."id" = "snapshot_id_v"
5174 AND "policy"."id" = "issue"."policy_id";
5175 UPDATE "initiative" SET
5176 "supporter_count" = (
5177 SELECT coalesce(sum("di"."weight"), 0)
5178 FROM "direct_interest_snapshot" AS "di"
5179 JOIN "direct_supporter_snapshot" AS "ds"
5180 ON "di"."member_id" = "ds"."member_id"
5181 WHERE "di"."snapshot_id" = "snapshot_id_v"
5182 AND "di"."issue_id" = "issue_id_p"
5183 AND "ds"."snapshot_id" = "snapshot_id_v"
5184 AND "ds"."initiative_id" = "initiative"."id"
5185 ),
5186 "informed_supporter_count" = (
5187 SELECT coalesce(sum("di"."weight"), 0)
5188 FROM "direct_interest_snapshot" AS "di"
5189 JOIN "direct_supporter_snapshot" AS "ds"
5190 ON "di"."member_id" = "ds"."member_id"
5191 WHERE "di"."snapshot_id" = "snapshot_id_v"
5192 AND "di"."issue_id" = "issue_id_p"
5193 AND "ds"."snapshot_id" = "snapshot_id_v"
5194 AND "ds"."initiative_id" = "initiative"."id"
5195 AND "ds"."informed"
5196 ),
5197 "satisfied_supporter_count" = (
5198 SELECT coalesce(sum("di"."weight"), 0)
5199 FROM "direct_interest_snapshot" AS "di"
5200 JOIN "direct_supporter_snapshot" AS "ds"
5201 ON "di"."member_id" = "ds"."member_id"
5202 WHERE "di"."snapshot_id" = "snapshot_id_v"
5203 AND "di"."issue_id" = "issue_id_p"
5204 AND "ds"."snapshot_id" = "snapshot_id_v"
5205 AND "ds"."initiative_id" = "initiative"."id"
5206 AND "ds"."satisfied"
5207 ),
5208 "satisfied_informed_supporter_count" = (
5209 SELECT coalesce(sum("di"."weight"), 0)
5210 FROM "direct_interest_snapshot" AS "di"
5211 JOIN "direct_supporter_snapshot" AS "ds"
5212 ON "di"."member_id" = "ds"."member_id"
5213 WHERE "di"."snapshot_id" = "snapshot_id_v"
5214 AND "di"."issue_id" = "issue_id_p"
5215 AND "ds"."snapshot_id" = "snapshot_id_v"
5216 AND "ds"."initiative_id" = "initiative"."id"
5217 AND "ds"."informed"
5218 AND "ds"."satisfied"
5219 )
5220 WHERE "issue_id" = "issue_id_p";
5221 UPDATE "suggestion" SET
5222 "minus2_unfulfilled_count" = "temp"."minus2_unfulfilled_count",
5223 "minus2_fulfilled_count" = "temp"."minus2_fulfilled_count",
5224 "minus1_unfulfilled_count" = "temp"."minus1_unfulfilled_count",
5225 "minus1_fulfilled_count" = "temp"."minus1_fulfilled_count",
5226 "plus1_unfulfilled_count" = "temp"."plus1_unfulfilled_count",
5227 "plus1_fulfilled_count" = "temp"."plus1_fulfilled_count",
5228 "plus2_unfulfilled_count" = "temp"."plus2_unfulfilled_count",
5229 "plus2_fulfilled_count" = "temp"."plus2_fulfilled_count"
5230 FROM "temporary_suggestion_counts" AS "temp", "initiative"
5231 WHERE "temp"."id" = "suggestion"."id"
5232 AND "initiative"."issue_id" = "issue_id_p"
5233 AND "suggestion"."initiative_id" = "initiative"."id";
5234 DELETE FROM "temporary_suggestion_counts";
5235 RETURN;
5236 END;
5237 $$;
5239 COMMENT ON FUNCTION "finish_snapshot"
5240 ( "issue"."id"%TYPE )
5241 IS 'After calling "take_snapshot", this function "finish_snapshot" needs to be called for every issue in the snapshot (separate function calls keep locking time minimal)';
5245 -----------------------
5246 -- Counting of votes --
5247 -----------------------
5250 CREATE FUNCTION "weight_of_added_vote_delegations"
5251 ( "issue_id_p" "issue"."id"%TYPE,
5252 "member_id_p" "member"."id"%TYPE,
5253 "delegate_member_ids_p" "delegating_voter"."delegate_member_ids"%TYPE )
5254 RETURNS "direct_voter"."weight"%TYPE
5255 LANGUAGE 'plpgsql' VOLATILE AS $$
5256 DECLARE
5257 "issue_delegation_row" "issue_delegation"%ROWTYPE;
5258 "delegate_member_ids_v" "delegating_voter"."delegate_member_ids"%TYPE;
5259 "weight_v" INT4;
5260 "sub_weight_v" INT4;
5261 BEGIN
5262 PERFORM "require_transaction_isolation"();
5263 "weight_v" := 0;
5264 FOR "issue_delegation_row" IN
5265 SELECT * FROM "issue_delegation"
5266 WHERE "trustee_id" = "member_id_p"
5267 AND "issue_id" = "issue_id_p"
5268 LOOP
5269 IF NOT EXISTS (
5270 SELECT NULL FROM "direct_voter"
5271 WHERE "member_id" = "issue_delegation_row"."truster_id"
5272 AND "issue_id" = "issue_id_p"
5273 ) AND NOT EXISTS (
5274 SELECT NULL FROM "delegating_voter"
5275 WHERE "member_id" = "issue_delegation_row"."truster_id"
5276 AND "issue_id" = "issue_id_p"
5277 ) THEN
5278 "delegate_member_ids_v" :=
5279 "member_id_p" || "delegate_member_ids_p";
5280 INSERT INTO "delegating_voter" (
5281 "issue_id",
5282 "member_id",
5283 "scope",
5284 "delegate_member_ids"
5285 ) VALUES (
5286 "issue_id_p",
5287 "issue_delegation_row"."truster_id",
5288 "issue_delegation_row"."scope",
5289 "delegate_member_ids_v"
5290 );
5291 "sub_weight_v" := 1 +
5292 "weight_of_added_vote_delegations"(
5293 "issue_id_p",
5294 "issue_delegation_row"."truster_id",
5295 "delegate_member_ids_v"
5296 );
5297 UPDATE "delegating_voter"
5298 SET "weight" = "sub_weight_v"
5299 WHERE "issue_id" = "issue_id_p"
5300 AND "member_id" = "issue_delegation_row"."truster_id";
5301 "weight_v" := "weight_v" + "sub_weight_v";
5302 END IF;
5303 END LOOP;
5304 RETURN "weight_v";
5305 END;
5306 $$;
5308 COMMENT ON FUNCTION "weight_of_added_vote_delegations"
5309 ( "issue"."id"%TYPE,
5310 "member"."id"%TYPE,
5311 "delegating_voter"."delegate_member_ids"%TYPE )
5312 IS 'Helper function for "add_vote_delegations" function';
5315 CREATE FUNCTION "add_vote_delegations"
5316 ( "issue_id_p" "issue"."id"%TYPE )
5317 RETURNS VOID
5318 LANGUAGE 'plpgsql' VOLATILE AS $$
5319 DECLARE
5320 "member_id_v" "member"."id"%TYPE;
5321 BEGIN
5322 PERFORM "require_transaction_isolation"();
5323 FOR "member_id_v" IN
5324 SELECT "member_id" FROM "direct_voter"
5325 WHERE "issue_id" = "issue_id_p"
5326 LOOP
5327 UPDATE "direct_voter" SET
5328 "weight" = "weight" + "weight_of_added_vote_delegations"(
5329 "issue_id_p",
5330 "member_id_v",
5331 '{}'
5332 )
5333 WHERE "member_id" = "member_id_v"
5334 AND "issue_id" = "issue_id_p";
5335 END LOOP;
5336 RETURN;
5337 END;
5338 $$;
5340 COMMENT ON FUNCTION "add_vote_delegations"
5341 ( "issue_id_p" "issue"."id"%TYPE )
5342 IS 'Helper function for "close_voting" function';
5345 CREATE FUNCTION "close_voting"("issue_id_p" "issue"."id"%TYPE)
5346 RETURNS VOID
5347 LANGUAGE 'plpgsql' VOLATILE AS $$
5348 DECLARE
5349 "area_id_v" "area"."id"%TYPE;
5350 "unit_id_v" "unit"."id"%TYPE;
5351 "member_id_v" "member"."id"%TYPE;
5352 BEGIN
5353 PERFORM "require_transaction_isolation"();
5354 SELECT "area_id" INTO "area_id_v" FROM "issue" WHERE "id" = "issue_id_p";
5355 SELECT "unit_id" INTO "unit_id_v" FROM "area" WHERE "id" = "area_id_v";
5356 -- override protection triggers:
5357 INSERT INTO "temporary_transaction_data" ("key", "value")
5358 VALUES ('override_protection_triggers', TRUE::TEXT);
5359 -- delete timestamp of voting comment:
5360 UPDATE "direct_voter" SET "comment_changed" = NULL
5361 WHERE "issue_id" = "issue_id_p";
5362 -- delete delegating votes (in cases of manual reset of issue state):
5363 DELETE FROM "delegating_voter"
5364 WHERE "issue_id" = "issue_id_p";
5365 -- delete votes from non-privileged voters:
5366 DELETE FROM "direct_voter"
5367 USING (
5368 SELECT
5369 "direct_voter"."member_id"
5370 FROM "direct_voter"
5371 JOIN "member" ON "direct_voter"."member_id" = "member"."id"
5372 LEFT JOIN "privilege"
5373 ON "privilege"."unit_id" = "unit_id_v"
5374 AND "privilege"."member_id" = "direct_voter"."member_id"
5375 WHERE "direct_voter"."issue_id" = "issue_id_p" AND (
5376 "member"."active" = FALSE OR
5377 "privilege"."voting_right" ISNULL OR
5378 "privilege"."voting_right" = FALSE
5379 )
5380 ) AS "subquery"
5381 WHERE "direct_voter"."issue_id" = "issue_id_p"
5382 AND "direct_voter"."member_id" = "subquery"."member_id";
5383 -- consider delegations:
5384 UPDATE "direct_voter" SET "weight" = 1
5385 WHERE "issue_id" = "issue_id_p";
5386 PERFORM "add_vote_delegations"("issue_id_p");
5387 -- mark first preferences:
5388 UPDATE "vote" SET "first_preference" = "subquery"."first_preference"
5389 FROM (
5390 SELECT
5391 "vote"."initiative_id",
5392 "vote"."member_id",
5393 CASE WHEN "vote"."grade" > 0 THEN
5394 CASE WHEN "vote"."grade" = max("agg"."grade") THEN TRUE ELSE FALSE END
5395 ELSE NULL
5396 END AS "first_preference"
5397 FROM "vote"
5398 JOIN "initiative" -- NOTE: due to missing index on issue_id
5399 ON "vote"."issue_id" = "initiative"."issue_id"
5400 JOIN "vote" AS "agg"
5401 ON "initiative"."id" = "agg"."initiative_id"
5402 AND "vote"."member_id" = "agg"."member_id"
5403 GROUP BY "vote"."initiative_id", "vote"."member_id", "vote"."grade"
5404 ) AS "subquery"
5405 WHERE "vote"."issue_id" = "issue_id_p"
5406 AND "vote"."initiative_id" = "subquery"."initiative_id"
5407 AND "vote"."member_id" = "subquery"."member_id";
5408 -- finish overriding protection triggers (avoids garbage):
5409 DELETE FROM "temporary_transaction_data"
5410 WHERE "key" = 'override_protection_triggers';
5411 -- materialize battle_view:
5412 -- NOTE: "closed" column of issue must be set at this point
5413 DELETE FROM "battle" WHERE "issue_id" = "issue_id_p";
5414 INSERT INTO "battle" (
5415 "issue_id",
5416 "winning_initiative_id", "losing_initiative_id",
5417 "count"
5418 ) SELECT
5419 "issue_id",
5420 "winning_initiative_id", "losing_initiative_id",
5421 "count"
5422 FROM "battle_view" WHERE "issue_id" = "issue_id_p";
5423 -- set voter count:
5424 UPDATE "issue" SET
5425 "voter_count" = (
5426 SELECT coalesce(sum("weight"), 0)
5427 FROM "direct_voter" WHERE "issue_id" = "issue_id_p"
5428 )
5429 WHERE "id" = "issue_id_p";
5430 -- copy "positive_votes" and "negative_votes" from "battle" table:
5431 -- NOTE: "first_preference_votes" is set to a default of 0 at this step
5432 UPDATE "initiative" SET
5433 "first_preference_votes" = 0,
5434 "positive_votes" = "battle_win"."count",
5435 "negative_votes" = "battle_lose"."count"
5436 FROM "battle" AS "battle_win", "battle" AS "battle_lose"
5437 WHERE
5438 "battle_win"."issue_id" = "issue_id_p" AND
5439 "battle_win"."winning_initiative_id" = "initiative"."id" AND
5440 "battle_win"."losing_initiative_id" ISNULL AND
5441 "battle_lose"."issue_id" = "issue_id_p" AND
5442 "battle_lose"."losing_initiative_id" = "initiative"."id" AND
5443 "battle_lose"."winning_initiative_id" ISNULL;
5444 -- calculate "first_preference_votes":
5445 -- NOTE: will only set values not equal to zero
5446 UPDATE "initiative" SET "first_preference_votes" = "subquery"."sum"
5447 FROM (
5448 SELECT "vote"."initiative_id", sum("direct_voter"."weight")
5449 FROM "vote" JOIN "direct_voter"
5450 ON "vote"."issue_id" = "direct_voter"."issue_id"
5451 AND "vote"."member_id" = "direct_voter"."member_id"
5452 WHERE "vote"."first_preference"
5453 GROUP BY "vote"."initiative_id"
5454 ) AS "subquery"
5455 WHERE "initiative"."issue_id" = "issue_id_p"
5456 AND "initiative"."admitted"
5457 AND "initiative"."id" = "subquery"."initiative_id";
5458 END;
5459 $$;
5461 COMMENT ON FUNCTION "close_voting"
5462 ( "issue"."id"%TYPE )
5463 IS 'Closes the voting on an issue, and calculates positive and negative votes for each initiative; The ranking is not calculated yet, to keep the (locking) transaction short.';
5466 CREATE FUNCTION "defeat_strength"
5467 ( "positive_votes_p" INT4,
5468 "negative_votes_p" INT4,
5469 "defeat_strength_p" "defeat_strength" )
5470 RETURNS INT8
5471 LANGUAGE 'plpgsql' IMMUTABLE AS $$
5472 BEGIN
5473 IF "defeat_strength_p" = 'simple'::"defeat_strength" THEN
5474 IF "positive_votes_p" > "negative_votes_p" THEN
5475 RETURN "positive_votes_p";
5476 ELSE
5477 RETURN 0;
5478 END IF;
5479 ELSE
5480 IF "positive_votes_p" > "negative_votes_p" THEN
5481 RETURN ("positive_votes_p"::INT8 << 31) - "negative_votes_p"::INT8;
5482 ELSIF "positive_votes_p" = "negative_votes_p" THEN
5483 RETURN 0;
5484 ELSE
5485 RETURN -1;
5486 END IF;
5487 END IF;
5488 END;
5489 $$;
5491 COMMENT ON FUNCTION "defeat_strength"(INT4, INT4, "defeat_strength") IS 'Calculates defeat strength (INT8!) according to the "defeat_strength" option (see comment on type "defeat_strength")';
5494 CREATE FUNCTION "secondary_link_strength"
5495 ( "initiative1_ord_p" INT4,
5496 "initiative2_ord_p" INT4,
5497 "tie_breaking_p" "tie_breaking" )
5498 RETURNS INT8
5499 LANGUAGE 'plpgsql' IMMUTABLE AS $$
5500 BEGIN
5501 IF "initiative1_ord_p" = "initiative2_ord_p" THEN
5502 RAISE EXCEPTION 'Identical initiative ids passed to "secondary_link_strength" function (should not happen)';
5503 END IF;
5504 RETURN (
5505 CASE WHEN "tie_breaking_p" = 'simple'::"tie_breaking" THEN
5506 0
5507 ELSE
5508 CASE WHEN "initiative1_ord_p" < "initiative2_ord_p" THEN
5509 1::INT8 << 62
5510 ELSE 0 END
5511 +
5512 CASE WHEN "tie_breaking_p" = 'variant2'::"tie_breaking" THEN
5513 ("initiative2_ord_p"::INT8 << 31) - "initiative1_ord_p"::INT8
5514 ELSE
5515 "initiative2_ord_p"::INT8 - ("initiative1_ord_p"::INT8 << 31)
5516 END
5517 END
5518 );
5519 END;
5520 $$;
5522 COMMENT ON FUNCTION "secondary_link_strength"(INT4, INT4, "tie_breaking") IS 'Calculates a secondary criterion for the defeat strength (tie-breaking of the links)';
5525 CREATE TYPE "link_strength" AS (
5526 "primary" INT8,
5527 "secondary" INT8 );
5529 COMMENT ON TYPE "link_strength" IS 'Type to store the defeat strength of a link between two candidates plus a secondary criterion to create unique link strengths between the candidates (needed for tie-breaking ''variant1'' and ''variant2'')';
5532 CREATE FUNCTION "find_best_paths"("matrix_d" "link_strength"[][])
5533 RETURNS "link_strength"[][]
5534 LANGUAGE 'plpgsql' IMMUTABLE AS $$
5535 DECLARE
5536 "dimension_v" INT4;
5537 "matrix_p" "link_strength"[][];
5538 "i" INT4;
5539 "j" INT4;
5540 "k" INT4;
5541 BEGIN
5542 "dimension_v" := array_upper("matrix_d", 1);
5543 "matrix_p" := "matrix_d";
5544 "i" := 1;
5545 LOOP
5546 "j" := 1;
5547 LOOP
5548 IF "i" != "j" THEN
5549 "k" := 1;
5550 LOOP
5551 IF "i" != "k" AND "j" != "k" THEN
5552 IF "matrix_p"["j"]["i"] < "matrix_p"["i"]["k"] THEN
5553 IF "matrix_p"["j"]["i"] > "matrix_p"["j"]["k"] THEN
5554 "matrix_p"["j"]["k"] := "matrix_p"["j"]["i"];
5555 END IF;
5556 ELSE
5557 IF "matrix_p"["i"]["k"] > "matrix_p"["j"]["k"] THEN
5558 "matrix_p"["j"]["k"] := "matrix_p"["i"]["k"];
5559 END IF;
5560 END IF;
5561 END IF;
5562 EXIT WHEN "k" = "dimension_v";
5563 "k" := "k" + 1;
5564 END LOOP;
5565 END IF;
5566 EXIT WHEN "j" = "dimension_v";
5567 "j" := "j" + 1;
5568 END LOOP;
5569 EXIT WHEN "i" = "dimension_v";
5570 "i" := "i" + 1;
5571 END LOOP;
5572 RETURN "matrix_p";
5573 END;
5574 $$;
5576 COMMENT ON FUNCTION "find_best_paths"("link_strength"[][]) IS 'Computes the strengths of the best beat-paths from a square matrix';
5579 CREATE FUNCTION "calculate_ranks"("issue_id_p" "issue"."id"%TYPE)
5580 RETURNS VOID
5581 LANGUAGE 'plpgsql' VOLATILE AS $$
5582 DECLARE
5583 "issue_row" "issue"%ROWTYPE;
5584 "policy_row" "policy"%ROWTYPE;
5585 "dimension_v" INT4;
5586 "matrix_a" INT4[][]; -- absolute votes
5587 "matrix_d" "link_strength"[][]; -- defeat strength (direct)
5588 "matrix_p" "link_strength"[][]; -- defeat strength (best path)
5589 "matrix_t" "link_strength"[][]; -- defeat strength (tie-breaking)
5590 "matrix_f" BOOLEAN[][]; -- forbidden link (tie-breaking)
5591 "matrix_b" BOOLEAN[][]; -- final order (who beats who)
5592 "i" INT4;
5593 "j" INT4;
5594 "m" INT4;
5595 "n" INT4;
5596 "battle_row" "battle"%ROWTYPE;
5597 "rank_ary" INT4[];
5598 "rank_v" INT4;
5599 "initiative_id_v" "initiative"."id"%TYPE;
5600 BEGIN
5601 PERFORM "require_transaction_isolation"();
5602 SELECT * INTO "issue_row"
5603 FROM "issue" WHERE "id" = "issue_id_p";
5604 SELECT * INTO "policy_row"
5605 FROM "policy" WHERE "id" = "issue_row"."policy_id";
5606 SELECT count(1) INTO "dimension_v"
5607 FROM "battle_participant" WHERE "issue_id" = "issue_id_p";
5608 -- create "matrix_a" with absolute number of votes in pairwise
5609 -- comparison:
5610 "matrix_a" := array_fill(NULL::INT4, ARRAY["dimension_v", "dimension_v"]);
5611 "i" := 1;
5612 "j" := 2;
5613 FOR "battle_row" IN
5614 SELECT * FROM "battle" WHERE "issue_id" = "issue_id_p"
5615 ORDER BY
5616 "winning_initiative_id" NULLS FIRST,
5617 "losing_initiative_id" NULLS FIRST
5618 LOOP
5619 "matrix_a"["i"]["j"] := "battle_row"."count";
5620 IF "j" = "dimension_v" THEN
5621 "i" := "i" + 1;
5622 "j" := 1;
5623 ELSE
5624 "j" := "j" + 1;
5625 IF "j" = "i" THEN
5626 "j" := "j" + 1;
5627 END IF;
5628 END IF;
5629 END LOOP;
5630 IF "i" != "dimension_v" OR "j" != "dimension_v" + 1 THEN
5631 RAISE EXCEPTION 'Wrong battle count (should not happen)';
5632 END IF;
5633 -- store direct defeat strengths in "matrix_d" using "defeat_strength"
5634 -- and "secondary_link_strength" functions:
5635 "matrix_d" := array_fill(NULL::INT8, ARRAY["dimension_v", "dimension_v"]);
5636 "i" := 1;
5637 LOOP
5638 "j" := 1;
5639 LOOP
5640 IF "i" != "j" THEN
5641 "matrix_d"["i"]["j"] := (
5642 "defeat_strength"(
5643 "matrix_a"["i"]["j"],
5644 "matrix_a"["j"]["i"],
5645 "policy_row"."defeat_strength"
5646 ),
5647 "secondary_link_strength"(
5648 "i",
5649 "j",
5650 "policy_row"."tie_breaking"
5651 )
5652 )::"link_strength";
5653 END IF;
5654 EXIT WHEN "j" = "dimension_v";
5655 "j" := "j" + 1;
5656 END LOOP;
5657 EXIT WHEN "i" = "dimension_v";
5658 "i" := "i" + 1;
5659 END LOOP;
5660 -- find best paths:
5661 "matrix_p" := "find_best_paths"("matrix_d");
5662 -- create partial order:
5663 "matrix_b" := array_fill(NULL::BOOLEAN, ARRAY["dimension_v", "dimension_v"]);
5664 "i" := 1;
5665 LOOP
5666 "j" := "i" + 1;
5667 LOOP
5668 IF "i" != "j" THEN
5669 IF "matrix_p"["i"]["j"] > "matrix_p"["j"]["i"] THEN
5670 "matrix_b"["i"]["j"] := TRUE;
5671 "matrix_b"["j"]["i"] := FALSE;
5672 ELSIF "matrix_p"["i"]["j"] < "matrix_p"["j"]["i"] THEN
5673 "matrix_b"["i"]["j"] := FALSE;
5674 "matrix_b"["j"]["i"] := TRUE;
5675 END IF;
5676 END IF;
5677 EXIT WHEN "j" = "dimension_v";
5678 "j" := "j" + 1;
5679 END LOOP;
5680 EXIT WHEN "i" = "dimension_v" - 1;
5681 "i" := "i" + 1;
5682 END LOOP;
5683 -- tie-breaking by forbidding shared weakest links in beat-paths
5684 -- (unless "tie_breaking" is set to 'simple', in which case tie-breaking
5685 -- is performed later by initiative id):
5686 IF "policy_row"."tie_breaking" != 'simple'::"tie_breaking" THEN
5687 "m" := 1;
5688 LOOP
5689 "n" := "m" + 1;
5690 LOOP
5691 -- only process those candidates m and n, which are tied:
5692 IF "matrix_b"["m"]["n"] ISNULL THEN
5693 -- start with beat-paths prior tie-breaking:
5694 "matrix_t" := "matrix_p";
5695 -- start with all links allowed:
5696 "matrix_f" := array_fill(FALSE, ARRAY["dimension_v", "dimension_v"]);
5697 LOOP
5698 -- determine (and forbid) that link that is the weakest link
5699 -- in both the best path from candidate m to candidate n and
5700 -- from candidate n to candidate m:
5701 "i" := 1;
5702 <<forbid_one_link>>
5703 LOOP
5704 "j" := 1;
5705 LOOP
5706 IF "i" != "j" THEN
5707 IF "matrix_d"["i"]["j"] = "matrix_t"["m"]["n"] THEN
5708 "matrix_f"["i"]["j"] := TRUE;
5709 -- exit for performance reasons,
5710 -- as exactly one link will be found:
5711 EXIT forbid_one_link;
5712 END IF;
5713 END IF;
5714 EXIT WHEN "j" = "dimension_v";
5715 "j" := "j" + 1;
5716 END LOOP;
5717 IF "i" = "dimension_v" THEN
5718 RAISE EXCEPTION 'Did not find shared weakest link for tie-breaking (should not happen)';
5719 END IF;
5720 "i" := "i" + 1;
5721 END LOOP;
5722 -- calculate best beat-paths while ignoring forbidden links:
5723 "i" := 1;
5724 LOOP
5725 "j" := 1;
5726 LOOP
5727 IF "i" != "j" THEN
5728 "matrix_t"["i"]["j"] := CASE
5729 WHEN "matrix_f"["i"]["j"]
5730 THEN ((-1::INT8) << 63, 0)::"link_strength" -- worst possible value
5731 ELSE "matrix_d"["i"]["j"] END;
5732 END IF;
5733 EXIT WHEN "j" = "dimension_v";
5734 "j" := "j" + 1;
5735 END LOOP;
5736 EXIT WHEN "i" = "dimension_v";
5737 "i" := "i" + 1;
5738 END LOOP;
5739 "matrix_t" := "find_best_paths"("matrix_t");
5740 -- extend partial order, if tie-breaking was successful:
5741 IF "matrix_t"["m"]["n"] > "matrix_t"["n"]["m"] THEN
5742 "matrix_b"["m"]["n"] := TRUE;
5743 "matrix_b"["n"]["m"] := FALSE;
5744 EXIT;
5745 ELSIF "matrix_t"["m"]["n"] < "matrix_t"["n"]["m"] THEN
5746 "matrix_b"["m"]["n"] := FALSE;
5747 "matrix_b"["n"]["m"] := TRUE;
5748 EXIT;
5749 END IF;
5750 END LOOP;
5751 END IF;
5752 EXIT WHEN "n" = "dimension_v";
5753 "n" := "n" + 1;
5754 END LOOP;
5755 EXIT WHEN "m" = "dimension_v" - 1;
5756 "m" := "m" + 1;
5757 END LOOP;
5758 END IF;
5759 -- store a unique ranking in "rank_ary":
5760 "rank_ary" := array_fill(NULL::INT4, ARRAY["dimension_v"]);
5761 "rank_v" := 1;
5762 LOOP
5763 "i" := 1;
5764 <<assign_next_rank>>
5765 LOOP
5766 IF "rank_ary"["i"] ISNULL THEN
5767 "j" := 1;
5768 LOOP
5769 IF
5770 "i" != "j" AND
5771 "rank_ary"["j"] ISNULL AND
5772 ( "matrix_b"["j"]["i"] OR
5773 -- tie-breaking by "id"
5774 ( "matrix_b"["j"]["i"] ISNULL AND
5775 "j" < "i" ) )
5776 THEN
5777 -- someone else is better
5778 EXIT;
5779 END IF;
5780 IF "j" = "dimension_v" THEN
5781 -- noone is better
5782 "rank_ary"["i"] := "rank_v";
5783 EXIT assign_next_rank;
5784 END IF;
5785 "j" := "j" + 1;
5786 END LOOP;
5787 END IF;
5788 "i" := "i" + 1;
5789 IF "i" > "dimension_v" THEN
5790 RAISE EXCEPTION 'Schulze ranking does not compute (should not happen)';
5791 END IF;
5792 END LOOP;
5793 EXIT WHEN "rank_v" = "dimension_v";
5794 "rank_v" := "rank_v" + 1;
5795 END LOOP;
5796 -- write preliminary results:
5797 "i" := 2; -- omit status quo with "i" = 1
5798 FOR "initiative_id_v" IN
5799 SELECT "id" FROM "initiative"
5800 WHERE "issue_id" = "issue_id_p" AND "admitted"
5801 ORDER BY "id"
5802 LOOP
5803 UPDATE "initiative" SET
5804 "direct_majority" =
5805 CASE WHEN "policy_row"."direct_majority_strict" THEN
5806 "positive_votes" * "policy_row"."direct_majority_den" >
5807 "policy_row"."direct_majority_num" * ("positive_votes"+"negative_votes")
5808 ELSE
5809 "positive_votes" * "policy_row"."direct_majority_den" >=
5810 "policy_row"."direct_majority_num" * ("positive_votes"+"negative_votes")
5811 END
5812 AND "positive_votes" >= "policy_row"."direct_majority_positive"
5813 AND "issue_row"."voter_count"-"negative_votes" >=
5814 "policy_row"."direct_majority_non_negative",
5815 "indirect_majority" =
5816 CASE WHEN "policy_row"."indirect_majority_strict" THEN
5817 "positive_votes" * "policy_row"."indirect_majority_den" >
5818 "policy_row"."indirect_majority_num" * ("positive_votes"+"negative_votes")
5819 ELSE
5820 "positive_votes" * "policy_row"."indirect_majority_den" >=
5821 "policy_row"."indirect_majority_num" * ("positive_votes"+"negative_votes")
5822 END
5823 AND "positive_votes" >= "policy_row"."indirect_majority_positive"
5824 AND "issue_row"."voter_count"-"negative_votes" >=
5825 "policy_row"."indirect_majority_non_negative",
5826 "schulze_rank" = "rank_ary"["i"],
5827 "better_than_status_quo" = "rank_ary"["i"] < "rank_ary"[1],
5828 "worse_than_status_quo" = "rank_ary"["i"] > "rank_ary"[1],
5829 "multistage_majority" = "rank_ary"["i"] >= "rank_ary"[1],
5830 "reverse_beat_path" = CASE WHEN "policy_row"."defeat_strength" = 'simple'::"defeat_strength"
5831 THEN NULL
5832 ELSE "matrix_p"[1]["i"]."primary" >= 0 END,
5833 "eligible" = FALSE,
5834 "winner" = FALSE,
5835 "rank" = NULL -- NOTE: in cases of manual reset of issue state
5836 WHERE "id" = "initiative_id_v";
5837 "i" := "i" + 1;
5838 END LOOP;
5839 IF "i" != "dimension_v" + 1 THEN
5840 RAISE EXCEPTION 'Wrong winner count (should not happen)';
5841 END IF;
5842 -- take indirect majorities into account:
5843 LOOP
5844 UPDATE "initiative" SET "indirect_majority" = TRUE
5845 FROM (
5846 SELECT "new_initiative"."id" AS "initiative_id"
5847 FROM "initiative" "old_initiative"
5848 JOIN "initiative" "new_initiative"
5849 ON "new_initiative"."issue_id" = "issue_id_p"
5850 AND "new_initiative"."indirect_majority" = FALSE
5851 JOIN "battle" "battle_win"
5852 ON "battle_win"."issue_id" = "issue_id_p"
5853 AND "battle_win"."winning_initiative_id" = "new_initiative"."id"
5854 AND "battle_win"."losing_initiative_id" = "old_initiative"."id"
5855 JOIN "battle" "battle_lose"
5856 ON "battle_lose"."issue_id" = "issue_id_p"
5857 AND "battle_lose"."losing_initiative_id" = "new_initiative"."id"
5858 AND "battle_lose"."winning_initiative_id" = "old_initiative"."id"
5859 WHERE "old_initiative"."issue_id" = "issue_id_p"
5860 AND "old_initiative"."indirect_majority" = TRUE
5861 AND CASE WHEN "policy_row"."indirect_majority_strict" THEN
5862 "battle_win"."count" * "policy_row"."indirect_majority_den" >
5863 "policy_row"."indirect_majority_num" *
5864 ("battle_win"."count"+"battle_lose"."count")
5865 ELSE
5866 "battle_win"."count" * "policy_row"."indirect_majority_den" >=
5867 "policy_row"."indirect_majority_num" *
5868 ("battle_win"."count"+"battle_lose"."count")
5869 END
5870 AND "battle_win"."count" >= "policy_row"."indirect_majority_positive"
5871 AND "issue_row"."voter_count"-"battle_lose"."count" >=
5872 "policy_row"."indirect_majority_non_negative"
5873 ) AS "subquery"
5874 WHERE "id" = "subquery"."initiative_id";
5875 EXIT WHEN NOT FOUND;
5876 END LOOP;
5877 -- set "multistage_majority" for remaining matching initiatives:
5878 UPDATE "initiative" SET "multistage_majority" = TRUE
5879 FROM (
5880 SELECT "losing_initiative"."id" AS "initiative_id"
5881 FROM "initiative" "losing_initiative"
5882 JOIN "initiative" "winning_initiative"
5883 ON "winning_initiative"."issue_id" = "issue_id_p"
5884 AND "winning_initiative"."admitted"
5885 JOIN "battle" "battle_win"
5886 ON "battle_win"."issue_id" = "issue_id_p"
5887 AND "battle_win"."winning_initiative_id" = "winning_initiative"."id"
5888 AND "battle_win"."losing_initiative_id" = "losing_initiative"."id"
5889 JOIN "battle" "battle_lose"
5890 ON "battle_lose"."issue_id" = "issue_id_p"
5891 AND "battle_lose"."losing_initiative_id" = "winning_initiative"."id"
5892 AND "battle_lose"."winning_initiative_id" = "losing_initiative"."id"
5893 WHERE "losing_initiative"."issue_id" = "issue_id_p"
5894 AND "losing_initiative"."admitted"
5895 AND "winning_initiative"."schulze_rank" <
5896 "losing_initiative"."schulze_rank"
5897 AND "battle_win"."count" > "battle_lose"."count"
5898 AND (
5899 "battle_win"."count" > "winning_initiative"."positive_votes" OR
5900 "battle_lose"."count" < "losing_initiative"."negative_votes" )
5901 ) AS "subquery"
5902 WHERE "id" = "subquery"."initiative_id";
5903 -- mark eligible initiatives:
5904 UPDATE "initiative" SET "eligible" = TRUE
5905 WHERE "issue_id" = "issue_id_p"
5906 AND "initiative"."direct_majority"
5907 AND "initiative"."indirect_majority"
5908 AND "initiative"."better_than_status_quo"
5909 AND (
5910 "policy_row"."no_multistage_majority" = FALSE OR
5911 "initiative"."multistage_majority" = FALSE )
5912 AND (
5913 "policy_row"."no_reverse_beat_path" = FALSE OR
5914 coalesce("initiative"."reverse_beat_path", FALSE) = FALSE );
5915 -- mark final winner:
5916 UPDATE "initiative" SET "winner" = TRUE
5917 FROM (
5918 SELECT "id" AS "initiative_id"
5919 FROM "initiative"
5920 WHERE "issue_id" = "issue_id_p" AND "eligible"
5921 ORDER BY
5922 "schulze_rank",
5923 "id"
5924 LIMIT 1
5925 ) AS "subquery"
5926 WHERE "id" = "subquery"."initiative_id";
5927 -- write (final) ranks:
5928 "rank_v" := 1;
5929 FOR "initiative_id_v" IN
5930 SELECT "id"
5931 FROM "initiative"
5932 WHERE "issue_id" = "issue_id_p" AND "admitted"
5933 ORDER BY
5934 "winner" DESC,
5935 "eligible" DESC,
5936 "schulze_rank",
5937 "id"
5938 LOOP
5939 UPDATE "initiative" SET "rank" = "rank_v"
5940 WHERE "id" = "initiative_id_v";
5941 "rank_v" := "rank_v" + 1;
5942 END LOOP;
5943 -- set schulze rank of status quo and mark issue as finished:
5944 UPDATE "issue" SET
5945 "status_quo_schulze_rank" = "rank_ary"[1],
5946 "state" =
5947 CASE WHEN EXISTS (
5948 SELECT NULL FROM "initiative"
5949 WHERE "issue_id" = "issue_id_p" AND "winner"
5950 ) THEN
5951 'finished_with_winner'::"issue_state"
5952 ELSE
5953 'finished_without_winner'::"issue_state"
5954 END,
5955 "closed" = "phase_finished",
5956 "phase_finished" = NULL
5957 WHERE "id" = "issue_id_p";
5958 RETURN;
5959 END;
5960 $$;
5962 COMMENT ON FUNCTION "calculate_ranks"
5963 ( "issue"."id"%TYPE )
5964 IS 'Determine ranking (Votes have to be counted first)';
5968 -----------------------------
5969 -- Automatic state changes --
5970 -----------------------------
5973 CREATE FUNCTION "issue_admission"
5974 ( "area_id_p" "area"."id"%TYPE )
5975 RETURNS BOOLEAN
5976 LANGUAGE 'plpgsql' VOLATILE AS $$
5977 DECLARE
5978 "issue_id_v" "issue"."id"%TYPE;
5979 BEGIN
5980 PERFORM "dont_require_transaction_isolation"();
5981 LOCK TABLE "snapshot" IN EXCLUSIVE MODE;
5982 UPDATE "area" SET "issue_quorum" = "view"."issue_quorum"
5983 FROM "area_quorum" AS "view"
5984 WHERE "area"."id" = "view"."area_id"
5985 AND "area"."id" = "area_id_p";
5986 SELECT "id" INTO "issue_id_v" FROM "issue_for_admission"
5987 WHERE "area_id" = "area_id_p";
5988 IF "issue_id_v" ISNULL THEN RETURN FALSE; END IF;
5989 UPDATE "issue" SET
5990 "admission_snapshot_id" = "latest_snapshot_id",
5991 "state" = 'discussion',
5992 "accepted" = now(),
5993 "phase_finished" = NULL,
5994 "issue_quorum" = "issue_quorum"."issue_quorum"
5995 FROM "issue_quorum"
5996 WHERE "id" = "issue_id_v"
5997 AND "issue_quorum"."issue_id" = "issue_id_v";
5998 RETURN TRUE;
5999 END;
6000 $$;
6002 COMMENT ON FUNCTION "issue_admission"
6003 ( "area"."id"%TYPE )
6004 IS 'Checks if an issue in the area can be admitted for further discussion; returns TRUE on success in which case the function must be called again until it returns FALSE';
6007 CREATE TYPE "check_issue_persistence" AS (
6008 "state" "issue_state",
6009 "phase_finished" BOOLEAN,
6010 "issue_revoked" BOOLEAN,
6011 "snapshot_created" BOOLEAN,
6012 "harmonic_weights_set" BOOLEAN,
6013 "closed_voting" BOOLEAN );
6015 COMMENT ON TYPE "check_issue_persistence" IS 'Type of data returned by "check_issue" function, to be passed to subsequent calls of the same function';
6018 CREATE FUNCTION "check_issue"
6019 ( "issue_id_p" "issue"."id"%TYPE,
6020 "persist" "check_issue_persistence" )
6021 RETURNS "check_issue_persistence"
6022 LANGUAGE 'plpgsql' VOLATILE AS $$
6023 DECLARE
6024 "issue_row" "issue"%ROWTYPE;
6025 "last_calculated_v" "snapshot"."calculated"%TYPE;
6026 "policy_row" "policy"%ROWTYPE;
6027 "initiative_row" "initiative"%ROWTYPE;
6028 "state_v" "issue_state";
6029 BEGIN
6030 PERFORM "require_transaction_isolation"();
6031 IF "persist" ISNULL THEN
6032 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
6033 FOR UPDATE;
6034 SELECT "calculated" INTO "last_calculated_v"
6035 FROM "snapshot" JOIN "snapshot_issue"
6036 ON "snapshot"."id" = "snapshot_issue"."snapshot_id"
6037 WHERE "snapshot_issue"."issue_id" = "issue_id_p";
6038 IF "issue_row"."closed" NOTNULL THEN
6039 RETURN NULL;
6040 END IF;
6041 "persist"."state" := "issue_row"."state";
6042 IF
6043 ( "issue_row"."state" = 'admission' AND "last_calculated_v" >=
6044 "issue_row"."created" + "issue_row"."max_admission_time" ) OR
6045 ( "issue_row"."state" = 'discussion' AND now() >=
6046 "issue_row"."accepted" + "issue_row"."discussion_time" ) OR
6047 ( "issue_row"."state" = 'verification' AND now() >=
6048 "issue_row"."half_frozen" + "issue_row"."verification_time" ) OR
6049 ( "issue_row"."state" = 'voting' AND now() >=
6050 "issue_row"."fully_frozen" + "issue_row"."voting_time" )
6051 THEN
6052 "persist"."phase_finished" := TRUE;
6053 ELSE
6054 "persist"."phase_finished" := FALSE;
6055 END IF;
6056 IF
6057 NOT EXISTS (
6058 -- all initiatives are revoked
6059 SELECT NULL FROM "initiative"
6060 WHERE "issue_id" = "issue_id_p" AND "revoked" ISNULL
6061 ) AND (
6062 -- and issue has not been accepted yet
6063 "persist"."state" = 'admission' OR
6064 -- or verification time has elapsed
6065 ( "persist"."state" = 'verification' AND
6066 "persist"."phase_finished" ) OR
6067 -- or no initiatives have been revoked lately
6068 NOT EXISTS (
6069 SELECT NULL FROM "initiative"
6070 WHERE "issue_id" = "issue_id_p"
6071 AND now() < "revoked" + "issue_row"."verification_time"
6072 )
6073 )
6074 THEN
6075 "persist"."issue_revoked" := TRUE;
6076 ELSE
6077 "persist"."issue_revoked" := FALSE;
6078 END IF;
6079 IF "persist"."phase_finished" OR "persist"."issue_revoked" THEN
6080 UPDATE "issue" SET "phase_finished" = now()
6081 WHERE "id" = "issue_row"."id";
6082 RETURN "persist";
6083 ELSIF
6084 "persist"."state" IN ('admission', 'discussion', 'verification')
6085 THEN
6086 RETURN "persist";
6087 ELSE
6088 RETURN NULL;
6089 END IF;
6090 END IF;
6091 IF
6092 "persist"."state" IN ('admission', 'discussion', 'verification') AND
6093 coalesce("persist"."snapshot_created", FALSE) = FALSE
6094 THEN
6095 IF "persist"."state" != 'admission' THEN
6096 PERFORM "take_snapshot"("issue_id_p");
6097 PERFORM "finish_snapshot"("issue_id_p");
6098 ELSE
6099 UPDATE "issue" SET "issue_quorum" = "issue_quorum"."issue_quorum"
6100 FROM "issue_quorum"
6101 WHERE "id" = "issue_id_p"
6102 AND "issue_quorum"."issue_id" = "issue_id_p";
6103 END IF;
6104 "persist"."snapshot_created" = TRUE;
6105 IF "persist"."phase_finished" THEN
6106 IF "persist"."state" = 'admission' THEN
6107 UPDATE "issue" SET "admission_snapshot_id" = "latest_snapshot_id"
6108 WHERE "id" = "issue_id_p";
6109 ELSIF "persist"."state" = 'discussion' THEN
6110 UPDATE "issue" SET "half_freeze_snapshot_id" = "latest_snapshot_id"
6111 WHERE "id" = "issue_id_p";
6112 ELSIF "persist"."state" = 'verification' THEN
6113 UPDATE "issue" SET "full_freeze_snapshot_id" = "latest_snapshot_id"
6114 WHERE "id" = "issue_id_p";
6115 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
6116 FOR "initiative_row" IN
6117 SELECT * FROM "initiative"
6118 WHERE "issue_id" = "issue_id_p" AND "revoked" ISNULL
6119 FOR UPDATE
6120 LOOP
6121 IF
6122 "initiative_row"."polling" OR
6123 "initiative_row"."satisfied_supporter_count" >=
6124 "issue_row"."initiative_quorum"
6125 THEN
6126 UPDATE "initiative" SET "admitted" = TRUE
6127 WHERE "id" = "initiative_row"."id";
6128 ELSE
6129 UPDATE "initiative" SET "admitted" = FALSE
6130 WHERE "id" = "initiative_row"."id";
6131 END IF;
6132 END LOOP;
6133 END IF;
6134 END IF;
6135 RETURN "persist";
6136 END IF;
6137 IF
6138 "persist"."state" IN ('admission', 'discussion', 'verification') AND
6139 coalesce("persist"."harmonic_weights_set", FALSE) = FALSE
6140 THEN
6141 PERFORM "set_harmonic_initiative_weights"("issue_id_p");
6142 "persist"."harmonic_weights_set" = TRUE;
6143 IF
6144 "persist"."phase_finished" OR
6145 "persist"."issue_revoked" OR
6146 "persist"."state" = 'admission'
6147 THEN
6148 RETURN "persist";
6149 ELSE
6150 RETURN NULL;
6151 END IF;
6152 END IF;
6153 IF "persist"."issue_revoked" THEN
6154 IF "persist"."state" = 'admission' THEN
6155 "state_v" := 'canceled_revoked_before_accepted';
6156 ELSIF "persist"."state" = 'discussion' THEN
6157 "state_v" := 'canceled_after_revocation_during_discussion';
6158 ELSIF "persist"."state" = 'verification' THEN
6159 "state_v" := 'canceled_after_revocation_during_verification';
6160 END IF;
6161 UPDATE "issue" SET
6162 "state" = "state_v",
6163 "closed" = "phase_finished",
6164 "phase_finished" = NULL
6165 WHERE "id" = "issue_id_p";
6166 RETURN NULL;
6167 END IF;
6168 IF "persist"."state" = 'admission' THEN
6169 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
6170 FOR UPDATE;
6171 IF "issue_row"."phase_finished" NOTNULL THEN
6172 UPDATE "issue" SET
6173 "state" = 'canceled_issue_not_accepted',
6174 "closed" = "phase_finished",
6175 "phase_finished" = NULL
6176 WHERE "id" = "issue_id_p";
6177 END IF;
6178 RETURN NULL;
6179 END IF;
6180 IF "persist"."phase_finished" THEN
6181 IF "persist"."state" = 'discussion' THEN
6182 UPDATE "issue" SET
6183 "state" = 'verification',
6184 "half_frozen" = "phase_finished",
6185 "phase_finished" = NULL
6186 WHERE "id" = "issue_id_p";
6187 RETURN NULL;
6188 END IF;
6189 IF "persist"."state" = 'verification' THEN
6190 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
6191 FOR UPDATE;
6192 SELECT * INTO "policy_row" FROM "policy"
6193 WHERE "id" = "issue_row"."policy_id";
6194 IF EXISTS (
6195 SELECT NULL FROM "initiative"
6196 WHERE "issue_id" = "issue_id_p" AND "admitted" = TRUE
6197 ) THEN
6198 UPDATE "issue" SET
6199 "state" = 'voting',
6200 "fully_frozen" = "phase_finished",
6201 "phase_finished" = NULL
6202 WHERE "id" = "issue_id_p";
6203 ELSE
6204 UPDATE "issue" SET
6205 "state" = 'canceled_no_initiative_admitted',
6206 "fully_frozen" = "phase_finished",
6207 "closed" = "phase_finished",
6208 "phase_finished" = NULL
6209 WHERE "id" = "issue_id_p";
6210 -- NOTE: The following DELETE statements have effect only when
6211 -- issue state has been manipulated
6212 DELETE FROM "direct_voter" WHERE "issue_id" = "issue_id_p";
6213 DELETE FROM "delegating_voter" WHERE "issue_id" = "issue_id_p";
6214 DELETE FROM "battle" WHERE "issue_id" = "issue_id_p";
6215 END IF;
6216 RETURN NULL;
6217 END IF;
6218 IF "persist"."state" = 'voting' THEN
6219 IF coalesce("persist"."closed_voting", FALSE) = FALSE THEN
6220 PERFORM "close_voting"("issue_id_p");
6221 "persist"."closed_voting" = TRUE;
6222 RETURN "persist";
6223 END IF;
6224 PERFORM "calculate_ranks"("issue_id_p");
6225 RETURN NULL;
6226 END IF;
6227 END IF;
6228 RAISE WARNING 'should not happen';
6229 RETURN NULL;
6230 END;
6231 $$;
6233 COMMENT ON FUNCTION "check_issue"
6234 ( "issue"."id"%TYPE,
6235 "check_issue_persistence" )
6236 IS 'Precalculate supporter counts etc. for a given issue, and check, if status change is required, and perform the status change when necessary; Function must be called multiple times with the previous result as second parameter, until the result is NULL (see source code of function "check_everything")';
6239 CREATE FUNCTION "check_everything"()
6240 RETURNS VOID
6241 LANGUAGE 'plpgsql' VOLATILE AS $$
6242 DECLARE
6243 "area_id_v" "area"."id"%TYPE;
6244 "snapshot_id_v" "snapshot"."id"%TYPE;
6245 "issue_id_v" "issue"."id"%TYPE;
6246 "persist_v" "check_issue_persistence";
6247 BEGIN
6248 RAISE WARNING 'Function "check_everything" should only be used for development and debugging purposes';
6249 DELETE FROM "expired_session";
6250 DELETE FROM "expired_token";
6251 DELETE FROM "expired_snapshot";
6252 PERFORM "check_activity"();
6253 PERFORM "calculate_member_counts"();
6254 FOR "area_id_v" IN SELECT "id" FROM "area_with_unaccepted_issues" LOOP
6255 SELECT "take_snapshot"(NULL, "area_id_v") INTO "snapshot_id_v";
6256 PERFORM "finish_snapshot"("issue_id") FROM "snapshot_issue"
6257 WHERE "snapshot_id" = "snapshot_id_v";
6258 LOOP
6259 EXIT WHEN "issue_admission"("area_id_v") = FALSE;
6260 END LOOP;
6261 END LOOP;
6262 FOR "issue_id_v" IN SELECT "id" FROM "open_issue" LOOP
6263 "persist_v" := NULL;
6264 LOOP
6265 "persist_v" := "check_issue"("issue_id_v", "persist_v");
6266 EXIT WHEN "persist_v" ISNULL;
6267 END LOOP;
6268 END LOOP;
6269 RETURN;
6270 END;
6271 $$;
6273 COMMENT ON FUNCTION "check_everything"() IS 'Amongst other regular tasks, this function performs "check_issue" for every open issue. Use this function only for development and debugging purposes, as you may run into locking and/or serialization problems in productive environments. For production, use lf_update binary instead';
6277 ----------------------
6278 -- Deletion of data --
6279 ----------------------
6282 CREATE FUNCTION "clean_issue"("issue_id_p" "issue"."id"%TYPE)
6283 RETURNS VOID
6284 LANGUAGE 'plpgsql' VOLATILE AS $$
6285 BEGIN
6286 IF EXISTS (
6287 SELECT NULL FROM "issue" WHERE "id" = "issue_id_p" AND "cleaned" ISNULL
6288 ) THEN
6289 -- override protection triggers:
6290 INSERT INTO "temporary_transaction_data" ("key", "value")
6291 VALUES ('override_protection_triggers', TRUE::TEXT);
6292 -- clean data:
6293 DELETE FROM "delegating_voter"
6294 WHERE "issue_id" = "issue_id_p";
6295 DELETE FROM "direct_voter"
6296 WHERE "issue_id" = "issue_id_p";
6297 DELETE FROM "delegating_interest_snapshot"
6298 WHERE "issue_id" = "issue_id_p";
6299 DELETE FROM "direct_interest_snapshot"
6300 WHERE "issue_id" = "issue_id_p";
6301 DELETE FROM "non_voter"
6302 WHERE "issue_id" = "issue_id_p";
6303 DELETE FROM "delegation"
6304 WHERE "issue_id" = "issue_id_p";
6305 DELETE FROM "supporter"
6306 USING "initiative" -- NOTE: due to missing index on issue_id
6307 WHERE "initiative"."issue_id" = "issue_id_p"
6308 AND "supporter"."initiative_id" = "initiative_id";
6309 -- mark issue as cleaned:
6310 UPDATE "issue" SET "cleaned" = now() WHERE "id" = "issue_id_p";
6311 -- finish overriding protection triggers (avoids garbage):
6312 DELETE FROM "temporary_transaction_data"
6313 WHERE "key" = 'override_protection_triggers';
6314 END IF;
6315 RETURN;
6316 END;
6317 $$;
6319 COMMENT ON FUNCTION "clean_issue"("issue"."id"%TYPE) IS 'Delete discussion data and votes belonging to an issue';
6322 CREATE FUNCTION "delete_member"("member_id_p" "member"."id"%TYPE)
6323 RETURNS VOID
6324 LANGUAGE 'plpgsql' VOLATILE AS $$
6325 BEGIN
6326 UPDATE "member" SET
6327 "last_login" = NULL,
6328 "last_delegation_check" = NULL,
6329 "login" = NULL,
6330 "password" = NULL,
6331 "authority" = NULL,
6332 "authority_uid" = NULL,
6333 "authority_login" = NULL,
6334 "deleted" = coalesce("deleted", now()),
6335 "locked" = TRUE,
6336 "active" = FALSE,
6337 "notify_email" = NULL,
6338 "notify_email_unconfirmed" = NULL,
6339 "notify_email_secret" = NULL,
6340 "notify_email_secret_expiry" = NULL,
6341 "notify_email_lock_expiry" = NULL,
6342 "disable_notifications" = TRUE,
6343 "notification_counter" = DEFAULT,
6344 "notification_sample_size" = 0,
6345 "notification_dow" = NULL,
6346 "notification_hour" = NULL,
6347 "notification_sent" = NULL,
6348 "login_recovery_expiry" = NULL,
6349 "password_reset_secret" = NULL,
6350 "password_reset_secret_expiry" = NULL,
6351 "location" = NULL
6352 WHERE "id" = "member_id_p";
6353 -- "text_search_data" is updated by triggers
6354 DELETE FROM "member_settings" WHERE "member_id" = "member_id_p";
6355 DELETE FROM "member_profile" WHERE "member_id" = "member_id_p";
6356 DELETE FROM "rendered_member_statement" WHERE "member_id" = "member_id_p";
6357 DELETE FROM "member_image" WHERE "member_id" = "member_id_p";
6358 DELETE FROM "contact" WHERE "member_id" = "member_id_p";
6359 DELETE FROM "ignored_member" WHERE "member_id" = "member_id_p";
6360 DELETE FROM "session" WHERE "member_id" = "member_id_p";
6361 DELETE FROM "member_application" WHERE "member_id" = "member_id_p";
6362 DELETE FROM "token" WHERE "member_id" = "member_id_p";
6363 DELETE FROM "subscription" WHERE "member_id" = "member_id_p";
6364 DELETE FROM "ignored_area" WHERE "member_id" = "member_id_p";
6365 DELETE FROM "ignored_initiative" WHERE "member_id" = "member_id_p";
6366 DELETE FROM "delegation" WHERE "truster_id" = "member_id_p";
6367 DELETE FROM "non_voter" WHERE "member_id" = "member_id_p";
6368 DELETE FROM "direct_voter" USING "issue"
6369 WHERE "direct_voter"."issue_id" = "issue"."id"
6370 AND "issue"."closed" ISNULL
6371 AND "member_id" = "member_id_p";
6372 DELETE FROM "notification_initiative_sent" WHERE "member_id" = "member_id_p";
6373 RETURN;
6374 END;
6375 $$;
6377 COMMENT ON FUNCTION "delete_member"("member_id_p" "member"."id"%TYPE) IS 'Deactivate member and clear certain settings and data of this member (data protection)';
6380 CREATE FUNCTION "delete_private_data"()
6381 RETURNS VOID
6382 LANGUAGE 'plpgsql' VOLATILE AS $$
6383 BEGIN
6384 DELETE FROM "temporary_transaction_data";
6385 DELETE FROM "temporary_suggestion_counts";
6386 DELETE FROM "member" WHERE "activated" ISNULL;
6387 UPDATE "member" SET
6388 "invite_code" = NULL,
6389 "invite_code_expiry" = NULL,
6390 "admin_comment" = NULL,
6391 "last_login" = NULL,
6392 "last_delegation_check" = NULL,
6393 "login" = NULL,
6394 "password" = NULL,
6395 "authority" = NULL,
6396 "authority_uid" = NULL,
6397 "authority_login" = NULL,
6398 "lang" = NULL,
6399 "notify_email" = NULL,
6400 "notify_email_unconfirmed" = NULL,
6401 "notify_email_secret" = NULL,
6402 "notify_email_secret_expiry" = NULL,
6403 "notify_email_lock_expiry" = NULL,
6404 "disable_notifications" = TRUE,
6405 "notification_counter" = DEFAULT,
6406 "notification_sample_size" = 0,
6407 "notification_dow" = NULL,
6408 "notification_hour" = NULL,
6409 "notification_sent" = NULL,
6410 "login_recovery_expiry" = NULL,
6411 "password_reset_secret" = NULL,
6412 "password_reset_secret_expiry" = NULL,
6413 "location" = NULL;
6414 -- "text_search_data" is updated by triggers
6415 DELETE FROM "verification";
6416 DELETE FROM "member_settings";
6417 DELETE FROM "member_useterms";
6418 DELETE FROM "member_profile";
6419 DELETE FROM "rendered_member_statement";
6420 DELETE FROM "member_image";
6421 DELETE FROM "contact";
6422 DELETE FROM "ignored_member";
6423 DELETE FROM "session";
6424 DELETE FROM "system_application";
6425 DELETE FROM "system_application_redirect_uri";
6426 DELETE FROM "dynamic_application_scope";
6427 DELETE FROM "member_application";
6428 DELETE FROM "token";
6429 DELETE FROM "subscription";
6430 DELETE FROM "ignored_area";
6431 DELETE FROM "ignored_initiative";
6432 DELETE FROM "non_voter";
6433 DELETE FROM "direct_voter" USING "issue"
6434 WHERE "direct_voter"."issue_id" = "issue"."id"
6435 AND "issue"."closed" ISNULL;
6436 DELETE FROM "event_processed";
6437 DELETE FROM "notification_initiative_sent";
6438 DELETE FROM "newsletter";
6439 RETURN;
6440 END;
6441 $$;
6443 COMMENT ON FUNCTION "delete_private_data"() IS 'Used by lf_export script. DO NOT USE on productive database, but only on a copy! This function deletes all data which should not be publicly available, and can be used to create a database dump for publication. See source code to see which data is deleted. If you need a different behaviour, copy this function and modify lf_export accordingly, to avoid data-leaks after updating.';
6447 COMMIT;