liquid_feedback_core
view core.sql @ 573:f28662013308
Experimental workaround for missing spatio-temporal index when looking up recently closed initiatives (with LIMIT) inside a bounding box
| author | jbe |
|---|---|
| date | Sun Oct 01 22:36:58 2017 +0200 (2017-10-01) |
| parents | ed3c3d8bd16b |
| 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 "discovery_baseurl" TEXT,
386 "client_id" TEXT NOT NULL UNIQUE,
387 "default_redirect_uri" TEXT NOT NULL,
388 "cert_common_name" TEXT,
389 "client_cred_scope" TEXT,
390 "flow" "authflow",
391 "automatic_scope" TEXT,
392 "permitted_scope" TEXT,
393 "forbidden_scope" TEXT );
395 COMMENT ON TABLE "system_application" IS 'OAuth 2.0 clients that are registered by the system administrator';
397 COMMENT ON COLUMN "system_application"."name" IS 'Human readable name of application';
398 COMMENT ON COLUMN "system_application"."discovery_baseurl" IS 'Base URL for application discovery; NULL for hidden application';
399 COMMENT ON COLUMN "system_application"."client_id" IS 'OAuth 2.0 "client_id"';
400 COMMENT ON COLUMN "system_application"."cert_common_name" IS 'Value for CN field of TLS client certificate';
401 COMMENT ON COLUMN "system_application"."client_cred_scope" IS 'Space-separated list of scopes; If set, Client Credentials Grant is allowed; value determines scope';
402 COMMENT ON COLUMN "system_application"."flow" IS 'If set to ''code'' or ''token'', then Authorization Code or Implicit flow is allowed respectively';
403 COMMENT ON COLUMN "system_application"."automatic_scope" IS 'Space-separated list of scopes; Automatically granted scope for Authorization Code or Implicit flow';
404 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';
405 COMMENT ON COLUMN "system_application"."forbidden_scope" IS 'Space-separated list of scopes that may not be granted to the application by a member';
408 CREATE TABLE "system_application_redirect_uri" (
409 PRIMARY KEY ("system_application_id", "redirect_uri"),
410 "system_application_id" INT4 REFERENCES "system_application" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
411 "redirect_uri" TEXT );
413 COMMENT ON TABLE "system_application_redirect_uri" IS 'Additional OAuth 2.0 redirection endpoints, which may be selected through the "redirect_uri" GET parameter';
416 CREATE TABLE "dynamic_application_scope" (
417 PRIMARY KEY ("redirect_uri", "flow", "scope"),
418 "redirect_uri" TEXT,
419 "flow" TEXT,
420 "scope" TEXT,
421 "expiry" TIMESTAMPTZ NOT NULL DEFAULT now() + '24 hours' );
422 CREATE INDEX "dynamic_application_scope_redirect_uri_scope_idx" ON "dynamic_application_scope" ("redirect_uri", "flow", "scope");
423 CREATE INDEX "dynamic_application_scope_expiry_idx" ON "dynamic_application_scope" ("expiry");
425 COMMENT ON TABLE "dynamic_application_scope" IS 'Dynamic OAuth 2.0 client registration data';
427 COMMENT ON COLUMN "dynamic_application_scope"."redirect_uri" IS 'Redirection endpoint for which the registration has been done';
428 COMMENT ON COLUMN "dynamic_application_scope"."flow" IS 'OAuth 2.0 flow for which the registration has been done (see also "system_application"."flow")';
429 COMMENT ON COLUMN "dynamic_application_scope"."scope" IS 'Single scope without space characters (use multiple rows for more scopes)';
430 COMMENT ON COLUMN "dynamic_application_scope"."expiry" IS 'Expiry unless renewed';
433 CREATE TABLE "member_application" (
434 "id" SERIAL4 PRIMARY KEY,
435 UNIQUE ("system_application_id", "member_id"),
436 UNIQUE ("domain", "member_id"),
437 "member_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
438 "system_application_id" INT4 REFERENCES "system_application" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
439 "domain" TEXT,
440 "session_id" INT8,
441 FOREIGN KEY ("member_id", "session_id") REFERENCES "session" ("member_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
442 "scope" TEXT NOT NULL,
443 CONSTRAINT "system_application_or_domain_but_not_both" CHECK (
444 ("system_application_id" NOTNULL AND "domain" ISNULL) OR
445 ("system_application_id" ISNULL AND "domain" NOTNULL) ) );
446 CREATE INDEX "member_application_member_id_idx" ON "member_application" ("member_id");
448 COMMENT ON TABLE "member_application" IS 'Application authorized by a member';
450 COMMENT ON COLUMN "member_application"."system_application_id" IS 'If set, then application is a system application';
451 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';
452 COMMENT ON COLUMN "member_application"."session_id" IS 'If set, registration ends with session';
453 COMMENT ON COLUMN "member_application"."scope" IS 'Granted scope as space-separated list of strings';
456 CREATE TYPE "token_type" AS ENUM ('authorization', 'refresh', 'access');
458 COMMENT ON TYPE "token_type" IS 'Types for entries in "token" table';
461 CREATE TABLE "token" (
462 "id" SERIAL8 PRIMARY KEY,
463 "token" TEXT NOT NULL UNIQUE,
464 "token_type" "token_type" NOT NULL,
465 "authorization_token_id" INT8 REFERENCES "token" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
466 "member_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
467 "system_application_id" INT4 REFERENCES "system_application" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
468 "domain" TEXT,
469 FOREIGN KEY ("member_id", "domain") REFERENCES "member_application" ("member_id", "domain") ON DELETE CASCADE ON UPDATE CASCADE,
470 "session_id" INT8,
471 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"
472 "redirect_uri" TEXT,
473 "redirect_uri_explicit" BOOLEAN,
474 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
475 "expiry" TIMESTAMPTZ DEFAULT now() + '1 hour',
476 "used" BOOLEAN NOT NULL DEFAULT FALSE,
477 "scope" TEXT NOT NULL,
478 CONSTRAINT "access_token_needs_expiry"
479 CHECK ("token_type" != 'access'::"token_type" OR "expiry" NOTNULL),
480 CONSTRAINT "authorization_token_needs_redirect_uri"
481 CHECK ("token_type" != 'authorization'::"token_type" OR ("redirect_uri" NOTNULL AND "redirect_uri_explicit" NOTNULL) ) );
482 CREATE INDEX "token_member_id_idx" ON "token" ("member_id");
483 CREATE INDEX "token_authorization_token_id_idx" ON "token" ("authorization_token_id");
484 CREATE INDEX "token_expiry_idx" ON "token" ("expiry");
486 COMMENT ON TABLE "token" IS 'Issued OAuth 2.0 authorization codes and access/refresh tokens';
488 COMMENT ON COLUMN "token"."token" IS 'String secret (the actual token)';
489 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)';
490 COMMENT ON COLUMN "token"."system_application_id" IS 'If set, then application is a system application';
491 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';
492 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''';
493 COMMENT ON COLUMN "token"."redirect_uri" IS 'Authorization codes must be bound to a specific redirect URI';
494 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)';
495 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';
496 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)';
497 COMMENT ON COLUMN "token"."scope" IS 'Scope as space-separated list of strings (detached scopes are marked with ''_detached'' suffix)';
500 CREATE TABLE "token_scope" (
501 PRIMARY KEY ("token_id", "index"),
502 "token_id" INT8 REFERENCES "token" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
503 "index" INT4,
504 "scope" TEXT NOT NULL );
506 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';
509 CREATE TYPE "defeat_strength" AS ENUM ('simple', 'tuple');
511 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';
514 CREATE TYPE "tie_breaking" AS ENUM ('simple', 'variant1', 'variant2');
516 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';
519 CREATE TABLE "policy" (
520 "id" SERIAL4 PRIMARY KEY,
521 "index" INT4 NOT NULL,
522 "active" BOOLEAN NOT NULL DEFAULT TRUE,
523 "name" TEXT NOT NULL UNIQUE,
524 "description" TEXT NOT NULL DEFAULT '',
525 "polling" BOOLEAN NOT NULL DEFAULT FALSE,
526 "min_admission_time" INTERVAL,
527 "max_admission_time" INTERVAL,
528 "discussion_time" INTERVAL,
529 "verification_time" INTERVAL,
530 "voting_time" INTERVAL,
531 "issue_quorum" INT4 CHECK ("issue_quorum" >= 1),
532 "issue_quorum_num" INT4,
533 "issue_quorum_den" INT4,
534 "initiative_quorum" INT4 NOT NULL CHECK ("initiative_quorum" >= 1),
535 "initiative_quorum_num" INT4 NOT NULL,
536 "initiative_quorum_den" INT4 NOT NULL,
537 "defeat_strength" "defeat_strength" NOT NULL DEFAULT 'tuple',
538 "tie_breaking" "tie_breaking" NOT NULL DEFAULT 'variant1',
539 "direct_majority_num" INT4 NOT NULL DEFAULT 1,
540 "direct_majority_den" INT4 NOT NULL DEFAULT 2,
541 "direct_majority_strict" BOOLEAN NOT NULL DEFAULT TRUE,
542 "direct_majority_positive" INT4 NOT NULL DEFAULT 0,
543 "direct_majority_non_negative" INT4 NOT NULL DEFAULT 0,
544 "indirect_majority_num" INT4 NOT NULL DEFAULT 1,
545 "indirect_majority_den" INT4 NOT NULL DEFAULT 2,
546 "indirect_majority_strict" BOOLEAN NOT NULL DEFAULT TRUE,
547 "indirect_majority_positive" INT4 NOT NULL DEFAULT 0,
548 "indirect_majority_non_negative" INT4 NOT NULL DEFAULT 0,
549 "no_reverse_beat_path" BOOLEAN NOT NULL DEFAULT FALSE,
550 "no_multistage_majority" BOOLEAN NOT NULL DEFAULT FALSE,
551 CONSTRAINT "issue_quorum_if_and_only_if_not_polling" CHECK (
552 "polling" = ("issue_quorum" ISNULL) AND
553 "polling" = ("issue_quorum_num" ISNULL) AND
554 "polling" = ("issue_quorum_den" ISNULL) ),
555 CONSTRAINT "min_admission_time_smaller_than_max_admission_time" CHECK (
556 "min_admission_time" < "max_admission_time" ),
557 CONSTRAINT "timing_null_or_not_null_constraints" CHECK (
558 ( "polling" = FALSE AND
559 "min_admission_time" NOTNULL AND "max_admission_time" NOTNULL AND
560 "discussion_time" NOTNULL AND
561 "verification_time" NOTNULL AND
562 "voting_time" NOTNULL ) OR
563 ( "polling" = TRUE AND
564 "min_admission_time" ISNULL AND "max_admission_time" ISNULL AND
565 "discussion_time" NOTNULL AND
566 "verification_time" NOTNULL AND
567 "voting_time" NOTNULL ) OR
568 ( "polling" = TRUE AND
569 "min_admission_time" ISNULL AND "max_admission_time" ISNULL AND
570 "discussion_time" ISNULL AND
571 "verification_time" ISNULL AND
572 "voting_time" ISNULL ) ),
573 CONSTRAINT "no_reverse_beat_path_requires_tuple_defeat_strength" CHECK (
574 "defeat_strength" = 'tuple'::"defeat_strength" OR
575 "no_reverse_beat_path" = FALSE ) );
576 CREATE INDEX "policy_active_idx" ON "policy" ("active");
578 COMMENT ON TABLE "policy" IS 'Policies for a particular proceeding type (timelimits, quorum)';
580 COMMENT ON COLUMN "policy"."index" IS 'Determines the order in listings';
581 COMMENT ON COLUMN "policy"."active" IS 'TRUE = policy can be used for new issues';
582 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';
583 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"';
584 COMMENT ON COLUMN "policy"."max_admission_time" IS 'Maximum duration of issue state ''admission''; Maximum time an issue stays open without being "accepted"';
585 COMMENT ON COLUMN "policy"."discussion_time" IS 'Duration of issue state ''discussion''; Regular time until an issue is "half_frozen" after being "accepted"';
586 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"';
587 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'')';
588 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';
589 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)';
590 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)';
591 COMMENT ON COLUMN "policy"."initiative_quorum" IS 'Absolute number of satisfied supporters to be reached by an initiative to be "admitted" for voting';
592 COMMENT ON COLUMN "policy"."initiative_quorum_num" IS 'Numerator of satisfied supporter quorum to be reached by an initiative to be "admitted" for voting';
593 COMMENT ON COLUMN "policy"."initiative_quorum_den" IS 'Denominator of satisfied supporter quorum to be reached by an initiative to be "admitted" for voting';
594 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';
595 COMMENT ON COLUMN "policy"."tie_breaking" IS 'Tie-breaker for the Schulze method; see type "tie_breaking"; ''variant1'' or ''variant2'' are recommended';
596 COMMENT ON COLUMN "policy"."direct_majority_num" IS 'Numerator of fraction of neccessary direct majority for initiatives to be attainable as winner';
597 COMMENT ON COLUMN "policy"."direct_majority_den" IS 'Denominator of fraction of neccessary direct majority for initaitives to be attainable as winner';
598 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.';
599 COMMENT ON COLUMN "policy"."direct_majority_positive" IS 'Absolute number of "positive_votes" neccessary for an initiative to be attainable as winner';
600 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';
601 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';
602 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';
603 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.';
604 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';
605 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';
606 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.';
607 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").';
610 CREATE TABLE "unit" (
611 "id" SERIAL4 PRIMARY KEY,
612 "parent_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
613 "active" BOOLEAN NOT NULL DEFAULT TRUE,
614 "name" TEXT NOT NULL,
615 "description" TEXT NOT NULL DEFAULT '',
616 "external_reference" TEXT,
617 "member_count" INT4,
618 "location" JSONB,
619 "text_search_data" TSVECTOR );
620 CREATE INDEX "unit_root_idx" ON "unit" ("id") WHERE "parent_id" ISNULL;
621 CREATE INDEX "unit_parent_id_idx" ON "unit" ("parent_id");
622 CREATE INDEX "unit_active_idx" ON "unit" ("active");
623 CREATE INDEX "unit_location_idx" ON "unit" USING gist ((GeoJSON_to_ecluster("location")));
624 CREATE INDEX "unit_text_search_data_idx" ON "unit" USING gin ("text_search_data");
625 CREATE TRIGGER "update_text_search_data"
626 BEFORE INSERT OR UPDATE ON "unit"
627 FOR EACH ROW EXECUTE PROCEDURE
628 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
629 "name", "description" );
631 COMMENT ON TABLE "unit" IS 'Organizational units organized as trees; Delegations are not inherited through these trees.';
633 COMMENT ON COLUMN "unit"."parent_id" IS 'Parent id of tree node; Multiple roots allowed';
634 COMMENT ON COLUMN "unit"."active" IS 'TRUE means new issues can be created in areas of this unit';
635 COMMENT ON COLUMN "unit"."external_reference" IS 'Opaque data field to store an external reference';
636 COMMENT ON COLUMN "unit"."member_count" IS 'Count of members as determined by column "voting_right" in table "privilege" (only active members counted)';
637 COMMENT ON COLUMN "unit"."location" IS 'Geographic location on earth as GeoJSON object indicating valid coordinates for initiatives of issues with this policy';
640 CREATE TABLE "subscription" (
641 PRIMARY KEY ("member_id", "unit_id"),
642 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
643 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
644 CREATE INDEX "subscription_unit_id_idx" ON "subscription" ("unit_id");
646 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';
649 CREATE TABLE "area" (
650 UNIQUE ("unit_id", "id"), -- index needed for foreign-key on table "event"
651 "id" SERIAL4 PRIMARY KEY,
652 "unit_id" INT4 NOT NULL REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
653 "active" BOOLEAN NOT NULL DEFAULT TRUE,
654 "name" TEXT NOT NULL,
655 "description" TEXT NOT NULL DEFAULT '',
656 "quorum_standard" NUMERIC NOT NULL DEFAULT 2 CHECK ("quorum_standard" >= 0),
657 "quorum_issues" NUMERIC NOT NULL DEFAULT 1 CHECK ("quorum_issues" > 0),
658 "quorum_time" INTERVAL NOT NULL DEFAULT '1 day' CHECK ("quorum_time" > '0'::INTERVAL),
659 "quorum_exponent" NUMERIC NOT NULL DEFAULT 0.5 CHECK ("quorum_exponent" BETWEEN 0 AND 1),
660 "quorum_factor" NUMERIC NOT NULL DEFAULT 2 CHECK ("quorum_factor" >= 1),
661 "quorum_den" INT4 CHECK ("quorum_den" > 0),
662 "issue_quorum" INT4,
663 "external_reference" TEXT,
664 "location" JSONB,
665 "text_search_data" TSVECTOR );
666 CREATE INDEX "area_active_idx" ON "area" ("active");
667 CREATE INDEX "area_location_idx" ON "area" USING gist ((GeoJSON_to_ecluster("location")));
668 CREATE INDEX "area_text_search_data_idx" ON "area" USING gin ("text_search_data");
669 CREATE TRIGGER "update_text_search_data"
670 BEFORE INSERT OR UPDATE ON "area"
671 FOR EACH ROW EXECUTE PROCEDURE
672 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
673 "name", "description" );
675 COMMENT ON TABLE "area" IS 'Subject areas';
677 COMMENT ON COLUMN "area"."active" IS 'TRUE means new issues can be created in this area';
678 COMMENT ON COLUMN "area"."quorum_standard" IS 'Parameter for dynamic issue quorum: default quorum';
679 COMMENT ON COLUMN "area"."quorum_issues" IS 'Parameter for dynamic issue quorum: number of open issues for default quorum';
680 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)';
681 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';
682 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';
683 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)';
684 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"';
685 COMMENT ON COLUMN "area"."external_reference" IS 'Opaque data field to store an external reference';
686 COMMENT ON COLUMN "area"."location" IS 'Geographic location on earth as GeoJSON object indicating valid coordinates for initiatives of issues with this policy';
689 CREATE TABLE "ignored_area" (
690 PRIMARY KEY ("member_id", "area_id"),
691 "member_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
692 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
693 CREATE INDEX "ignored_area_area_id_idx" ON "ignored_area" ("area_id");
695 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';
698 CREATE TABLE "allowed_policy" (
699 PRIMARY KEY ("area_id", "policy_id"),
700 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
701 "policy_id" INT4 NOT NULL REFERENCES "policy" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
702 "default_policy" BOOLEAN NOT NULL DEFAULT FALSE );
703 CREATE UNIQUE INDEX "allowed_policy_one_default_per_area_idx" ON "allowed_policy" ("area_id") WHERE "default_policy";
705 COMMENT ON TABLE "allowed_policy" IS 'Selects which policies can be used in each area';
707 COMMENT ON COLUMN "allowed_policy"."default_policy" IS 'One policy per area can be set as default.';
710 CREATE TABLE "snapshot" (
711 UNIQUE ("issue_id", "id"), -- index needed for foreign-key on table "issue"
712 "id" SERIAL8 PRIMARY KEY,
713 "calculated" TIMESTAMPTZ NOT NULL DEFAULT now(),
714 "population" INT4,
715 "area_id" INT4 NOT NULL REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
716 "issue_id" INT4 ); -- NOTE: following (cyclic) reference is added later through ALTER command: REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE
718 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';
721 CREATE TABLE "snapshot_population" (
722 PRIMARY KEY ("snapshot_id", "member_id"),
723 "snapshot_id" INT8 REFERENCES "snapshot" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
724 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE );
726 COMMENT ON TABLE "snapshot_population" IS 'Members with voting right relevant for a snapshot';
729 CREATE TYPE "issue_state" AS ENUM (
730 'admission', 'discussion', 'verification', 'voting',
731 'canceled_by_admin',
732 'canceled_revoked_before_accepted',
733 'canceled_issue_not_accepted',
734 'canceled_after_revocation_during_discussion',
735 'canceled_after_revocation_during_verification',
736 'canceled_no_initiative_admitted',
737 'finished_without_winner', 'finished_with_winner');
739 COMMENT ON TYPE "issue_state" IS 'State of issues';
742 CREATE TABLE "issue" (
743 UNIQUE ("area_id", "id"), -- index needed for foreign-key on table "event"
744 UNIQUE ("policy_id", "id"), -- index needed for foreign-key on table "event"
745 "id" SERIAL4 PRIMARY KEY,
746 "area_id" INT4 NOT NULL REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
747 "policy_id" INT4 NOT NULL REFERENCES "policy" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
748 "admin_notice" TEXT,
749 "external_reference" TEXT,
750 "state" "issue_state" NOT NULL DEFAULT 'admission',
751 "phase_finished" TIMESTAMPTZ,
752 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
753 "accepted" TIMESTAMPTZ,
754 "half_frozen" TIMESTAMPTZ,
755 "fully_frozen" TIMESTAMPTZ,
756 "closed" TIMESTAMPTZ,
757 "cleaned" TIMESTAMPTZ,
758 "min_admission_time" INTERVAL,
759 "max_admission_time" INTERVAL,
760 "discussion_time" INTERVAL NOT NULL,
761 "verification_time" INTERVAL NOT NULL,
762 "voting_time" INTERVAL NOT NULL,
763 "calculated" TIMESTAMPTZ, -- NOTE: copy of "calculated" column of latest snapshot, but no referential integrity to avoid overhead
764 "latest_snapshot_id" INT8 REFERENCES "snapshot" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
765 "admission_snapshot_id" INT8 REFERENCES "snapshot" ("id") ON DELETE SET NULL ON UPDATE CASCADE,
766 "half_freeze_snapshot_id" INT8,
767 FOREIGN KEY ("id", "half_freeze_snapshot_id")
768 REFERENCES "snapshot" ("issue_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE,
769 "full_freeze_snapshot_id" INT8,
770 FOREIGN KEY ("id", "full_freeze_snapshot_id")
771 REFERENCES "snapshot" ("issue_id", "id") ON DELETE RESTRICT ON UPDATE CASCADE,
772 "issue_quorum" INT4,
773 "initiative_quorum" INT4,
774 "population" INT4,
775 "voter_count" INT4,
776 "status_quo_schulze_rank" INT4,
777 CONSTRAINT "admission_time_not_null_unless_instantly_accepted" CHECK (
778 ("min_admission_time" NOTNULL) = ("max_admission_time" NOTNULL) AND
779 ("min_admission_time" NOTNULL OR ("accepted" NOTNULL AND "accepted" = "created")) ),
780 CONSTRAINT "valid_state" CHECK (
781 (
782 ("accepted" ISNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL ) OR
783 ("accepted" NOTNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL ) OR
784 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" ISNULL ) OR
785 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" NOTNULL)
786 ) AND (
787 ("state" = 'admission' AND "closed" ISNULL AND "accepted" ISNULL) OR
788 ("state" = 'discussion' AND "closed" ISNULL AND "accepted" NOTNULL AND "half_frozen" ISNULL) OR
789 ("state" = 'verification' AND "closed" ISNULL AND "half_frozen" NOTNULL AND "fully_frozen" ISNULL) OR
790 ("state" = 'voting' AND "closed" ISNULL AND "fully_frozen" NOTNULL) OR
791 ("state" = 'canceled_by_admin' AND "closed" NOTNULL) OR
792 ("state" = 'canceled_revoked_before_accepted' AND "closed" NOTNULL AND "accepted" ISNULL) OR
793 ("state" = 'canceled_issue_not_accepted' AND "closed" NOTNULL AND "accepted" ISNULL) OR
794 ("state" = 'canceled_after_revocation_during_discussion' AND "closed" NOTNULL AND "half_frozen" ISNULL) OR
795 ("state" = 'canceled_after_revocation_during_verification' AND "closed" NOTNULL AND "fully_frozen" ISNULL) OR
796 ("state" = 'canceled_no_initiative_admitted' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" = "fully_frozen") OR
797 ("state" = 'finished_without_winner' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" != "fully_frozen") OR
798 ("state" = 'finished_with_winner' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" != "fully_frozen")
799 )),
800 CONSTRAINT "phase_finished_only_when_not_closed" CHECK (
801 "phase_finished" ISNULL OR "closed" ISNULL ),
802 CONSTRAINT "state_change_order" CHECK (
803 "created" <= "accepted" AND
804 "accepted" <= "half_frozen" AND
805 "half_frozen" <= "fully_frozen" AND
806 "fully_frozen" <= "closed" ),
807 CONSTRAINT "only_closed_issues_may_be_cleaned" CHECK (
808 "cleaned" ISNULL OR "closed" NOTNULL ),
809 CONSTRAINT "snapshot_required" CHECK (
810 --("accepted" ISNULL OR "admission_snapshot_id" NOTNULL) AND
811 ("half_frozen" ISNULL OR "half_freeze_snapshot_id" NOTNULL) AND
812 ("fully_frozen" ISNULL OR "full_freeze_snapshot_id" NOTNULL) ) );
813 CREATE INDEX "issue_state_idx" ON "issue" ("state");
814 CREATE INDEX "issue_created_idx" ON "issue" ("created");
815 CREATE INDEX "issue_accepted_idx" ON "issue" ("accepted");
816 CREATE INDEX "issue_half_frozen_idx" ON "issue" ("half_frozen");
817 CREATE INDEX "issue_fully_frozen_idx" ON "issue" ("fully_frozen");
818 CREATE INDEX "issue_closed_idx" ON "issue" ("closed");
819 CREATE INDEX "issue_created_idx_open" ON "issue" ("created") WHERE "closed" ISNULL;
820 CREATE INDEX "issue_closed_idx_canceled" ON "issue" ("closed") WHERE "fully_frozen" ISNULL;
821 CREATE INDEX "issue_latest_snapshot_id" ON "issue" ("latest_snapshot_id");
822 CREATE INDEX "issue_admission_snapshot_id" ON "issue" ("admission_snapshot_id");
823 CREATE INDEX "issue_half_freeze_snapshot_id" ON "issue" ("half_freeze_snapshot_id");
824 CREATE INDEX "issue_full_freeze_snapshot_id" ON "issue" ("full_freeze_snapshot_id");
826 COMMENT ON TABLE "issue" IS 'Groups of initiatives';
828 COMMENT ON COLUMN "issue"."admin_notice" IS 'Public notice by admin to explain manual interventions, or to announce corrections';
829 COMMENT ON COLUMN "issue"."external_reference" IS 'Opaque data field to store an external reference';
830 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';
831 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")';
832 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.';
833 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.';
834 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.';
835 COMMENT ON COLUMN "issue"."cleaned" IS 'Point in time, when discussion data and votes had been deleted';
836 COMMENT ON COLUMN "issue"."min_admission_time" IS 'Copied from "policy" table at creation of issue';
837 COMMENT ON COLUMN "issue"."max_admission_time" IS 'Copied from "policy" table at creation of issue';
838 COMMENT ON COLUMN "issue"."discussion_time" IS 'Copied from "policy" table at creation of issue';
839 COMMENT ON COLUMN "issue"."verification_time" IS 'Copied from "policy" table at creation of issue';
840 COMMENT ON COLUMN "issue"."voting_time" IS 'Copied from "policy" table at creation of issue';
841 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")';
842 COMMENT ON COLUMN "issue"."latest_snapshot_id" IS 'Snapshot id of most recent snapshot';
843 COMMENT ON COLUMN "issue"."admission_snapshot_id" IS 'Snapshot id when issue as accepted or canceled in admission phase';
844 COMMENT ON COLUMN "issue"."half_freeze_snapshot_id" IS 'Snapshot id at end of discussion phase';
845 COMMENT ON COLUMN "issue"."full_freeze_snapshot_id" IS 'Snapshot id at end of verification phase';
846 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';
847 COMMENT ON COLUMN "issue"."initiative_quorum" IS 'Calculated number of satisfied supporters to be reached by an initiative to be "admitted" for voting';
848 COMMENT ON COLUMN "issue"."population" IS 'Count of members in "snapshot_population" table with "snapshot_id" equal to "issue"."latest_snapshot_id"';
849 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';
850 COMMENT ON COLUMN "issue"."status_quo_schulze_rank" IS 'Schulze rank of status quo, as calculated by "calculate_ranks" function';
853 ALTER TABLE "snapshot" ADD FOREIGN KEY ("issue_id") REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE;
856 CREATE TABLE "issue_order_in_admission_state" (
857 "id" INT8 PRIMARY KEY, -- NOTE: no referential integrity due to performans/locking issues; REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
858 "order_in_area" INT4,
859 "order_in_unit" INT4 );
861 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"';
863 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';
864 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';
865 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';
868 CREATE TABLE "initiative" (
869 UNIQUE ("issue_id", "id"), -- index needed for foreign-key on table "vote"
870 "issue_id" INT4 NOT NULL REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
871 "id" SERIAL4 PRIMARY KEY,
872 "name" TEXT NOT NULL,
873 "polling" BOOLEAN NOT NULL DEFAULT FALSE,
874 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
875 "revoked" TIMESTAMPTZ,
876 "revoked_by_member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
877 "suggested_initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE SET NULL ON UPDATE CASCADE,
878 "location" JSONB,
879 "external_reference" TEXT,
880 "admitted" BOOLEAN,
881 "supporter_count" INT4,
882 "informed_supporter_count" INT4,
883 "satisfied_supporter_count" INT4,
884 "satisfied_informed_supporter_count" INT4,
885 "harmonic_weight" NUMERIC(12, 3),
886 "final_suggestion_order_calculated" BOOLEAN NOT NULL DEFAULT FALSE,
887 "first_preference_votes" INT4,
888 "positive_votes" INT4,
889 "negative_votes" INT4,
890 "direct_majority" BOOLEAN,
891 "indirect_majority" BOOLEAN,
892 "schulze_rank" INT4,
893 "better_than_status_quo" BOOLEAN,
894 "worse_than_status_quo" BOOLEAN,
895 "reverse_beat_path" BOOLEAN,
896 "multistage_majority" BOOLEAN,
897 "eligible" BOOLEAN,
898 "winner" BOOLEAN,
899 "rank" INT4,
900 "text_search_data" TSVECTOR,
901 "draft_text_search_data" TSVECTOR,
902 CONSTRAINT "all_or_none_of_revoked_and_revoked_by_member_id_must_be_null"
903 CHECK (("revoked" NOTNULL) = ("revoked_by_member_id" NOTNULL)),
904 CONSTRAINT "non_revoked_initiatives_cant_suggest_other"
905 CHECK ("revoked" NOTNULL OR "suggested_initiative_id" ISNULL),
906 CONSTRAINT "revoked_initiatives_cant_be_admitted"
907 CHECK ("revoked" ISNULL OR "admitted" ISNULL),
908 CONSTRAINT "non_admitted_initiatives_cant_contain_voting_results" CHECK (
909 ( "admitted" NOTNULL AND "admitted" = TRUE ) OR
910 ( "first_preference_votes" ISNULL AND
911 "positive_votes" ISNULL AND "negative_votes" ISNULL AND
912 "direct_majority" ISNULL AND "indirect_majority" ISNULL AND
913 "schulze_rank" ISNULL AND
914 "better_than_status_quo" ISNULL AND "worse_than_status_quo" ISNULL AND
915 "reverse_beat_path" ISNULL AND "multistage_majority" ISNULL AND
916 "eligible" ISNULL AND "winner" ISNULL AND "rank" ISNULL ) ),
917 CONSTRAINT "better_excludes_worse" CHECK (NOT ("better_than_status_quo" AND "worse_than_status_quo")),
918 CONSTRAINT "minimum_requirement_to_be_eligible" CHECK (
919 "eligible" = FALSE OR
920 ("direct_majority" AND "indirect_majority" AND "better_than_status_quo") ),
921 CONSTRAINT "winner_must_be_eligible" CHECK ("winner"=FALSE OR "eligible"=TRUE),
922 CONSTRAINT "winner_must_have_first_rank" CHECK ("winner"=FALSE OR "rank"=1),
923 CONSTRAINT "eligible_at_first_rank_is_winner" CHECK ("eligible"=FALSE OR "rank"!=1 OR "winner"=TRUE),
924 CONSTRAINT "unique_rank_per_issue" UNIQUE ("issue_id", "rank") );
925 CREATE INDEX "initiative_created_idx" ON "initiative" ("created");
926 CREATE INDEX "initiative_revoked_idx" ON "initiative" ("revoked");
927 CREATE INDEX "initiative_location_idx" ON "initiative" USING gist ((GeoJSON_to_ecluster("location")));
928 CREATE INDEX "initiative_text_search_data_idx" ON "initiative" USING gin ("text_search_data");
929 CREATE INDEX "initiative_draft_text_search_data_idx" ON "initiative" USING gin ("draft_text_search_data");
930 CREATE TRIGGER "update_text_search_data"
931 BEFORE INSERT OR UPDATE ON "initiative"
932 FOR EACH ROW EXECUTE PROCEDURE
933 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "name");
935 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.';
937 COMMENT ON COLUMN "initiative"."polling" IS 'Initiative does not need to pass the initiative quorum (see "policy"."polling")';
938 COMMENT ON COLUMN "initiative"."revoked" IS 'Point in time, when one initiator decided to revoke the initiative';
939 COMMENT ON COLUMN "initiative"."revoked_by_member_id" IS 'Member, who decided to revoke the initiative';
940 COMMENT ON COLUMN "initiative"."location" IS 'Geographic location of initiative as GeoJSON object (automatically copied from most recent draft)';
941 COMMENT ON COLUMN "initiative"."external_reference" IS 'Opaque data field to store an external reference';
942 COMMENT ON COLUMN "initiative"."admitted" IS 'TRUE, if initiative reaches the "initiative_quorum" when freezing the issue';
943 COMMENT ON COLUMN "initiative"."supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
944 COMMENT ON COLUMN "initiative"."informed_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
945 COMMENT ON COLUMN "initiative"."satisfied_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
946 COMMENT ON COLUMN "initiative"."satisfied_informed_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
947 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';
948 COMMENT ON COLUMN "initiative"."final_suggestion_order_calculated" IS 'Set to TRUE, when "proportional_order" of suggestions has been calculated the last time';
949 COMMENT ON COLUMN "initiative"."first_preference_votes" IS 'Number of direct and delegating voters who ranked this initiative as their first choice';
950 COMMENT ON COLUMN "initiative"."positive_votes" IS 'Number of direct and delegating voters who ranked this initiative better than the status quo';
951 COMMENT ON COLUMN "initiative"."negative_votes" IS 'Number of direct and delegating voters who ranked this initiative worse than the status quo';
952 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"';
953 COMMENT ON COLUMN "initiative"."indirect_majority" IS 'Same as "direct_majority", but also considering indirect beat paths';
954 COMMENT ON COLUMN "initiative"."schulze_rank" IS 'Schulze-Ranking';
955 COMMENT ON COLUMN "initiative"."better_than_status_quo" IS 'TRUE, if initiative has a schulze-ranking better than the status quo';
956 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)';
957 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''';
958 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';
959 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"';
960 COMMENT ON COLUMN "initiative"."winner" IS 'Winner is the "eligible" initiative with best "schulze_rank"';
961 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';
964 CREATE TABLE "battle" (
965 "issue_id" INT4 NOT NULL,
966 "winning_initiative_id" INT4,
967 FOREIGN KEY ("issue_id", "winning_initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
968 "losing_initiative_id" INT4,
969 FOREIGN KEY ("issue_id", "losing_initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
970 "count" INT4 NOT NULL,
971 CONSTRAINT "initiative_ids_not_equal" CHECK (
972 "winning_initiative_id" != "losing_initiative_id" OR
973 ( ("winning_initiative_id" NOTNULL AND "losing_initiative_id" ISNULL) OR
974 ("winning_initiative_id" ISNULL AND "losing_initiative_id" NOTNULL) ) ) );
975 CREATE UNIQUE INDEX "battle_winning_losing_idx" ON "battle" ("issue_id", "winning_initiative_id", "losing_initiative_id");
976 CREATE UNIQUE INDEX "battle_winning_null_idx" ON "battle" ("issue_id", "winning_initiative_id") WHERE "losing_initiative_id" ISNULL;
977 CREATE UNIQUE INDEX "battle_null_losing_idx" ON "battle" ("issue_id", "losing_initiative_id") WHERE "winning_initiative_id" ISNULL;
979 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';
982 CREATE TABLE "ignored_initiative" (
983 PRIMARY KEY ("member_id", "initiative_id"),
984 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
985 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
986 CREATE INDEX "ignored_initiative_initiative_id_idx" ON "ignored_initiative" ("initiative_id");
988 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';
991 CREATE TABLE "draft" (
992 UNIQUE ("initiative_id", "id"), -- index needed for foreign-key on table "supporter"
993 "initiative_id" INT4 NOT NULL REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
994 "id" SERIAL8 PRIMARY KEY,
995 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
996 "author_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
997 "formatting_engine" TEXT,
998 "content" TEXT NOT NULL,
999 "location" JSONB,
1000 "external_reference" TEXT,
1001 "text_search_data" TSVECTOR );
1002 CREATE INDEX "draft_created_idx" ON "draft" ("created");
1003 CREATE INDEX "draft_author_id_created_idx" ON "draft" ("author_id", "created");
1004 CREATE INDEX "draft_location_idx" ON "draft" USING gist ((GeoJSON_to_ecluster("location")));
1005 CREATE INDEX "draft_text_search_data_idx" ON "draft" USING gin ("text_search_data");
1006 CREATE TRIGGER "update_text_search_data"
1007 BEFORE INSERT OR UPDATE ON "draft"
1008 FOR EACH ROW EXECUTE PROCEDURE
1009 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "content");
1011 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.';
1013 COMMENT ON COLUMN "draft"."formatting_engine" IS 'Allows different formatting engines (i.e. wiki formats) to be used';
1014 COMMENT ON COLUMN "draft"."content" IS 'Text of the draft in a format depending on the field "formatting_engine"';
1015 COMMENT ON COLUMN "draft"."location" IS 'Geographic location of initiative as GeoJSON object (automatically copied to "initiative" table if draft is most recent)';
1016 COMMENT ON COLUMN "draft"."external_reference" IS 'Opaque data field to store an external reference';
1019 CREATE TABLE "rendered_draft" (
1020 PRIMARY KEY ("draft_id", "format"),
1021 "draft_id" INT8 REFERENCES "draft" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1022 "format" TEXT,
1023 "content" TEXT NOT NULL );
1025 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)';
1028 CREATE TABLE "suggestion" (
1029 UNIQUE ("initiative_id", "id"), -- index needed for foreign-key on table "opinion"
1030 "initiative_id" INT4 NOT NULL REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1031 "id" SERIAL8 PRIMARY KEY,
1032 "draft_id" INT8 NOT NULL,
1033 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE,
1034 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
1035 "author_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1036 "name" TEXT NOT NULL,
1037 "formatting_engine" TEXT,
1038 "content" TEXT NOT NULL DEFAULT '',
1039 "location" JSONB,
1040 "external_reference" TEXT,
1041 "text_search_data" TSVECTOR,
1042 "minus2_unfulfilled_count" INT4,
1043 "minus2_fulfilled_count" INT4,
1044 "minus1_unfulfilled_count" INT4,
1045 "minus1_fulfilled_count" INT4,
1046 "plus1_unfulfilled_count" INT4,
1047 "plus1_fulfilled_count" INT4,
1048 "plus2_unfulfilled_count" INT4,
1049 "plus2_fulfilled_count" INT4,
1050 "proportional_order" INT4 );
1051 CREATE INDEX "suggestion_created_idx" ON "suggestion" ("created");
1052 CREATE INDEX "suggestion_author_id_created_idx" ON "suggestion" ("author_id", "created");
1053 CREATE INDEX "suggestion_location_idx" ON "suggestion" USING gist ((GeoJSON_to_ecluster("location")));
1054 CREATE INDEX "suggestion_text_search_data_idx" ON "suggestion" USING gin ("text_search_data");
1055 CREATE TRIGGER "update_text_search_data"
1056 BEFORE INSERT OR UPDATE ON "suggestion"
1057 FOR EACH ROW EXECUTE PROCEDURE
1058 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
1059 "name", "content");
1061 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';
1063 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")';
1064 COMMENT ON COLUMN "suggestion"."location" IS 'Geographic location of suggestion as GeoJSON object';
1065 COMMENT ON COLUMN "suggestion"."external_reference" IS 'Opaque data field to store an external reference';
1066 COMMENT ON COLUMN "suggestion"."minus2_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1067 COMMENT ON COLUMN "suggestion"."minus2_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1068 COMMENT ON COLUMN "suggestion"."minus1_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1069 COMMENT ON COLUMN "suggestion"."minus1_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1070 COMMENT ON COLUMN "suggestion"."plus1_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1071 COMMENT ON COLUMN "suggestion"."plus1_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1072 COMMENT ON COLUMN "suggestion"."plus2_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1073 COMMENT ON COLUMN "suggestion"."plus2_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
1074 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"';
1077 CREATE TABLE "rendered_suggestion" (
1078 PRIMARY KEY ("suggestion_id", "format"),
1079 "suggestion_id" INT8 REFERENCES "suggestion" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1080 "format" TEXT,
1081 "content" TEXT NOT NULL );
1083 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)';
1086 CREATE TABLE "temporary_suggestion_counts" (
1087 "id" INT8 PRIMARY KEY, -- NOTE: no referential integrity due to performance/locking issues; REFERENCES "suggestion" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1088 "minus2_unfulfilled_count" INT4 NOT NULL,
1089 "minus2_fulfilled_count" INT4 NOT NULL,
1090 "minus1_unfulfilled_count" INT4 NOT NULL,
1091 "minus1_fulfilled_count" INT4 NOT NULL,
1092 "plus1_unfulfilled_count" INT4 NOT NULL,
1093 "plus1_fulfilled_count" INT4 NOT NULL,
1094 "plus2_unfulfilled_count" INT4 NOT NULL,
1095 "plus2_fulfilled_count" INT4 NOT NULL );
1097 COMMENT ON TABLE "temporary_suggestion_counts" IS 'Holds certain calculated values (suggestion counts) temporarily until they can be copied into table "suggestion"';
1099 COMMENT ON COLUMN "temporary_suggestion_counts"."id" IS 'References "suggestion" ("id") but has no referential integrity trigger associated, due to performance/locking issues';
1102 CREATE TABLE "privilege" (
1103 PRIMARY KEY ("unit_id", "member_id"),
1104 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1105 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1106 "admin_manager" BOOLEAN NOT NULL DEFAULT FALSE,
1107 "unit_manager" BOOLEAN NOT NULL DEFAULT FALSE,
1108 "area_manager" BOOLEAN NOT NULL DEFAULT FALSE,
1109 "member_manager" BOOLEAN NOT NULL DEFAULT FALSE,
1110 "initiative_right" BOOLEAN NOT NULL DEFAULT TRUE,
1111 "voting_right" BOOLEAN NOT NULL DEFAULT TRUE,
1112 "polling_right" BOOLEAN NOT NULL DEFAULT FALSE );
1114 COMMENT ON TABLE "privilege" IS 'Members rights related to each unit';
1116 COMMENT ON COLUMN "privilege"."admin_manager" IS 'Grant/revoke any privileges to/from other members';
1117 COMMENT ON COLUMN "privilege"."unit_manager" IS 'Create and disable sub units';
1118 COMMENT ON COLUMN "privilege"."area_manager" IS 'Create and disable areas and set area parameters';
1119 COMMENT ON COLUMN "privilege"."member_manager" IS 'Adding/removing members from the unit, granting or revoking "initiative_right" and "voting_right"';
1120 COMMENT ON COLUMN "privilege"."initiative_right" IS 'Right to create an initiative';
1121 COMMENT ON COLUMN "privilege"."voting_right" IS 'Right to support initiatives, create and rate suggestions, and to vote';
1122 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';
1125 CREATE TABLE "interest" (
1126 PRIMARY KEY ("issue_id", "member_id"),
1127 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1128 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE );
1129 CREATE INDEX "interest_member_id_idx" ON "interest" ("member_id");
1131 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.';
1134 CREATE TABLE "initiator" (
1135 PRIMARY KEY ("initiative_id", "member_id"),
1136 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1137 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1138 "accepted" BOOLEAN );
1139 CREATE INDEX "initiator_member_id_idx" ON "initiator" ("member_id");
1141 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.';
1143 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.';
1146 CREATE TABLE "supporter" (
1147 "issue_id" INT4 NOT NULL,
1148 PRIMARY KEY ("initiative_id", "member_id"),
1149 "initiative_id" INT4,
1150 "member_id" INT4,
1151 "draft_id" INT8 NOT NULL,
1152 FOREIGN KEY ("issue_id", "member_id") REFERENCES "interest" ("issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE,
1153 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE );
1154 CREATE INDEX "supporter_member_id_idx" ON "supporter" ("member_id");
1156 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.';
1158 COMMENT ON COLUMN "supporter"."issue_id" IS 'WARNING: No index: For selections use column "initiative_id" and join via table "initiative" where neccessary';
1159 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")';
1162 CREATE TABLE "opinion" (
1163 "initiative_id" INT4 NOT NULL,
1164 PRIMARY KEY ("suggestion_id", "member_id"),
1165 "suggestion_id" INT8,
1166 "member_id" INT4,
1167 "degree" INT2 NOT NULL CHECK ("degree" >= -2 AND "degree" <= 2 AND "degree" != 0),
1168 "fulfilled" BOOLEAN NOT NULL DEFAULT FALSE,
1169 FOREIGN KEY ("initiative_id", "suggestion_id") REFERENCES "suggestion" ("initiative_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1170 FOREIGN KEY ("initiative_id", "member_id") REFERENCES "supporter" ("initiative_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
1171 CREATE INDEX "opinion_member_id_initiative_id_idx" ON "opinion" ("member_id", "initiative_id");
1173 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.';
1175 COMMENT ON COLUMN "opinion"."degree" IS '2 = fulfillment required for support; 1 = fulfillment desired; -1 = fulfillment unwanted; -2 = fulfillment cancels support';
1178 CREATE TYPE "delegation_scope" AS ENUM ('unit', 'area', 'issue');
1180 COMMENT ON TYPE "delegation_scope" IS 'Scope for delegations: ''unit'', ''area'', or ''issue'' (order is relevant)';
1183 CREATE TABLE "delegation" (
1184 "id" SERIAL8 PRIMARY KEY,
1185 "truster_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1186 "trustee_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1187 "scope" "delegation_scope" NOT NULL,
1188 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1189 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1190 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1191 CONSTRAINT "cant_delegate_to_yourself" CHECK ("truster_id" != "trustee_id"),
1192 CONSTRAINT "no_unit_delegation_to_null"
1193 CHECK ("trustee_id" NOTNULL OR "scope" != 'unit'),
1194 CONSTRAINT "area_id_and_issue_id_set_according_to_scope" CHECK (
1195 ("scope" = 'unit' AND "unit_id" NOTNULL AND "area_id" ISNULL AND "issue_id" ISNULL ) OR
1196 ("scope" = 'area' AND "unit_id" ISNULL AND "area_id" NOTNULL AND "issue_id" ISNULL ) OR
1197 ("scope" = 'issue' AND "unit_id" ISNULL AND "area_id" ISNULL AND "issue_id" NOTNULL) ),
1198 UNIQUE ("unit_id", "truster_id"),
1199 UNIQUE ("area_id", "truster_id"),
1200 UNIQUE ("issue_id", "truster_id") );
1201 CREATE INDEX "delegation_truster_id_idx" ON "delegation" ("truster_id");
1202 CREATE INDEX "delegation_trustee_id_idx" ON "delegation" ("trustee_id");
1204 COMMENT ON TABLE "delegation" IS 'Delegation of vote-weight to other members';
1206 COMMENT ON COLUMN "delegation"."unit_id" IS 'Reference to unit, if delegation is unit-wide, otherwise NULL';
1207 COMMENT ON COLUMN "delegation"."area_id" IS 'Reference to area, if delegation is area-wide, otherwise NULL';
1208 COMMENT ON COLUMN "delegation"."issue_id" IS 'Reference to issue, if delegation is issue-wide, otherwise NULL';
1211 CREATE TABLE "snapshot_issue" (
1212 PRIMARY KEY ("snapshot_id", "issue_id"),
1213 "snapshot_id" INT8 REFERENCES "snapshot" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1214 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE ); -- NOTE: trigger "delete_snapshot_on_partial_delete" will delete whole "snapshot"
1215 CREATE INDEX "snapshot_issue_issue_id_idx" ON "snapshot_issue" ("issue_id");
1217 COMMENT ON TABLE "snapshot_issue" IS 'List of issues included in a snapshot';
1219 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.';
1222 CREATE TABLE "direct_interest_snapshot" (
1223 PRIMARY KEY ("snapshot_id", "issue_id", "member_id"),
1224 "snapshot_id" INT8,
1225 "issue_id" INT4,
1226 FOREIGN KEY ("snapshot_id", "issue_id")
1227 REFERENCES "snapshot_issue" ("snapshot_id", "issue_id") ON DELETE CASCADE ON UPDATE CASCADE,
1228 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1229 "weight" INT4 );
1230 CREATE INDEX "direct_interest_snapshot_member_id_idx" ON "direct_interest_snapshot" ("member_id");
1232 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';
1234 COMMENT ON COLUMN "direct_interest_snapshot"."weight" IS 'Weight of member (1 or higher) according to "delegating_interest_snapshot"';
1237 CREATE TABLE "delegating_interest_snapshot" (
1238 PRIMARY KEY ("snapshot_id", "issue_id", "member_id"),
1239 "snapshot_id" INT8,
1240 "issue_id" INT4,
1241 FOREIGN KEY ("snapshot_id", "issue_id")
1242 REFERENCES "snapshot_issue" ("snapshot_id", "issue_id") ON DELETE CASCADE ON UPDATE CASCADE,
1243 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1244 "weight" INT4,
1245 "scope" "delegation_scope" NOT NULL,
1246 "delegate_member_ids" INT4[] NOT NULL );
1247 CREATE INDEX "delegating_interest_snapshot_member_id_idx" ON "delegating_interest_snapshot" ("member_id");
1249 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';
1251 COMMENT ON COLUMN "delegating_interest_snapshot"."member_id" IS 'Delegating member';
1252 COMMENT ON COLUMN "delegating_interest_snapshot"."weight" IS 'Intermediate weight';
1253 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"';
1256 CREATE TABLE "direct_supporter_snapshot" (
1257 PRIMARY KEY ("snapshot_id", "initiative_id", "member_id"),
1258 "snapshot_id" INT8,
1259 "issue_id" INT4 NOT NULL,
1260 FOREIGN KEY ("snapshot_id", "issue_id")
1261 REFERENCES "snapshot_issue" ("snapshot_id", "issue_id") ON DELETE CASCADE ON UPDATE CASCADE,
1262 "initiative_id" INT4,
1263 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1264 "draft_id" INT8 NOT NULL,
1265 "informed" BOOLEAN NOT NULL,
1266 "satisfied" BOOLEAN NOT NULL,
1267 FOREIGN KEY ("issue_id", "initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1268 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE,
1269 FOREIGN KEY ("snapshot_id", "issue_id", "member_id") REFERENCES "direct_interest_snapshot" ("snapshot_id", "issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
1270 CREATE INDEX "direct_supporter_snapshot_member_id_idx" ON "direct_supporter_snapshot" ("member_id");
1272 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';
1274 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';
1275 COMMENT ON COLUMN "direct_supporter_snapshot"."informed" IS 'Supporter has seen the latest draft of the initiative';
1276 COMMENT ON COLUMN "direct_supporter_snapshot"."satisfied" IS 'Supporter has no "critical_opinion"s';
1279 CREATE TABLE "non_voter" (
1280 PRIMARY KEY ("member_id", "issue_id"),
1281 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1282 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
1283 CREATE INDEX "non_voter_issue_id_idx" ON "non_voter" ("issue_id");
1285 COMMENT ON TABLE "non_voter" IS 'Members who decided to not vote directly on an issue';
1288 CREATE TABLE "direct_voter" (
1289 PRIMARY KEY ("issue_id", "member_id"),
1290 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1291 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1292 "weight" INT4,
1293 "comment_changed" TIMESTAMPTZ,
1294 "formatting_engine" TEXT,
1295 "comment" TEXT,
1296 "text_search_data" TSVECTOR );
1297 CREATE INDEX "direct_voter_member_id_idx" ON "direct_voter" ("member_id");
1298 CREATE INDEX "direct_voter_text_search_data_idx" ON "direct_voter" USING gin ("text_search_data");
1299 CREATE TRIGGER "update_text_search_data"
1300 BEFORE INSERT OR UPDATE ON "direct_voter"
1301 FOR EACH ROW EXECUTE PROCEDURE
1302 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "comment");
1304 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';
1306 COMMENT ON COLUMN "direct_voter"."weight" IS 'Weight of member (1 or higher) according to "delegating_voter" table';
1307 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';
1308 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';
1309 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.';
1312 CREATE TABLE "rendered_voter_comment" (
1313 PRIMARY KEY ("issue_id", "member_id", "format"),
1314 FOREIGN KEY ("issue_id", "member_id")
1315 REFERENCES "direct_voter" ("issue_id", "member_id")
1316 ON DELETE CASCADE ON UPDATE CASCADE,
1317 "issue_id" INT4,
1318 "member_id" INT4,
1319 "format" TEXT,
1320 "content" TEXT NOT NULL );
1322 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)';
1325 CREATE TABLE "delegating_voter" (
1326 PRIMARY KEY ("issue_id", "member_id"),
1327 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1328 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
1329 "weight" INT4,
1330 "scope" "delegation_scope" NOT NULL,
1331 "delegate_member_ids" INT4[] NOT NULL );
1332 CREATE INDEX "delegating_voter_member_id_idx" ON "delegating_voter" ("member_id");
1334 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';
1336 COMMENT ON COLUMN "delegating_voter"."member_id" IS 'Delegating member';
1337 COMMENT ON COLUMN "delegating_voter"."weight" IS 'Intermediate weight';
1338 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"';
1341 CREATE TABLE "vote" (
1342 "issue_id" INT4 NOT NULL,
1343 PRIMARY KEY ("initiative_id", "member_id"),
1344 "initiative_id" INT4,
1345 "member_id" INT4,
1346 "grade" INT4 NOT NULL,
1347 "first_preference" BOOLEAN,
1348 FOREIGN KEY ("issue_id", "initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1349 FOREIGN KEY ("issue_id", "member_id") REFERENCES "direct_voter" ("issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE,
1350 CONSTRAINT "first_preference_flag_only_set_on_positive_grades"
1351 CHECK ("grade" > 0 OR "first_preference" ISNULL) );
1352 CREATE INDEX "vote_member_id_idx" ON "vote" ("member_id");
1354 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';
1356 COMMENT ON COLUMN "vote"."issue_id" IS 'WARNING: No index: For selections use column "initiative_id" and join via table "initiative" where neccessary';
1357 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.';
1358 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.';
1361 CREATE TYPE "event_type" AS ENUM (
1362 'unit_created',
1363 'unit_updated',
1364 'area_created',
1365 'area_updated',
1366 'policy_created',
1367 'policy_updated',
1368 'issue_state_changed',
1369 'initiative_created_in_new_issue',
1370 'initiative_created_in_existing_issue',
1371 'initiative_revoked',
1372 'new_draft_created',
1373 'suggestion_created',
1374 'suggestion_deleted',
1375 'member_activated',
1376 'member_deleted',
1377 'member_active',
1378 'member_name_updated',
1379 'member_profile_updated',
1380 'member_image_updated',
1381 'interest',
1382 'initiator',
1383 'support',
1384 'support_updated',
1385 'suggestion_rated',
1386 'delegation',
1387 'contact' );
1389 COMMENT ON TYPE "event_type" IS 'Type used for column "event" of table "event"';
1392 CREATE TABLE "event" (
1393 "id" SERIAL8 PRIMARY KEY,
1394 "occurrence" TIMESTAMPTZ NOT NULL DEFAULT now(),
1395 "event" "event_type" NOT NULL,
1396 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1397 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
1398 "scope" "delegation_scope",
1399 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1400 "area_id" INT4,
1401 FOREIGN KEY ("unit_id", "area_id") REFERENCES "area" ("unit_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1402 "policy_id" INT4 REFERENCES "policy" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1403 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1404 FOREIGN KEY ("area_id", "issue_id") REFERENCES "issue" ("area_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1405 FOREIGN KEY ("policy_id", "issue_id") REFERENCES "issue" ("policy_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
1406 "state" "issue_state",
1407 "initiative_id" INT4,
1408 "draft_id" INT8,
1409 "suggestion_id" INT8,
1410 "boolean_value" BOOLEAN,
1411 "numeric_value" INT4,
1412 "text_value" TEXT,
1413 "old_text_value" TEXT,
1414 FOREIGN KEY ("issue_id", "initiative_id")
1415 REFERENCES "initiative" ("issue_id", "id")
1416 ON DELETE CASCADE ON UPDATE CASCADE,
1417 FOREIGN KEY ("initiative_id", "draft_id")
1418 REFERENCES "draft" ("initiative_id", "id")
1419 ON DELETE CASCADE ON UPDATE CASCADE,
1420 -- NOTE: no referential integrity for suggestions because those are
1421 -- actually deleted
1422 -- FOREIGN KEY ("initiative_id", "suggestion_id")
1423 -- REFERENCES "suggestion" ("initiative_id", "id")
1424 -- ON DELETE CASCADE ON UPDATE CASCADE,
1425 CONSTRAINT "constr_for_issue_state_changed" CHECK (
1426 "event" != 'issue_state_changed' OR (
1427 "member_id" ISNULL AND
1428 "other_member_id" ISNULL AND
1429 "scope" ISNULL AND
1430 "unit_id" NOTNULL AND
1431 "area_id" NOTNULL AND
1432 "policy_id" NOTNULL AND
1433 "issue_id" NOTNULL AND
1434 "state" NOTNULL AND
1435 "initiative_id" ISNULL AND
1436 "draft_id" ISNULL AND
1437 "suggestion_id" ISNULL AND
1438 "boolean_value" ISNULL AND
1439 "numeric_value" ISNULL AND
1440 "text_value" ISNULL AND
1441 "old_text_value" ISNULL )),
1442 CONSTRAINT "constr_for_initiative_creation_or_revocation_or_new_draft" CHECK (
1443 "event" NOT IN (
1444 'initiative_created_in_new_issue',
1445 'initiative_created_in_existing_issue',
1446 'initiative_revoked',
1447 'new_draft_created'
1448 ) OR (
1449 "member_id" NOTNULL AND
1450 "other_member_id" ISNULL AND
1451 "scope" ISNULL AND
1452 "unit_id" NOTNULL AND
1453 "area_id" NOTNULL AND
1454 "policy_id" NOTNULL AND
1455 "issue_id" NOTNULL AND
1456 "state" NOTNULL AND
1457 "initiative_id" NOTNULL AND
1458 "draft_id" NOTNULL AND
1459 "suggestion_id" ISNULL AND
1460 "boolean_value" ISNULL AND
1461 "numeric_value" ISNULL AND
1462 "text_value" ISNULL AND
1463 "old_text_value" ISNULL )),
1464 CONSTRAINT "constr_for_suggestion_creation" CHECK (
1465 "event" != 'suggestion_created' OR (
1466 "member_id" NOTNULL AND
1467 "other_member_id" ISNULL AND
1468 "scope" ISNULL AND
1469 "unit_id" NOTNULL AND
1470 "area_id" NOTNULL AND
1471 "policy_id" NOTNULL AND
1472 "issue_id" NOTNULL AND
1473 "state" NOTNULL AND
1474 "initiative_id" NOTNULL AND
1475 "draft_id" ISNULL AND
1476 "suggestion_id" NOTNULL AND
1477 "boolean_value" ISNULL AND
1478 "numeric_value" ISNULL AND
1479 "text_value" ISNULL AND
1480 "old_text_value" ISNULL )),
1481 CONSTRAINT "constr_for_suggestion_removal" CHECK (
1482 "event" != 'suggestion_deleted' OR (
1483 "member_id" ISNULL AND
1484 "other_member_id" ISNULL AND
1485 "scope" ISNULL AND
1486 "unit_id" NOTNULL AND
1487 "area_id" NOTNULL AND
1488 "policy_id" NOTNULL AND
1489 "issue_id" NOTNULL AND
1490 "state" NOTNULL AND
1491 "initiative_id" NOTNULL AND
1492 "draft_id" ISNULL AND
1493 "suggestion_id" NOTNULL AND
1494 "boolean_value" ISNULL AND
1495 "numeric_value" ISNULL AND
1496 "text_value" ISNULL AND
1497 "old_text_value" ISNULL )),
1498 CONSTRAINT "constr_for_value_less_member_event" CHECK (
1499 "event" NOT IN (
1500 'member_activated',
1501 'member_deleted',
1502 'member_profile_updated',
1503 'member_image_updated'
1504 ) OR (
1505 "member_id" NOTNULL AND
1506 "other_member_id" ISNULL AND
1507 "scope" ISNULL AND
1508 "unit_id" ISNULL AND
1509 "area_id" ISNULL AND
1510 "policy_id" ISNULL AND
1511 "issue_id" ISNULL AND
1512 "state" ISNULL AND
1513 "initiative_id" ISNULL AND
1514 "draft_id" ISNULL AND
1515 "suggestion_id" ISNULL AND
1516 "boolean_value" ISNULL AND
1517 "numeric_value" ISNULL AND
1518 "text_value" ISNULL AND
1519 "old_text_value" ISNULL )),
1520 CONSTRAINT "constr_for_member_active" CHECK (
1521 "event" != 'member_active' OR (
1522 "member_id" NOTNULL AND
1523 "other_member_id" ISNULL AND
1524 "scope" ISNULL AND
1525 "unit_id" ISNULL AND
1526 "area_id" ISNULL AND
1527 "policy_id" ISNULL AND
1528 "issue_id" ISNULL AND
1529 "state" ISNULL AND
1530 "initiative_id" ISNULL AND
1531 "draft_id" ISNULL AND
1532 "suggestion_id" ISNULL AND
1533 "boolean_value" NOTNULL AND
1534 "numeric_value" ISNULL AND
1535 "text_value" ISNULL AND
1536 "old_text_value" ISNULL )),
1537 CONSTRAINT "constr_for_member_name_updated" CHECK (
1538 "event" != 'member_name_updated' OR (
1539 "member_id" NOTNULL AND
1540 "other_member_id" ISNULL AND
1541 "scope" ISNULL AND
1542 "unit_id" ISNULL AND
1543 "area_id" ISNULL AND
1544 "policy_id" ISNULL AND
1545 "issue_id" ISNULL AND
1546 "state" ISNULL AND
1547 "initiative_id" ISNULL AND
1548 "draft_id" ISNULL AND
1549 "suggestion_id" ISNULL AND
1550 "boolean_value" ISNULL AND
1551 "numeric_value" ISNULL AND
1552 "text_value" NOTNULL AND
1553 "old_text_value" NOTNULL )),
1554 CONSTRAINT "constr_for_interest" CHECK (
1555 "event" != 'interest' OR (
1556 "member_id" NOTNULL AND
1557 "other_member_id" ISNULL AND
1558 "scope" ISNULL AND
1559 "unit_id" NOTNULL AND
1560 "area_id" NOTNULL AND
1561 "policy_id" NOTNULL AND
1562 "issue_id" NOTNULL AND
1563 "state" NOTNULL AND
1564 "initiative_id" ISNULL AND
1565 "draft_id" ISNULL AND
1566 "suggestion_id" ISNULL AND
1567 "boolean_value" NOTNULL AND
1568 "numeric_value" ISNULL AND
1569 "text_value" ISNULL AND
1570 "old_text_value" ISNULL )),
1571 CONSTRAINT "constr_for_initiator" CHECK (
1572 "event" != 'initiator' OR (
1573 "member_id" NOTNULL AND
1574 "other_member_id" ISNULL AND
1575 "scope" ISNULL AND
1576 "unit_id" NOTNULL AND
1577 "area_id" NOTNULL AND
1578 "policy_id" NOTNULL AND
1579 "issue_id" NOTNULL AND
1580 "state" NOTNULL AND
1581 "initiative_id" NOTNULL AND
1582 "draft_id" ISNULL AND
1583 "suggestion_id" ISNULL AND
1584 "boolean_value" NOTNULL AND
1585 "numeric_value" ISNULL AND
1586 "text_value" ISNULL AND
1587 "old_text_value" ISNULL )),
1588 CONSTRAINT "constr_for_support" CHECK (
1589 "event" != 'support' OR (
1590 "member_id" NOTNULL AND
1591 "other_member_id" ISNULL AND
1592 "scope" ISNULL AND
1593 "unit_id" NOTNULL AND
1594 "area_id" NOTNULL AND
1595 "policy_id" NOTNULL AND
1596 "issue_id" NOTNULL AND
1597 "state" NOTNULL AND
1598 "initiative_id" NOTNULL AND
1599 ("draft_id" NOTNULL) = ("boolean_value" = TRUE) AND
1600 "suggestion_id" ISNULL AND
1601 "boolean_value" NOTNULL AND
1602 "numeric_value" ISNULL AND
1603 "text_value" ISNULL AND
1604 "old_text_value" ISNULL )),
1605 CONSTRAINT "constr_for_support_updated" CHECK (
1606 "event" != 'support_updated' OR (
1607 "member_id" NOTNULL AND
1608 "other_member_id" ISNULL AND
1609 "scope" ISNULL AND
1610 "unit_id" NOTNULL AND
1611 "area_id" NOTNULL AND
1612 "policy_id" NOTNULL AND
1613 "issue_id" NOTNULL AND
1614 "state" NOTNULL AND
1615 "initiative_id" NOTNULL AND
1616 "draft_id" NOTNULL AND
1617 "suggestion_id" ISNULL AND
1618 "boolean_value" ISNULL AND
1619 "numeric_value" ISNULL AND
1620 "text_value" ISNULL AND
1621 "old_text_value" ISNULL )),
1622 CONSTRAINT "constr_for_suggestion_rated" CHECK (
1623 "event" != 'suggestion_rated' OR (
1624 "member_id" NOTNULL AND
1625 "other_member_id" ISNULL AND
1626 "scope" ISNULL AND
1627 "unit_id" NOTNULL AND
1628 "area_id" NOTNULL AND
1629 "policy_id" NOTNULL AND
1630 "issue_id" NOTNULL AND
1631 "state" NOTNULL AND
1632 "initiative_id" NOTNULL AND
1633 "draft_id" ISNULL AND
1634 "suggestion_id" NOTNULL AND
1635 ("boolean_value" NOTNULL) = ("numeric_value" != 0) AND
1636 "numeric_value" NOTNULL AND
1637 "numeric_value" IN (-2, -1, 0, 1, 2) AND
1638 "text_value" ISNULL AND
1639 "old_text_value" ISNULL )),
1640 CONSTRAINT "constr_for_delegation" CHECK (
1641 "event" != 'delegation' OR (
1642 "member_id" NOTNULL AND
1643 (("other_member_id" ISNULL) OR ("boolean_value" = TRUE)) AND
1644 "scope" NOTNULL AND
1645 "unit_id" NOTNULL AND
1646 ("area_id" NOTNULL) = ("scope" != 'unit'::"delegation_scope") AND
1647 "policy_id" ISNULL AND
1648 ("issue_id" NOTNULL) = ("scope" = 'issue'::"delegation_scope") AND
1649 ("state" NOTNULL) = ("scope" = 'issue'::"delegation_scope") AND
1650 "initiative_id" ISNULL AND
1651 "draft_id" ISNULL AND
1652 "suggestion_id" ISNULL AND
1653 "boolean_value" NOTNULL AND
1654 "numeric_value" ISNULL AND
1655 "text_value" ISNULL AND
1656 "old_text_value" ISNULL )),
1657 CONSTRAINT "constr_for_contact" CHECK (
1658 "event" != 'contact' OR (
1659 "member_id" NOTNULL AND
1660 "other_member_id" NOTNULL AND
1661 "scope" ISNULL AND
1662 "unit_id" ISNULL AND
1663 "area_id" ISNULL AND
1664 "policy_id" ISNULL AND
1665 "issue_id" ISNULL AND
1666 "state" ISNULL AND
1667 "initiative_id" ISNULL AND
1668 "draft_id" ISNULL AND
1669 "suggestion_id" ISNULL AND
1670 "boolean_value" NOTNULL AND
1671 "numeric_value" ISNULL AND
1672 "text_value" ISNULL AND
1673 "old_text_value" ISNULL )) );
1674 CREATE INDEX "event_occurrence_idx" ON "event" ("occurrence");
1676 COMMENT ON TABLE "event" IS 'Event table, automatically filled by triggers';
1678 COMMENT ON COLUMN "event"."occurrence" IS 'Point in time, when event occurred';
1679 COMMENT ON COLUMN "event"."event" IS 'Type of event (see TYPE "event_type")';
1680 COMMENT ON COLUMN "event"."member_id" IS 'Member who caused the event, if applicable';
1681 COMMENT ON COLUMN "event"."state" IS 'If issue_id is set: state of affected issue; If state changed: new state';
1684 CREATE TABLE "event_processed" (
1685 "event_id" INT8 NOT NULL );
1686 CREATE UNIQUE INDEX "event_processed_singleton_idx" ON "event_processed" ((1));
1688 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)';
1689 COMMENT ON INDEX "event_processed_singleton_idx" IS 'This index ensures that "event_processed" only contains one row maximum.';
1692 CREATE TABLE "notification_initiative_sent" (
1693 PRIMARY KEY ("member_id", "initiative_id"),
1694 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1695 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1696 "last_draft_id" INT8 NOT NULL,
1697 "last_suggestion_id" INT8 );
1698 CREATE INDEX "notification_initiative_sent_initiative_idx" ON "notification_initiative_sent" ("initiative_id");
1700 COMMENT ON TABLE "notification_initiative_sent" IS 'Information which initiatives have been promoted to a member in a scheduled notification mail';
1702 COMMENT ON COLUMN "notification_initiative_sent"."last_draft_id" IS 'Current (i.e. last) draft_id when initiative had been promoted';
1703 COMMENT ON COLUMN "notification_initiative_sent"."last_suggestion_id" IS 'Current (i.e. last) draft_id when initiative had been promoted';
1706 CREATE TABLE "newsletter" (
1707 "id" SERIAL4 PRIMARY KEY,
1708 "published" TIMESTAMPTZ NOT NULL,
1709 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
1710 "include_all_members" BOOLEAN NOT NULL,
1711 "sent" TIMESTAMPTZ,
1712 "subject" TEXT NOT NULL,
1713 "content" TEXT NOT NULL );
1714 CREATE INDEX "newsletter_unit_id_idx" ON "newsletter" ("unit_id", "published");
1715 CREATE INDEX "newsletter_all_units_published_idx" ON "newsletter" ("published") WHERE "unit_id" ISNULL;
1716 CREATE INDEX "newsletter_published_idx" ON "newsletter" ("published");
1718 COMMENT ON TABLE "newsletter" IS 'Contains newsletters created by administrators to be sent out and for further reference';
1720 COMMENT ON COLUMN "newsletter"."published" IS 'Timestamp when the newsletter is to be sent out (and made available in the frontend)';
1721 COMMENT ON COLUMN "newsletter"."unit_id" IS 'If set, only members with voting right in the given unit are considered to be recipients';
1722 COMMENT ON COLUMN "newsletter"."include_all_members" IS 'TRUE = include all members regardless of their ''disable_notifications'' setting';
1723 COMMENT ON COLUMN "newsletter"."sent" IS 'Timestamp when the newsletter has been mailed out';
1724 COMMENT ON COLUMN "newsletter"."subject" IS 'Subject line (e.g. to be used for the email)';
1725 COMMENT ON COLUMN "newsletter"."content" IS 'Plain text content of the newsletter';
1729 ----------------------------------------------
1730 -- Writing of history entries and event log --
1731 ----------------------------------------------
1734 CREATE FUNCTION "write_member_history_trigger"()
1735 RETURNS TRIGGER
1736 LANGUAGE 'plpgsql' VOLATILE AS $$
1737 BEGIN
1738 IF
1739 ( NEW."active" != OLD."active" OR
1740 NEW."name" != OLD."name" ) AND
1741 OLD."activated" NOTNULL
1742 THEN
1743 INSERT INTO "member_history"
1744 ("member_id", "active", "name")
1745 VALUES (NEW."id", OLD."active", OLD."name");
1746 END IF;
1747 RETURN NULL;
1748 END;
1749 $$;
1751 CREATE TRIGGER "write_member_history"
1752 AFTER UPDATE ON "member" FOR EACH ROW EXECUTE PROCEDURE
1753 "write_member_history_trigger"();
1755 COMMENT ON FUNCTION "write_member_history_trigger"() IS 'Implementation of trigger "write_member_history" on table "member"';
1756 COMMENT ON TRIGGER "write_member_history" ON "member" IS 'When changing certain fields of a member, create a history entry in "member_history" table';
1759 CREATE FUNCTION "write_event_unit_trigger"()
1760 RETURNS TRIGGER
1761 LANGUAGE 'plpgsql' VOLATILE AS $$
1762 DECLARE
1763 "event_v" "event_type";
1764 BEGIN
1765 IF TG_OP = 'UPDATE' THEN
1766 IF OLD."active" = FALSE AND NEW."active" = FALSE THEN
1767 RETURN NULL;
1768 --ELSIF OLD."active" = FALSE AND NEW."active" = TRUE THEN
1769 -- "event_v" := 'unit_created';
1770 --ELSIF OLD."active" = TRUE AND NEW."active" = FALSE THEN
1771 -- "event_v" := 'unit_deleted';
1772 ELSIF OLD != NEW THEN
1773 "event_v" := 'unit_updated';
1774 ELSE
1775 RETURN NULL;
1776 END IF;
1777 ELSE
1778 "event_v" := 'unit_created';
1779 END IF;
1780 INSERT INTO "event" ("event", "unit_id") VALUES ("event_v", NEW."id");
1781 RETURN NULL;
1782 END;
1783 $$;
1785 CREATE TRIGGER "write_event_unit" AFTER INSERT OR UPDATE ON "unit"
1786 FOR EACH ROW EXECUTE PROCEDURE "write_event_unit_trigger"();
1788 COMMENT ON FUNCTION "write_event_unit_trigger"() IS 'Implementation of trigger "write_event_unit" on table "unit"';
1789 COMMENT ON TRIGGER "write_event_unit" ON "unit" IS 'Create entry in "event" table on new or changed/disabled units';
1792 CREATE FUNCTION "write_event_area_trigger"()
1793 RETURNS TRIGGER
1794 LANGUAGE 'plpgsql' VOLATILE AS $$
1795 DECLARE
1796 "event_v" "event_type";
1797 BEGIN
1798 IF TG_OP = 'UPDATE' THEN
1799 IF OLD."active" = FALSE AND NEW."active" = FALSE THEN
1800 RETURN NULL;
1801 --ELSIF OLD."active" = FALSE AND NEW."active" = TRUE THEN
1802 -- "event_v" := 'area_created';
1803 --ELSIF OLD."active" = TRUE AND NEW."active" = FALSE THEN
1804 -- "event_v" := 'area_deleted';
1805 ELSIF OLD != NEW THEN
1806 "event_v" := 'area_updated';
1807 ELSE
1808 RETURN NULL;
1809 END IF;
1810 ELSE
1811 "event_v" := 'area_created';
1812 END IF;
1813 INSERT INTO "event" ("event", "area_id") VALUES ("event_v", NEW."id");
1814 RETURN NULL;
1815 END;
1816 $$;
1818 CREATE TRIGGER "write_event_area" AFTER INSERT OR UPDATE ON "area"
1819 FOR EACH ROW EXECUTE PROCEDURE "write_event_area_trigger"();
1821 COMMENT ON FUNCTION "write_event_area_trigger"() IS 'Implementation of trigger "write_event_area" on table "area"';
1822 COMMENT ON TRIGGER "write_event_area" ON "area" IS 'Create entry in "event" table on new or changed/disabled areas';
1825 CREATE FUNCTION "write_event_policy_trigger"()
1826 RETURNS TRIGGER
1827 LANGUAGE 'plpgsql' VOLATILE AS $$
1828 DECLARE
1829 "event_v" "event_type";
1830 BEGIN
1831 IF TG_OP = 'UPDATE' THEN
1832 IF OLD."active" = FALSE AND NEW."active" = FALSE THEN
1833 RETURN NULL;
1834 --ELSIF OLD."active" = FALSE AND NEW."active" = TRUE THEN
1835 -- "event_v" := 'policy_created';
1836 --ELSIF OLD."active" = TRUE AND NEW."active" = FALSE THEN
1837 -- "event_v" := 'policy_deleted';
1838 ELSIF OLD != NEW THEN
1839 "event_v" := 'policy_updated';
1840 ELSE
1841 RETURN NULL;
1842 END IF;
1843 ELSE
1844 "event_v" := 'policy_created';
1845 END IF;
1846 INSERT INTO "event" ("event", "policy_id") VALUES ("event_v", NEW."id");
1847 RETURN NULL;
1848 END;
1849 $$;
1851 CREATE TRIGGER "write_event_policy" AFTER INSERT OR UPDATE ON "policy"
1852 FOR EACH ROW EXECUTE PROCEDURE "write_event_policy_trigger"();
1854 COMMENT ON FUNCTION "write_event_policy_trigger"() IS 'Implementation of trigger "write_event_policy" on table "policy"';
1855 COMMENT ON TRIGGER "write_event_policy" ON "policy" IS 'Create entry in "event" table on new or changed/disabled policies';
1858 CREATE FUNCTION "write_event_issue_state_changed_trigger"()
1859 RETURNS TRIGGER
1860 LANGUAGE 'plpgsql' VOLATILE AS $$
1861 DECLARE
1862 "area_row" "area"%ROWTYPE;
1863 BEGIN
1864 IF NEW."state" != OLD."state" THEN
1865 SELECT * INTO "area_row" FROM "area" WHERE "id" = NEW."area_id"
1866 FOR SHARE;
1867 INSERT INTO "event" (
1868 "event",
1869 "unit_id", "area_id", "policy_id", "issue_id", "state"
1870 ) VALUES (
1871 'issue_state_changed',
1872 "area_row"."unit_id", NEW."area_id", NEW."policy_id",
1873 NEW."id", NEW."state"
1874 );
1875 END IF;
1876 RETURN NULL;
1877 END;
1878 $$;
1880 CREATE TRIGGER "write_event_issue_state_changed"
1881 AFTER UPDATE ON "issue" FOR EACH ROW EXECUTE PROCEDURE
1882 "write_event_issue_state_changed_trigger"();
1884 COMMENT ON FUNCTION "write_event_issue_state_changed_trigger"() IS 'Implementation of trigger "write_event_issue_state_changed" on table "issue"';
1885 COMMENT ON TRIGGER "write_event_issue_state_changed" ON "issue" IS 'Create entry in "event" table on "state" change';
1888 CREATE FUNCTION "write_event_initiative_or_draft_created_trigger"()
1889 RETURNS TRIGGER
1890 LANGUAGE 'plpgsql' VOLATILE AS $$
1891 DECLARE
1892 "initiative_row" "initiative"%ROWTYPE;
1893 "issue_row" "issue"%ROWTYPE;
1894 "area_row" "area"%ROWTYPE;
1895 "event_v" "event_type";
1896 BEGIN
1897 SELECT * INTO "initiative_row" FROM "initiative"
1898 WHERE "id" = NEW."initiative_id" FOR SHARE;
1899 SELECT * INTO "issue_row" FROM "issue"
1900 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
1901 SELECT * INTO "area_row" FROM "area"
1902 WHERE "id" = "issue_row"."area_id" FOR SHARE;
1903 IF EXISTS (
1904 SELECT NULL FROM "draft"
1905 WHERE "initiative_id" = NEW."initiative_id" AND "id" != NEW."id"
1906 FOR SHARE
1907 ) THEN
1908 "event_v" := 'new_draft_created';
1909 ELSE
1910 IF EXISTS (
1911 SELECT NULL FROM "initiative"
1912 WHERE "issue_id" = "initiative_row"."issue_id"
1913 AND "id" != "initiative_row"."id"
1914 FOR SHARE
1915 ) THEN
1916 "event_v" := 'initiative_created_in_existing_issue';
1917 ELSE
1918 "event_v" := 'initiative_created_in_new_issue';
1919 END IF;
1920 END IF;
1921 INSERT INTO "event" (
1922 "event", "member_id",
1923 "unit_id", "area_id", "policy_id", "issue_id", "state",
1924 "initiative_id", "draft_id"
1925 ) VALUES (
1926 "event_v", NEW."author_id",
1927 "area_row"."unit_id", "issue_row"."area_id", "issue_row"."policy_id",
1928 "initiative_row"."issue_id", "issue_row"."state",
1929 NEW."initiative_id", NEW."id"
1930 );
1931 RETURN NULL;
1932 END;
1933 $$;
1935 CREATE TRIGGER "write_event_initiative_or_draft_created"
1936 AFTER INSERT ON "draft" FOR EACH ROW EXECUTE PROCEDURE
1937 "write_event_initiative_or_draft_created_trigger"();
1939 COMMENT ON FUNCTION "write_event_initiative_or_draft_created_trigger"() IS 'Implementation of trigger "write_event_initiative_or_draft_created" on table "issue"';
1940 COMMENT ON TRIGGER "write_event_initiative_or_draft_created" ON "draft" IS 'Create entry in "event" table on draft creation';
1943 CREATE FUNCTION "write_event_initiative_revoked_trigger"()
1944 RETURNS TRIGGER
1945 LANGUAGE 'plpgsql' VOLATILE AS $$
1946 DECLARE
1947 "issue_row" "issue"%ROWTYPE;
1948 "area_row" "area"%ROWTYPE;
1949 "draft_id_v" "draft"."id"%TYPE;
1950 BEGIN
1951 IF OLD."revoked" ISNULL AND NEW."revoked" NOTNULL THEN
1952 -- NOTE: lock for primary key update to avoid new drafts
1953 SELECT NULL FROM "initiative" WHERE "id" = NEW."id" FOR UPDATE;
1954 SELECT * INTO "issue_row" FROM "issue"
1955 WHERE "id" = NEW."issue_id" FOR SHARE;
1956 SELECT * INTO "area_row" FROM "area"
1957 WHERE "id" = "issue_row"."area_id" FOR SHARE;
1958 -- NOTE: FOR SHARE cannot be used with DISTINCT in view "current_draft"
1959 SELECT NULL FROM "draft" WHERE "initiative_id" = NEW."id" FOR SHARE;
1960 SELECT "id" INTO "draft_id_v" FROM "current_draft"
1961 WHERE "initiative_id" = NEW."id";
1962 INSERT INTO "event" (
1963 "event", "member_id",
1964 "unit_id", "area_id", "policy_id", "issue_id", "state",
1965 "initiative_id", "draft_id"
1966 ) VALUES (
1967 'initiative_revoked', NEW."revoked_by_member_id",
1968 "area_row"."unit_id", "issue_row"."area_id",
1969 "issue_row"."policy_id",
1970 NEW."issue_id", "issue_row"."state",
1971 NEW."id", "draft_id_v"
1972 );
1973 END IF;
1974 RETURN NULL;
1975 END;
1976 $$;
1978 CREATE TRIGGER "write_event_initiative_revoked"
1979 AFTER UPDATE ON "initiative" FOR EACH ROW EXECUTE PROCEDURE
1980 "write_event_initiative_revoked_trigger"();
1982 COMMENT ON FUNCTION "write_event_initiative_revoked_trigger"() IS 'Implementation of trigger "write_event_initiative_revoked" on table "issue"';
1983 COMMENT ON TRIGGER "write_event_initiative_revoked" ON "initiative" IS 'Create entry in "event" table, when an initiative is revoked';
1986 CREATE FUNCTION "write_event_suggestion_created_trigger"()
1987 RETURNS TRIGGER
1988 LANGUAGE 'plpgsql' VOLATILE AS $$
1989 DECLARE
1990 "initiative_row" "initiative"%ROWTYPE;
1991 "issue_row" "issue"%ROWTYPE;
1992 "area_row" "area"%ROWTYPE;
1993 BEGIN
1994 SELECT * INTO "initiative_row" FROM "initiative"
1995 WHERE "id" = NEW."initiative_id" FOR SHARE;
1996 SELECT * INTO "issue_row" FROM "issue"
1997 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
1998 SELECT * INTO "area_row" FROM "area"
1999 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2000 INSERT INTO "event" (
2001 "event", "member_id",
2002 "unit_id", "area_id", "policy_id", "issue_id", "state",
2003 "initiative_id", "suggestion_id"
2004 ) VALUES (
2005 'suggestion_created', NEW."author_id",
2006 "area_row"."unit_id", "issue_row"."area_id", "issue_row"."policy_id",
2007 "initiative_row"."issue_id", "issue_row"."state",
2008 NEW."initiative_id", NEW."id"
2009 );
2010 RETURN NULL;
2011 END;
2012 $$;
2014 CREATE TRIGGER "write_event_suggestion_created"
2015 AFTER INSERT ON "suggestion" FOR EACH ROW EXECUTE PROCEDURE
2016 "write_event_suggestion_created_trigger"();
2018 COMMENT ON FUNCTION "write_event_suggestion_created_trigger"() IS 'Implementation of trigger "write_event_suggestion_created" on table "issue"';
2019 COMMENT ON TRIGGER "write_event_suggestion_created" ON "suggestion" IS 'Create entry in "event" table on suggestion creation';
2022 CREATE FUNCTION "write_event_suggestion_removed_trigger"()
2023 RETURNS TRIGGER
2024 LANGUAGE 'plpgsql' VOLATILE AS $$
2025 DECLARE
2026 "initiative_row" "initiative"%ROWTYPE;
2027 "issue_row" "issue"%ROWTYPE;
2028 "area_row" "area"%ROWTYPE;
2029 BEGIN
2030 SELECT * INTO "initiative_row" FROM "initiative"
2031 WHERE "id" = OLD."initiative_id" FOR SHARE;
2032 IF "initiative_row"."id" NOTNULL THEN
2033 SELECT * INTO "issue_row" FROM "issue"
2034 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2035 SELECT * INTO "area_row" FROM "area"
2036 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2037 INSERT INTO "event" (
2038 "event",
2039 "unit_id", "area_id", "policy_id", "issue_id", "state",
2040 "initiative_id", "suggestion_id"
2041 ) VALUES (
2042 'suggestion_deleted',
2043 "area_row"."unit_id", "issue_row"."area_id",
2044 "issue_row"."policy_id",
2045 "initiative_row"."issue_id", "issue_row"."state",
2046 OLD."initiative_id", OLD."id"
2047 );
2048 END IF;
2049 RETURN NULL;
2050 END;
2051 $$;
2053 CREATE TRIGGER "write_event_suggestion_removed"
2054 AFTER DELETE ON "suggestion" FOR EACH ROW EXECUTE PROCEDURE
2055 "write_event_suggestion_removed_trigger"();
2057 COMMENT ON FUNCTION "write_event_suggestion_removed_trigger"() IS 'Implementation of trigger "write_event_suggestion_removed" on table "issue"';
2058 COMMENT ON TRIGGER "write_event_suggestion_removed" ON "suggestion" IS 'Create entry in "event" table on suggestion creation';
2061 CREATE FUNCTION "write_event_member_trigger"()
2062 RETURNS TRIGGER
2063 LANGUAGE 'plpgsql' VOLATILE AS $$
2064 BEGIN
2065 IF TG_OP = 'INSERT' THEN
2066 IF NEW."activated" NOTNULL AND NEW."deleted" ISNULL THEN
2067 INSERT INTO "event" ("event", "member_id")
2068 VALUES ('member_activated', NEW."id");
2069 END IF;
2070 IF NEW."active" THEN
2071 INSERT INTO "event" ("event", "member_id", "boolean_value")
2072 VALUES ('member_active', NEW."id", TRUE);
2073 END IF;
2074 ELSIF TG_OP = 'UPDATE' THEN
2075 IF OLD."id" != NEW."id" THEN
2076 RAISE EXCEPTION 'Cannot change member ID';
2077 END IF;
2078 IF
2079 (OLD."activated" ISNULL OR OLD."deleted" NOTNULL) AND
2080 NEW."activated" NOTNULL AND NEW."deleted" ISNULL
2081 THEN
2082 INSERT INTO "event" ("event", "member_id")
2083 VALUES ('member_activated', NEW."id");
2084 END IF;
2085 IF OLD."active" != NEW."active" THEN
2086 INSERT INTO "event" ("event", "member_id", "boolean_value") VALUES (
2087 'member_active', NEW."id", NEW."active"
2088 );
2089 END IF;
2090 IF OLD."name" != NEW."name" THEN
2091 INSERT INTO "event" (
2092 "event", "member_id", "text_value", "old_text_value"
2093 ) VALUES (
2094 'member_name_updated', NEW."id", NEW."name", OLD."name"
2095 );
2096 END IF;
2097 IF
2098 OLD."activated" NOTNULL AND OLD."deleted" ISNULL AND
2099 (NEW."activated" ISNULL OR NEW."deleted" NOTNULL)
2100 THEN
2101 INSERT INTO "event" ("event", "member_id")
2102 VALUES ('member_deleted', NEW."id");
2103 END IF;
2104 END IF;
2105 RETURN NULL;
2106 END;
2107 $$;
2109 CREATE TRIGGER "write_event_member"
2110 AFTER INSERT OR UPDATE ON "member" FOR EACH ROW EXECUTE PROCEDURE
2111 "write_event_member_trigger"();
2113 COMMENT ON FUNCTION "write_event_member_trigger"() IS 'Implementation of trigger "write_event_member" on table "member"';
2114 COMMENT ON TRIGGER "write_event_member" ON "member" IS 'Create entries in "event" table on insertion to member table';
2117 CREATE FUNCTION "write_event_member_profile_updated_trigger"()
2118 RETURNS TRIGGER
2119 LANGUAGE 'plpgsql' VOLATILE AS $$
2120 BEGIN
2121 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2122 IF EXISTS (SELECT NULL FROM "member" WHERE "id" = OLD."member_id") THEN
2123 INSERT INTO "event" ("event", "member_id") VALUES (
2124 'member_profile_updated', OLD."member_id"
2125 );
2126 END IF;
2127 END IF;
2128 IF TG_OP = 'UPDATE' THEN
2129 IF OLD."member_id" = NEW."member_id" THEN
2130 RETURN NULL;
2131 END IF;
2132 END IF;
2133 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2134 INSERT INTO "event" ("event", "member_id") VALUES (
2135 'member_profile_updated', NEW."member_id"
2136 );
2137 END IF;
2138 RETURN NULL;
2139 END;
2140 $$;
2142 CREATE TRIGGER "write_event_member_profile_updated"
2143 AFTER INSERT OR UPDATE OR DELETE ON "member_profile"
2144 FOR EACH ROW EXECUTE PROCEDURE
2145 "write_event_member_profile_updated_trigger"();
2147 COMMENT ON FUNCTION "write_event_member_profile_updated_trigger"() IS 'Implementation of trigger "write_event_member_profile_updated" on table "member_profile"';
2148 COMMENT ON TRIGGER "write_event_member_profile_updated" ON "member_profile" IS 'Creates entries in "event" table on member profile update';
2151 CREATE FUNCTION "write_event_member_image_updated_trigger"()
2152 RETURNS TRIGGER
2153 LANGUAGE 'plpgsql' VOLATILE AS $$
2154 BEGIN
2155 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2156 IF NOT OLD."scaled" THEN
2157 IF EXISTS (SELECT NULL FROM "member" WHERE "id" = OLD."member_id") THEN
2158 INSERT INTO "event" ("event", "member_id") VALUES (
2159 'member_image_updated', OLD."member_id"
2160 );
2161 END IF;
2162 END IF;
2163 END IF;
2164 IF TG_OP = 'UPDATE' THEN
2165 IF
2166 OLD."member_id" = NEW."member_id" AND
2167 OLD."scaled" = NEW."scaled"
2168 THEN
2169 RETURN NULL;
2170 END IF;
2171 END IF;
2172 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2173 IF NOT NEW."scaled" THEN
2174 INSERT INTO "event" ("event", "member_id") VALUES (
2175 'member_image_updated', NEW."member_id"
2176 );
2177 END IF;
2178 END IF;
2179 RETURN NULL;
2180 END;
2181 $$;
2183 CREATE TRIGGER "write_event_member_image_updated"
2184 AFTER INSERT OR UPDATE OR DELETE ON "member_image"
2185 FOR EACH ROW EXECUTE PROCEDURE
2186 "write_event_member_image_updated_trigger"();
2188 COMMENT ON FUNCTION "write_event_member_image_updated_trigger"() IS 'Implementation of trigger "write_event_member_image_updated" on table "member_image"';
2189 COMMENT ON TRIGGER "write_event_member_image_updated" ON "member_image" IS 'Creates entries in "event" table on member image update';
2192 CREATE FUNCTION "write_event_interest_trigger"()
2193 RETURNS TRIGGER
2194 LANGUAGE 'plpgsql' VOLATILE AS $$
2195 DECLARE
2196 "issue_row" "issue"%ROWTYPE;
2197 "area_row" "area"%ROWTYPE;
2198 BEGIN
2199 IF TG_OP = 'UPDATE' THEN
2200 IF OLD = NEW THEN
2201 RETURN NULL;
2202 END IF;
2203 END IF;
2204 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2205 SELECT * INTO "issue_row" FROM "issue"
2206 WHERE "id" = OLD."issue_id" FOR SHARE;
2207 SELECT * INTO "area_row" FROM "area"
2208 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2209 IF "issue_row"."id" NOTNULL THEN
2210 INSERT INTO "event" (
2211 "event", "member_id",
2212 "unit_id", "area_id", "policy_id", "issue_id", "state",
2213 "boolean_value"
2214 ) VALUES (
2215 'interest', OLD."member_id",
2216 "area_row"."unit_id", "issue_row"."area_id",
2217 "issue_row"."policy_id",
2218 OLD."issue_id", "issue_row"."state",
2219 FALSE
2220 );
2221 END IF;
2222 END IF;
2223 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2224 SELECT * INTO "issue_row" FROM "issue"
2225 WHERE "id" = NEW."issue_id" FOR SHARE;
2226 SELECT * INTO "area_row" FROM "area"
2227 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2228 INSERT INTO "event" (
2229 "event", "member_id",
2230 "unit_id", "area_id", "policy_id", "issue_id", "state",
2231 "boolean_value"
2232 ) VALUES (
2233 'interest', NEW."member_id",
2234 "area_row"."unit_id", "issue_row"."area_id",
2235 "issue_row"."policy_id",
2236 NEW."issue_id", "issue_row"."state",
2237 TRUE
2238 );
2239 END IF;
2240 RETURN NULL;
2241 END;
2242 $$;
2244 CREATE TRIGGER "write_event_interest"
2245 AFTER INSERT OR UPDATE OR DELETE ON "interest" FOR EACH ROW EXECUTE PROCEDURE
2246 "write_event_interest_trigger"();
2248 COMMENT ON FUNCTION "write_event_interest_trigger"() IS 'Implementation of trigger "write_event_interest_inserted" on table "interest"';
2249 COMMENT ON TRIGGER "write_event_interest" ON "interest" IS 'Create entry in "event" table on adding or removing interest';
2252 CREATE FUNCTION "write_event_initiator_trigger"()
2253 RETURNS TRIGGER
2254 LANGUAGE 'plpgsql' VOLATILE AS $$
2255 DECLARE
2256 "initiative_row" "initiative"%ROWTYPE;
2257 "issue_row" "issue"%ROWTYPE;
2258 "area_row" "area"%ROWTYPE;
2259 "accepted_v" BOOLEAN = FALSE;
2260 "rejected_v" BOOLEAN = FALSE;
2261 BEGIN
2262 IF TG_OP = 'UPDATE' THEN
2263 IF
2264 OLD."initiative_id" = NEW."initiative_id" AND
2265 OLD."member_id" = NEW."member_id"
2266 THEN
2267 IF
2268 coalesce(OLD."accepted", FALSE) = coalesce(NEW."accepted", FALSE)
2269 THEN
2270 RETURN NULL;
2271 END IF;
2272 IF coalesce(NEW."accepted", FALSE) = TRUE THEN
2273 "accepted_v" := TRUE;
2274 ELSE
2275 "rejected_v" := TRUE;
2276 END IF;
2277 END IF;
2278 END IF;
2279 IF (TG_OP = 'DELETE' OR TG_OP = 'UPDATE') AND NOT "accepted_v" THEN
2280 IF coalesce(OLD."accepted", FALSE) = TRUE THEN
2281 SELECT * INTO "initiative_row" FROM "initiative"
2282 WHERE "id" = OLD."initiative_id" FOR SHARE;
2283 IF "initiative_row"."id" NOTNULL THEN
2284 SELECT * INTO "issue_row" FROM "issue"
2285 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2286 SELECT * INTO "area_row" FROM "area"
2287 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2288 INSERT INTO "event" (
2289 "event", "member_id",
2290 "unit_id", "area_id", "policy_id", "issue_id", "state",
2291 "initiative_id", "boolean_value"
2292 ) VALUES (
2293 'initiator', OLD."member_id",
2294 "area_row"."unit_id", "issue_row"."area_id",
2295 "issue_row"."policy_id",
2296 "issue_row"."id", "issue_row"."state",
2297 OLD."initiative_id", FALSE
2298 );
2299 END IF;
2300 END IF;
2301 END IF;
2302 IF TG_OP = 'UPDATE' AND NOT "rejected_v" THEN
2303 IF coalesce(NEW."accepted", FALSE) = TRUE THEN
2304 SELECT * INTO "initiative_row" FROM "initiative"
2305 WHERE "id" = NEW."initiative_id" FOR SHARE;
2306 SELECT * INTO "issue_row" FROM "issue"
2307 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2308 SELECT * INTO "area_row" FROM "area"
2309 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2310 INSERT INTO "event" (
2311 "event", "member_id",
2312 "unit_id", "area_id", "policy_id", "issue_id", "state",
2313 "initiative_id", "boolean_value"
2314 ) VALUES (
2315 'initiator', NEW."member_id",
2316 "area_row"."unit_id", "issue_row"."area_id",
2317 "issue_row"."policy_id",
2318 "issue_row"."id", "issue_row"."state",
2319 NEW."initiative_id", TRUE
2320 );
2321 END IF;
2322 END IF;
2323 RETURN NULL;
2324 END;
2325 $$;
2327 CREATE TRIGGER "write_event_initiator"
2328 AFTER UPDATE OR DELETE ON "initiator" FOR EACH ROW EXECUTE PROCEDURE
2329 "write_event_initiator_trigger"();
2331 COMMENT ON FUNCTION "write_event_initiator_trigger"() IS 'Implementation of trigger "write_event_initiator" on table "initiator"';
2332 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)';
2335 CREATE FUNCTION "write_event_support_trigger"()
2336 RETURNS TRIGGER
2337 LANGUAGE 'plpgsql' VOLATILE AS $$
2338 DECLARE
2339 "issue_row" "issue"%ROWTYPE;
2340 "area_row" "area"%ROWTYPE;
2341 BEGIN
2342 IF TG_OP = 'UPDATE' THEN
2343 IF
2344 OLD."initiative_id" = NEW."initiative_id" AND
2345 OLD."member_id" = NEW."member_id"
2346 THEN
2347 IF OLD."draft_id" != NEW."draft_id" THEN
2348 SELECT * INTO "issue_row" FROM "issue"
2349 WHERE "id" = NEW."issue_id" FOR SHARE;
2350 SELECT * INTO "area_row" FROM "area"
2351 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2352 INSERT INTO "event" (
2353 "event", "member_id",
2354 "unit_id", "area_id", "policy_id", "issue_id", "state",
2355 "initiative_id", "draft_id"
2356 ) VALUES (
2357 'support_updated', NEW."member_id",
2358 "area_row"."unit_id", "issue_row"."area_id",
2359 "issue_row"."policy_id",
2360 "issue_row"."id", "issue_row"."state",
2361 NEW."initiative_id", NEW."draft_id"
2362 );
2363 END IF;
2364 RETURN NULL;
2365 END IF;
2366 END IF;
2367 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2368 IF EXISTS (
2369 SELECT NULL FROM "initiative" WHERE "id" = OLD."initiative_id"
2370 FOR SHARE
2371 ) THEN
2372 SELECT * INTO "issue_row" FROM "issue"
2373 WHERE "id" = OLD."issue_id" FOR SHARE;
2374 SELECT * INTO "area_row" FROM "area"
2375 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2376 INSERT INTO "event" (
2377 "event", "member_id",
2378 "unit_id", "area_id", "policy_id", "issue_id", "state",
2379 "initiative_id", "boolean_value"
2380 ) VALUES (
2381 'support', OLD."member_id",
2382 "area_row"."unit_id", "issue_row"."area_id",
2383 "issue_row"."policy_id",
2384 "issue_row"."id", "issue_row"."state",
2385 OLD."initiative_id", FALSE
2386 );
2387 END IF;
2388 END IF;
2389 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2390 SELECT * INTO "issue_row" FROM "issue"
2391 WHERE "id" = NEW."issue_id" FOR SHARE;
2392 SELECT * INTO "area_row" FROM "area"
2393 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2394 INSERT INTO "event" (
2395 "event", "member_id",
2396 "unit_id", "area_id", "policy_id", "issue_id", "state",
2397 "initiative_id", "draft_id", "boolean_value"
2398 ) VALUES (
2399 'support', NEW."member_id",
2400 "area_row"."unit_id", "issue_row"."area_id",
2401 "issue_row"."policy_id",
2402 "issue_row"."id", "issue_row"."state",
2403 NEW."initiative_id", NEW."draft_id", TRUE
2404 );
2405 END IF;
2406 RETURN NULL;
2407 END;
2408 $$;
2410 CREATE TRIGGER "write_event_support"
2411 AFTER INSERT OR UPDATE OR DELETE ON "supporter" FOR EACH ROW EXECUTE PROCEDURE
2412 "write_event_support_trigger"();
2414 COMMENT ON FUNCTION "write_event_support_trigger"() IS 'Implementation of trigger "write_event_support" on table "supporter"';
2415 COMMENT ON TRIGGER "write_event_support" ON "supporter" IS 'Create entry in "event" table when adding, updating, or removing support';
2418 CREATE FUNCTION "write_event_suggestion_rated_trigger"()
2419 RETURNS TRIGGER
2420 LANGUAGE 'plpgsql' VOLATILE AS $$
2421 DECLARE
2422 "same_pkey_v" BOOLEAN = FALSE;
2423 "initiative_row" "initiative"%ROWTYPE;
2424 "issue_row" "issue"%ROWTYPE;
2425 "area_row" "area"%ROWTYPE;
2426 BEGIN
2427 IF TG_OP = 'UPDATE' THEN
2428 IF
2429 OLD."suggestion_id" = NEW."suggestion_id" AND
2430 OLD."member_id" = NEW."member_id"
2431 THEN
2432 IF
2433 OLD."degree" = NEW."degree" AND
2434 OLD."fulfilled" = NEW."fulfilled"
2435 THEN
2436 RETURN NULL;
2437 END IF;
2438 "same_pkey_v" := TRUE;
2439 END IF;
2440 END IF;
2441 IF (TG_OP = 'DELETE' OR TG_OP = 'UPDATE') AND NOT "same_pkey_v" THEN
2442 IF EXISTS (
2443 SELECT NULL FROM "suggestion" WHERE "id" = OLD."suggestion_id"
2444 FOR SHARE
2445 ) THEN
2446 SELECT * INTO "initiative_row" FROM "initiative"
2447 WHERE "id" = OLD."initiative_id" FOR SHARE;
2448 SELECT * INTO "issue_row" FROM "issue"
2449 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2450 SELECT * INTO "area_row" FROM "area"
2451 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2452 INSERT INTO "event" (
2453 "event", "member_id",
2454 "unit_id", "area_id", "policy_id", "issue_id", "state",
2455 "initiative_id", "suggestion_id",
2456 "boolean_value", "numeric_value"
2457 ) VALUES (
2458 'suggestion_rated', OLD."member_id",
2459 "area_row"."unit_id", "issue_row"."area_id",
2460 "issue_row"."policy_id",
2461 "initiative_row"."issue_id", "issue_row"."state",
2462 OLD."initiative_id", OLD."suggestion_id",
2463 NULL, 0
2464 );
2465 END IF;
2466 END IF;
2467 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2468 SELECT * INTO "initiative_row" FROM "initiative"
2469 WHERE "id" = NEW."initiative_id" FOR SHARE;
2470 SELECT * INTO "issue_row" FROM "issue"
2471 WHERE "id" = "initiative_row"."issue_id" FOR SHARE;
2472 SELECT * INTO "area_row" FROM "area"
2473 WHERE "id" = "issue_row"."area_id" FOR SHARE;
2474 INSERT INTO "event" (
2475 "event", "member_id",
2476 "unit_id", "area_id", "policy_id", "issue_id", "state",
2477 "initiative_id", "suggestion_id",
2478 "boolean_value", "numeric_value"
2479 ) VALUES (
2480 'suggestion_rated', NEW."member_id",
2481 "area_row"."unit_id", "issue_row"."area_id",
2482 "issue_row"."policy_id",
2483 "initiative_row"."issue_id", "issue_row"."state",
2484 NEW."initiative_id", NEW."suggestion_id",
2485 NEW."fulfilled", NEW."degree"
2486 );
2487 END IF;
2488 RETURN NULL;
2489 END;
2490 $$;
2492 CREATE TRIGGER "write_event_suggestion_rated"
2493 AFTER INSERT OR UPDATE OR DELETE ON "opinion" FOR EACH ROW EXECUTE PROCEDURE
2494 "write_event_suggestion_rated_trigger"();
2496 COMMENT ON FUNCTION "write_event_suggestion_rated_trigger"() IS 'Implementation of trigger "write_event_suggestion_rated" on table "opinion"';
2497 COMMENT ON TRIGGER "write_event_suggestion_rated" ON "opinion" IS 'Create entry in "event" table when adding, updating, or removing support';
2500 CREATE FUNCTION "write_event_delegation_trigger"()
2501 RETURNS TRIGGER
2502 LANGUAGE 'plpgsql' VOLATILE AS $$
2503 DECLARE
2504 "issue_row" "issue"%ROWTYPE;
2505 "area_row" "area"%ROWTYPE;
2506 BEGIN
2507 IF TG_OP = 'DELETE' THEN
2508 IF EXISTS (
2509 SELECT NULL FROM "member" WHERE "id" = OLD."truster_id"
2510 ) AND (CASE OLD."scope"
2511 WHEN 'unit'::"delegation_scope" THEN EXISTS (
2512 SELECT NULL FROM "unit" WHERE "id" = OLD."unit_id"
2513 )
2514 WHEN 'area'::"delegation_scope" THEN EXISTS (
2515 SELECT NULL FROM "area" WHERE "id" = OLD."area_id"
2516 )
2517 WHEN 'issue'::"delegation_scope" THEN EXISTS (
2518 SELECT NULL FROM "issue" WHERE "id" = OLD."issue_id"
2519 )
2520 END) THEN
2521 SELECT * INTO "issue_row" FROM "issue"
2522 WHERE "id" = OLD."issue_id" FOR SHARE;
2523 SELECT * INTO "area_row" FROM "area"
2524 WHERE "id" = COALESCE(OLD."area_id", "issue_row"."area_id")
2525 FOR SHARE;
2526 INSERT INTO "event" (
2527 "event", "member_id", "scope",
2528 "unit_id", "area_id", "issue_id", "state",
2529 "boolean_value"
2530 ) VALUES (
2531 'delegation', OLD."truster_id", OLD."scope",
2532 COALESCE(OLD."unit_id", "area_row"."unit_id"), "area_row"."id",
2533 OLD."issue_id", "issue_row"."state",
2534 FALSE
2535 );
2536 END IF;
2537 ELSE
2538 SELECT * INTO "issue_row" FROM "issue"
2539 WHERE "id" = NEW."issue_id" FOR SHARE;
2540 SELECT * INTO "area_row" FROM "area"
2541 WHERE "id" = COALESCE(NEW."area_id", "issue_row"."area_id")
2542 FOR SHARE;
2543 INSERT INTO "event" (
2544 "event", "member_id", "other_member_id", "scope",
2545 "unit_id", "area_id", "issue_id", "state",
2546 "boolean_value"
2547 ) VALUES (
2548 'delegation', NEW."truster_id", NEW."trustee_id", NEW."scope",
2549 COALESCE(NEW."unit_id", "area_row"."unit_id"), "area_row"."id",
2550 NEW."issue_id", "issue_row"."state",
2551 TRUE
2552 );
2553 END IF;
2554 RETURN NULL;
2555 END;
2556 $$;
2558 CREATE TRIGGER "write_event_delegation"
2559 AFTER INSERT OR UPDATE OR DELETE ON "delegation" FOR EACH ROW EXECUTE PROCEDURE
2560 "write_event_delegation_trigger"();
2562 COMMENT ON FUNCTION "write_event_delegation_trigger"() IS 'Implementation of trigger "write_event_delegation" on table "delegation"';
2563 COMMENT ON TRIGGER "write_event_delegation" ON "delegation" IS 'Create entry in "event" table when adding, updating, or removing a delegation';
2566 CREATE FUNCTION "write_event_contact_trigger"()
2567 RETURNS TRIGGER
2568 LANGUAGE 'plpgsql' VOLATILE AS $$
2569 BEGIN
2570 IF TG_OP = 'UPDATE' THEN
2571 IF
2572 OLD."member_id" = NEW."member_id" AND
2573 OLD."other_member_id" = NEW."other_member_id" AND
2574 OLD."public" = NEW."public"
2575 THEN
2576 RETURN NULL;
2577 END IF;
2578 END IF;
2579 IF TG_OP = 'DELETE' OR TG_OP = 'UPDATE' THEN
2580 IF OLD."public" THEN
2581 IF EXISTS (
2582 SELECT NULL FROM "member" WHERE "id" = OLD."member_id"
2583 FOR SHARE
2584 ) AND EXISTS (
2585 SELECT NULL FROM "member" WHERE "id" = OLD."other_member_id"
2586 FOR SHARE
2587 ) THEN
2588 INSERT INTO "event" (
2589 "event", "member_id", "other_member_id", "boolean_value"
2590 ) VALUES (
2591 'contact', OLD."member_id", OLD."other_member_id", FALSE
2592 );
2593 END IF;
2594 END IF;
2595 END IF;
2596 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
2597 IF NEW."public" THEN
2598 INSERT INTO "event" (
2599 "event", "member_id", "other_member_id", "boolean_value"
2600 ) VALUES (
2601 'contact', NEW."member_id", NEW."other_member_id", TRUE
2602 );
2603 END IF;
2604 END IF;
2605 RETURN NULL;
2606 END;
2607 $$;
2609 CREATE TRIGGER "write_event_contact"
2610 AFTER INSERT OR UPDATE OR DELETE ON "contact" FOR EACH ROW EXECUTE PROCEDURE
2611 "write_event_contact_trigger"();
2613 COMMENT ON FUNCTION "write_event_contact_trigger"() IS 'Implementation of trigger "write_event_contact" on table "contact"';
2614 COMMENT ON TRIGGER "write_event_contact" ON "contact" IS 'Create entry in "event" table when adding or removing public contacts';
2617 CREATE FUNCTION "send_event_notify_trigger"()
2618 RETURNS TRIGGER
2619 LANGUAGE 'plpgsql' VOLATILE AS $$
2620 BEGIN
2621 EXECUTE 'NOTIFY "event", ''' || NEW."event" || '''';
2622 RETURN NULL;
2623 END;
2624 $$;
2626 CREATE TRIGGER "send_notify"
2627 AFTER INSERT OR UPDATE ON "event" FOR EACH ROW EXECUTE PROCEDURE
2628 "send_event_notify_trigger"();
2632 ----------------------------
2633 -- Additional constraints --
2634 ----------------------------
2637 CREATE FUNCTION "delete_extended_scope_tokens_trigger"()
2638 RETURNS TRIGGER
2639 LANGUAGE 'plpgsql' VOLATILE AS $$
2640 DECLARE
2641 "system_application_row" "system_application"%ROWTYPE;
2642 BEGIN
2643 IF OLD."system_application_id" NOTNULL THEN
2644 SELECT * FROM "system_application" INTO "system_application_row"
2645 WHERE "id" = OLD."system_application_id";
2646 DELETE FROM "token"
2647 WHERE "member_id" = OLD."member_id"
2648 AND "system_application_id" = OLD."system_application_id"
2649 AND NOT COALESCE(
2650 regexp_split_to_array("scope", E'\\s+') <@
2651 regexp_split_to_array(
2652 "system_application_row"."automatic_scope", E'\\s+'
2653 ),
2654 FALSE
2655 );
2656 END IF;
2657 RETURN OLD;
2658 END;
2659 $$;
2661 CREATE TRIGGER "delete_extended_scope_tokens"
2662 BEFORE DELETE ON "member_application" FOR EACH ROW EXECUTE PROCEDURE
2663 "delete_extended_scope_tokens_trigger"();
2666 CREATE FUNCTION "detach_token_from_session_trigger"()
2667 RETURNS TRIGGER
2668 LANGUAGE 'plpgsql' VOLATILE AS $$
2669 BEGIN
2670 UPDATE "token" SET "session_id" = NULL
2671 WHERE "session_id" = OLD."id";
2672 RETURN OLD;
2673 END;
2674 $$;
2676 CREATE TRIGGER "detach_token_from_session"
2677 BEFORE DELETE ON "session" FOR EACH ROW EXECUTE PROCEDURE
2678 "detach_token_from_session_trigger"();
2681 CREATE FUNCTION "delete_non_detached_scope_with_session_trigger"()
2682 RETURNS TRIGGER
2683 LANGUAGE 'plpgsql' VOLATILE AS $$
2684 BEGIN
2685 IF NEW."session_id" ISNULL THEN
2686 SELECT coalesce(string_agg("element", ' '), '') INTO NEW."scope"
2687 FROM unnest(regexp_split_to_array(NEW."scope", E'\\s+')) AS "element"
2688 WHERE "element" LIKE '%_detached';
2689 END IF;
2690 RETURN NEW;
2691 END;
2692 $$;
2694 CREATE TRIGGER "delete_non_detached_scope_with_session"
2695 BEFORE INSERT OR UPDATE ON "token" FOR EACH ROW EXECUTE PROCEDURE
2696 "delete_non_detached_scope_with_session_trigger"();
2699 CREATE FUNCTION "delete_token_with_empty_scope_trigger"()
2700 RETURNS TRIGGER
2701 LANGUAGE 'plpgsql' VOLATILE AS $$
2702 BEGIN
2703 IF NEW."scope" = '' THEN
2704 DELETE FROM "token" WHERE "id" = NEW."id";
2705 END IF;
2706 RETURN NULL;
2707 END;
2708 $$;
2710 CREATE TRIGGER "delete_token_with_empty_scope"
2711 AFTER INSERT OR UPDATE ON "token" FOR EACH ROW EXECUTE PROCEDURE
2712 "delete_token_with_empty_scope_trigger"();
2715 CREATE FUNCTION "issue_requires_first_initiative_trigger"()
2716 RETURNS TRIGGER
2717 LANGUAGE 'plpgsql' VOLATILE AS $$
2718 BEGIN
2719 IF NOT EXISTS (
2720 SELECT NULL FROM "initiative" WHERE "issue_id" = NEW."id"
2721 ) THEN
2722 RAISE EXCEPTION 'Cannot create issue without an initial initiative.' USING
2723 ERRCODE = 'integrity_constraint_violation',
2724 HINT = 'Create issue, initiative, and draft within the same transaction.';
2725 END IF;
2726 RETURN NULL;
2727 END;
2728 $$;
2730 CREATE CONSTRAINT TRIGGER "issue_requires_first_initiative"
2731 AFTER INSERT OR UPDATE ON "issue" DEFERRABLE INITIALLY DEFERRED
2732 FOR EACH ROW EXECUTE PROCEDURE
2733 "issue_requires_first_initiative_trigger"();
2735 COMMENT ON FUNCTION "issue_requires_first_initiative_trigger"() IS 'Implementation of trigger "issue_requires_first_initiative" on table "issue"';
2736 COMMENT ON TRIGGER "issue_requires_first_initiative" ON "issue" IS 'Ensure that new issues have at least one initiative';
2739 CREATE FUNCTION "last_initiative_deletes_issue_trigger"()
2740 RETURNS TRIGGER
2741 LANGUAGE 'plpgsql' VOLATILE AS $$
2742 DECLARE
2743 "reference_lost" BOOLEAN;
2744 BEGIN
2745 IF TG_OP = 'DELETE' THEN
2746 "reference_lost" := TRUE;
2747 ELSE
2748 "reference_lost" := NEW."issue_id" != OLD."issue_id";
2749 END IF;
2750 IF
2751 "reference_lost" AND NOT EXISTS (
2752 SELECT NULL FROM "initiative" WHERE "issue_id" = OLD."issue_id"
2753 )
2754 THEN
2755 DELETE FROM "issue" WHERE "id" = OLD."issue_id";
2756 END IF;
2757 RETURN NULL;
2758 END;
2759 $$;
2761 CREATE CONSTRAINT TRIGGER "last_initiative_deletes_issue"
2762 AFTER UPDATE OR DELETE ON "initiative" DEFERRABLE INITIALLY DEFERRED
2763 FOR EACH ROW EXECUTE PROCEDURE
2764 "last_initiative_deletes_issue_trigger"();
2766 COMMENT ON FUNCTION "last_initiative_deletes_issue_trigger"() IS 'Implementation of trigger "last_initiative_deletes_issue" on table "initiative"';
2767 COMMENT ON TRIGGER "last_initiative_deletes_issue" ON "initiative" IS 'Removing the last initiative of an issue deletes the issue';
2770 CREATE FUNCTION "initiative_requires_first_draft_trigger"()
2771 RETURNS TRIGGER
2772 LANGUAGE 'plpgsql' VOLATILE AS $$
2773 BEGIN
2774 IF NOT EXISTS (
2775 SELECT NULL FROM "draft" WHERE "initiative_id" = NEW."id"
2776 ) THEN
2777 RAISE EXCEPTION 'Cannot create initiative without an initial draft.' USING
2778 ERRCODE = 'integrity_constraint_violation',
2779 HINT = 'Create issue, initiative and draft within the same transaction.';
2780 END IF;
2781 RETURN NULL;
2782 END;
2783 $$;
2785 CREATE CONSTRAINT TRIGGER "initiative_requires_first_draft"
2786 AFTER INSERT OR UPDATE ON "initiative" DEFERRABLE INITIALLY DEFERRED
2787 FOR EACH ROW EXECUTE PROCEDURE
2788 "initiative_requires_first_draft_trigger"();
2790 COMMENT ON FUNCTION "initiative_requires_first_draft_trigger"() IS 'Implementation of trigger "initiative_requires_first_draft" on table "initiative"';
2791 COMMENT ON TRIGGER "initiative_requires_first_draft" ON "initiative" IS 'Ensure that new initiatives have at least one draft';
2794 CREATE FUNCTION "last_draft_deletes_initiative_trigger"()
2795 RETURNS TRIGGER
2796 LANGUAGE 'plpgsql' VOLATILE AS $$
2797 DECLARE
2798 "reference_lost" BOOLEAN;
2799 BEGIN
2800 IF TG_OP = 'DELETE' THEN
2801 "reference_lost" := TRUE;
2802 ELSE
2803 "reference_lost" := NEW."initiative_id" != OLD."initiative_id";
2804 END IF;
2805 IF
2806 "reference_lost" AND NOT EXISTS (
2807 SELECT NULL FROM "draft" WHERE "initiative_id" = OLD."initiative_id"
2808 )
2809 THEN
2810 DELETE FROM "initiative" WHERE "id" = OLD."initiative_id";
2811 END IF;
2812 RETURN NULL;
2813 END;
2814 $$;
2816 CREATE CONSTRAINT TRIGGER "last_draft_deletes_initiative"
2817 AFTER UPDATE OR DELETE ON "draft" DEFERRABLE INITIALLY DEFERRED
2818 FOR EACH ROW EXECUTE PROCEDURE
2819 "last_draft_deletes_initiative_trigger"();
2821 COMMENT ON FUNCTION "last_draft_deletes_initiative_trigger"() IS 'Implementation of trigger "last_draft_deletes_initiative" on table "draft"';
2822 COMMENT ON TRIGGER "last_draft_deletes_initiative" ON "draft" IS 'Removing the last draft of an initiative deletes the initiative';
2825 CREATE FUNCTION "suggestion_requires_first_opinion_trigger"()
2826 RETURNS TRIGGER
2827 LANGUAGE 'plpgsql' VOLATILE AS $$
2828 BEGIN
2829 IF NOT EXISTS (
2830 SELECT NULL FROM "opinion" WHERE "suggestion_id" = NEW."id"
2831 ) THEN
2832 RAISE EXCEPTION 'Cannot create a suggestion without an opinion.' USING
2833 ERRCODE = 'integrity_constraint_violation',
2834 HINT = 'Create suggestion and opinion within the same transaction.';
2835 END IF;
2836 RETURN NULL;
2837 END;
2838 $$;
2840 CREATE CONSTRAINT TRIGGER "suggestion_requires_first_opinion"
2841 AFTER INSERT OR UPDATE ON "suggestion" DEFERRABLE INITIALLY DEFERRED
2842 FOR EACH ROW EXECUTE PROCEDURE
2843 "suggestion_requires_first_opinion_trigger"();
2845 COMMENT ON FUNCTION "suggestion_requires_first_opinion_trigger"() IS 'Implementation of trigger "suggestion_requires_first_opinion" on table "suggestion"';
2846 COMMENT ON TRIGGER "suggestion_requires_first_opinion" ON "suggestion" IS 'Ensure that new suggestions have at least one opinion';
2849 CREATE FUNCTION "last_opinion_deletes_suggestion_trigger"()
2850 RETURNS TRIGGER
2851 LANGUAGE 'plpgsql' VOLATILE AS $$
2852 DECLARE
2853 "reference_lost" BOOLEAN;
2854 BEGIN
2855 IF TG_OP = 'DELETE' THEN
2856 "reference_lost" := TRUE;
2857 ELSE
2858 "reference_lost" := NEW."suggestion_id" != OLD."suggestion_id";
2859 END IF;
2860 IF
2861 "reference_lost" AND NOT EXISTS (
2862 SELECT NULL FROM "opinion" WHERE "suggestion_id" = OLD."suggestion_id"
2863 )
2864 THEN
2865 DELETE FROM "suggestion" WHERE "id" = OLD."suggestion_id";
2866 END IF;
2867 RETURN NULL;
2868 END;
2869 $$;
2871 CREATE CONSTRAINT TRIGGER "last_opinion_deletes_suggestion"
2872 AFTER UPDATE OR DELETE ON "opinion" DEFERRABLE INITIALLY DEFERRED
2873 FOR EACH ROW EXECUTE PROCEDURE
2874 "last_opinion_deletes_suggestion_trigger"();
2876 COMMENT ON FUNCTION "last_opinion_deletes_suggestion_trigger"() IS 'Implementation of trigger "last_opinion_deletes_suggestion" on table "opinion"';
2877 COMMENT ON TRIGGER "last_opinion_deletes_suggestion" ON "opinion" IS 'Removing the last opinion of a suggestion deletes the suggestion';
2880 CREATE FUNCTION "non_voter_deletes_direct_voter_trigger"()
2881 RETURNS TRIGGER
2882 LANGUAGE 'plpgsql' VOLATILE AS $$
2883 BEGIN
2884 DELETE FROM "direct_voter"
2885 WHERE "issue_id" = NEW."issue_id" AND "member_id" = NEW."member_id";
2886 RETURN NULL;
2887 END;
2888 $$;
2890 CREATE TRIGGER "non_voter_deletes_direct_voter"
2891 AFTER INSERT OR UPDATE ON "non_voter"
2892 FOR EACH ROW EXECUTE PROCEDURE
2893 "non_voter_deletes_direct_voter_trigger"();
2895 COMMENT ON FUNCTION "non_voter_deletes_direct_voter_trigger"() IS 'Implementation of trigger "non_voter_deletes_direct_voter" on table "non_voter"';
2896 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")';
2899 CREATE FUNCTION "direct_voter_deletes_non_voter_trigger"()
2900 RETURNS TRIGGER
2901 LANGUAGE 'plpgsql' VOLATILE AS $$
2902 BEGIN
2903 DELETE FROM "non_voter"
2904 WHERE "issue_id" = NEW."issue_id" AND "member_id" = NEW."member_id";
2905 RETURN NULL;
2906 END;
2907 $$;
2909 CREATE TRIGGER "direct_voter_deletes_non_voter"
2910 AFTER INSERT OR UPDATE ON "direct_voter"
2911 FOR EACH ROW EXECUTE PROCEDURE
2912 "direct_voter_deletes_non_voter_trigger"();
2914 COMMENT ON FUNCTION "direct_voter_deletes_non_voter_trigger"() IS 'Implementation of trigger "direct_voter_deletes_non_voter" on table "direct_voter"';
2915 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")';
2918 CREATE FUNCTION "voter_comment_fields_only_set_when_voter_comment_is_set_trigger"()
2919 RETURNS TRIGGER
2920 LANGUAGE 'plpgsql' VOLATILE AS $$
2921 BEGIN
2922 IF NEW."comment" ISNULL THEN
2923 NEW."comment_changed" := NULL;
2924 NEW."formatting_engine" := NULL;
2925 END IF;
2926 RETURN NEW;
2927 END;
2928 $$;
2930 CREATE TRIGGER "voter_comment_fields_only_set_when_voter_comment_is_set"
2931 BEFORE INSERT OR UPDATE ON "direct_voter"
2932 FOR EACH ROW EXECUTE PROCEDURE
2933 "voter_comment_fields_only_set_when_voter_comment_is_set_trigger"();
2935 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"';
2936 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.';
2940 ---------------------------------
2941 -- Delete incomplete snapshots --
2942 ---------------------------------
2945 CREATE FUNCTION "delete_snapshot_on_partial_delete_trigger"()
2946 RETURNS TRIGGER
2947 LANGUAGE 'plpgsql' VOLATILE AS $$
2948 BEGIN
2949 IF TG_OP = 'UPDATE' THEN
2950 IF
2951 OLD."snapshot_id" = NEW."snapshot_id" AND
2952 OLD."issue_id" = NEW."issue_id"
2953 THEN
2954 RETURN NULL;
2955 END IF;
2956 END IF;
2957 DELETE FROM "snapshot" WHERE "id" = OLD."snapshot_id";
2958 RETURN NULL;
2959 END;
2960 $$;
2962 CREATE TRIGGER "delete_snapshot_on_partial_delete"
2963 AFTER UPDATE OR DELETE ON "snapshot_issue"
2964 FOR EACH ROW EXECUTE PROCEDURE
2965 "delete_snapshot_on_partial_delete_trigger"();
2967 COMMENT ON FUNCTION "delete_snapshot_on_partial_delete_trigger"() IS 'Implementation of trigger "delete_snapshot_on_partial_delete" on table "snapshot_issue"';
2968 COMMENT ON TRIGGER "delete_snapshot_on_partial_delete" ON "snapshot_issue" IS 'Deletes whole snapshot if one issue is deleted from the snapshot';
2972 ---------------------------------------------------------------
2973 -- Ensure that votes are not modified when issues are closed --
2974 ---------------------------------------------------------------
2976 -- NOTE: Frontends should ensure this anyway, but in case of programming
2977 -- errors the following triggers ensure data integrity.
2980 CREATE FUNCTION "forbid_changes_on_closed_issue_trigger"()
2981 RETURNS TRIGGER
2982 LANGUAGE 'plpgsql' VOLATILE AS $$
2983 DECLARE
2984 "issue_id_v" "issue"."id"%TYPE;
2985 "issue_row" "issue"%ROWTYPE;
2986 BEGIN
2987 IF EXISTS (
2988 SELECT NULL FROM "temporary_transaction_data"
2989 WHERE "txid" = txid_current()
2990 AND "key" = 'override_protection_triggers'
2991 AND "value" = TRUE::TEXT
2992 ) THEN
2993 RETURN NULL;
2994 END IF;
2995 IF TG_OP = 'DELETE' THEN
2996 "issue_id_v" := OLD."issue_id";
2997 ELSE
2998 "issue_id_v" := NEW."issue_id";
2999 END IF;
3000 SELECT INTO "issue_row" * FROM "issue"
3001 WHERE "id" = "issue_id_v" FOR SHARE;
3002 IF (
3003 "issue_row"."closed" NOTNULL OR (
3004 "issue_row"."state" = 'voting' AND
3005 "issue_row"."phase_finished" NOTNULL
3006 )
3007 ) THEN
3008 IF
3009 TG_RELID = 'direct_voter'::regclass AND
3010 TG_OP = 'UPDATE'
3011 THEN
3012 IF
3013 OLD."issue_id" = NEW."issue_id" AND
3014 OLD."member_id" = NEW."member_id" AND
3015 OLD."weight" = NEW."weight"
3016 THEN
3017 RETURN NULL; -- allows changing of voter comment
3018 END IF;
3019 END IF;
3020 RAISE EXCEPTION 'Tried to modify data after voting has been closed.' USING
3021 ERRCODE = 'integrity_constraint_violation';
3022 END IF;
3023 RETURN NULL;
3024 END;
3025 $$;
3027 CREATE TRIGGER "forbid_changes_on_closed_issue"
3028 AFTER INSERT OR UPDATE OR DELETE ON "direct_voter"
3029 FOR EACH ROW EXECUTE PROCEDURE
3030 "forbid_changes_on_closed_issue_trigger"();
3032 CREATE TRIGGER "forbid_changes_on_closed_issue"
3033 AFTER INSERT OR UPDATE OR DELETE ON "delegating_voter"
3034 FOR EACH ROW EXECUTE PROCEDURE
3035 "forbid_changes_on_closed_issue_trigger"();
3037 CREATE TRIGGER "forbid_changes_on_closed_issue"
3038 AFTER INSERT OR UPDATE OR DELETE ON "vote"
3039 FOR EACH ROW EXECUTE PROCEDURE
3040 "forbid_changes_on_closed_issue_trigger"();
3042 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"';
3043 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';
3044 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';
3045 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';
3049 --------------------------------------------------------------------
3050 -- Auto-retrieval of fields only needed for referential integrity --
3051 --------------------------------------------------------------------
3054 CREATE FUNCTION "autofill_issue_id_trigger"()
3055 RETURNS TRIGGER
3056 LANGUAGE 'plpgsql' VOLATILE AS $$
3057 BEGIN
3058 IF NEW."issue_id" ISNULL THEN
3059 SELECT "issue_id" INTO NEW."issue_id"
3060 FROM "initiative" WHERE "id" = NEW."initiative_id";
3061 END IF;
3062 RETURN NEW;
3063 END;
3064 $$;
3066 CREATE TRIGGER "autofill_issue_id" BEFORE INSERT ON "supporter"
3067 FOR EACH ROW EXECUTE PROCEDURE "autofill_issue_id_trigger"();
3069 CREATE TRIGGER "autofill_issue_id" BEFORE INSERT ON "vote"
3070 FOR EACH ROW EXECUTE PROCEDURE "autofill_issue_id_trigger"();
3072 COMMENT ON FUNCTION "autofill_issue_id_trigger"() IS 'Implementation of triggers "autofill_issue_id" on tables "supporter" and "vote"';
3073 COMMENT ON TRIGGER "autofill_issue_id" ON "supporter" IS 'Set "issue_id" field automatically, if NULL';
3074 COMMENT ON TRIGGER "autofill_issue_id" ON "vote" IS 'Set "issue_id" field automatically, if NULL';
3077 CREATE FUNCTION "autofill_initiative_id_trigger"()
3078 RETURNS TRIGGER
3079 LANGUAGE 'plpgsql' VOLATILE AS $$
3080 BEGIN
3081 IF NEW."initiative_id" ISNULL THEN
3082 SELECT "initiative_id" INTO NEW."initiative_id"
3083 FROM "suggestion" WHERE "id" = NEW."suggestion_id";
3084 END IF;
3085 RETURN NEW;
3086 END;
3087 $$;
3089 CREATE TRIGGER "autofill_initiative_id" BEFORE INSERT ON "opinion"
3090 FOR EACH ROW EXECUTE PROCEDURE "autofill_initiative_id_trigger"();
3092 COMMENT ON FUNCTION "autofill_initiative_id_trigger"() IS 'Implementation of trigger "autofill_initiative_id" on table "opinion"';
3093 COMMENT ON TRIGGER "autofill_initiative_id" ON "opinion" IS 'Set "initiative_id" field automatically, if NULL';
3097 -------------------------------------------------------
3098 -- Automatic copying of values for indexing purposes --
3099 -------------------------------------------------------
3102 CREATE FUNCTION "copy_current_draft_data"
3103 ("initiative_id_p" "initiative"."id"%TYPE )
3104 RETURNS VOID
3105 LANGUAGE 'plpgsql' VOLATILE AS $$
3106 BEGIN
3107 PERFORM NULL FROM "initiative" WHERE "id" = "initiative_id_p"
3108 FOR UPDATE;
3109 UPDATE "initiative" SET
3110 "location" = "draft"."location",
3111 "draft_text_search_data" = "draft"."text_search_data"
3112 FROM "current_draft" AS "draft"
3113 WHERE "initiative"."id" = "initiative_id_p"
3114 AND "draft"."initiative_id" = "initiative_id_p";
3115 END;
3116 $$;
3118 COMMENT ON FUNCTION "copy_current_draft_data"
3119 ( "initiative"."id"%TYPE )
3120 IS 'Helper function for function "copy_current_draft_data_trigger"';
3123 CREATE FUNCTION "copy_current_draft_data_trigger"()
3124 RETURNS TRIGGER
3125 LANGUAGE 'plpgsql' VOLATILE AS $$
3126 BEGIN
3127 IF TG_OP='DELETE' THEN
3128 PERFORM "copy_current_draft_data"(OLD."initiative_id");
3129 ELSE
3130 IF TG_OP='UPDATE' THEN
3131 IF COALESCE(OLD."inititiave_id" != NEW."initiative_id", TRUE) THEN
3132 PERFORM "copy_current_draft_data"(OLD."initiative_id");
3133 END IF;
3134 END IF;
3135 PERFORM "copy_current_draft_data"(NEW."initiative_id");
3136 END IF;
3137 RETURN NULL;
3138 END;
3139 $$;
3141 CREATE TRIGGER "copy_current_draft_data"
3142 AFTER INSERT OR UPDATE OR DELETE ON "draft"
3143 FOR EACH ROW EXECUTE PROCEDURE
3144 "copy_current_draft_data_trigger"();
3146 COMMENT ON FUNCTION "copy_current_draft_data_trigger"() IS 'Implementation of trigger "copy_current_draft_data" on table "draft"';
3147 COMMENT ON TRIGGER "copy_current_draft_data" ON "draft" IS 'Copy certain fields from most recent "draft" to "initiative"';
3151 -----------------------------------------------------
3152 -- Automatic calculation of certain default values --
3153 -----------------------------------------------------
3156 CREATE FUNCTION "copy_timings_trigger"()
3157 RETURNS TRIGGER
3158 LANGUAGE 'plpgsql' VOLATILE AS $$
3159 DECLARE
3160 "policy_row" "policy"%ROWTYPE;
3161 BEGIN
3162 SELECT * INTO "policy_row" FROM "policy"
3163 WHERE "id" = NEW."policy_id";
3164 IF NEW."min_admission_time" ISNULL THEN
3165 NEW."min_admission_time" := "policy_row"."min_admission_time";
3166 END IF;
3167 IF NEW."max_admission_time" ISNULL THEN
3168 NEW."max_admission_time" := "policy_row"."max_admission_time";
3169 END IF;
3170 IF NEW."discussion_time" ISNULL THEN
3171 NEW."discussion_time" := "policy_row"."discussion_time";
3172 END IF;
3173 IF NEW."verification_time" ISNULL THEN
3174 NEW."verification_time" := "policy_row"."verification_time";
3175 END IF;
3176 IF NEW."voting_time" ISNULL THEN
3177 NEW."voting_time" := "policy_row"."voting_time";
3178 END IF;
3179 RETURN NEW;
3180 END;
3181 $$;
3183 CREATE TRIGGER "copy_timings" BEFORE INSERT OR UPDATE ON "issue"
3184 FOR EACH ROW EXECUTE PROCEDURE "copy_timings_trigger"();
3186 COMMENT ON FUNCTION "copy_timings_trigger"() IS 'Implementation of trigger "copy_timings" on table "issue"';
3187 COMMENT ON TRIGGER "copy_timings" ON "issue" IS 'If timing fields are NULL, copy values from policy.';
3190 CREATE FUNCTION "default_for_draft_id_trigger"()
3191 RETURNS TRIGGER
3192 LANGUAGE 'plpgsql' VOLATILE AS $$
3193 BEGIN
3194 IF NEW."draft_id" ISNULL THEN
3195 SELECT "id" INTO NEW."draft_id" FROM "current_draft"
3196 WHERE "initiative_id" = NEW."initiative_id";
3197 END IF;
3198 RETURN NEW;
3199 END;
3200 $$;
3202 CREATE TRIGGER "default_for_draft_id" BEFORE INSERT OR UPDATE ON "suggestion"
3203 FOR EACH ROW EXECUTE PROCEDURE "default_for_draft_id_trigger"();
3204 CREATE TRIGGER "default_for_draft_id" BEFORE INSERT OR UPDATE ON "supporter"
3205 FOR EACH ROW EXECUTE PROCEDURE "default_for_draft_id_trigger"();
3207 COMMENT ON FUNCTION "default_for_draft_id_trigger"() IS 'Implementation of trigger "default_for_draft" on tables "supporter" and "suggestion"';
3208 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';
3209 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';
3213 ----------------------------------------
3214 -- Automatic creation of dependencies --
3215 ----------------------------------------
3218 CREATE FUNCTION "autocreate_interest_trigger"()
3219 RETURNS TRIGGER
3220 LANGUAGE 'plpgsql' VOLATILE AS $$
3221 BEGIN
3222 IF NOT EXISTS (
3223 SELECT NULL FROM "initiative" JOIN "interest"
3224 ON "initiative"."issue_id" = "interest"."issue_id"
3225 WHERE "initiative"."id" = NEW."initiative_id"
3226 AND "interest"."member_id" = NEW."member_id"
3227 ) THEN
3228 BEGIN
3229 INSERT INTO "interest" ("issue_id", "member_id")
3230 SELECT "issue_id", NEW."member_id"
3231 FROM "initiative" WHERE "id" = NEW."initiative_id";
3232 EXCEPTION WHEN unique_violation THEN END;
3233 END IF;
3234 RETURN NEW;
3235 END;
3236 $$;
3238 CREATE TRIGGER "autocreate_interest" BEFORE INSERT ON "supporter"
3239 FOR EACH ROW EXECUTE PROCEDURE "autocreate_interest_trigger"();
3241 COMMENT ON FUNCTION "autocreate_interest_trigger"() IS 'Implementation of trigger "autocreate_interest" on table "supporter"';
3242 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';
3245 CREATE FUNCTION "autocreate_supporter_trigger"()
3246 RETURNS TRIGGER
3247 LANGUAGE 'plpgsql' VOLATILE AS $$
3248 BEGIN
3249 IF NOT EXISTS (
3250 SELECT NULL FROM "suggestion" JOIN "supporter"
3251 ON "suggestion"."initiative_id" = "supporter"."initiative_id"
3252 WHERE "suggestion"."id" = NEW."suggestion_id"
3253 AND "supporter"."member_id" = NEW."member_id"
3254 ) THEN
3255 BEGIN
3256 INSERT INTO "supporter" ("initiative_id", "member_id")
3257 SELECT "initiative_id", NEW."member_id"
3258 FROM "suggestion" WHERE "id" = NEW."suggestion_id";
3259 EXCEPTION WHEN unique_violation THEN END;
3260 END IF;
3261 RETURN NEW;
3262 END;
3263 $$;
3265 CREATE TRIGGER "autocreate_supporter" BEFORE INSERT ON "opinion"
3266 FOR EACH ROW EXECUTE PROCEDURE "autocreate_supporter_trigger"();
3268 COMMENT ON FUNCTION "autocreate_supporter_trigger"() IS 'Implementation of trigger "autocreate_supporter" on table "opinion"';
3269 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.';
3273 ------------------------------------------
3274 -- Views and helper functions for views --
3275 ------------------------------------------
3278 CREATE VIEW "member_eligible_to_be_notified" AS
3279 SELECT * FROM "member"
3280 WHERE "activated" NOTNULL AND "locked" = FALSE;
3282 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")';
3285 CREATE VIEW "member_to_notify" AS
3286 SELECT * FROM "member_eligible_to_be_notified"
3287 WHERE "disable_notifications" = FALSE;
3289 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)';
3292 CREATE VIEW "area_quorum" AS
3293 SELECT
3294 "area"."id" AS "area_id",
3295 ceil(
3296 "area"."quorum_standard"::FLOAT8 * "quorum_factor"::FLOAT8 ^ (
3297 coalesce(
3298 ( SELECT sum(
3299 ( extract(epoch from "area"."quorum_time")::FLOAT8 /
3300 extract(epoch from
3301 ("issue"."accepted"-"issue"."created") +
3302 "issue"."discussion_time" +
3303 "issue"."verification_time" +
3304 "issue"."voting_time"
3305 )::FLOAT8
3306 ) ^ "area"."quorum_exponent"::FLOAT8
3307 )
3308 FROM "issue" JOIN "policy"
3309 ON "issue"."policy_id" = "policy"."id"
3310 WHERE "issue"."area_id" = "area"."id"
3311 AND "issue"."accepted" NOTNULL
3312 AND "issue"."closed" ISNULL
3313 AND "policy"."polling" = FALSE
3314 )::FLOAT8, 0::FLOAT8
3315 ) / "area"."quorum_issues"::FLOAT8 - 1::FLOAT8
3316 ) * CASE WHEN "area"."quorum_den" ISNULL THEN 1 ELSE (
3317 SELECT "snapshot"."population"
3318 FROM "snapshot"
3319 WHERE "snapshot"."area_id" = "area"."id"
3320 AND "snapshot"."issue_id" ISNULL
3321 ORDER BY "snapshot"."id" DESC
3322 LIMIT 1
3323 ) END / coalesce("area"."quorum_den", 1)
3325 )::INT4 AS "issue_quorum"
3326 FROM "area";
3328 COMMENT ON VIEW "area_quorum" IS 'Area-based quorum considering number of open (accepted) issues';
3331 CREATE VIEW "issue_quorum" AS
3332 SELECT DISTINCT ON ("issue_id")
3333 "issue"."id" AS "issue_id",
3334 "subquery"."issue_quorum"
3335 FROM "issue"
3336 CROSS JOIN LATERAL (
3337 SELECT "area_quorum"."issue_quorum"
3338 FROM "area_quorum" WHERE "area_quorum"."area_id" = "issue"."area_id"
3339 UNION ALL
3340 SELECT "policy"."issue_quorum"
3341 FROM "policy" WHERE "policy"."id" = "issue"."policy_id"
3342 UNION ALL
3343 SELECT
3344 ceil(
3345 ("issue"."population"::INT8 * "policy"."issue_quorum_num"::INT8) /
3346 "policy"."issue_quorum_den"::FLOAT8
3347 )::INT4
3348 FROM "policy" WHERE "policy"."id" = "issue"."policy_id"
3349 ) AS "subquery"
3350 ORDER BY "issue_id", "issue_quorum" DESC;
3352 COMMENT ON VIEW "issue_quorum" IS 'Effective quorum for issue admission';
3355 CREATE VIEW "area_with_unaccepted_issues" AS
3356 SELECT DISTINCT ON ("area"."id") "area".*
3357 FROM "area" JOIN "issue" ON "area"."id" = "issue"."area_id"
3358 WHERE "issue"."state" = 'admission';
3360 COMMENT ON VIEW "area_with_unaccepted_issues" IS 'All areas with unaccepted open issues (needed for issue admission system)';
3363 CREATE VIEW "issue_for_admission" AS
3364 SELECT DISTINCT ON ("issue"."area_id")
3365 "issue".*,
3366 max("initiative"."supporter_count") AS "max_supporter_count"
3367 FROM "issue"
3368 JOIN "policy" ON "issue"."policy_id" = "policy"."id"
3369 JOIN "initiative" ON "issue"."id" = "initiative"."issue_id"
3370 JOIN "area" ON "issue"."area_id" = "area"."id"
3371 WHERE "issue"."state" = 'admission'::"issue_state"
3372 AND now() >= "issue"."created" + "issue"."min_admission_time"
3373 AND "initiative"."supporter_count" >= "policy"."issue_quorum"
3374 AND "initiative"."supporter_count" * "policy"."issue_quorum_den" >=
3375 "issue"."population" * "policy"."issue_quorum_num"
3376 AND "initiative"."supporter_count" >= "area"."issue_quorum"
3377 AND "initiative"."revoked" ISNULL
3378 GROUP BY "issue"."id"
3379 ORDER BY "issue"."area_id", "max_supporter_count" DESC, "issue"."id";
3381 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';
3384 CREATE VIEW "unit_delegation" AS
3385 SELECT
3386 "unit"."id" AS "unit_id",
3387 "delegation"."id",
3388 "delegation"."truster_id",
3389 "delegation"."trustee_id",
3390 "delegation"."scope"
3391 FROM "unit"
3392 JOIN "delegation"
3393 ON "delegation"."unit_id" = "unit"."id"
3394 JOIN "member"
3395 ON "delegation"."truster_id" = "member"."id"
3396 JOIN "privilege"
3397 ON "delegation"."unit_id" = "privilege"."unit_id"
3398 AND "delegation"."truster_id" = "privilege"."member_id"
3399 WHERE "member"."active" AND "privilege"."voting_right";
3401 COMMENT ON VIEW "unit_delegation" IS 'Unit delegations where trusters are active and have voting right';
3404 CREATE VIEW "area_delegation" AS
3405 SELECT DISTINCT ON ("area"."id", "delegation"."truster_id")
3406 "area"."id" AS "area_id",
3407 "delegation"."id",
3408 "delegation"."truster_id",
3409 "delegation"."trustee_id",
3410 "delegation"."scope"
3411 FROM "area"
3412 JOIN "delegation"
3413 ON "delegation"."unit_id" = "area"."unit_id"
3414 OR "delegation"."area_id" = "area"."id"
3415 JOIN "member"
3416 ON "delegation"."truster_id" = "member"."id"
3417 JOIN "privilege"
3418 ON "area"."unit_id" = "privilege"."unit_id"
3419 AND "delegation"."truster_id" = "privilege"."member_id"
3420 WHERE "member"."active" AND "privilege"."voting_right"
3421 ORDER BY
3422 "area"."id",
3423 "delegation"."truster_id",
3424 "delegation"."scope" DESC;
3426 COMMENT ON VIEW "area_delegation" IS 'Area delegations where trusters are active and have voting right';
3429 CREATE VIEW "issue_delegation" AS
3430 SELECT DISTINCT ON ("issue"."id", "delegation"."truster_id")
3431 "issue"."id" AS "issue_id",
3432 "delegation"."id",
3433 "delegation"."truster_id",
3434 "delegation"."trustee_id",
3435 "delegation"."scope"
3436 FROM "issue"
3437 JOIN "area"
3438 ON "area"."id" = "issue"."area_id"
3439 JOIN "delegation"
3440 ON "delegation"."unit_id" = "area"."unit_id"
3441 OR "delegation"."area_id" = "area"."id"
3442 OR "delegation"."issue_id" = "issue"."id"
3443 JOIN "member"
3444 ON "delegation"."truster_id" = "member"."id"
3445 JOIN "privilege"
3446 ON "area"."unit_id" = "privilege"."unit_id"
3447 AND "delegation"."truster_id" = "privilege"."member_id"
3448 WHERE "member"."active" AND "privilege"."voting_right"
3449 ORDER BY
3450 "issue"."id",
3451 "delegation"."truster_id",
3452 "delegation"."scope" DESC;
3454 COMMENT ON VIEW "issue_delegation" IS 'Issue delegations where trusters are active and have voting right';
3457 CREATE VIEW "member_count_view" AS
3458 SELECT count(1) AS "total_count" FROM "member" WHERE "active";
3460 COMMENT ON VIEW "member_count_view" IS 'View used to update "member_count" table';
3463 CREATE VIEW "unit_member" AS
3464 SELECT
3465 "unit"."id" AS "unit_id",
3466 "member"."id" AS "member_id"
3467 FROM "privilege"
3468 JOIN "unit" ON "unit"."id" = "privilege"."unit_id"
3469 JOIN "member" ON "member"."id" = "privilege"."member_id"
3470 WHERE "privilege"."voting_right" AND "member"."active";
3472 COMMENT ON VIEW "unit_member" IS 'Active members with voting right in a unit';
3475 CREATE VIEW "unit_member_count" AS
3476 SELECT
3477 "unit"."id" AS "unit_id",
3478 count("unit_member"."member_id") AS "member_count"
3479 FROM "unit" LEFT JOIN "unit_member"
3480 ON "unit"."id" = "unit_member"."unit_id"
3481 GROUP BY "unit"."id";
3483 COMMENT ON VIEW "unit_member_count" IS 'View used to update "member_count" column of "unit" table';
3486 CREATE VIEW "opening_draft" AS
3487 SELECT DISTINCT ON ("initiative_id") * FROM "draft"
3488 ORDER BY "initiative_id", "id";
3490 COMMENT ON VIEW "opening_draft" IS 'First drafts of all initiatives';
3493 CREATE VIEW "current_draft" AS
3494 SELECT DISTINCT ON ("initiative_id") * FROM "draft"
3495 ORDER BY "initiative_id", "id" DESC;
3497 COMMENT ON VIEW "current_draft" IS 'All latest drafts for each initiative';
3500 CREATE VIEW "critical_opinion" AS
3501 SELECT * FROM "opinion"
3502 WHERE ("degree" = 2 AND "fulfilled" = FALSE)
3503 OR ("degree" = -2 AND "fulfilled" = TRUE);
3505 COMMENT ON VIEW "critical_opinion" IS 'Opinions currently causing dissatisfaction';
3508 CREATE VIEW "issue_supporter_in_admission_state" AS
3509 SELECT
3510 "area"."unit_id",
3511 "issue"."area_id",
3512 "issue"."id" AS "issue_id",
3513 "supporter"."member_id",
3514 "direct_interest_snapshot"."weight"
3515 FROM "issue"
3516 JOIN "area" ON "area"."id" = "issue"."area_id"
3517 JOIN "supporter" ON "supporter"."issue_id" = "issue"."id"
3518 JOIN "direct_interest_snapshot"
3519 ON "direct_interest_snapshot"."snapshot_id" = "issue"."latest_snapshot_id"
3520 AND "direct_interest_snapshot"."issue_id" = "issue"."id"
3521 AND "direct_interest_snapshot"."member_id" = "supporter"."member_id"
3522 WHERE "issue"."state" = 'admission'::"issue_state";
3524 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';
3527 CREATE VIEW "initiative_suggestion_order_calculation" AS
3528 SELECT
3529 "initiative"."id" AS "initiative_id",
3530 ("issue"."closed" NOTNULL OR "issue"."fully_frozen" NOTNULL) AS "final"
3531 FROM "initiative" JOIN "issue"
3532 ON "initiative"."issue_id" = "issue"."id"
3533 WHERE ("issue"."closed" ISNULL AND "issue"."fully_frozen" ISNULL)
3534 OR ("initiative"."final_suggestion_order_calculated" = FALSE);
3536 COMMENT ON VIEW "initiative_suggestion_order_calculation" IS 'Initiatives, where the "proportional_order" of its suggestions has to be calculated';
3538 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';
3541 CREATE VIEW "individual_suggestion_ranking" AS
3542 SELECT
3543 "opinion"."initiative_id",
3544 "opinion"."member_id",
3545 "direct_interest_snapshot"."weight",
3546 CASE WHEN
3547 ("opinion"."degree" = 2 AND "opinion"."fulfilled" = FALSE) OR
3548 ("opinion"."degree" = -2 AND "opinion"."fulfilled" = TRUE)
3549 THEN 1 ELSE
3550 CASE WHEN
3551 ("opinion"."degree" = 1 AND "opinion"."fulfilled" = FALSE) OR
3552 ("opinion"."degree" = -1 AND "opinion"."fulfilled" = TRUE)
3553 THEN 2 ELSE
3554 CASE WHEN
3555 ("opinion"."degree" = 2 AND "opinion"."fulfilled" = TRUE) OR
3556 ("opinion"."degree" = -2 AND "opinion"."fulfilled" = FALSE)
3557 THEN 3 ELSE 4 END
3558 END
3559 END AS "preference",
3560 "opinion"."suggestion_id"
3561 FROM "opinion"
3562 JOIN "initiative" ON "initiative"."id" = "opinion"."initiative_id"
3563 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
3564 JOIN "direct_interest_snapshot"
3565 ON "direct_interest_snapshot"."snapshot_id" = "issue"."latest_snapshot_id"
3566 AND "direct_interest_snapshot"."issue_id" = "issue"."id"
3567 AND "direct_interest_snapshot"."member_id" = "opinion"."member_id";
3569 COMMENT ON VIEW "individual_suggestion_ranking" IS 'Helper view for "lf_update_suggestion_order" to allow a proportional ordering of suggestions within an initiative';
3572 CREATE VIEW "battle_participant" AS
3573 SELECT "initiative"."id", "initiative"."issue_id"
3574 FROM "issue" JOIN "initiative"
3575 ON "issue"."id" = "initiative"."issue_id"
3576 WHERE "initiative"."admitted"
3577 UNION ALL
3578 SELECT NULL, "id" AS "issue_id"
3579 FROM "issue";
3581 COMMENT ON VIEW "battle_participant" IS 'Helper view for "battle_view" containing admitted initiatives plus virtual "status-quo" initiative denoted by NULL reference';
3584 CREATE VIEW "battle_view" AS
3585 SELECT
3586 "issue"."id" AS "issue_id",
3587 "winning_initiative"."id" AS "winning_initiative_id",
3588 "losing_initiative"."id" AS "losing_initiative_id",
3589 sum(
3590 CASE WHEN
3591 coalesce("better_vote"."grade", 0) >
3592 coalesce("worse_vote"."grade", 0)
3593 THEN "direct_voter"."weight" ELSE 0 END
3594 ) AS "count"
3595 FROM "issue"
3596 LEFT JOIN "direct_voter"
3597 ON "issue"."id" = "direct_voter"."issue_id"
3598 JOIN "battle_participant" AS "winning_initiative"
3599 ON "issue"."id" = "winning_initiative"."issue_id"
3600 JOIN "battle_participant" AS "losing_initiative"
3601 ON "issue"."id" = "losing_initiative"."issue_id"
3602 LEFT JOIN "vote" AS "better_vote"
3603 ON "direct_voter"."member_id" = "better_vote"."member_id"
3604 AND "winning_initiative"."id" = "better_vote"."initiative_id"
3605 LEFT JOIN "vote" AS "worse_vote"
3606 ON "direct_voter"."member_id" = "worse_vote"."member_id"
3607 AND "losing_initiative"."id" = "worse_vote"."initiative_id"
3608 WHERE "issue"."state" = 'voting'
3609 AND "issue"."phase_finished" NOTNULL
3610 AND (
3611 "winning_initiative"."id" != "losing_initiative"."id" OR
3612 ( ("winning_initiative"."id" NOTNULL AND "losing_initiative"."id" ISNULL) OR
3613 ("winning_initiative"."id" ISNULL AND "losing_initiative"."id" NOTNULL) ) )
3614 GROUP BY
3615 "issue"."id",
3616 "winning_initiative"."id",
3617 "losing_initiative"."id";
3619 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';
3622 CREATE VIEW "expired_session" AS
3623 SELECT * FROM "session" WHERE now() > "expiry";
3625 CREATE RULE "delete" AS ON DELETE TO "expired_session" DO INSTEAD
3626 DELETE FROM "session" WHERE "id" = OLD."id";
3628 COMMENT ON VIEW "expired_session" IS 'View containing all expired sessions where DELETE is possible';
3629 COMMENT ON RULE "delete" ON "expired_session" IS 'Rule allowing DELETE on rows in "expired_session" view, i.e. DELETE FROM "expired_session"';
3632 CREATE VIEW "expired_token" AS
3633 SELECT * FROM "token" WHERE now() > "expiry" AND NOT (
3634 "token_type" = 'authorization' AND "used" AND EXISTS (
3635 SELECT NULL FROM "token" AS "other"
3636 WHERE "other"."authorization_token_id" = "id" ) );
3638 CREATE RULE "delete" AS ON DELETE TO "expired_token" DO INSTEAD
3639 DELETE FROM "token" WHERE "id" = OLD."id";
3641 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';
3644 CREATE VIEW "unused_snapshot" AS
3645 SELECT "snapshot".* FROM "snapshot"
3646 LEFT JOIN "issue"
3647 ON "snapshot"."id" = "issue"."latest_snapshot_id"
3648 OR "snapshot"."id" = "issue"."admission_snapshot_id"
3649 OR "snapshot"."id" = "issue"."half_freeze_snapshot_id"
3650 OR "snapshot"."id" = "issue"."full_freeze_snapshot_id"
3651 WHERE "issue"."id" ISNULL;
3653 CREATE RULE "delete" AS ON DELETE TO "unused_snapshot" DO INSTEAD
3654 DELETE FROM "snapshot" WHERE "id" = OLD."id";
3656 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)';
3659 CREATE VIEW "expired_snapshot" AS
3660 SELECT "unused_snapshot".* FROM "unused_snapshot" CROSS JOIN "system_setting"
3661 WHERE "unused_snapshot"."calculated" <
3662 now() - "system_setting"."snapshot_retention";
3664 CREATE RULE "delete" AS ON DELETE TO "expired_snapshot" DO INSTEAD
3665 DELETE FROM "snapshot" WHERE "id" = OLD."id";
3667 COMMENT ON VIEW "expired_snapshot" IS 'Contains "unused_snapshot"s that are older than "system_setting"."snapshot_retention" (for deletion)';
3670 CREATE VIEW "open_issue" AS
3671 SELECT * FROM "issue" WHERE "closed" ISNULL;
3673 COMMENT ON VIEW "open_issue" IS 'All open issues';
3676 CREATE VIEW "member_contingent" AS
3677 SELECT
3678 "member"."id" AS "member_id",
3679 "contingent"."polling",
3680 "contingent"."time_frame",
3681 CASE WHEN "contingent"."text_entry_limit" NOTNULL THEN
3682 (
3683 SELECT count(1) FROM "draft"
3684 JOIN "initiative" ON "initiative"."id" = "draft"."initiative_id"
3685 WHERE "draft"."author_id" = "member"."id"
3686 AND "initiative"."polling" = "contingent"."polling"
3687 AND "draft"."created" > now() - "contingent"."time_frame"
3688 ) + (
3689 SELECT count(1) FROM "suggestion"
3690 JOIN "initiative" ON "initiative"."id" = "suggestion"."initiative_id"
3691 WHERE "suggestion"."author_id" = "member"."id"
3692 AND "contingent"."polling" = FALSE
3693 AND "suggestion"."created" > now() - "contingent"."time_frame"
3694 )
3695 ELSE NULL END AS "text_entry_count",
3696 "contingent"."text_entry_limit",
3697 CASE WHEN "contingent"."initiative_limit" NOTNULL THEN (
3698 SELECT count(1) FROM "opening_draft" AS "draft"
3699 JOIN "initiative" ON "initiative"."id" = "draft"."initiative_id"
3700 WHERE "draft"."author_id" = "member"."id"
3701 AND "initiative"."polling" = "contingent"."polling"
3702 AND "draft"."created" > now() - "contingent"."time_frame"
3703 ) ELSE NULL END AS "initiative_count",
3704 "contingent"."initiative_limit"
3705 FROM "member" CROSS JOIN "contingent";
3707 COMMENT ON VIEW "member_contingent" IS 'Actual counts of text entries and initiatives are calculated per member for each limit in the "contingent" table.';
3709 COMMENT ON COLUMN "member_contingent"."text_entry_count" IS 'Only calculated when "text_entry_limit" is not null in the same row';
3710 COMMENT ON COLUMN "member_contingent"."initiative_count" IS 'Only calculated when "initiative_limit" is not null in the same row';
3713 CREATE VIEW "member_contingent_left" AS
3714 SELECT
3715 "member_id",
3716 "polling",
3717 max("text_entry_limit" - "text_entry_count") AS "text_entries_left",
3718 max("initiative_limit" - "initiative_count") AS "initiatives_left"
3719 FROM "member_contingent" GROUP BY "member_id", "polling";
3721 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.';
3724 CREATE VIEW "event_for_notification" AS
3725 SELECT
3726 "member"."id" AS "recipient_id",
3727 "event".*
3728 FROM "member" CROSS JOIN "event"
3729 JOIN "issue" ON "issue"."id" = "event"."issue_id"
3730 JOIN "area" ON "area"."id" = "issue"."area_id"
3731 LEFT JOIN "privilege" ON
3732 "privilege"."member_id" = "member"."id" AND
3733 "privilege"."unit_id" = "area"."unit_id" AND
3734 "privilege"."voting_right" = TRUE
3735 LEFT JOIN "subscription" ON
3736 "subscription"."member_id" = "member"."id" AND
3737 "subscription"."unit_id" = "area"."unit_id"
3738 LEFT JOIN "ignored_area" ON
3739 "ignored_area"."member_id" = "member"."id" AND
3740 "ignored_area"."area_id" = "issue"."area_id"
3741 LEFT JOIN "interest" ON
3742 "interest"."member_id" = "member"."id" AND
3743 "interest"."issue_id" = "event"."issue_id"
3744 LEFT JOIN "supporter" ON
3745 "supporter"."member_id" = "member"."id" AND
3746 "supporter"."initiative_id" = "event"."initiative_id"
3747 WHERE ("privilege"."member_id" NOTNULL OR "subscription"."member_id" NOTNULL)
3748 AND ("ignored_area"."member_id" ISNULL OR "interest"."member_id" NOTNULL)
3749 AND (
3750 "event"."event" = 'issue_state_changed'::"event_type" OR
3751 ( "event"."event" = 'initiative_revoked'::"event_type" AND
3752 "supporter"."member_id" NOTNULL ) );
3754 COMMENT ON VIEW "event_for_notification" IS 'Entries of the "event" table which are of interest for a particular notification mail recipient';
3756 COMMENT ON COLUMN "event_for_notification"."recipient_id" IS 'member_id of the recipient of a notification mail';
3759 CREATE VIEW "updated_initiative" AS
3760 SELECT
3761 "supporter"."member_id" AS "recipient_id",
3762 FALSE AS "featured",
3763 "supporter"."initiative_id"
3764 FROM "supporter"
3765 JOIN "initiative" ON "supporter"."initiative_id" = "initiative"."id"
3766 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
3767 LEFT JOIN "notification_initiative_sent" AS "sent" ON
3768 "sent"."member_id" = "supporter"."member_id" AND
3769 "sent"."initiative_id" = "supporter"."initiative_id"
3770 LEFT JOIN "ignored_initiative" ON
3771 "ignored_initiative"."member_id" = "supporter"."member_id" AND
3772 "ignored_initiative"."initiative_id" = "supporter"."initiative_id"
3773 WHERE "issue"."state" IN ('admission', 'discussion')
3774 AND "initiative"."revoked" ISNULL
3775 AND "ignored_initiative"."member_id" ISNULL
3776 AND (
3777 EXISTS (
3778 SELECT NULL FROM "draft"
3779 LEFT JOIN "ignored_member" ON
3780 "ignored_member"."member_id" = "supporter"."member_id" AND
3781 "ignored_member"."other_member_id" = "draft"."author_id"
3782 WHERE "draft"."initiative_id" = "supporter"."initiative_id"
3783 AND "draft"."id" > "supporter"."draft_id"
3784 AND "ignored_member"."member_id" ISNULL
3785 ) OR EXISTS (
3786 SELECT NULL FROM "suggestion"
3787 LEFT JOIN "opinion" ON
3788 "opinion"."member_id" = "supporter"."member_id" AND
3789 "opinion"."suggestion_id" = "suggestion"."id"
3790 LEFT JOIN "ignored_member" ON
3791 "ignored_member"."member_id" = "supporter"."member_id" AND
3792 "ignored_member"."other_member_id" = "suggestion"."author_id"
3793 WHERE "suggestion"."initiative_id" = "supporter"."initiative_id"
3794 AND "opinion"."member_id" ISNULL
3795 AND COALESCE("suggestion"."id" > "sent"."last_suggestion_id", TRUE)
3796 AND "ignored_member"."member_id" ISNULL
3797 )
3798 );
3800 COMMENT ON VIEW "updated_initiative" IS 'Helper view for view "updated_or_featured_initiative"';
3803 CREATE FUNCTION "featured_initiative"
3804 ( "recipient_id_p" "member"."id"%TYPE,
3805 "area_id_p" "area"."id"%TYPE )
3806 RETURNS SETOF "initiative"."id"%TYPE
3807 LANGUAGE 'plpgsql' STABLE AS $$
3808 DECLARE
3809 "counter_v" "member"."notification_counter"%TYPE;
3810 "sample_size_v" "member"."notification_sample_size"%TYPE;
3811 "initiative_id_ary" INT4[]; --"initiative"."id"%TYPE[]
3812 "match_v" BOOLEAN;
3813 "member_id_v" "member"."id"%TYPE;
3814 "seed_v" TEXT;
3815 "initiative_id_v" "initiative"."id"%TYPE;
3816 BEGIN
3817 SELECT "notification_counter", "notification_sample_size"
3818 INTO "counter_v", "sample_size_v"
3819 FROM "member" WHERE "id" = "recipient_id_p";
3820 IF COALESCE("sample_size_v" <= 0, TRUE) THEN
3821 RETURN;
3822 END IF;
3823 "initiative_id_ary" := '{}';
3824 LOOP
3825 "match_v" := FALSE;
3826 FOR "member_id_v", "seed_v" IN
3827 SELECT * FROM (
3828 SELECT DISTINCT
3829 "supporter"."member_id",
3830 md5(
3831 "recipient_id_p" || '-' ||
3832 "counter_v" || '-' ||
3833 "area_id_p" || '-' ||
3834 "supporter"."member_id"
3835 ) AS "seed"
3836 FROM "supporter"
3837 JOIN "initiative" ON "initiative"."id" = "supporter"."initiative_id"
3838 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
3839 WHERE "supporter"."member_id" != "recipient_id_p"
3840 AND "issue"."area_id" = "area_id_p"
3841 AND "issue"."state" IN ('admission', 'discussion', 'verification')
3842 ) AS "subquery"
3843 ORDER BY "seed"
3844 LOOP
3845 SELECT "initiative"."id" INTO "initiative_id_v"
3846 FROM "initiative"
3847 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
3848 JOIN "area" ON "area"."id" = "issue"."area_id"
3849 JOIN "supporter" ON "supporter"."initiative_id" = "initiative"."id"
3850 LEFT JOIN "supporter" AS "self_support" ON
3851 "self_support"."initiative_id" = "initiative"."id" AND
3852 "self_support"."member_id" = "recipient_id_p"
3853 LEFT JOIN "privilege" ON
3854 "privilege"."member_id" = "recipient_id_p" AND
3855 "privilege"."unit_id" = "area"."unit_id" AND
3856 "privilege"."voting_right" = TRUE
3857 LEFT JOIN "subscription" ON
3858 "subscription"."member_id" = "recipient_id_p" AND
3859 "subscription"."unit_id" = "area"."unit_id"
3860 LEFT JOIN "ignored_initiative" ON
3861 "ignored_initiative"."member_id" = "recipient_id_p" AND
3862 "ignored_initiative"."initiative_id" = "initiative"."id"
3863 WHERE "supporter"."member_id" = "member_id_v"
3864 AND "issue"."area_id" = "area_id_p"
3865 AND "issue"."state" IN ('admission', 'discussion', 'verification')
3866 AND "initiative"."revoked" ISNULL
3867 AND "self_support"."member_id" ISNULL
3868 AND NOT "initiative_id_ary" @> ARRAY["initiative"."id"]
3869 AND (
3870 "privilege"."member_id" NOTNULL OR
3871 "subscription"."member_id" NOTNULL )
3872 AND "ignored_initiative"."member_id" ISNULL
3873 AND NOT EXISTS (
3874 SELECT NULL FROM "draft"
3875 JOIN "ignored_member" ON
3876 "ignored_member"."member_id" = "recipient_id_p" AND
3877 "ignored_member"."other_member_id" = "draft"."author_id"
3878 WHERE "draft"."initiative_id" = "initiative"."id"
3879 )
3880 ORDER BY md5("seed_v" || '-' || "initiative"."id")
3881 LIMIT 1;
3882 IF FOUND THEN
3883 "match_v" := TRUE;
3884 RETURN NEXT "initiative_id_v";
3885 IF array_length("initiative_id_ary", 1) + 1 >= "sample_size_v" THEN
3886 RETURN;
3887 END IF;
3888 "initiative_id_ary" := "initiative_id_ary" || "initiative_id_v";
3889 END IF;
3890 END LOOP;
3891 EXIT WHEN NOT "match_v";
3892 END LOOP;
3893 RETURN;
3894 END;
3895 $$;
3897 COMMENT ON FUNCTION "featured_initiative"
3898 ( "recipient_id_p" "member"."id"%TYPE,
3899 "area_id_p" "area"."id"%TYPE )
3900 IS 'Helper function for view "updated_or_featured_initiative"';
3903 CREATE VIEW "updated_or_featured_initiative" AS
3904 SELECT
3905 "subquery".*,
3906 NOT EXISTS (
3907 SELECT NULL FROM "initiative" AS "better_initiative"
3908 WHERE "better_initiative"."issue_id" = "initiative"."issue_id"
3909 AND
3910 ( COALESCE("better_initiative"."supporter_count", -1),
3911 -"better_initiative"."id" ) >
3912 ( COALESCE("initiative"."supporter_count", -1),
3913 -"initiative"."id" )
3914 ) AS "leading"
3915 FROM (
3916 SELECT * FROM "updated_initiative"
3917 UNION ALL
3918 SELECT
3919 "member"."id" AS "recipient_id",
3920 TRUE AS "featured",
3921 "featured_initiative_id" AS "initiative_id"
3922 FROM "member" CROSS JOIN "area"
3923 CROSS JOIN LATERAL
3924 "featured_initiative"("member"."id", "area"."id") AS "featured_initiative_id"
3925 JOIN "initiative" ON "initiative"."id" = "featured_initiative_id"
3926 ) AS "subquery"
3927 JOIN "initiative" ON "initiative"."id" = "subquery"."initiative_id";
3929 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';
3931 COMMENT ON COLUMN "updated_or_featured_initiative"."recipient_id" IS '"id" of the member who receives the notification mail';
3932 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")';
3933 COMMENT ON COLUMN "updated_or_featured_initiative"."initiative_id" IS '"id" of the initiative to be included in the notification mail';
3934 COMMENT ON COLUMN "updated_or_featured_initiative"."leading" IS 'TRUE if the initiative has the highest "supporter_count" in the issue';
3937 CREATE VIEW "leading_complement_initiative" AS
3938 SELECT * FROM (
3939 SELECT DISTINCT ON ("uf_initiative"."recipient_id", "initiative"."issue_id")
3940 "uf_initiative"."recipient_id",
3941 FALSE AS "featured",
3942 "uf_initiative"."initiative_id",
3943 TRUE AS "leading"
3944 FROM "updated_or_featured_initiative" AS "uf_initiative"
3945 JOIN "initiative" AS "uf_initiative_full" ON
3946 "uf_initiative_full"."id" = "uf_initiative"."initiative_id"
3947 JOIN "initiative" ON
3948 "initiative"."issue_id" = "uf_initiative_full"."issue_id"
3949 WHERE "initiative"."revoked" ISNULL
3950 ORDER BY
3951 "uf_initiative"."recipient_id",
3952 "initiative"."issue_id",
3953 "initiative"."supporter_count" DESC,
3954 "initiative"."id"
3955 ) AS "subquery"
3956 WHERE NOT EXISTS (
3957 SELECT NULL FROM "updated_or_featured_initiative" AS "other"
3958 WHERE "other"."recipient_id" = "subquery"."recipient_id"
3959 AND "other"."initiative_id" = "subquery"."initiative_id"
3960 );
3962 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';
3963 COMMENT ON COLUMN "leading_complement_initiative"."featured" IS 'Always FALSE in this view';
3964 COMMENT ON COLUMN "leading_complement_initiative"."initiative_id" IS '"id" of the initiative to be included in the notification mail';
3965 COMMENT ON COLUMN "leading_complement_initiative"."leading" IS 'Always TRUE in this view';
3968 CREATE VIEW "unfiltered_initiative_for_notification" AS
3969 SELECT
3970 "subquery".*,
3971 "supporter"."member_id" NOTNULL AS "supported",
3972 CASE WHEN "supporter"."member_id" NOTNULL THEN
3973 EXISTS (
3974 SELECT NULL FROM "draft"
3975 WHERE "draft"."initiative_id" = "subquery"."initiative_id"
3976 AND "draft"."id" > "supporter"."draft_id"
3977 )
3978 ELSE
3979 EXISTS (
3980 SELECT NULL FROM "draft"
3981 WHERE "draft"."initiative_id" = "subquery"."initiative_id"
3982 AND COALESCE("draft"."id" > "sent"."last_draft_id", TRUE)
3983 )
3984 END AS "new_draft",
3985 CASE WHEN "supporter"."member_id" NOTNULL THEN
3986 ( SELECT count(1) FROM "suggestion"
3987 LEFT JOIN "opinion" ON
3988 "opinion"."member_id" = "supporter"."member_id" AND
3989 "opinion"."suggestion_id" = "suggestion"."id"
3990 WHERE "suggestion"."initiative_id" = "subquery"."initiative_id"
3991 AND "opinion"."member_id" ISNULL
3992 AND COALESCE("suggestion"."id" > "sent"."last_suggestion_id", TRUE)
3993 )
3994 ELSE
3995 ( SELECT count(1) FROM "suggestion"
3996 WHERE "suggestion"."initiative_id" = "subquery"."initiative_id"
3997 AND COALESCE("suggestion"."id" > "sent"."last_suggestion_id", TRUE)
3998 )
3999 END AS "new_suggestion_count"
4000 FROM (
4001 SELECT * FROM "updated_or_featured_initiative"
4002 UNION ALL
4003 SELECT * FROM "leading_complement_initiative"
4004 ) AS "subquery"
4005 LEFT JOIN "supporter" ON
4006 "supporter"."member_id" = "subquery"."recipient_id" AND
4007 "supporter"."initiative_id" = "subquery"."initiative_id"
4008 LEFT JOIN "notification_initiative_sent" AS "sent" ON
4009 "sent"."member_id" = "subquery"."recipient_id" AND
4010 "sent"."initiative_id" = "subquery"."initiative_id";
4012 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';
4014 COMMENT ON COLUMN "unfiltered_initiative_for_notification"."supported" IS 'TRUE if initiative is supported by the recipient';
4015 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)';
4016 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")';
4019 CREATE VIEW "initiative_for_notification" AS
4020 SELECT "unfiltered1".*
4021 FROM "unfiltered_initiative_for_notification" "unfiltered1"
4022 JOIN "initiative" AS "initiative1" ON
4023 "initiative1"."id" = "unfiltered1"."initiative_id"
4024 JOIN "issue" AS "issue1" ON "issue1"."id" = "initiative1"."issue_id"
4025 WHERE EXISTS (
4026 SELECT NULL
4027 FROM "unfiltered_initiative_for_notification" "unfiltered2"
4028 JOIN "initiative" AS "initiative2" ON
4029 "initiative2"."id" = "unfiltered2"."initiative_id"
4030 JOIN "issue" AS "issue2" ON "issue2"."id" = "initiative2"."issue_id"
4031 WHERE "unfiltered1"."recipient_id" = "unfiltered2"."recipient_id"
4032 AND "issue1"."area_id" = "issue2"."area_id"
4033 AND ("unfiltered2"."new_draft" OR "unfiltered2"."new_suggestion_count" > 0 )
4034 );
4036 COMMENT ON VIEW "initiative_for_notification" IS 'Initiatives to be included in a scheduled notification mail';
4038 COMMENT ON COLUMN "initiative_for_notification"."recipient_id" IS '"id" of the member who receives the notification mail';
4039 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")';
4040 COMMENT ON COLUMN "initiative_for_notification"."initiative_id" IS '"id" of the initiative to be included in the notification mail';
4041 COMMENT ON COLUMN "initiative_for_notification"."leading" IS 'TRUE if the initiative has the highest "supporter_count" in the issue';
4042 COMMENT ON COLUMN "initiative_for_notification"."supported" IS 'TRUE if initiative is supported by the recipient';
4043 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)';
4044 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")';
4047 CREATE VIEW "scheduled_notification_to_send" AS
4048 SELECT * FROM (
4049 SELECT
4050 "id" AS "recipient_id",
4051 now() - CASE WHEN "notification_dow" ISNULL THEN
4052 ( "notification_sent"::DATE + CASE
4053 WHEN EXTRACT(HOUR FROM "notification_sent") < "notification_hour"
4054 THEN 0 ELSE 1 END
4055 )::TIMESTAMP + '1 hour'::INTERVAL * "notification_hour"
4056 ELSE
4057 ( "notification_sent"::DATE +
4058 ( 7 + "notification_dow" -
4059 EXTRACT(DOW FROM
4060 ( "notification_sent"::DATE + CASE
4061 WHEN EXTRACT(HOUR FROM "notification_sent") < "notification_hour"
4062 THEN 0 ELSE 1 END
4063 )::TIMESTAMP + '1 hour'::INTERVAL * "notification_hour"
4064 )::INTEGER
4065 ) % 7 +
4066 CASE
4067 WHEN EXTRACT(HOUR FROM "notification_sent") < "notification_hour"
4068 THEN 0 ELSE 1
4069 END
4070 )::TIMESTAMP + '1 hour'::INTERVAL * "notification_hour"
4071 END AS "pending"
4072 FROM (
4073 SELECT
4074 "id",
4075 COALESCE("notification_sent", "activated") AS "notification_sent",
4076 "notification_dow",
4077 "notification_hour"
4078 FROM "member_to_notify"
4079 WHERE "notification_hour" NOTNULL
4080 ) AS "subquery1"
4081 ) AS "subquery2"
4082 WHERE "pending" > '0'::INTERVAL;
4084 COMMENT ON VIEW "scheduled_notification_to_send" IS 'Set of members where a scheduled notification mail is pending';
4086 COMMENT ON COLUMN "scheduled_notification_to_send"."recipient_id" IS '"id" of the member who needs to receive a notification mail';
4087 COMMENT ON COLUMN "scheduled_notification_to_send"."pending" IS 'Duration for which the notification mail has already been pending';
4090 CREATE VIEW "newsletter_to_send" AS
4091 SELECT
4092 "member"."id" AS "recipient_id",
4093 "newsletter"."id" AS "newsletter_id",
4094 "newsletter"."published"
4095 FROM "newsletter" CROSS JOIN "member_eligible_to_be_notified" AS "member"
4096 LEFT JOIN "privilege" ON
4097 "privilege"."member_id" = "member"."id" AND
4098 "privilege"."unit_id" = "newsletter"."unit_id" AND
4099 "privilege"."voting_right" = TRUE
4100 LEFT JOIN "subscription" ON
4101 "subscription"."member_id" = "member"."id" AND
4102 "subscription"."unit_id" = "newsletter"."unit_id"
4103 WHERE "newsletter"."published" <= now()
4104 AND "newsletter"."sent" ISNULL
4105 AND (
4106 "member"."disable_notifications" = FALSE OR
4107 "newsletter"."include_all_members" = TRUE )
4108 AND (
4109 "newsletter"."unit_id" ISNULL OR
4110 "privilege"."member_id" NOTNULL OR
4111 "subscription"."member_id" NOTNULL );
4113 COMMENT ON VIEW "newsletter_to_send" IS 'List of "newsletter_id"s for each member that are due to be sent out';
4115 COMMENT ON COLUMN "newsletter"."published" IS 'Timestamp when the newsletter was supposed to be sent out (can be used for ordering)';
4119 ------------------------------------------------------
4120 -- Row set returning function for delegation chains --
4121 ------------------------------------------------------
4124 CREATE TYPE "delegation_chain_loop_tag" AS ENUM
4125 ('first', 'intermediate', 'last', 'repetition');
4127 COMMENT ON TYPE "delegation_chain_loop_tag" IS 'Type for loop tags in "delegation_chain_row" type';
4130 CREATE TYPE "delegation_chain_row" AS (
4131 "index" INT4,
4132 "member_id" INT4,
4133 "member_valid" BOOLEAN,
4134 "participation" BOOLEAN,
4135 "overridden" BOOLEAN,
4136 "scope_in" "delegation_scope",
4137 "scope_out" "delegation_scope",
4138 "disabled_out" BOOLEAN,
4139 "loop" "delegation_chain_loop_tag" );
4141 COMMENT ON TYPE "delegation_chain_row" IS 'Type of rows returned by "delegation_chain" function';
4143 COMMENT ON COLUMN "delegation_chain_row"."index" IS 'Index starting with 0 and counting up';
4144 COMMENT ON COLUMN "delegation_chain_row"."participation" IS 'In case of delegation chains for issues: interest; for area and global delegation chains: always null';
4145 COMMENT ON COLUMN "delegation_chain_row"."overridden" IS 'True, if an entry with lower index has "participation" set to true';
4146 COMMENT ON COLUMN "delegation_chain_row"."scope_in" IS 'Scope of used incoming delegation';
4147 COMMENT ON COLUMN "delegation_chain_row"."scope_out" IS 'Scope of used outgoing delegation';
4148 COMMENT ON COLUMN "delegation_chain_row"."disabled_out" IS 'Outgoing delegation is explicitly disabled by a delegation with trustee_id set to NULL';
4149 COMMENT ON COLUMN "delegation_chain_row"."loop" IS 'Not null, if member is part of a loop, see "delegation_chain_loop_tag" type';
4152 CREATE FUNCTION "delegation_chain_for_closed_issue"
4153 ( "member_id_p" "member"."id"%TYPE,
4154 "issue_id_p" "issue"."id"%TYPE )
4155 RETURNS SETOF "delegation_chain_row"
4156 LANGUAGE 'plpgsql' STABLE AS $$
4157 DECLARE
4158 "output_row" "delegation_chain_row";
4159 "direct_voter_row" "direct_voter"%ROWTYPE;
4160 "delegating_voter_row" "delegating_voter"%ROWTYPE;
4161 BEGIN
4162 "output_row"."index" := 0;
4163 "output_row"."member_id" := "member_id_p";
4164 "output_row"."member_valid" := TRUE;
4165 "output_row"."participation" := FALSE;
4166 "output_row"."overridden" := FALSE;
4167 "output_row"."disabled_out" := FALSE;
4168 LOOP
4169 SELECT INTO "direct_voter_row" * FROM "direct_voter"
4170 WHERE "issue_id" = "issue_id_p"
4171 AND "member_id" = "output_row"."member_id";
4172 IF "direct_voter_row"."member_id" NOTNULL THEN
4173 "output_row"."participation" := TRUE;
4174 "output_row"."scope_out" := NULL;
4175 "output_row"."disabled_out" := NULL;
4176 RETURN NEXT "output_row";
4177 RETURN;
4178 END IF;
4179 SELECT INTO "delegating_voter_row" * FROM "delegating_voter"
4180 WHERE "issue_id" = "issue_id_p"
4181 AND "member_id" = "output_row"."member_id";
4182 IF "delegating_voter_row"."member_id" ISNULL THEN
4183 RETURN;
4184 END IF;
4185 "output_row"."scope_out" := "delegating_voter_row"."scope";
4186 RETURN NEXT "output_row";
4187 "output_row"."member_id" := "delegating_voter_row"."delegate_member_ids"[1];
4188 "output_row"."scope_in" := "output_row"."scope_out";
4189 END LOOP;
4190 END;
4191 $$;
4193 COMMENT ON FUNCTION "delegation_chain_for_closed_issue"
4194 ( "member"."id"%TYPE,
4195 "member"."id"%TYPE )
4196 IS 'Helper function for "delegation_chain" function, handling the special case of closed issues after voting';
4199 CREATE FUNCTION "delegation_chain"
4200 ( "member_id_p" "member"."id"%TYPE,
4201 "unit_id_p" "unit"."id"%TYPE,
4202 "area_id_p" "area"."id"%TYPE,
4203 "issue_id_p" "issue"."id"%TYPE,
4204 "simulate_trustee_id_p" "member"."id"%TYPE DEFAULT NULL,
4205 "simulate_default_p" BOOLEAN DEFAULT FALSE )
4206 RETURNS SETOF "delegation_chain_row"
4207 LANGUAGE 'plpgsql' STABLE AS $$
4208 DECLARE
4209 "scope_v" "delegation_scope";
4210 "unit_id_v" "unit"."id"%TYPE;
4211 "area_id_v" "area"."id"%TYPE;
4212 "issue_row" "issue"%ROWTYPE;
4213 "visited_member_ids" INT4[]; -- "member"."id"%TYPE[]
4214 "loop_member_id_v" "member"."id"%TYPE;
4215 "output_row" "delegation_chain_row";
4216 "output_rows" "delegation_chain_row"[];
4217 "simulate_v" BOOLEAN;
4218 "simulate_here_v" BOOLEAN;
4219 "delegation_row" "delegation"%ROWTYPE;
4220 "row_count" INT4;
4221 "i" INT4;
4222 "loop_v" BOOLEAN;
4223 BEGIN
4224 IF "simulate_trustee_id_p" NOTNULL AND "simulate_default_p" THEN
4225 RAISE EXCEPTION 'Both "simulate_trustee_id_p" is set, and "simulate_default_p" is true';
4226 END IF;
4227 IF "simulate_trustee_id_p" NOTNULL OR "simulate_default_p" THEN
4228 "simulate_v" := TRUE;
4229 ELSE
4230 "simulate_v" := FALSE;
4231 END IF;
4232 IF
4233 "unit_id_p" NOTNULL AND
4234 "area_id_p" ISNULL AND
4235 "issue_id_p" ISNULL
4236 THEN
4237 "scope_v" := 'unit';
4238 "unit_id_v" := "unit_id_p";
4239 ELSIF
4240 "unit_id_p" ISNULL AND
4241 "area_id_p" NOTNULL AND
4242 "issue_id_p" ISNULL
4243 THEN
4244 "scope_v" := 'area';
4245 "area_id_v" := "area_id_p";
4246 SELECT "unit_id" INTO "unit_id_v"
4247 FROM "area" WHERE "id" = "area_id_v";
4248 ELSIF
4249 "unit_id_p" ISNULL AND
4250 "area_id_p" ISNULL AND
4251 "issue_id_p" NOTNULL
4252 THEN
4253 SELECT INTO "issue_row" * FROM "issue" WHERE "id" = "issue_id_p";
4254 IF "issue_row"."id" ISNULL THEN
4255 RETURN;
4256 END IF;
4257 IF "issue_row"."closed" NOTNULL THEN
4258 IF "simulate_v" THEN
4259 RAISE EXCEPTION 'Tried to simulate delegation chain for closed issue.';
4260 END IF;
4261 FOR "output_row" IN
4262 SELECT * FROM
4263 "delegation_chain_for_closed_issue"("member_id_p", "issue_id_p")
4264 LOOP
4265 RETURN NEXT "output_row";
4266 END LOOP;
4267 RETURN;
4268 END IF;
4269 "scope_v" := 'issue';
4270 SELECT "area_id" INTO "area_id_v"
4271 FROM "issue" WHERE "id" = "issue_id_p";
4272 SELECT "unit_id" INTO "unit_id_v"
4273 FROM "area" WHERE "id" = "area_id_v";
4274 ELSE
4275 RAISE EXCEPTION 'Exactly one of unit_id_p, area_id_p, or issue_id_p must be NOTNULL.';
4276 END IF;
4277 "visited_member_ids" := '{}';
4278 "loop_member_id_v" := NULL;
4279 "output_rows" := '{}';
4280 "output_row"."index" := 0;
4281 "output_row"."member_id" := "member_id_p";
4282 "output_row"."member_valid" := TRUE;
4283 "output_row"."participation" := FALSE;
4284 "output_row"."overridden" := FALSE;
4285 "output_row"."disabled_out" := FALSE;
4286 "output_row"."scope_out" := NULL;
4287 LOOP
4288 IF "visited_member_ids" @> ARRAY["output_row"."member_id"] THEN
4289 "loop_member_id_v" := "output_row"."member_id";
4290 ELSE
4291 "visited_member_ids" :=
4292 "visited_member_ids" || "output_row"."member_id";
4293 END IF;
4294 IF "output_row"."participation" ISNULL THEN
4295 "output_row"."overridden" := NULL;
4296 ELSIF "output_row"."participation" THEN
4297 "output_row"."overridden" := TRUE;
4298 END IF;
4299 "output_row"."scope_in" := "output_row"."scope_out";
4300 "output_row"."member_valid" := EXISTS (
4301 SELECT NULL FROM "member" JOIN "privilege"
4302 ON "privilege"."member_id" = "member"."id"
4303 AND "privilege"."unit_id" = "unit_id_v"
4304 WHERE "id" = "output_row"."member_id"
4305 AND "member"."active" AND "privilege"."voting_right"
4306 );
4307 "simulate_here_v" := (
4308 "simulate_v" AND
4309 "output_row"."member_id" = "member_id_p"
4310 );
4311 "delegation_row" := ROW(NULL);
4312 IF "output_row"."member_valid" OR "simulate_here_v" THEN
4313 IF "scope_v" = 'unit' THEN
4314 IF NOT "simulate_here_v" THEN
4315 SELECT * INTO "delegation_row" FROM "delegation"
4316 WHERE "truster_id" = "output_row"."member_id"
4317 AND "unit_id" = "unit_id_v";
4318 END IF;
4319 ELSIF "scope_v" = 'area' THEN
4320 IF "simulate_here_v" THEN
4321 IF "simulate_trustee_id_p" ISNULL THEN
4322 SELECT * INTO "delegation_row" FROM "delegation"
4323 WHERE "truster_id" = "output_row"."member_id"
4324 AND "unit_id" = "unit_id_v";
4325 END IF;
4326 ELSE
4327 SELECT * INTO "delegation_row" FROM "delegation"
4328 WHERE "truster_id" = "output_row"."member_id"
4329 AND (
4330 "unit_id" = "unit_id_v" OR
4331 "area_id" = "area_id_v"
4332 )
4333 ORDER BY "scope" DESC;
4334 END IF;
4335 ELSIF "scope_v" = 'issue' THEN
4336 IF "issue_row"."fully_frozen" ISNULL THEN
4337 "output_row"."participation" := EXISTS (
4338 SELECT NULL FROM "interest"
4339 WHERE "issue_id" = "issue_id_p"
4340 AND "member_id" = "output_row"."member_id"
4341 );
4342 ELSE
4343 IF "output_row"."member_id" = "member_id_p" THEN
4344 "output_row"."participation" := EXISTS (
4345 SELECT NULL FROM "direct_voter"
4346 WHERE "issue_id" = "issue_id_p"
4347 AND "member_id" = "output_row"."member_id"
4348 );
4349 ELSE
4350 "output_row"."participation" := NULL;
4351 END IF;
4352 END IF;
4353 IF "simulate_here_v" THEN
4354 IF "simulate_trustee_id_p" ISNULL THEN
4355 SELECT * INTO "delegation_row" FROM "delegation"
4356 WHERE "truster_id" = "output_row"."member_id"
4357 AND (
4358 "unit_id" = "unit_id_v" OR
4359 "area_id" = "area_id_v"
4360 )
4361 ORDER BY "scope" DESC;
4362 END IF;
4363 ELSE
4364 SELECT * INTO "delegation_row" FROM "delegation"
4365 WHERE "truster_id" = "output_row"."member_id"
4366 AND (
4367 "unit_id" = "unit_id_v" OR
4368 "area_id" = "area_id_v" OR
4369 "issue_id" = "issue_id_p"
4370 )
4371 ORDER BY "scope" DESC;
4372 END IF;
4373 END IF;
4374 ELSE
4375 "output_row"."participation" := FALSE;
4376 END IF;
4377 IF "simulate_here_v" AND "simulate_trustee_id_p" NOTNULL THEN
4378 "output_row"."scope_out" := "scope_v";
4379 "output_rows" := "output_rows" || "output_row";
4380 "output_row"."member_id" := "simulate_trustee_id_p";
4381 ELSIF "delegation_row"."trustee_id" NOTNULL THEN
4382 "output_row"."scope_out" := "delegation_row"."scope";
4383 "output_rows" := "output_rows" || "output_row";
4384 "output_row"."member_id" := "delegation_row"."trustee_id";
4385 ELSIF "delegation_row"."scope" NOTNULL THEN
4386 "output_row"."scope_out" := "delegation_row"."scope";
4387 "output_row"."disabled_out" := TRUE;
4388 "output_rows" := "output_rows" || "output_row";
4389 EXIT;
4390 ELSE
4391 "output_row"."scope_out" := NULL;
4392 "output_rows" := "output_rows" || "output_row";
4393 EXIT;
4394 END IF;
4395 EXIT WHEN "loop_member_id_v" NOTNULL;
4396 "output_row"."index" := "output_row"."index" + 1;
4397 END LOOP;
4398 "row_count" := array_upper("output_rows", 1);
4399 "i" := 1;
4400 "loop_v" := FALSE;
4401 LOOP
4402 "output_row" := "output_rows"["i"];
4403 EXIT WHEN "output_row" ISNULL; -- NOTE: ISNULL and NOT ... NOTNULL produce different results!
4404 IF "loop_v" THEN
4405 IF "i" + 1 = "row_count" THEN
4406 "output_row"."loop" := 'last';
4407 ELSIF "i" = "row_count" THEN
4408 "output_row"."loop" := 'repetition';
4409 ELSE
4410 "output_row"."loop" := 'intermediate';
4411 END IF;
4412 ELSIF "output_row"."member_id" = "loop_member_id_v" THEN
4413 "output_row"."loop" := 'first';
4414 "loop_v" := TRUE;
4415 END IF;
4416 IF "scope_v" = 'unit' THEN
4417 "output_row"."participation" := NULL;
4418 END IF;
4419 RETURN NEXT "output_row";
4420 "i" := "i" + 1;
4421 END LOOP;
4422 RETURN;
4423 END;
4424 $$;
4426 COMMENT ON FUNCTION "delegation_chain"
4427 ( "member"."id"%TYPE,
4428 "unit"."id"%TYPE,
4429 "area"."id"%TYPE,
4430 "issue"."id"%TYPE,
4431 "member"."id"%TYPE,
4432 BOOLEAN )
4433 IS 'Shows a delegation chain for unit, area, or issue; See "delegation_chain_row" type for more information';
4437 ---------------------------------------------------------
4438 -- Single row returning function for delegation chains --
4439 ---------------------------------------------------------
4442 CREATE TYPE "delegation_info_loop_type" AS ENUM
4443 ('own', 'first', 'first_ellipsis', 'other', 'other_ellipsis');
4445 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''';
4448 CREATE TYPE "delegation_info_type" AS (
4449 "own_participation" BOOLEAN,
4450 "own_delegation_scope" "delegation_scope",
4451 "first_trustee_id" INT4,
4452 "first_trustee_participation" BOOLEAN,
4453 "first_trustee_ellipsis" BOOLEAN,
4454 "other_trustee_id" INT4,
4455 "other_trustee_participation" BOOLEAN,
4456 "other_trustee_ellipsis" BOOLEAN,
4457 "delegation_loop" "delegation_info_loop_type",
4458 "participating_member_id" INT4 );
4460 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';
4462 COMMENT ON COLUMN "delegation_info_type"."own_participation" IS 'Member is directly participating';
4463 COMMENT ON COLUMN "delegation_info_type"."own_delegation_scope" IS 'Delegation scope of member';
4464 COMMENT ON COLUMN "delegation_info_type"."first_trustee_id" IS 'Direct trustee of member';
4465 COMMENT ON COLUMN "delegation_info_type"."first_trustee_participation" IS 'Direct trustee of member is participating';
4466 COMMENT ON COLUMN "delegation_info_type"."first_trustee_ellipsis" IS 'Ellipsis in delegation chain after "first_trustee"';
4467 COMMENT ON COLUMN "delegation_info_type"."other_trustee_id" IS 'Another relevant trustee (due to participation)';
4468 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)';
4469 COMMENT ON COLUMN "delegation_info_type"."other_trustee_ellipsis" IS 'Ellipsis in delegation chain after "other_trustee"';
4470 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';
4471 COMMENT ON COLUMN "delegation_info_type"."participating_member_id" IS 'First participating member in delegation chain';
4474 CREATE FUNCTION "delegation_info"
4475 ( "member_id_p" "member"."id"%TYPE,
4476 "unit_id_p" "unit"."id"%TYPE,
4477 "area_id_p" "area"."id"%TYPE,
4478 "issue_id_p" "issue"."id"%TYPE,
4479 "simulate_trustee_id_p" "member"."id"%TYPE DEFAULT NULL,
4480 "simulate_default_p" BOOLEAN DEFAULT FALSE )
4481 RETURNS "delegation_info_type"
4482 LANGUAGE 'plpgsql' STABLE AS $$
4483 DECLARE
4484 "current_row" "delegation_chain_row";
4485 "result" "delegation_info_type";
4486 BEGIN
4487 "result"."own_participation" := FALSE;
4488 FOR "current_row" IN
4489 SELECT * FROM "delegation_chain"(
4490 "member_id_p",
4491 "unit_id_p", "area_id_p", "issue_id_p",
4492 "simulate_trustee_id_p", "simulate_default_p")
4493 LOOP
4494 IF
4495 "result"."participating_member_id" ISNULL AND
4496 "current_row"."participation"
4497 THEN
4498 "result"."participating_member_id" := "current_row"."member_id";
4499 END IF;
4500 IF "current_row"."member_id" = "member_id_p" THEN
4501 "result"."own_participation" := "current_row"."participation";
4502 "result"."own_delegation_scope" := "current_row"."scope_out";
4503 IF "current_row"."loop" = 'first' THEN
4504 "result"."delegation_loop" := 'own';
4505 END IF;
4506 ELSIF
4507 "current_row"."member_valid" AND
4508 ( "current_row"."loop" ISNULL OR
4509 "current_row"."loop" != 'repetition' )
4510 THEN
4511 IF "result"."first_trustee_id" ISNULL THEN
4512 "result"."first_trustee_id" := "current_row"."member_id";
4513 "result"."first_trustee_participation" := "current_row"."participation";
4514 "result"."first_trustee_ellipsis" := FALSE;
4515 IF "current_row"."loop" = 'first' THEN
4516 "result"."delegation_loop" := 'first';
4517 END IF;
4518 ELSIF "result"."other_trustee_id" ISNULL THEN
4519 IF "current_row"."participation" AND NOT "current_row"."overridden" THEN
4520 "result"."other_trustee_id" := "current_row"."member_id";
4521 "result"."other_trustee_participation" := TRUE;
4522 "result"."other_trustee_ellipsis" := FALSE;
4523 IF "current_row"."loop" = 'first' THEN
4524 "result"."delegation_loop" := 'other';
4525 END IF;
4526 ELSE
4527 "result"."first_trustee_ellipsis" := TRUE;
4528 IF "current_row"."loop" = 'first' THEN
4529 "result"."delegation_loop" := 'first_ellipsis';
4530 END IF;
4531 END IF;
4532 ELSE
4533 "result"."other_trustee_ellipsis" := TRUE;
4534 IF "current_row"."loop" = 'first' THEN
4535 "result"."delegation_loop" := 'other_ellipsis';
4536 END IF;
4537 END IF;
4538 END IF;
4539 END LOOP;
4540 RETURN "result";
4541 END;
4542 $$;
4544 COMMENT ON FUNCTION "delegation_info"
4545 ( "member"."id"%TYPE,
4546 "unit"."id"%TYPE,
4547 "area"."id"%TYPE,
4548 "issue"."id"%TYPE,
4549 "member"."id"%TYPE,
4550 BOOLEAN )
4551 IS 'Notable information about a delegation chain for unit, area, or issue; See "delegation_info_type" for more information';
4555 ------------------------
4556 -- Geospatial lookups --
4557 ------------------------
4559 CREATE FUNCTION "closed_initiatives_in_bounding_box"
4560 ( "bounding_box_p" EBOX,
4561 "limit_p" INT4 )
4562 RETURNS SETOF "initiative"
4563 LANGUAGE 'plpgsql' STABLE AS $$
4564 DECLARE
4565 "limit_v" INT4;
4566 "count_v" INT4;
4567 BEGIN
4568 "limit_v" := "limit_p" + 1;
4569 LOOP
4570 SELECT count(1) INTO "count_v"
4571 FROM "initiative"
4572 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
4573 WHERE "issue"."closed" NOTNULL
4574 AND GeoJSON_to_ecluster("initiative"."location") && "bounding_box_p"
4575 LIMIT "limit_v";
4576 IF "count_v" < "limit_v" THEN
4577 RETURN QUERY SELECT "initiative".*
4578 FROM (
4579 SELECT
4580 "initiative"."id" AS "initiative_id",
4581 "issue"."closed"
4582 FROM "initiative"
4583 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
4584 WHERE "issue"."closed" NOTNULL
4585 AND GeoJSON_to_ecluster("initiative"."location") && "bounding_box_p"
4586 ) AS "subquery"
4587 JOIN "initiative" ON "initiative"."id" = "subquery"."initiative_id"
4588 ORDER BY "subquery"."closed" DESC
4589 LIMIT "limit_p";
4590 RETURN;
4591 END IF;
4592 SELECT count(1) INTO "count_v"
4593 FROM (
4594 SELECT "initiative"."id" AS "initiative_id"
4595 FROM "initiative"
4596 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
4597 WHERE "issue"."closed" NOTNULL
4598 ORDER BY "closed" DESC
4599 LIMIT "limit_v"
4600 ) AS "subquery"
4601 JOIN "initiative" ON "initiative"."id" = "subquery"."initiative_id"
4602 WHERE GeoJSON_to_ecluster("initiative"."location") && "bounding_box_p"
4603 LIMIT "limit_p";
4604 IF "count_v" >= "limit_p" THEN
4605 RETURN QUERY SELECT "initiative".*
4606 FROM (
4607 SELECT
4608 "initiative"."id" AS "initiative_id",
4609 "issue"."closed"
4610 FROM "initiative"
4611 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
4612 WHERE "issue"."closed" NOTNULL
4613 ORDER BY "closed" DESC
4614 LIMIT "limit_v"
4615 ) AS "subquery"
4616 JOIN "initiative" ON "initiative"."id" = "subquery"."initiative_id"
4617 WHERE GeoJSON_to_ecluster("initiative"."location") && "bounding_box_p"
4618 ORDER BY "subquery"."closed" DESC
4619 LIMIT "limit_p";
4620 RETURN;
4621 END IF;
4622 "limit_v" := "limit_v" * 2;
4623 END LOOP;
4624 END;
4625 $$;
4627 COMMENT ON FUNCTION "closed_initiatives_in_bounding_box"
4628 ( EBOX, INT4 )
4629 IS 'TODO';
4633 ---------------------------
4634 -- Transaction isolation --
4635 ---------------------------
4638 CREATE FUNCTION "require_transaction_isolation"()
4639 RETURNS VOID
4640 LANGUAGE 'plpgsql' VOLATILE AS $$
4641 BEGIN
4642 IF
4643 current_setting('transaction_isolation') NOT IN
4644 ('repeatable read', 'serializable')
4645 THEN
4646 RAISE EXCEPTION 'Insufficient transaction isolation level' USING
4647 HINT = 'Consider using SET TRANSACTION ISOLATION LEVEL REPEATABLE READ.';
4648 END IF;
4649 RETURN;
4650 END;
4651 $$;
4653 COMMENT ON FUNCTION "require_transaction_isolation"() IS 'Throws an exception, if transaction isolation level is too low to provide a consistent snapshot';
4656 CREATE FUNCTION "dont_require_transaction_isolation"()
4657 RETURNS VOID
4658 LANGUAGE 'plpgsql' VOLATILE AS $$
4659 BEGIN
4660 IF
4661 current_setting('transaction_isolation') IN
4662 ('repeatable read', 'serializable')
4663 THEN
4664 RAISE WARNING 'Unneccessary transaction isolation level: %',
4665 current_setting('transaction_isolation');
4666 END IF;
4667 RETURN;
4668 END;
4669 $$;
4671 COMMENT ON FUNCTION "dont_require_transaction_isolation"() IS 'Raises a warning, if transaction isolation level is higher than READ COMMITTED';
4675 -------------------------
4676 -- Notification system --
4677 -------------------------
4679 CREATE FUNCTION "get_initiatives_for_notification"
4680 ( "recipient_id_p" "member"."id"%TYPE )
4681 RETURNS SETOF "initiative_for_notification"
4682 LANGUAGE 'plpgsql' VOLATILE AS $$
4683 DECLARE
4684 "result_row" "initiative_for_notification"%ROWTYPE;
4685 "last_draft_id_v" "draft"."id"%TYPE;
4686 "last_suggestion_id_v" "suggestion"."id"%TYPE;
4687 BEGIN
4688 PERFORM "require_transaction_isolation"();
4689 PERFORM NULL FROM "member" WHERE "id" = "recipient_id_p" FOR UPDATE;
4690 FOR "result_row" IN
4691 SELECT * FROM "initiative_for_notification"
4692 WHERE "recipient_id" = "recipient_id_p"
4693 LOOP
4694 SELECT "id" INTO "last_draft_id_v" FROM "draft"
4695 WHERE "draft"."initiative_id" = "result_row"."initiative_id"
4696 ORDER BY "id" DESC LIMIT 1;
4697 SELECT "id" INTO "last_suggestion_id_v" FROM "suggestion"
4698 WHERE "suggestion"."initiative_id" = "result_row"."initiative_id"
4699 ORDER BY "id" DESC LIMIT 1;
4700 INSERT INTO "notification_initiative_sent"
4701 ("member_id", "initiative_id", "last_draft_id", "last_suggestion_id")
4702 VALUES (
4703 "recipient_id_p",
4704 "result_row"."initiative_id",
4705 "last_draft_id_v",
4706 "last_suggestion_id_v" )
4707 ON CONFLICT ("member_id", "initiative_id") DO UPDATE SET
4708 "last_draft_id" = "last_draft_id_v",
4709 "last_suggestion_id" = "last_suggestion_id_v";
4710 RETURN NEXT "result_row";
4711 END LOOP;
4712 DELETE FROM "notification_initiative_sent"
4713 USING "initiative", "issue"
4714 WHERE "notification_initiative_sent"."member_id" = "recipient_id_p"
4715 AND "initiative"."id" = "notification_initiative_sent"."initiative_id"
4716 AND "issue"."id" = "initiative"."issue_id"
4717 AND ( "issue"."closed" NOTNULL OR "issue"."fully_frozen" NOTNULL );
4718 UPDATE "member" SET
4719 "notification_counter" = "notification_counter" + 1,
4720 "notification_sent" = now()
4721 WHERE "id" = "recipient_id_p";
4722 RETURN;
4723 END;
4724 $$;
4726 COMMENT ON FUNCTION "get_initiatives_for_notification"
4727 ( "member"."id"%TYPE )
4728 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';
4732 ------------------------------------------------------------------------
4733 -- Regular tasks, except calculcation of snapshots and voting results --
4734 ------------------------------------------------------------------------
4737 CREATE FUNCTION "check_activity"()
4738 RETURNS VOID
4739 LANGUAGE 'plpgsql' VOLATILE AS $$
4740 DECLARE
4741 "system_setting_row" "system_setting"%ROWTYPE;
4742 BEGIN
4743 PERFORM "dont_require_transaction_isolation"();
4744 SELECT * INTO "system_setting_row" FROM "system_setting";
4745 IF "system_setting_row"."member_ttl" NOTNULL THEN
4746 UPDATE "member" SET "active" = FALSE
4747 WHERE "active" = TRUE
4748 AND "last_activity" < (now() - "system_setting_row"."member_ttl")::DATE;
4749 END IF;
4750 RETURN;
4751 END;
4752 $$;
4754 COMMENT ON FUNCTION "check_activity"() IS 'Deactivates members when "last_activity" is older than "system_setting"."member_ttl".';
4757 CREATE FUNCTION "calculate_member_counts"()
4758 RETURNS VOID
4759 LANGUAGE 'plpgsql' VOLATILE AS $$
4760 BEGIN
4761 PERFORM "require_transaction_isolation"();
4762 DELETE FROM "member_count";
4763 INSERT INTO "member_count" ("total_count")
4764 SELECT "total_count" FROM "member_count_view";
4765 UPDATE "unit" SET "member_count" = "view"."member_count"
4766 FROM "unit_member_count" AS "view"
4767 WHERE "view"."unit_id" = "unit"."id";
4768 RETURN;
4769 END;
4770 $$;
4772 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"';
4776 ------------------------------------
4777 -- Calculation of harmonic weight --
4778 ------------------------------------
4781 CREATE VIEW "remaining_harmonic_supporter_weight" AS
4782 SELECT
4783 "direct_interest_snapshot"."snapshot_id",
4784 "direct_interest_snapshot"."issue_id",
4785 "direct_interest_snapshot"."member_id",
4786 "direct_interest_snapshot"."weight" AS "weight_num",
4787 count("initiative"."id") AS "weight_den"
4788 FROM "issue"
4789 JOIN "direct_interest_snapshot"
4790 ON "issue"."latest_snapshot_id" = "direct_interest_snapshot"."snapshot_id"
4791 AND "issue"."id" = "direct_interest_snapshot"."issue_id"
4792 JOIN "initiative"
4793 ON "issue"."id" = "initiative"."issue_id"
4794 AND "initiative"."harmonic_weight" ISNULL
4795 JOIN "direct_supporter_snapshot"
4796 ON "issue"."latest_snapshot_id" = "direct_supporter_snapshot"."snapshot_id"
4797 AND "initiative"."id" = "direct_supporter_snapshot"."initiative_id"
4798 AND "direct_interest_snapshot"."member_id" = "direct_supporter_snapshot"."member_id"
4799 AND (
4800 "direct_supporter_snapshot"."satisfied" = TRUE OR
4801 coalesce("initiative"."admitted", FALSE) = FALSE
4802 )
4803 GROUP BY
4804 "direct_interest_snapshot"."snapshot_id",
4805 "direct_interest_snapshot"."issue_id",
4806 "direct_interest_snapshot"."member_id",
4807 "direct_interest_snapshot"."weight";
4809 COMMENT ON VIEW "remaining_harmonic_supporter_weight" IS 'Helper view for function "set_harmonic_initiative_weights"';
4812 CREATE VIEW "remaining_harmonic_initiative_weight_summands" AS
4813 SELECT
4814 "initiative"."issue_id",
4815 "initiative"."id" AS "initiative_id",
4816 "initiative"."admitted",
4817 sum("remaining_harmonic_supporter_weight"."weight_num") AS "weight_num",
4818 "remaining_harmonic_supporter_weight"."weight_den"
4819 FROM "remaining_harmonic_supporter_weight"
4820 JOIN "initiative"
4821 ON "remaining_harmonic_supporter_weight"."issue_id" = "initiative"."issue_id"
4822 AND "initiative"."harmonic_weight" ISNULL
4823 JOIN "direct_supporter_snapshot"
4824 ON "remaining_harmonic_supporter_weight"."snapshot_id" = "direct_supporter_snapshot"."snapshot_id"
4825 AND "initiative"."id" = "direct_supporter_snapshot"."initiative_id"
4826 AND "remaining_harmonic_supporter_weight"."member_id" = "direct_supporter_snapshot"."member_id"
4827 AND (
4828 "direct_supporter_snapshot"."satisfied" = TRUE OR
4829 coalesce("initiative"."admitted", FALSE) = FALSE
4830 )
4831 GROUP BY
4832 "initiative"."issue_id",
4833 "initiative"."id",
4834 "initiative"."admitted",
4835 "remaining_harmonic_supporter_weight"."weight_den";
4837 COMMENT ON VIEW "remaining_harmonic_initiative_weight_summands" IS 'Helper view for function "set_harmonic_initiative_weights"';
4840 CREATE VIEW "remaining_harmonic_initiative_weight_dummies" AS
4841 SELECT
4842 "issue_id",
4843 "id" AS "initiative_id",
4844 "admitted",
4845 0 AS "weight_num",
4846 1 AS "weight_den"
4847 FROM "initiative"
4848 WHERE "harmonic_weight" ISNULL;
4850 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';
4853 CREATE FUNCTION "set_harmonic_initiative_weights"
4854 ( "issue_id_p" "issue"."id"%TYPE )
4855 RETURNS VOID
4856 LANGUAGE 'plpgsql' VOLATILE AS $$
4857 DECLARE
4858 "weight_row" "remaining_harmonic_initiative_weight_summands"%ROWTYPE;
4859 "i" INT4;
4860 "count_v" INT4;
4861 "summand_v" FLOAT;
4862 "id_ary" INT4[];
4863 "weight_ary" FLOAT[];
4864 "min_weight_v" FLOAT;
4865 BEGIN
4866 PERFORM "require_transaction_isolation"();
4867 UPDATE "initiative" SET "harmonic_weight" = NULL
4868 WHERE "issue_id" = "issue_id_p";
4869 LOOP
4870 "min_weight_v" := NULL;
4871 "i" := 0;
4872 "count_v" := 0;
4873 FOR "weight_row" IN
4874 SELECT * FROM "remaining_harmonic_initiative_weight_summands"
4875 WHERE "issue_id" = "issue_id_p"
4876 AND (
4877 coalesce("admitted", FALSE) = FALSE OR NOT EXISTS (
4878 SELECT NULL FROM "initiative"
4879 WHERE "issue_id" = "issue_id_p"
4880 AND "harmonic_weight" ISNULL
4881 AND coalesce("admitted", FALSE) = FALSE
4882 )
4883 )
4884 UNION ALL -- needed for corner cases
4885 SELECT * FROM "remaining_harmonic_initiative_weight_dummies"
4886 WHERE "issue_id" = "issue_id_p"
4887 AND (
4888 coalesce("admitted", FALSE) = FALSE OR NOT EXISTS (
4889 SELECT NULL FROM "initiative"
4890 WHERE "issue_id" = "issue_id_p"
4891 AND "harmonic_weight" ISNULL
4892 AND coalesce("admitted", FALSE) = FALSE
4893 )
4894 )
4895 ORDER BY "initiative_id" DESC, "weight_den" DESC
4896 -- NOTE: non-admitted initiatives placed first (at last positions),
4897 -- latest initiatives treated worse in case of tie
4898 LOOP
4899 "summand_v" := "weight_row"."weight_num"::FLOAT / "weight_row"."weight_den"::FLOAT;
4900 IF "i" = 0 OR "weight_row"."initiative_id" != "id_ary"["i"] THEN
4901 "i" := "i" + 1;
4902 "count_v" := "i";
4903 "id_ary"["i"] := "weight_row"."initiative_id";
4904 "weight_ary"["i"] := "summand_v";
4905 ELSE
4906 "weight_ary"["i"] := "weight_ary"["i"] + "summand_v";
4907 END IF;
4908 END LOOP;
4909 EXIT WHEN "count_v" = 0;
4910 "i" := 1;
4911 LOOP
4912 "weight_ary"["i"] := "weight_ary"["i"]::NUMERIC(18,9)::NUMERIC(12,3);
4913 IF "min_weight_v" ISNULL OR "weight_ary"["i"] < "min_weight_v" THEN
4914 "min_weight_v" := "weight_ary"["i"];
4915 END IF;
4916 "i" := "i" + 1;
4917 EXIT WHEN "i" > "count_v";
4918 END LOOP;
4919 "i" := 1;
4920 LOOP
4921 IF "weight_ary"["i"] = "min_weight_v" THEN
4922 UPDATE "initiative" SET "harmonic_weight" = "min_weight_v"
4923 WHERE "id" = "id_ary"["i"];
4924 EXIT;
4925 END IF;
4926 "i" := "i" + 1;
4927 END LOOP;
4928 END LOOP;
4929 UPDATE "initiative" SET "harmonic_weight" = 0
4930 WHERE "issue_id" = "issue_id_p" AND "harmonic_weight" ISNULL;
4931 END;
4932 $$;
4934 COMMENT ON FUNCTION "set_harmonic_initiative_weights"
4935 ( "issue"."id"%TYPE )
4936 IS 'Calculates and sets "harmonic_weight" of initiatives in a given issue';
4940 ------------------------------
4941 -- Calculation of snapshots --
4942 ------------------------------
4945 CREATE FUNCTION "weight_of_added_delegations_for_snapshot"
4946 ( "snapshot_id_p" "snapshot"."id"%TYPE,
4947 "issue_id_p" "issue"."id"%TYPE,
4948 "member_id_p" "member"."id"%TYPE,
4949 "delegate_member_ids_p" "delegating_interest_snapshot"."delegate_member_ids"%TYPE )
4950 RETURNS "direct_interest_snapshot"."weight"%TYPE
4951 LANGUAGE 'plpgsql' VOLATILE AS $$
4952 DECLARE
4953 "issue_delegation_row" "issue_delegation"%ROWTYPE;
4954 "delegate_member_ids_v" "delegating_interest_snapshot"."delegate_member_ids"%TYPE;
4955 "weight_v" INT4;
4956 "sub_weight_v" INT4;
4957 BEGIN
4958 PERFORM "require_transaction_isolation"();
4959 "weight_v" := 0;
4960 FOR "issue_delegation_row" IN
4961 SELECT * FROM "issue_delegation"
4962 WHERE "trustee_id" = "member_id_p"
4963 AND "issue_id" = "issue_id_p"
4964 LOOP
4965 IF NOT EXISTS (
4966 SELECT NULL FROM "direct_interest_snapshot"
4967 WHERE "snapshot_id" = "snapshot_id_p"
4968 AND "issue_id" = "issue_id_p"
4969 AND "member_id" = "issue_delegation_row"."truster_id"
4970 ) AND NOT EXISTS (
4971 SELECT NULL FROM "delegating_interest_snapshot"
4972 WHERE "snapshot_id" = "snapshot_id_p"
4973 AND "issue_id" = "issue_id_p"
4974 AND "member_id" = "issue_delegation_row"."truster_id"
4975 ) THEN
4976 "delegate_member_ids_v" :=
4977 "member_id_p" || "delegate_member_ids_p";
4978 INSERT INTO "delegating_interest_snapshot" (
4979 "snapshot_id",
4980 "issue_id",
4981 "member_id",
4982 "scope",
4983 "delegate_member_ids"
4984 ) VALUES (
4985 "snapshot_id_p",
4986 "issue_id_p",
4987 "issue_delegation_row"."truster_id",
4988 "issue_delegation_row"."scope",
4989 "delegate_member_ids_v"
4990 );
4991 "sub_weight_v" := 1 +
4992 "weight_of_added_delegations_for_snapshot"(
4993 "snapshot_id_p",
4994 "issue_id_p",
4995 "issue_delegation_row"."truster_id",
4996 "delegate_member_ids_v"
4997 );
4998 UPDATE "delegating_interest_snapshot"
4999 SET "weight" = "sub_weight_v"
5000 WHERE "snapshot_id" = "snapshot_id_p"
5001 AND "issue_id" = "issue_id_p"
5002 AND "member_id" = "issue_delegation_row"."truster_id";
5003 "weight_v" := "weight_v" + "sub_weight_v";
5004 END IF;
5005 END LOOP;
5006 RETURN "weight_v";
5007 END;
5008 $$;
5010 COMMENT ON FUNCTION "weight_of_added_delegations_for_snapshot"
5011 ( "snapshot"."id"%TYPE,
5012 "issue"."id"%TYPE,
5013 "member"."id"%TYPE,
5014 "delegating_interest_snapshot"."delegate_member_ids"%TYPE )
5015 IS 'Helper function for "fill_snapshot" function';
5018 CREATE FUNCTION "take_snapshot"
5019 ( "issue_id_p" "issue"."id"%TYPE,
5020 "area_id_p" "area"."id"%TYPE = NULL )
5021 RETURNS "snapshot"."id"%TYPE
5022 LANGUAGE 'plpgsql' VOLATILE AS $$
5023 DECLARE
5024 "area_id_v" "area"."id"%TYPE;
5025 "unit_id_v" "unit"."id"%TYPE;
5026 "snapshot_id_v" "snapshot"."id"%TYPE;
5027 "issue_id_v" "issue"."id"%TYPE;
5028 "member_id_v" "member"."id"%TYPE;
5029 BEGIN
5030 IF "issue_id_p" NOTNULL AND "area_id_p" NOTNULL THEN
5031 RAISE EXCEPTION 'One of "issue_id_p" and "area_id_p" must be NULL';
5032 END IF;
5033 PERFORM "require_transaction_isolation"();
5034 IF "issue_id_p" ISNULL THEN
5035 "area_id_v" := "area_id_p";
5036 ELSE
5037 SELECT "area_id" INTO "area_id_v"
5038 FROM "issue" WHERE "id" = "issue_id_p";
5039 END IF;
5040 SELECT "unit_id" INTO "unit_id_v" FROM "area" WHERE "id" = "area_id_v";
5041 INSERT INTO "snapshot" ("area_id", "issue_id")
5042 VALUES ("area_id_v", "issue_id_p")
5043 RETURNING "id" INTO "snapshot_id_v";
5044 INSERT INTO "snapshot_population" ("snapshot_id", "member_id")
5045 SELECT "snapshot_id_v", "member_id"
5046 FROM "unit_member" WHERE "unit_id" = "unit_id_v";
5047 UPDATE "snapshot" SET
5048 "population" = (
5049 SELECT count(1) FROM "snapshot_population"
5050 WHERE "snapshot_id" = "snapshot_id_v"
5051 ) WHERE "id" = "snapshot_id_v";
5052 FOR "issue_id_v" IN
5053 SELECT "id" FROM "issue"
5054 WHERE CASE WHEN "issue_id_p" ISNULL THEN
5055 "area_id" = "area_id_p" AND
5056 "state" = 'admission'
5057 ELSE
5058 "id" = "issue_id_p"
5059 END
5060 LOOP
5061 INSERT INTO "snapshot_issue" ("snapshot_id", "issue_id")
5062 VALUES ("snapshot_id_v", "issue_id_v");
5063 INSERT INTO "direct_interest_snapshot"
5064 ("snapshot_id", "issue_id", "member_id")
5065 SELECT
5066 "snapshot_id_v" AS "snapshot_id",
5067 "issue_id_v" AS "issue_id",
5068 "member"."id" AS "member_id"
5069 FROM "issue"
5070 JOIN "area" ON "issue"."area_id" = "area"."id"
5071 JOIN "interest" ON "issue"."id" = "interest"."issue_id"
5072 JOIN "member" ON "interest"."member_id" = "member"."id"
5073 JOIN "privilege"
5074 ON "privilege"."unit_id" = "area"."unit_id"
5075 AND "privilege"."member_id" = "member"."id"
5076 WHERE "issue"."id" = "issue_id_v"
5077 AND "member"."active" AND "privilege"."voting_right";
5078 FOR "member_id_v" IN
5079 SELECT "member_id" FROM "direct_interest_snapshot"
5080 WHERE "snapshot_id" = "snapshot_id_v"
5081 AND "issue_id" = "issue_id_v"
5082 LOOP
5083 UPDATE "direct_interest_snapshot" SET
5084 "weight" = 1 +
5085 "weight_of_added_delegations_for_snapshot"(
5086 "snapshot_id_v",
5087 "issue_id_v",
5088 "member_id_v",
5089 '{}'
5090 )
5091 WHERE "snapshot_id" = "snapshot_id_v"
5092 AND "issue_id" = "issue_id_v"
5093 AND "member_id" = "member_id_v";
5094 END LOOP;
5095 INSERT INTO "direct_supporter_snapshot"
5096 ( "snapshot_id", "issue_id", "initiative_id", "member_id",
5097 "draft_id", "informed", "satisfied" )
5098 SELECT
5099 "snapshot_id_v" AS "snapshot_id",
5100 "issue_id_v" AS "issue_id",
5101 "initiative"."id" AS "initiative_id",
5102 "supporter"."member_id" AS "member_id",
5103 "supporter"."draft_id" AS "draft_id",
5104 "supporter"."draft_id" = "current_draft"."id" AS "informed",
5105 NOT EXISTS (
5106 SELECT NULL FROM "critical_opinion"
5107 WHERE "initiative_id" = "initiative"."id"
5108 AND "member_id" = "supporter"."member_id"
5109 ) AS "satisfied"
5110 FROM "initiative"
5111 JOIN "supporter"
5112 ON "supporter"."initiative_id" = "initiative"."id"
5113 JOIN "current_draft"
5114 ON "initiative"."id" = "current_draft"."initiative_id"
5115 JOIN "direct_interest_snapshot"
5116 ON "snapshot_id_v" = "direct_interest_snapshot"."snapshot_id"
5117 AND "supporter"."member_id" = "direct_interest_snapshot"."member_id"
5118 AND "initiative"."issue_id" = "direct_interest_snapshot"."issue_id"
5119 WHERE "initiative"."issue_id" = "issue_id_v";
5120 DELETE FROM "temporary_suggestion_counts";
5121 INSERT INTO "temporary_suggestion_counts"
5122 ( "id",
5123 "minus2_unfulfilled_count", "minus2_fulfilled_count",
5124 "minus1_unfulfilled_count", "minus1_fulfilled_count",
5125 "plus1_unfulfilled_count", "plus1_fulfilled_count",
5126 "plus2_unfulfilled_count", "plus2_fulfilled_count" )
5127 SELECT
5128 "suggestion"."id",
5129 ( SELECT coalesce(sum("di"."weight"), 0)
5130 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5131 ON "di"."snapshot_id" = "snapshot_id_v"
5132 AND "di"."issue_id" = "issue_id_v"
5133 AND "di"."member_id" = "opinion"."member_id"
5134 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5135 AND "opinion"."degree" = -2
5136 AND "opinion"."fulfilled" = FALSE
5137 ) AS "minus2_unfulfilled_count",
5138 ( SELECT coalesce(sum("di"."weight"), 0)
5139 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5140 ON "di"."snapshot_id" = "snapshot_id_v"
5141 AND "di"."issue_id" = "issue_id_v"
5142 AND "di"."member_id" = "opinion"."member_id"
5143 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5144 AND "opinion"."degree" = -2
5145 AND "opinion"."fulfilled" = TRUE
5146 ) AS "minus2_fulfilled_count",
5147 ( SELECT coalesce(sum("di"."weight"), 0)
5148 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5149 ON "di"."snapshot_id" = "snapshot_id_v"
5150 AND "di"."issue_id" = "issue_id_v"
5151 AND "di"."member_id" = "opinion"."member_id"
5152 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5153 AND "opinion"."degree" = -1
5154 AND "opinion"."fulfilled" = FALSE
5155 ) AS "minus1_unfulfilled_count",
5156 ( SELECT coalesce(sum("di"."weight"), 0)
5157 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5158 ON "di"."snapshot_id" = "snapshot_id_v"
5159 AND "di"."issue_id" = "issue_id_v"
5160 AND "di"."member_id" = "opinion"."member_id"
5161 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5162 AND "opinion"."degree" = -1
5163 AND "opinion"."fulfilled" = TRUE
5164 ) AS "minus1_fulfilled_count",
5165 ( SELECT coalesce(sum("di"."weight"), 0)
5166 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5167 ON "di"."snapshot_id" = "snapshot_id_v"
5168 AND "di"."issue_id" = "issue_id_v"
5169 AND "di"."member_id" = "opinion"."member_id"
5170 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5171 AND "opinion"."degree" = 1
5172 AND "opinion"."fulfilled" = FALSE
5173 ) AS "plus1_unfulfilled_count",
5174 ( SELECT coalesce(sum("di"."weight"), 0)
5175 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5176 ON "di"."snapshot_id" = "snapshot_id_v"
5177 AND "di"."issue_id" = "issue_id_v"
5178 AND "di"."member_id" = "opinion"."member_id"
5179 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5180 AND "opinion"."degree" = 1
5181 AND "opinion"."fulfilled" = TRUE
5182 ) AS "plus1_fulfilled_count",
5183 ( SELECT coalesce(sum("di"."weight"), 0)
5184 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5185 ON "di"."snapshot_id" = "snapshot_id_v"
5186 AND "di"."issue_id" = "issue_id_v"
5187 AND "di"."member_id" = "opinion"."member_id"
5188 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5189 AND "opinion"."degree" = 2
5190 AND "opinion"."fulfilled" = FALSE
5191 ) AS "plus2_unfulfilled_count",
5192 ( SELECT coalesce(sum("di"."weight"), 0)
5193 FROM "opinion" JOIN "direct_interest_snapshot" AS "di"
5194 ON "di"."snapshot_id" = "snapshot_id_v"
5195 AND "di"."issue_id" = "issue_id_v"
5196 AND "di"."member_id" = "opinion"."member_id"
5197 WHERE "opinion"."suggestion_id" = "suggestion"."id"
5198 AND "opinion"."degree" = 2
5199 AND "opinion"."fulfilled" = TRUE
5200 ) AS "plus2_fulfilled_count"
5201 FROM "suggestion" JOIN "initiative"
5202 ON "suggestion"."initiative_id" = "initiative"."id"
5203 WHERE "initiative"."issue_id" = "issue_id_v";
5204 END LOOP;
5205 RETURN "snapshot_id_v";
5206 END;
5207 $$;
5209 COMMENT ON FUNCTION "take_snapshot"
5210 ( "issue"."id"%TYPE,
5211 "area"."id"%TYPE )
5212 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.';
5215 CREATE FUNCTION "finish_snapshot"
5216 ( "issue_id_p" "issue"."id"%TYPE )
5217 RETURNS VOID
5218 LANGUAGE 'plpgsql' VOLATILE AS $$
5219 DECLARE
5220 "snapshot_id_v" "snapshot"."id"%TYPE;
5221 BEGIN
5222 -- NOTE: function does not require snapshot isolation but we don't call
5223 -- "dont_require_snapshot_isolation" here because this function is
5224 -- also invoked by "check_issue"
5225 LOCK TABLE "snapshot" IN EXCLUSIVE MODE;
5226 SELECT "id" INTO "snapshot_id_v" FROM "snapshot"
5227 ORDER BY "id" DESC LIMIT 1;
5228 UPDATE "issue" SET
5229 "calculated" = "snapshot"."calculated",
5230 "latest_snapshot_id" = "snapshot_id_v",
5231 "population" = "snapshot"."population",
5232 "initiative_quorum" = CASE WHEN
5233 "policy"."initiative_quorum" > ceil(
5234 ( "issue"."population"::INT8 *
5235 "policy"."initiative_quorum_num"::INT8 ) /
5236 "policy"."initiative_quorum_den"::FLOAT8
5237 )::INT4
5238 THEN
5239 "policy"."initiative_quorum"
5240 ELSE
5241 ceil(
5242 ( "issue"."population"::INT8 *
5243 "policy"."initiative_quorum_num"::INT8 ) /
5244 "policy"."initiative_quorum_den"::FLOAT8
5245 )::INT4
5246 END
5247 FROM "snapshot", "policy"
5248 WHERE "issue"."id" = "issue_id_p"
5249 AND "snapshot"."id" = "snapshot_id_v"
5250 AND "policy"."id" = "issue"."policy_id";
5251 UPDATE "initiative" SET
5252 "supporter_count" = (
5253 SELECT coalesce(sum("di"."weight"), 0)
5254 FROM "direct_interest_snapshot" AS "di"
5255 JOIN "direct_supporter_snapshot" AS "ds"
5256 ON "di"."member_id" = "ds"."member_id"
5257 WHERE "di"."snapshot_id" = "snapshot_id_v"
5258 AND "di"."issue_id" = "issue_id_p"
5259 AND "ds"."snapshot_id" = "snapshot_id_v"
5260 AND "ds"."initiative_id" = "initiative"."id"
5261 ),
5262 "informed_supporter_count" = (
5263 SELECT coalesce(sum("di"."weight"), 0)
5264 FROM "direct_interest_snapshot" AS "di"
5265 JOIN "direct_supporter_snapshot" AS "ds"
5266 ON "di"."member_id" = "ds"."member_id"
5267 WHERE "di"."snapshot_id" = "snapshot_id_v"
5268 AND "di"."issue_id" = "issue_id_p"
5269 AND "ds"."snapshot_id" = "snapshot_id_v"
5270 AND "ds"."initiative_id" = "initiative"."id"
5271 AND "ds"."informed"
5272 ),
5273 "satisfied_supporter_count" = (
5274 SELECT coalesce(sum("di"."weight"), 0)
5275 FROM "direct_interest_snapshot" AS "di"
5276 JOIN "direct_supporter_snapshot" AS "ds"
5277 ON "di"."member_id" = "ds"."member_id"
5278 WHERE "di"."snapshot_id" = "snapshot_id_v"
5279 AND "di"."issue_id" = "issue_id_p"
5280 AND "ds"."snapshot_id" = "snapshot_id_v"
5281 AND "ds"."initiative_id" = "initiative"."id"
5282 AND "ds"."satisfied"
5283 ),
5284 "satisfied_informed_supporter_count" = (
5285 SELECT coalesce(sum("di"."weight"), 0)
5286 FROM "direct_interest_snapshot" AS "di"
5287 JOIN "direct_supporter_snapshot" AS "ds"
5288 ON "di"."member_id" = "ds"."member_id"
5289 WHERE "di"."snapshot_id" = "snapshot_id_v"
5290 AND "di"."issue_id" = "issue_id_p"
5291 AND "ds"."snapshot_id" = "snapshot_id_v"
5292 AND "ds"."initiative_id" = "initiative"."id"
5293 AND "ds"."informed"
5294 AND "ds"."satisfied"
5295 )
5296 WHERE "issue_id" = "issue_id_p";
5297 UPDATE "suggestion" SET
5298 "minus2_unfulfilled_count" = "temp"."minus2_unfulfilled_count",
5299 "minus2_fulfilled_count" = "temp"."minus2_fulfilled_count",
5300 "minus1_unfulfilled_count" = "temp"."minus1_unfulfilled_count",
5301 "minus1_fulfilled_count" = "temp"."minus1_fulfilled_count",
5302 "plus1_unfulfilled_count" = "temp"."plus1_unfulfilled_count",
5303 "plus1_fulfilled_count" = "temp"."plus1_fulfilled_count",
5304 "plus2_unfulfilled_count" = "temp"."plus2_unfulfilled_count",
5305 "plus2_fulfilled_count" = "temp"."plus2_fulfilled_count"
5306 FROM "temporary_suggestion_counts" AS "temp", "initiative"
5307 WHERE "temp"."id" = "suggestion"."id"
5308 AND "initiative"."issue_id" = "issue_id_p"
5309 AND "suggestion"."initiative_id" = "initiative"."id";
5310 DELETE FROM "temporary_suggestion_counts";
5311 RETURN;
5312 END;
5313 $$;
5315 COMMENT ON FUNCTION "finish_snapshot"
5316 ( "issue"."id"%TYPE )
5317 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)';
5321 -----------------------
5322 -- Counting of votes --
5323 -----------------------
5326 CREATE FUNCTION "weight_of_added_vote_delegations"
5327 ( "issue_id_p" "issue"."id"%TYPE,
5328 "member_id_p" "member"."id"%TYPE,
5329 "delegate_member_ids_p" "delegating_voter"."delegate_member_ids"%TYPE )
5330 RETURNS "direct_voter"."weight"%TYPE
5331 LANGUAGE 'plpgsql' VOLATILE AS $$
5332 DECLARE
5333 "issue_delegation_row" "issue_delegation"%ROWTYPE;
5334 "delegate_member_ids_v" "delegating_voter"."delegate_member_ids"%TYPE;
5335 "weight_v" INT4;
5336 "sub_weight_v" INT4;
5337 BEGIN
5338 PERFORM "require_transaction_isolation"();
5339 "weight_v" := 0;
5340 FOR "issue_delegation_row" IN
5341 SELECT * FROM "issue_delegation"
5342 WHERE "trustee_id" = "member_id_p"
5343 AND "issue_id" = "issue_id_p"
5344 LOOP
5345 IF NOT EXISTS (
5346 SELECT NULL FROM "direct_voter"
5347 WHERE "member_id" = "issue_delegation_row"."truster_id"
5348 AND "issue_id" = "issue_id_p"
5349 ) AND NOT EXISTS (
5350 SELECT NULL FROM "delegating_voter"
5351 WHERE "member_id" = "issue_delegation_row"."truster_id"
5352 AND "issue_id" = "issue_id_p"
5353 ) THEN
5354 "delegate_member_ids_v" :=
5355 "member_id_p" || "delegate_member_ids_p";
5356 INSERT INTO "delegating_voter" (
5357 "issue_id",
5358 "member_id",
5359 "scope",
5360 "delegate_member_ids"
5361 ) VALUES (
5362 "issue_id_p",
5363 "issue_delegation_row"."truster_id",
5364 "issue_delegation_row"."scope",
5365 "delegate_member_ids_v"
5366 );
5367 "sub_weight_v" := 1 +
5368 "weight_of_added_vote_delegations"(
5369 "issue_id_p",
5370 "issue_delegation_row"."truster_id",
5371 "delegate_member_ids_v"
5372 );
5373 UPDATE "delegating_voter"
5374 SET "weight" = "sub_weight_v"
5375 WHERE "issue_id" = "issue_id_p"
5376 AND "member_id" = "issue_delegation_row"."truster_id";
5377 "weight_v" := "weight_v" + "sub_weight_v";
5378 END IF;
5379 END LOOP;
5380 RETURN "weight_v";
5381 END;
5382 $$;
5384 COMMENT ON FUNCTION "weight_of_added_vote_delegations"
5385 ( "issue"."id"%TYPE,
5386 "member"."id"%TYPE,
5387 "delegating_voter"."delegate_member_ids"%TYPE )
5388 IS 'Helper function for "add_vote_delegations" function';
5391 CREATE FUNCTION "add_vote_delegations"
5392 ( "issue_id_p" "issue"."id"%TYPE )
5393 RETURNS VOID
5394 LANGUAGE 'plpgsql' VOLATILE AS $$
5395 DECLARE
5396 "member_id_v" "member"."id"%TYPE;
5397 BEGIN
5398 PERFORM "require_transaction_isolation"();
5399 FOR "member_id_v" IN
5400 SELECT "member_id" FROM "direct_voter"
5401 WHERE "issue_id" = "issue_id_p"
5402 LOOP
5403 UPDATE "direct_voter" SET
5404 "weight" = "weight" + "weight_of_added_vote_delegations"(
5405 "issue_id_p",
5406 "member_id_v",
5407 '{}'
5408 )
5409 WHERE "member_id" = "member_id_v"
5410 AND "issue_id" = "issue_id_p";
5411 END LOOP;
5412 RETURN;
5413 END;
5414 $$;
5416 COMMENT ON FUNCTION "add_vote_delegations"
5417 ( "issue_id_p" "issue"."id"%TYPE )
5418 IS 'Helper function for "close_voting" function';
5421 CREATE FUNCTION "close_voting"("issue_id_p" "issue"."id"%TYPE)
5422 RETURNS VOID
5423 LANGUAGE 'plpgsql' VOLATILE AS $$
5424 DECLARE
5425 "area_id_v" "area"."id"%TYPE;
5426 "unit_id_v" "unit"."id"%TYPE;
5427 "member_id_v" "member"."id"%TYPE;
5428 BEGIN
5429 PERFORM "require_transaction_isolation"();
5430 SELECT "area_id" INTO "area_id_v" FROM "issue" WHERE "id" = "issue_id_p";
5431 SELECT "unit_id" INTO "unit_id_v" FROM "area" WHERE "id" = "area_id_v";
5432 -- override protection triggers:
5433 INSERT INTO "temporary_transaction_data" ("key", "value")
5434 VALUES ('override_protection_triggers', TRUE::TEXT);
5435 -- delete timestamp of voting comment:
5436 UPDATE "direct_voter" SET "comment_changed" = NULL
5437 WHERE "issue_id" = "issue_id_p";
5438 -- delete delegating votes (in cases of manual reset of issue state):
5439 DELETE FROM "delegating_voter"
5440 WHERE "issue_id" = "issue_id_p";
5441 -- delete votes from non-privileged voters:
5442 DELETE FROM "direct_voter"
5443 USING (
5444 SELECT
5445 "direct_voter"."member_id"
5446 FROM "direct_voter"
5447 JOIN "member" ON "direct_voter"."member_id" = "member"."id"
5448 LEFT JOIN "privilege"
5449 ON "privilege"."unit_id" = "unit_id_v"
5450 AND "privilege"."member_id" = "direct_voter"."member_id"
5451 WHERE "direct_voter"."issue_id" = "issue_id_p" AND (
5452 "member"."active" = FALSE OR
5453 "privilege"."voting_right" ISNULL OR
5454 "privilege"."voting_right" = FALSE
5455 )
5456 ) AS "subquery"
5457 WHERE "direct_voter"."issue_id" = "issue_id_p"
5458 AND "direct_voter"."member_id" = "subquery"."member_id";
5459 -- consider delegations:
5460 UPDATE "direct_voter" SET "weight" = 1
5461 WHERE "issue_id" = "issue_id_p";
5462 PERFORM "add_vote_delegations"("issue_id_p");
5463 -- mark first preferences:
5464 UPDATE "vote" SET "first_preference" = "subquery"."first_preference"
5465 FROM (
5466 SELECT
5467 "vote"."initiative_id",
5468 "vote"."member_id",
5469 CASE WHEN "vote"."grade" > 0 THEN
5470 CASE WHEN "vote"."grade" = max("agg"."grade") THEN TRUE ELSE FALSE END
5471 ELSE NULL
5472 END AS "first_preference"
5473 FROM "vote"
5474 JOIN "initiative" -- NOTE: due to missing index on issue_id
5475 ON "vote"."issue_id" = "initiative"."issue_id"
5476 JOIN "vote" AS "agg"
5477 ON "initiative"."id" = "agg"."initiative_id"
5478 AND "vote"."member_id" = "agg"."member_id"
5479 GROUP BY "vote"."initiative_id", "vote"."member_id", "vote"."grade"
5480 ) AS "subquery"
5481 WHERE "vote"."issue_id" = "issue_id_p"
5482 AND "vote"."initiative_id" = "subquery"."initiative_id"
5483 AND "vote"."member_id" = "subquery"."member_id";
5484 -- finish overriding protection triggers (avoids garbage):
5485 DELETE FROM "temporary_transaction_data"
5486 WHERE "key" = 'override_protection_triggers';
5487 -- materialize battle_view:
5488 -- NOTE: "closed" column of issue must be set at this point
5489 DELETE FROM "battle" WHERE "issue_id" = "issue_id_p";
5490 INSERT INTO "battle" (
5491 "issue_id",
5492 "winning_initiative_id", "losing_initiative_id",
5493 "count"
5494 ) SELECT
5495 "issue_id",
5496 "winning_initiative_id", "losing_initiative_id",
5497 "count"
5498 FROM "battle_view" WHERE "issue_id" = "issue_id_p";
5499 -- set voter count:
5500 UPDATE "issue" SET
5501 "voter_count" = (
5502 SELECT coalesce(sum("weight"), 0)
5503 FROM "direct_voter" WHERE "issue_id" = "issue_id_p"
5504 )
5505 WHERE "id" = "issue_id_p";
5506 -- copy "positive_votes" and "negative_votes" from "battle" table:
5507 -- NOTE: "first_preference_votes" is set to a default of 0 at this step
5508 UPDATE "initiative" SET
5509 "first_preference_votes" = 0,
5510 "positive_votes" = "battle_win"."count",
5511 "negative_votes" = "battle_lose"."count"
5512 FROM "battle" AS "battle_win", "battle" AS "battle_lose"
5513 WHERE
5514 "battle_win"."issue_id" = "issue_id_p" AND
5515 "battle_win"."winning_initiative_id" = "initiative"."id" AND
5516 "battle_win"."losing_initiative_id" ISNULL AND
5517 "battle_lose"."issue_id" = "issue_id_p" AND
5518 "battle_lose"."losing_initiative_id" = "initiative"."id" AND
5519 "battle_lose"."winning_initiative_id" ISNULL;
5520 -- calculate "first_preference_votes":
5521 -- NOTE: will only set values not equal to zero
5522 UPDATE "initiative" SET "first_preference_votes" = "subquery"."sum"
5523 FROM (
5524 SELECT "vote"."initiative_id", sum("direct_voter"."weight")
5525 FROM "vote" JOIN "direct_voter"
5526 ON "vote"."issue_id" = "direct_voter"."issue_id"
5527 AND "vote"."member_id" = "direct_voter"."member_id"
5528 WHERE "vote"."first_preference"
5529 GROUP BY "vote"."initiative_id"
5530 ) AS "subquery"
5531 WHERE "initiative"."issue_id" = "issue_id_p"
5532 AND "initiative"."admitted"
5533 AND "initiative"."id" = "subquery"."initiative_id";
5534 END;
5535 $$;
5537 COMMENT ON FUNCTION "close_voting"
5538 ( "issue"."id"%TYPE )
5539 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.';
5542 CREATE FUNCTION "defeat_strength"
5543 ( "positive_votes_p" INT4,
5544 "negative_votes_p" INT4,
5545 "defeat_strength_p" "defeat_strength" )
5546 RETURNS INT8
5547 LANGUAGE 'plpgsql' IMMUTABLE AS $$
5548 BEGIN
5549 IF "defeat_strength_p" = 'simple'::"defeat_strength" THEN
5550 IF "positive_votes_p" > "negative_votes_p" THEN
5551 RETURN "positive_votes_p";
5552 ELSE
5553 RETURN 0;
5554 END IF;
5555 ELSE
5556 IF "positive_votes_p" > "negative_votes_p" THEN
5557 RETURN ("positive_votes_p"::INT8 << 31) - "negative_votes_p"::INT8;
5558 ELSIF "positive_votes_p" = "negative_votes_p" THEN
5559 RETURN 0;
5560 ELSE
5561 RETURN -1;
5562 END IF;
5563 END IF;
5564 END;
5565 $$;
5567 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")';
5570 CREATE FUNCTION "secondary_link_strength"
5571 ( "initiative1_ord_p" INT4,
5572 "initiative2_ord_p" INT4,
5573 "tie_breaking_p" "tie_breaking" )
5574 RETURNS INT8
5575 LANGUAGE 'plpgsql' IMMUTABLE AS $$
5576 BEGIN
5577 IF "initiative1_ord_p" = "initiative2_ord_p" THEN
5578 RAISE EXCEPTION 'Identical initiative ids passed to "secondary_link_strength" function (should not happen)';
5579 END IF;
5580 RETURN (
5581 CASE WHEN "tie_breaking_p" = 'simple'::"tie_breaking" THEN
5582 0
5583 ELSE
5584 CASE WHEN "initiative1_ord_p" < "initiative2_ord_p" THEN
5585 1::INT8 << 62
5586 ELSE 0 END
5587 +
5588 CASE WHEN "tie_breaking_p" = 'variant2'::"tie_breaking" THEN
5589 ("initiative2_ord_p"::INT8 << 31) - "initiative1_ord_p"::INT8
5590 ELSE
5591 "initiative2_ord_p"::INT8 - ("initiative1_ord_p"::INT8 << 31)
5592 END
5593 END
5594 );
5595 END;
5596 $$;
5598 COMMENT ON FUNCTION "secondary_link_strength"(INT4, INT4, "tie_breaking") IS 'Calculates a secondary criterion for the defeat strength (tie-breaking of the links)';
5601 CREATE TYPE "link_strength" AS (
5602 "primary" INT8,
5603 "secondary" INT8 );
5605 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'')';
5608 CREATE FUNCTION "find_best_paths"("matrix_d" "link_strength"[][])
5609 RETURNS "link_strength"[][]
5610 LANGUAGE 'plpgsql' IMMUTABLE AS $$
5611 DECLARE
5612 "dimension_v" INT4;
5613 "matrix_p" "link_strength"[][];
5614 "i" INT4;
5615 "j" INT4;
5616 "k" INT4;
5617 BEGIN
5618 "dimension_v" := array_upper("matrix_d", 1);
5619 "matrix_p" := "matrix_d";
5620 "i" := 1;
5621 LOOP
5622 "j" := 1;
5623 LOOP
5624 IF "i" != "j" THEN
5625 "k" := 1;
5626 LOOP
5627 IF "i" != "k" AND "j" != "k" THEN
5628 IF "matrix_p"["j"]["i"] < "matrix_p"["i"]["k"] THEN
5629 IF "matrix_p"["j"]["i"] > "matrix_p"["j"]["k"] THEN
5630 "matrix_p"["j"]["k"] := "matrix_p"["j"]["i"];
5631 END IF;
5632 ELSE
5633 IF "matrix_p"["i"]["k"] > "matrix_p"["j"]["k"] THEN
5634 "matrix_p"["j"]["k"] := "matrix_p"["i"]["k"];
5635 END IF;
5636 END IF;
5637 END IF;
5638 EXIT WHEN "k" = "dimension_v";
5639 "k" := "k" + 1;
5640 END LOOP;
5641 END IF;
5642 EXIT WHEN "j" = "dimension_v";
5643 "j" := "j" + 1;
5644 END LOOP;
5645 EXIT WHEN "i" = "dimension_v";
5646 "i" := "i" + 1;
5647 END LOOP;
5648 RETURN "matrix_p";
5649 END;
5650 $$;
5652 COMMENT ON FUNCTION "find_best_paths"("link_strength"[][]) IS 'Computes the strengths of the best beat-paths from a square matrix';
5655 CREATE FUNCTION "calculate_ranks"("issue_id_p" "issue"."id"%TYPE)
5656 RETURNS VOID
5657 LANGUAGE 'plpgsql' VOLATILE AS $$
5658 DECLARE
5659 "issue_row" "issue"%ROWTYPE;
5660 "policy_row" "policy"%ROWTYPE;
5661 "dimension_v" INT4;
5662 "matrix_a" INT4[][]; -- absolute votes
5663 "matrix_d" "link_strength"[][]; -- defeat strength (direct)
5664 "matrix_p" "link_strength"[][]; -- defeat strength (best path)
5665 "matrix_t" "link_strength"[][]; -- defeat strength (tie-breaking)
5666 "matrix_f" BOOLEAN[][]; -- forbidden link (tie-breaking)
5667 "matrix_b" BOOLEAN[][]; -- final order (who beats who)
5668 "i" INT4;
5669 "j" INT4;
5670 "m" INT4;
5671 "n" INT4;
5672 "battle_row" "battle"%ROWTYPE;
5673 "rank_ary" INT4[];
5674 "rank_v" INT4;
5675 "initiative_id_v" "initiative"."id"%TYPE;
5676 BEGIN
5677 PERFORM "require_transaction_isolation"();
5678 SELECT * INTO "issue_row"
5679 FROM "issue" WHERE "id" = "issue_id_p";
5680 SELECT * INTO "policy_row"
5681 FROM "policy" WHERE "id" = "issue_row"."policy_id";
5682 SELECT count(1) INTO "dimension_v"
5683 FROM "battle_participant" WHERE "issue_id" = "issue_id_p";
5684 -- create "matrix_a" with absolute number of votes in pairwise
5685 -- comparison:
5686 "matrix_a" := array_fill(NULL::INT4, ARRAY["dimension_v", "dimension_v"]);
5687 "i" := 1;
5688 "j" := 2;
5689 FOR "battle_row" IN
5690 SELECT * FROM "battle" WHERE "issue_id" = "issue_id_p"
5691 ORDER BY
5692 "winning_initiative_id" NULLS FIRST,
5693 "losing_initiative_id" NULLS FIRST
5694 LOOP
5695 "matrix_a"["i"]["j"] := "battle_row"."count";
5696 IF "j" = "dimension_v" THEN
5697 "i" := "i" + 1;
5698 "j" := 1;
5699 ELSE
5700 "j" := "j" + 1;
5701 IF "j" = "i" THEN
5702 "j" := "j" + 1;
5703 END IF;
5704 END IF;
5705 END LOOP;
5706 IF "i" != "dimension_v" OR "j" != "dimension_v" + 1 THEN
5707 RAISE EXCEPTION 'Wrong battle count (should not happen)';
5708 END IF;
5709 -- store direct defeat strengths in "matrix_d" using "defeat_strength"
5710 -- and "secondary_link_strength" functions:
5711 "matrix_d" := array_fill(NULL::INT8, ARRAY["dimension_v", "dimension_v"]);
5712 "i" := 1;
5713 LOOP
5714 "j" := 1;
5715 LOOP
5716 IF "i" != "j" THEN
5717 "matrix_d"["i"]["j"] := (
5718 "defeat_strength"(
5719 "matrix_a"["i"]["j"],
5720 "matrix_a"["j"]["i"],
5721 "policy_row"."defeat_strength"
5722 ),
5723 "secondary_link_strength"(
5724 "i",
5725 "j",
5726 "policy_row"."tie_breaking"
5727 )
5728 )::"link_strength";
5729 END IF;
5730 EXIT WHEN "j" = "dimension_v";
5731 "j" := "j" + 1;
5732 END LOOP;
5733 EXIT WHEN "i" = "dimension_v";
5734 "i" := "i" + 1;
5735 END LOOP;
5736 -- find best paths:
5737 "matrix_p" := "find_best_paths"("matrix_d");
5738 -- create partial order:
5739 "matrix_b" := array_fill(NULL::BOOLEAN, ARRAY["dimension_v", "dimension_v"]);
5740 "i" := 1;
5741 LOOP
5742 "j" := "i" + 1;
5743 LOOP
5744 IF "i" != "j" THEN
5745 IF "matrix_p"["i"]["j"] > "matrix_p"["j"]["i"] THEN
5746 "matrix_b"["i"]["j"] := TRUE;
5747 "matrix_b"["j"]["i"] := FALSE;
5748 ELSIF "matrix_p"["i"]["j"] < "matrix_p"["j"]["i"] THEN
5749 "matrix_b"["i"]["j"] := FALSE;
5750 "matrix_b"["j"]["i"] := TRUE;
5751 END IF;
5752 END IF;
5753 EXIT WHEN "j" = "dimension_v";
5754 "j" := "j" + 1;
5755 END LOOP;
5756 EXIT WHEN "i" = "dimension_v" - 1;
5757 "i" := "i" + 1;
5758 END LOOP;
5759 -- tie-breaking by forbidding shared weakest links in beat-paths
5760 -- (unless "tie_breaking" is set to 'simple', in which case tie-breaking
5761 -- is performed later by initiative id):
5762 IF "policy_row"."tie_breaking" != 'simple'::"tie_breaking" THEN
5763 "m" := 1;
5764 LOOP
5765 "n" := "m" + 1;
5766 LOOP
5767 -- only process those candidates m and n, which are tied:
5768 IF "matrix_b"["m"]["n"] ISNULL THEN
5769 -- start with beat-paths prior tie-breaking:
5770 "matrix_t" := "matrix_p";
5771 -- start with all links allowed:
5772 "matrix_f" := array_fill(FALSE, ARRAY["dimension_v", "dimension_v"]);
5773 LOOP
5774 -- determine (and forbid) that link that is the weakest link
5775 -- in both the best path from candidate m to candidate n and
5776 -- from candidate n to candidate m:
5777 "i" := 1;
5778 <<forbid_one_link>>
5779 LOOP
5780 "j" := 1;
5781 LOOP
5782 IF "i" != "j" THEN
5783 IF "matrix_d"["i"]["j"] = "matrix_t"["m"]["n"] THEN
5784 "matrix_f"["i"]["j"] := TRUE;
5785 -- exit for performance reasons,
5786 -- as exactly one link will be found:
5787 EXIT forbid_one_link;
5788 END IF;
5789 END IF;
5790 EXIT WHEN "j" = "dimension_v";
5791 "j" := "j" + 1;
5792 END LOOP;
5793 IF "i" = "dimension_v" THEN
5794 RAISE EXCEPTION 'Did not find shared weakest link for tie-breaking (should not happen)';
5795 END IF;
5796 "i" := "i" + 1;
5797 END LOOP;
5798 -- calculate best beat-paths while ignoring forbidden links:
5799 "i" := 1;
5800 LOOP
5801 "j" := 1;
5802 LOOP
5803 IF "i" != "j" THEN
5804 "matrix_t"["i"]["j"] := CASE
5805 WHEN "matrix_f"["i"]["j"]
5806 THEN ((-1::INT8) << 63, 0)::"link_strength" -- worst possible value
5807 ELSE "matrix_d"["i"]["j"] END;
5808 END IF;
5809 EXIT WHEN "j" = "dimension_v";
5810 "j" := "j" + 1;
5811 END LOOP;
5812 EXIT WHEN "i" = "dimension_v";
5813 "i" := "i" + 1;
5814 END LOOP;
5815 "matrix_t" := "find_best_paths"("matrix_t");
5816 -- extend partial order, if tie-breaking was successful:
5817 IF "matrix_t"["m"]["n"] > "matrix_t"["n"]["m"] THEN
5818 "matrix_b"["m"]["n"] := TRUE;
5819 "matrix_b"["n"]["m"] := FALSE;
5820 EXIT;
5821 ELSIF "matrix_t"["m"]["n"] < "matrix_t"["n"]["m"] THEN
5822 "matrix_b"["m"]["n"] := FALSE;
5823 "matrix_b"["n"]["m"] := TRUE;
5824 EXIT;
5825 END IF;
5826 END LOOP;
5827 END IF;
5828 EXIT WHEN "n" = "dimension_v";
5829 "n" := "n" + 1;
5830 END LOOP;
5831 EXIT WHEN "m" = "dimension_v" - 1;
5832 "m" := "m" + 1;
5833 END LOOP;
5834 END IF;
5835 -- store a unique ranking in "rank_ary":
5836 "rank_ary" := array_fill(NULL::INT4, ARRAY["dimension_v"]);
5837 "rank_v" := 1;
5838 LOOP
5839 "i" := 1;
5840 <<assign_next_rank>>
5841 LOOP
5842 IF "rank_ary"["i"] ISNULL THEN
5843 "j" := 1;
5844 LOOP
5845 IF
5846 "i" != "j" AND
5847 "rank_ary"["j"] ISNULL AND
5848 ( "matrix_b"["j"]["i"] OR
5849 -- tie-breaking by "id"
5850 ( "matrix_b"["j"]["i"] ISNULL AND
5851 "j" < "i" ) )
5852 THEN
5853 -- someone else is better
5854 EXIT;
5855 END IF;
5856 IF "j" = "dimension_v" THEN
5857 -- noone is better
5858 "rank_ary"["i"] := "rank_v";
5859 EXIT assign_next_rank;
5860 END IF;
5861 "j" := "j" + 1;
5862 END LOOP;
5863 END IF;
5864 "i" := "i" + 1;
5865 IF "i" > "dimension_v" THEN
5866 RAISE EXCEPTION 'Schulze ranking does not compute (should not happen)';
5867 END IF;
5868 END LOOP;
5869 EXIT WHEN "rank_v" = "dimension_v";
5870 "rank_v" := "rank_v" + 1;
5871 END LOOP;
5872 -- write preliminary results:
5873 "i" := 2; -- omit status quo with "i" = 1
5874 FOR "initiative_id_v" IN
5875 SELECT "id" FROM "initiative"
5876 WHERE "issue_id" = "issue_id_p" AND "admitted"
5877 ORDER BY "id"
5878 LOOP
5879 UPDATE "initiative" SET
5880 "direct_majority" =
5881 CASE WHEN "policy_row"."direct_majority_strict" THEN
5882 "positive_votes" * "policy_row"."direct_majority_den" >
5883 "policy_row"."direct_majority_num" * ("positive_votes"+"negative_votes")
5884 ELSE
5885 "positive_votes" * "policy_row"."direct_majority_den" >=
5886 "policy_row"."direct_majority_num" * ("positive_votes"+"negative_votes")
5887 END
5888 AND "positive_votes" >= "policy_row"."direct_majority_positive"
5889 AND "issue_row"."voter_count"-"negative_votes" >=
5890 "policy_row"."direct_majority_non_negative",
5891 "indirect_majority" =
5892 CASE WHEN "policy_row"."indirect_majority_strict" THEN
5893 "positive_votes" * "policy_row"."indirect_majority_den" >
5894 "policy_row"."indirect_majority_num" * ("positive_votes"+"negative_votes")
5895 ELSE
5896 "positive_votes" * "policy_row"."indirect_majority_den" >=
5897 "policy_row"."indirect_majority_num" * ("positive_votes"+"negative_votes")
5898 END
5899 AND "positive_votes" >= "policy_row"."indirect_majority_positive"
5900 AND "issue_row"."voter_count"-"negative_votes" >=
5901 "policy_row"."indirect_majority_non_negative",
5902 "schulze_rank" = "rank_ary"["i"],
5903 "better_than_status_quo" = "rank_ary"["i"] < "rank_ary"[1],
5904 "worse_than_status_quo" = "rank_ary"["i"] > "rank_ary"[1],
5905 "multistage_majority" = "rank_ary"["i"] >= "rank_ary"[1],
5906 "reverse_beat_path" = CASE WHEN "policy_row"."defeat_strength" = 'simple'::"defeat_strength"
5907 THEN NULL
5908 ELSE "matrix_p"[1]["i"]."primary" >= 0 END,
5909 "eligible" = FALSE,
5910 "winner" = FALSE,
5911 "rank" = NULL -- NOTE: in cases of manual reset of issue state
5912 WHERE "id" = "initiative_id_v";
5913 "i" := "i" + 1;
5914 END LOOP;
5915 IF "i" != "dimension_v" + 1 THEN
5916 RAISE EXCEPTION 'Wrong winner count (should not happen)';
5917 END IF;
5918 -- take indirect majorities into account:
5919 LOOP
5920 UPDATE "initiative" SET "indirect_majority" = TRUE
5921 FROM (
5922 SELECT "new_initiative"."id" AS "initiative_id"
5923 FROM "initiative" "old_initiative"
5924 JOIN "initiative" "new_initiative"
5925 ON "new_initiative"."issue_id" = "issue_id_p"
5926 AND "new_initiative"."indirect_majority" = FALSE
5927 JOIN "battle" "battle_win"
5928 ON "battle_win"."issue_id" = "issue_id_p"
5929 AND "battle_win"."winning_initiative_id" = "new_initiative"."id"
5930 AND "battle_win"."losing_initiative_id" = "old_initiative"."id"
5931 JOIN "battle" "battle_lose"
5932 ON "battle_lose"."issue_id" = "issue_id_p"
5933 AND "battle_lose"."losing_initiative_id" = "new_initiative"."id"
5934 AND "battle_lose"."winning_initiative_id" = "old_initiative"."id"
5935 WHERE "old_initiative"."issue_id" = "issue_id_p"
5936 AND "old_initiative"."indirect_majority" = TRUE
5937 AND CASE WHEN "policy_row"."indirect_majority_strict" THEN
5938 "battle_win"."count" * "policy_row"."indirect_majority_den" >
5939 "policy_row"."indirect_majority_num" *
5940 ("battle_win"."count"+"battle_lose"."count")
5941 ELSE
5942 "battle_win"."count" * "policy_row"."indirect_majority_den" >=
5943 "policy_row"."indirect_majority_num" *
5944 ("battle_win"."count"+"battle_lose"."count")
5945 END
5946 AND "battle_win"."count" >= "policy_row"."indirect_majority_positive"
5947 AND "issue_row"."voter_count"-"battle_lose"."count" >=
5948 "policy_row"."indirect_majority_non_negative"
5949 ) AS "subquery"
5950 WHERE "id" = "subquery"."initiative_id";
5951 EXIT WHEN NOT FOUND;
5952 END LOOP;
5953 -- set "multistage_majority" for remaining matching initiatives:
5954 UPDATE "initiative" SET "multistage_majority" = TRUE
5955 FROM (
5956 SELECT "losing_initiative"."id" AS "initiative_id"
5957 FROM "initiative" "losing_initiative"
5958 JOIN "initiative" "winning_initiative"
5959 ON "winning_initiative"."issue_id" = "issue_id_p"
5960 AND "winning_initiative"."admitted"
5961 JOIN "battle" "battle_win"
5962 ON "battle_win"."issue_id" = "issue_id_p"
5963 AND "battle_win"."winning_initiative_id" = "winning_initiative"."id"
5964 AND "battle_win"."losing_initiative_id" = "losing_initiative"."id"
5965 JOIN "battle" "battle_lose"
5966 ON "battle_lose"."issue_id" = "issue_id_p"
5967 AND "battle_lose"."losing_initiative_id" = "winning_initiative"."id"
5968 AND "battle_lose"."winning_initiative_id" = "losing_initiative"."id"
5969 WHERE "losing_initiative"."issue_id" = "issue_id_p"
5970 AND "losing_initiative"."admitted"
5971 AND "winning_initiative"."schulze_rank" <
5972 "losing_initiative"."schulze_rank"
5973 AND "battle_win"."count" > "battle_lose"."count"
5974 AND (
5975 "battle_win"."count" > "winning_initiative"."positive_votes" OR
5976 "battle_lose"."count" < "losing_initiative"."negative_votes" )
5977 ) AS "subquery"
5978 WHERE "id" = "subquery"."initiative_id";
5979 -- mark eligible initiatives:
5980 UPDATE "initiative" SET "eligible" = TRUE
5981 WHERE "issue_id" = "issue_id_p"
5982 AND "initiative"."direct_majority"
5983 AND "initiative"."indirect_majority"
5984 AND "initiative"."better_than_status_quo"
5985 AND (
5986 "policy_row"."no_multistage_majority" = FALSE OR
5987 "initiative"."multistage_majority" = FALSE )
5988 AND (
5989 "policy_row"."no_reverse_beat_path" = FALSE OR
5990 coalesce("initiative"."reverse_beat_path", FALSE) = FALSE );
5991 -- mark final winner:
5992 UPDATE "initiative" SET "winner" = TRUE
5993 FROM (
5994 SELECT "id" AS "initiative_id"
5995 FROM "initiative"
5996 WHERE "issue_id" = "issue_id_p" AND "eligible"
5997 ORDER BY
5998 "schulze_rank",
5999 "id"
6000 LIMIT 1
6001 ) AS "subquery"
6002 WHERE "id" = "subquery"."initiative_id";
6003 -- write (final) ranks:
6004 "rank_v" := 1;
6005 FOR "initiative_id_v" IN
6006 SELECT "id"
6007 FROM "initiative"
6008 WHERE "issue_id" = "issue_id_p" AND "admitted"
6009 ORDER BY
6010 "winner" DESC,
6011 "eligible" DESC,
6012 "schulze_rank",
6013 "id"
6014 LOOP
6015 UPDATE "initiative" SET "rank" = "rank_v"
6016 WHERE "id" = "initiative_id_v";
6017 "rank_v" := "rank_v" + 1;
6018 END LOOP;
6019 -- set schulze rank of status quo and mark issue as finished:
6020 UPDATE "issue" SET
6021 "status_quo_schulze_rank" = "rank_ary"[1],
6022 "state" =
6023 CASE WHEN EXISTS (
6024 SELECT NULL FROM "initiative"
6025 WHERE "issue_id" = "issue_id_p" AND "winner"
6026 ) THEN
6027 'finished_with_winner'::"issue_state"
6028 ELSE
6029 'finished_without_winner'::"issue_state"
6030 END,
6031 "closed" = "phase_finished",
6032 "phase_finished" = NULL
6033 WHERE "id" = "issue_id_p";
6034 RETURN;
6035 END;
6036 $$;
6038 COMMENT ON FUNCTION "calculate_ranks"
6039 ( "issue"."id"%TYPE )
6040 IS 'Determine ranking (Votes have to be counted first)';
6044 -----------------------------
6045 -- Automatic state changes --
6046 -----------------------------
6049 CREATE FUNCTION "issue_admission"
6050 ( "area_id_p" "area"."id"%TYPE )
6051 RETURNS BOOLEAN
6052 LANGUAGE 'plpgsql' VOLATILE AS $$
6053 DECLARE
6054 "issue_id_v" "issue"."id"%TYPE;
6055 BEGIN
6056 PERFORM "dont_require_transaction_isolation"();
6057 LOCK TABLE "snapshot" IN EXCLUSIVE MODE;
6058 UPDATE "area" SET "issue_quorum" = "view"."issue_quorum"
6059 FROM "area_quorum" AS "view"
6060 WHERE "area"."id" = "view"."area_id"
6061 AND "area"."id" = "area_id_p";
6062 SELECT "id" INTO "issue_id_v" FROM "issue_for_admission"
6063 WHERE "area_id" = "area_id_p";
6064 IF "issue_id_v" ISNULL THEN RETURN FALSE; END IF;
6065 UPDATE "issue" SET
6066 "admission_snapshot_id" = "latest_snapshot_id",
6067 "state" = 'discussion',
6068 "accepted" = now(),
6069 "phase_finished" = NULL,
6070 "issue_quorum" = "issue_quorum"."issue_quorum"
6071 FROM "issue_quorum"
6072 WHERE "id" = "issue_id_v"
6073 AND "issue_quorum"."issue_id" = "issue_id_v";
6074 RETURN TRUE;
6075 END;
6076 $$;
6078 COMMENT ON FUNCTION "issue_admission"
6079 ( "area"."id"%TYPE )
6080 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';
6083 CREATE TYPE "check_issue_persistence" AS (
6084 "state" "issue_state",
6085 "phase_finished" BOOLEAN,
6086 "issue_revoked" BOOLEAN,
6087 "snapshot_created" BOOLEAN,
6088 "harmonic_weights_set" BOOLEAN,
6089 "closed_voting" BOOLEAN );
6091 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';
6094 CREATE FUNCTION "check_issue"
6095 ( "issue_id_p" "issue"."id"%TYPE,
6096 "persist" "check_issue_persistence" )
6097 RETURNS "check_issue_persistence"
6098 LANGUAGE 'plpgsql' VOLATILE AS $$
6099 DECLARE
6100 "issue_row" "issue"%ROWTYPE;
6101 "last_calculated_v" "snapshot"."calculated"%TYPE;
6102 "policy_row" "policy"%ROWTYPE;
6103 "initiative_row" "initiative"%ROWTYPE;
6104 "state_v" "issue_state";
6105 BEGIN
6106 PERFORM "require_transaction_isolation"();
6107 IF "persist" ISNULL THEN
6108 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
6109 FOR UPDATE;
6110 SELECT "calculated" INTO "last_calculated_v"
6111 FROM "snapshot" JOIN "snapshot_issue"
6112 ON "snapshot"."id" = "snapshot_issue"."snapshot_id"
6113 WHERE "snapshot_issue"."issue_id" = "issue_id_p";
6114 IF "issue_row"."closed" NOTNULL THEN
6115 RETURN NULL;
6116 END IF;
6117 "persist"."state" := "issue_row"."state";
6118 IF
6119 ( "issue_row"."state" = 'admission' AND "last_calculated_v" >=
6120 "issue_row"."created" + "issue_row"."max_admission_time" ) OR
6121 ( "issue_row"."state" = 'discussion' AND now() >=
6122 "issue_row"."accepted" + "issue_row"."discussion_time" ) OR
6123 ( "issue_row"."state" = 'verification' AND now() >=
6124 "issue_row"."half_frozen" + "issue_row"."verification_time" ) OR
6125 ( "issue_row"."state" = 'voting' AND now() >=
6126 "issue_row"."fully_frozen" + "issue_row"."voting_time" )
6127 THEN
6128 "persist"."phase_finished" := TRUE;
6129 ELSE
6130 "persist"."phase_finished" := FALSE;
6131 END IF;
6132 IF
6133 NOT EXISTS (
6134 -- all initiatives are revoked
6135 SELECT NULL FROM "initiative"
6136 WHERE "issue_id" = "issue_id_p" AND "revoked" ISNULL
6137 ) AND (
6138 -- and issue has not been accepted yet
6139 "persist"."state" = 'admission' OR
6140 -- or verification time has elapsed
6141 ( "persist"."state" = 'verification' AND
6142 "persist"."phase_finished" ) OR
6143 -- or no initiatives have been revoked lately
6144 NOT EXISTS (
6145 SELECT NULL FROM "initiative"
6146 WHERE "issue_id" = "issue_id_p"
6147 AND now() < "revoked" + "issue_row"."verification_time"
6148 )
6149 )
6150 THEN
6151 "persist"."issue_revoked" := TRUE;
6152 ELSE
6153 "persist"."issue_revoked" := FALSE;
6154 END IF;
6155 IF "persist"."phase_finished" OR "persist"."issue_revoked" THEN
6156 UPDATE "issue" SET "phase_finished" = now()
6157 WHERE "id" = "issue_row"."id";
6158 RETURN "persist";
6159 ELSIF
6160 "persist"."state" IN ('admission', 'discussion', 'verification')
6161 THEN
6162 RETURN "persist";
6163 ELSE
6164 RETURN NULL;
6165 END IF;
6166 END IF;
6167 IF
6168 "persist"."state" IN ('admission', 'discussion', 'verification') AND
6169 coalesce("persist"."snapshot_created", FALSE) = FALSE
6170 THEN
6171 IF "persist"."state" != 'admission' THEN
6172 PERFORM "take_snapshot"("issue_id_p");
6173 PERFORM "finish_snapshot"("issue_id_p");
6174 ELSE
6175 UPDATE "issue" SET "issue_quorum" = "issue_quorum"."issue_quorum"
6176 FROM "issue_quorum"
6177 WHERE "id" = "issue_id_p"
6178 AND "issue_quorum"."issue_id" = "issue_id_p";
6179 END IF;
6180 "persist"."snapshot_created" = TRUE;
6181 IF "persist"."phase_finished" THEN
6182 IF "persist"."state" = 'admission' THEN
6183 UPDATE "issue" SET "admission_snapshot_id" = "latest_snapshot_id"
6184 WHERE "id" = "issue_id_p";
6185 ELSIF "persist"."state" = 'discussion' THEN
6186 UPDATE "issue" SET "half_freeze_snapshot_id" = "latest_snapshot_id"
6187 WHERE "id" = "issue_id_p";
6188 ELSIF "persist"."state" = 'verification' THEN
6189 UPDATE "issue" SET "full_freeze_snapshot_id" = "latest_snapshot_id"
6190 WHERE "id" = "issue_id_p";
6191 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
6192 FOR "initiative_row" IN
6193 SELECT * FROM "initiative"
6194 WHERE "issue_id" = "issue_id_p" AND "revoked" ISNULL
6195 FOR UPDATE
6196 LOOP
6197 IF
6198 "initiative_row"."polling" OR
6199 "initiative_row"."satisfied_supporter_count" >=
6200 "issue_row"."initiative_quorum"
6201 THEN
6202 UPDATE "initiative" SET "admitted" = TRUE
6203 WHERE "id" = "initiative_row"."id";
6204 ELSE
6205 UPDATE "initiative" SET "admitted" = FALSE
6206 WHERE "id" = "initiative_row"."id";
6207 END IF;
6208 END LOOP;
6209 END IF;
6210 END IF;
6211 RETURN "persist";
6212 END IF;
6213 IF
6214 "persist"."state" IN ('admission', 'discussion', 'verification') AND
6215 coalesce("persist"."harmonic_weights_set", FALSE) = FALSE
6216 THEN
6217 PERFORM "set_harmonic_initiative_weights"("issue_id_p");
6218 "persist"."harmonic_weights_set" = TRUE;
6219 IF
6220 "persist"."phase_finished" OR
6221 "persist"."issue_revoked" OR
6222 "persist"."state" = 'admission'
6223 THEN
6224 RETURN "persist";
6225 ELSE
6226 RETURN NULL;
6227 END IF;
6228 END IF;
6229 IF "persist"."issue_revoked" THEN
6230 IF "persist"."state" = 'admission' THEN
6231 "state_v" := 'canceled_revoked_before_accepted';
6232 ELSIF "persist"."state" = 'discussion' THEN
6233 "state_v" := 'canceled_after_revocation_during_discussion';
6234 ELSIF "persist"."state" = 'verification' THEN
6235 "state_v" := 'canceled_after_revocation_during_verification';
6236 END IF;
6237 UPDATE "issue" SET
6238 "state" = "state_v",
6239 "closed" = "phase_finished",
6240 "phase_finished" = NULL
6241 WHERE "id" = "issue_id_p";
6242 RETURN NULL;
6243 END IF;
6244 IF "persist"."state" = 'admission' THEN
6245 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
6246 FOR UPDATE;
6247 IF "issue_row"."phase_finished" NOTNULL THEN
6248 UPDATE "issue" SET
6249 "state" = 'canceled_issue_not_accepted',
6250 "closed" = "phase_finished",
6251 "phase_finished" = NULL
6252 WHERE "id" = "issue_id_p";
6253 END IF;
6254 RETURN NULL;
6255 END IF;
6256 IF "persist"."phase_finished" THEN
6257 IF "persist"."state" = 'discussion' THEN
6258 UPDATE "issue" SET
6259 "state" = 'verification',
6260 "half_frozen" = "phase_finished",
6261 "phase_finished" = NULL
6262 WHERE "id" = "issue_id_p";
6263 RETURN NULL;
6264 END IF;
6265 IF "persist"."state" = 'verification' THEN
6266 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
6267 FOR UPDATE;
6268 SELECT * INTO "policy_row" FROM "policy"
6269 WHERE "id" = "issue_row"."policy_id";
6270 IF EXISTS (
6271 SELECT NULL FROM "initiative"
6272 WHERE "issue_id" = "issue_id_p" AND "admitted" = TRUE
6273 ) THEN
6274 UPDATE "issue" SET
6275 "state" = 'voting',
6276 "fully_frozen" = "phase_finished",
6277 "phase_finished" = NULL
6278 WHERE "id" = "issue_id_p";
6279 ELSE
6280 UPDATE "issue" SET
6281 "state" = 'canceled_no_initiative_admitted',
6282 "fully_frozen" = "phase_finished",
6283 "closed" = "phase_finished",
6284 "phase_finished" = NULL
6285 WHERE "id" = "issue_id_p";
6286 -- NOTE: The following DELETE statements have effect only when
6287 -- issue state has been manipulated
6288 DELETE FROM "direct_voter" WHERE "issue_id" = "issue_id_p";
6289 DELETE FROM "delegating_voter" WHERE "issue_id" = "issue_id_p";
6290 DELETE FROM "battle" WHERE "issue_id" = "issue_id_p";
6291 END IF;
6292 RETURN NULL;
6293 END IF;
6294 IF "persist"."state" = 'voting' THEN
6295 IF coalesce("persist"."closed_voting", FALSE) = FALSE THEN
6296 PERFORM "close_voting"("issue_id_p");
6297 "persist"."closed_voting" = TRUE;
6298 RETURN "persist";
6299 END IF;
6300 PERFORM "calculate_ranks"("issue_id_p");
6301 RETURN NULL;
6302 END IF;
6303 END IF;
6304 RAISE WARNING 'should not happen';
6305 RETURN NULL;
6306 END;
6307 $$;
6309 COMMENT ON FUNCTION "check_issue"
6310 ( "issue"."id"%TYPE,
6311 "check_issue_persistence" )
6312 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")';
6315 CREATE FUNCTION "check_everything"()
6316 RETURNS VOID
6317 LANGUAGE 'plpgsql' VOLATILE AS $$
6318 DECLARE
6319 "area_id_v" "area"."id"%TYPE;
6320 "snapshot_id_v" "snapshot"."id"%TYPE;
6321 "issue_id_v" "issue"."id"%TYPE;
6322 "persist_v" "check_issue_persistence";
6323 BEGIN
6324 RAISE WARNING 'Function "check_everything" should only be used for development and debugging purposes';
6325 DELETE FROM "expired_session";
6326 DELETE FROM "expired_token";
6327 DELETE FROM "expired_snapshot";
6328 PERFORM "check_activity"();
6329 PERFORM "calculate_member_counts"();
6330 FOR "area_id_v" IN SELECT "id" FROM "area_with_unaccepted_issues" LOOP
6331 SELECT "take_snapshot"(NULL, "area_id_v") INTO "snapshot_id_v";
6332 PERFORM "finish_snapshot"("issue_id") FROM "snapshot_issue"
6333 WHERE "snapshot_id" = "snapshot_id_v";
6334 LOOP
6335 EXIT WHEN "issue_admission"("area_id_v") = FALSE;
6336 END LOOP;
6337 END LOOP;
6338 FOR "issue_id_v" IN SELECT "id" FROM "open_issue" LOOP
6339 "persist_v" := NULL;
6340 LOOP
6341 "persist_v" := "check_issue"("issue_id_v", "persist_v");
6342 EXIT WHEN "persist_v" ISNULL;
6343 END LOOP;
6344 END LOOP;
6345 RETURN;
6346 END;
6347 $$;
6349 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';
6353 ----------------------
6354 -- Deletion of data --
6355 ----------------------
6358 CREATE FUNCTION "clean_issue"("issue_id_p" "issue"."id"%TYPE)
6359 RETURNS VOID
6360 LANGUAGE 'plpgsql' VOLATILE AS $$
6361 BEGIN
6362 IF EXISTS (
6363 SELECT NULL FROM "issue" WHERE "id" = "issue_id_p" AND "cleaned" ISNULL
6364 ) THEN
6365 -- override protection triggers:
6366 INSERT INTO "temporary_transaction_data" ("key", "value")
6367 VALUES ('override_protection_triggers', TRUE::TEXT);
6368 -- clean data:
6369 DELETE FROM "delegating_voter"
6370 WHERE "issue_id" = "issue_id_p";
6371 DELETE FROM "direct_voter"
6372 WHERE "issue_id" = "issue_id_p";
6373 DELETE FROM "delegating_interest_snapshot"
6374 WHERE "issue_id" = "issue_id_p";
6375 DELETE FROM "direct_interest_snapshot"
6376 WHERE "issue_id" = "issue_id_p";
6377 DELETE FROM "non_voter"
6378 WHERE "issue_id" = "issue_id_p";
6379 DELETE FROM "delegation"
6380 WHERE "issue_id" = "issue_id_p";
6381 DELETE FROM "supporter"
6382 USING "initiative" -- NOTE: due to missing index on issue_id
6383 WHERE "initiative"."issue_id" = "issue_id_p"
6384 AND "supporter"."initiative_id" = "initiative_id";
6385 -- mark issue as cleaned:
6386 UPDATE "issue" SET "cleaned" = now() WHERE "id" = "issue_id_p";
6387 -- finish overriding protection triggers (avoids garbage):
6388 DELETE FROM "temporary_transaction_data"
6389 WHERE "key" = 'override_protection_triggers';
6390 END IF;
6391 RETURN;
6392 END;
6393 $$;
6395 COMMENT ON FUNCTION "clean_issue"("issue"."id"%TYPE) IS 'Delete discussion data and votes belonging to an issue';
6398 CREATE FUNCTION "delete_member"("member_id_p" "member"."id"%TYPE)
6399 RETURNS VOID
6400 LANGUAGE 'plpgsql' VOLATILE AS $$
6401 BEGIN
6402 UPDATE "member" SET
6403 "last_login" = NULL,
6404 "last_delegation_check" = NULL,
6405 "login" = NULL,
6406 "password" = NULL,
6407 "authority" = NULL,
6408 "authority_uid" = NULL,
6409 "authority_login" = NULL,
6410 "deleted" = coalesce("deleted", now()),
6411 "locked" = TRUE,
6412 "active" = FALSE,
6413 "notify_email" = NULL,
6414 "notify_email_unconfirmed" = NULL,
6415 "notify_email_secret" = NULL,
6416 "notify_email_secret_expiry" = NULL,
6417 "notify_email_lock_expiry" = NULL,
6418 "disable_notifications" = TRUE,
6419 "notification_counter" = DEFAULT,
6420 "notification_sample_size" = 0,
6421 "notification_dow" = NULL,
6422 "notification_hour" = NULL,
6423 "notification_sent" = NULL,
6424 "login_recovery_expiry" = NULL,
6425 "password_reset_secret" = NULL,
6426 "password_reset_secret_expiry" = NULL,
6427 "location" = NULL
6428 WHERE "id" = "member_id_p";
6429 -- "text_search_data" is updated by triggers
6430 DELETE FROM "member_settings" WHERE "member_id" = "member_id_p";
6431 DELETE FROM "member_profile" WHERE "member_id" = "member_id_p";
6432 DELETE FROM "rendered_member_statement" WHERE "member_id" = "member_id_p";
6433 DELETE FROM "member_image" WHERE "member_id" = "member_id_p";
6434 DELETE FROM "contact" WHERE "member_id" = "member_id_p";
6435 DELETE FROM "ignored_member" WHERE "member_id" = "member_id_p";
6436 DELETE FROM "session" WHERE "member_id" = "member_id_p";
6437 DELETE FROM "member_application" WHERE "member_id" = "member_id_p";
6438 DELETE FROM "token" WHERE "member_id" = "member_id_p";
6439 DELETE FROM "subscription" WHERE "member_id" = "member_id_p";
6440 DELETE FROM "ignored_area" WHERE "member_id" = "member_id_p";
6441 DELETE FROM "ignored_initiative" WHERE "member_id" = "member_id_p";
6442 DELETE FROM "delegation" WHERE "truster_id" = "member_id_p";
6443 DELETE FROM "non_voter" WHERE "member_id" = "member_id_p";
6444 DELETE FROM "direct_voter" USING "issue"
6445 WHERE "direct_voter"."issue_id" = "issue"."id"
6446 AND "issue"."closed" ISNULL
6447 AND "member_id" = "member_id_p";
6448 DELETE FROM "notification_initiative_sent" WHERE "member_id" = "member_id_p";
6449 RETURN;
6450 END;
6451 $$;
6453 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)';
6456 CREATE FUNCTION "delete_private_data"()
6457 RETURNS VOID
6458 LANGUAGE 'plpgsql' VOLATILE AS $$
6459 BEGIN
6460 DELETE FROM "temporary_transaction_data";
6461 DELETE FROM "temporary_suggestion_counts";
6462 DELETE FROM "member" WHERE "activated" ISNULL;
6463 UPDATE "member" SET
6464 "invite_code" = NULL,
6465 "invite_code_expiry" = NULL,
6466 "admin_comment" = NULL,
6467 "last_login" = NULL,
6468 "last_delegation_check" = NULL,
6469 "login" = NULL,
6470 "password" = NULL,
6471 "authority" = NULL,
6472 "authority_uid" = NULL,
6473 "authority_login" = NULL,
6474 "lang" = NULL,
6475 "notify_email" = NULL,
6476 "notify_email_unconfirmed" = NULL,
6477 "notify_email_secret" = NULL,
6478 "notify_email_secret_expiry" = NULL,
6479 "notify_email_lock_expiry" = NULL,
6480 "disable_notifications" = TRUE,
6481 "notification_counter" = DEFAULT,
6482 "notification_sample_size" = 0,
6483 "notification_dow" = NULL,
6484 "notification_hour" = NULL,
6485 "notification_sent" = NULL,
6486 "login_recovery_expiry" = NULL,
6487 "password_reset_secret" = NULL,
6488 "password_reset_secret_expiry" = NULL,
6489 "location" = NULL;
6490 -- "text_search_data" is updated by triggers
6491 DELETE FROM "verification";
6492 DELETE FROM "member_settings";
6493 DELETE FROM "member_useterms";
6494 DELETE FROM "member_profile";
6495 DELETE FROM "rendered_member_statement";
6496 DELETE FROM "member_image";
6497 DELETE FROM "contact";
6498 DELETE FROM "ignored_member";
6499 DELETE FROM "session";
6500 DELETE FROM "system_application";
6501 DELETE FROM "system_application_redirect_uri";
6502 DELETE FROM "dynamic_application_scope";
6503 DELETE FROM "member_application";
6504 DELETE FROM "token";
6505 DELETE FROM "subscription";
6506 DELETE FROM "ignored_area";
6507 DELETE FROM "ignored_initiative";
6508 DELETE FROM "non_voter";
6509 DELETE FROM "direct_voter" USING "issue"
6510 WHERE "direct_voter"."issue_id" = "issue"."id"
6511 AND "issue"."closed" ISNULL;
6512 DELETE FROM "event_processed";
6513 DELETE FROM "notification_initiative_sent";
6514 DELETE FROM "newsletter";
6515 RETURN;
6516 END;
6517 $$;
6519 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.';
6523 COMMIT;