liquid_feedback_core
view core.sql @ 96:07e6a4f11b5b
Removed unneccessary JOIN in "create_interest_snapshot"(...)
The INSERT INTO "direct_supporter_snapshot" in function "create_interest_snapshot"(...) does not need to check if members are active.
The previous step ensures that the joined table "direct_interest_snapshot" does not contain entries from disabled members.
The INSERT INTO "direct_supporter_snapshot" in function "create_interest_snapshot"(...) does not need to check if members are active.
The previous step ensures that the joined table "direct_interest_snapshot" does not contain entries from disabled members.
| author | jbe |
|---|---|
| date | Mon Dec 06 23:50:32 2010 +0100 (2010-12-06) |
| parents | fb9688f31740 |
| children | 58451b5565ae 46260129d0ce |
line source
2 -- Execute the following command manually for PostgreSQL prior version 9.0:
3 -- CREATE LANGUAGE plpgsql;
5 -- NOTE: In PostgreSQL every UNIQUE constraint implies creation of an index
7 BEGIN;
9 CREATE VIEW "liquid_feedback_version" AS
10 SELECT * FROM (VALUES ('1.3.0', 1, 3, 0))
11 AS "subquery"("string", "major", "minor", "revision");
15 ----------------------
16 -- Full text search --
17 ----------------------
20 CREATE FUNCTION "text_search_query"("query_text_p" TEXT)
21 RETURNS TSQUERY
22 LANGUAGE 'plpgsql' IMMUTABLE AS $$
23 BEGIN
24 RETURN plainto_tsquery('pg_catalog.simple', "query_text_p");
25 END;
26 $$;
28 COMMENT ON FUNCTION "text_search_query"(TEXT) IS 'Usage: WHERE "text_search_data" @@ "text_search_query"(''<user query>'')';
31 CREATE FUNCTION "highlight"
32 ( "body_p" TEXT,
33 "query_text_p" TEXT )
34 RETURNS TEXT
35 LANGUAGE 'plpgsql' IMMUTABLE AS $$
36 BEGIN
37 RETURN ts_headline(
38 'pg_catalog.simple',
39 replace(replace("body_p", e'\\', e'\\\\'), '*', e'\\*'),
40 "text_search_query"("query_text_p"),
41 'StartSel=* StopSel=* HighlightAll=TRUE' );
42 END;
43 $$;
45 COMMENT ON FUNCTION "highlight"
46 ( "body_p" TEXT,
47 "query_text_p" TEXT )
48 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.';
52 -------------------------
53 -- Tables and indicies --
54 -------------------------
57 CREATE TABLE "member" (
58 "id" SERIAL4 PRIMARY KEY,
59 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
60 "last_login" TIMESTAMPTZ,
61 "login" TEXT UNIQUE,
62 "password" TEXT,
63 "active" BOOLEAN NOT NULL DEFAULT TRUE,
64 "admin" BOOLEAN NOT NULL DEFAULT FALSE,
65 "notify_email" TEXT,
66 "notify_email_unconfirmed" TEXT,
67 "notify_email_secret" TEXT UNIQUE,
68 "notify_email_secret_expiry" TIMESTAMPTZ,
69 "notify_email_lock_expiry" TIMESTAMPTZ,
70 "password_reset_secret" TEXT UNIQUE,
71 "password_reset_secret_expiry" TIMESTAMPTZ,
72 "name" TEXT NOT NULL UNIQUE,
73 "identification" TEXT UNIQUE,
74 "organizational_unit" TEXT,
75 "internal_posts" TEXT,
76 "realname" TEXT,
77 "birthday" DATE,
78 "address" TEXT,
79 "email" TEXT,
80 "xmpp_address" TEXT,
81 "website" TEXT,
82 "phone" TEXT,
83 "mobile_phone" TEXT,
84 "profession" TEXT,
85 "external_memberships" TEXT,
86 "external_posts" TEXT,
87 "statement" TEXT,
88 "text_search_data" TSVECTOR );
89 CREATE INDEX "member_active_idx" ON "member" ("active");
90 CREATE INDEX "member_text_search_data_idx" ON "member" USING gin ("text_search_data");
91 CREATE TRIGGER "update_text_search_data"
92 BEFORE INSERT OR UPDATE ON "member"
93 FOR EACH ROW EXECUTE PROCEDURE
94 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
95 "name", "identification", "organizational_unit", "internal_posts",
96 "realname", "external_memberships", "external_posts", "statement" );
98 COMMENT ON TABLE "member" IS 'Users of the system, e.g. members of an organization';
100 COMMENT ON COLUMN "member"."login" IS 'Login name';
101 COMMENT ON COLUMN "member"."password" IS 'Password (preferably as crypto-hash, depending on the frontend or access layer)';
102 COMMENT ON COLUMN "member"."active" IS 'Inactive members can not login and their supports/votes are not counted by the system.';
103 COMMENT ON COLUMN "member"."admin" IS 'TRUE for admins, which can administrate other users and setup policies and areas';
104 COMMENT ON COLUMN "member"."notify_email" IS 'Email address where notifications of the system are sent to';
105 COMMENT ON COLUMN "member"."notify_email_unconfirmed" IS 'Unconfirmed email address provided by the member to be copied into "notify_email" field after verification';
106 COMMENT ON COLUMN "member"."notify_email_secret" IS 'Secret sent to the address in "notify_email_unconformed"';
107 COMMENT ON COLUMN "member"."notify_email_secret_expiry" IS 'Expiry date/time for "notify_email_secret"';
108 COMMENT ON COLUMN "member"."notify_email_lock_expiry" IS 'Date/time until no further email confirmation mails may be sent (abuse protection)';
109 COMMENT ON COLUMN "member"."name" IS 'Distinct name of the member';
110 COMMENT ON COLUMN "member"."identification" IS 'Optional identification number or code of the member';
111 COMMENT ON COLUMN "member"."organizational_unit" IS 'Branch or division of the organization the member belongs to';
112 COMMENT ON COLUMN "member"."internal_posts" IS 'Posts (offices) of the member inside the organization';
113 COMMENT ON COLUMN "member"."realname" IS 'Real name of the member, may be identical with "name"';
114 COMMENT ON COLUMN "member"."email" IS 'Published email address of the member; not used for system notifications';
115 COMMENT ON COLUMN "member"."external_memberships" IS 'Other organizations the member is involved in';
116 COMMENT ON COLUMN "member"."external_posts" IS 'Posts (offices) outside the organization';
117 COMMENT ON COLUMN "member"."statement" IS 'Freely chosen text of the member for his homepage within the system';
120 CREATE TABLE "member_history" (
121 "id" SERIAL8 PRIMARY KEY,
122 "member_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
123 "until" TIMESTAMPTZ NOT NULL DEFAULT now(),
124 "active" BOOLEAN NOT NULL,
125 "name" TEXT NOT NULL );
126 CREATE INDEX "member_history_member_id_idx" ON "member_history" ("member_id");
128 COMMENT ON TABLE "member_history" IS 'Filled by trigger; keeps information about old names and active flag of members';
130 COMMENT ON COLUMN "member_history"."id" IS 'Primary key, which can be used to sort entries correctly (and time warp resistant)';
131 COMMENT ON COLUMN "member_history"."until" IS 'Timestamp until the data was valid';
134 CREATE TABLE "invite_code" (
135 "code" TEXT PRIMARY KEY,
136 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
137 "used" TIMESTAMPTZ,
138 "member_id" INT4 UNIQUE REFERENCES "member" ("id") ON DELETE SET NULL ON UPDATE CASCADE,
139 "comment" TEXT,
140 CONSTRAINT "only_used_codes_may_refer_to_member" CHECK ("used" NOTNULL OR "member_id" ISNULL) );
142 COMMENT ON TABLE "invite_code" IS 'Invite codes can be used once to create a new member account.';
144 COMMENT ON COLUMN "invite_code"."code" IS 'Secret code';
145 COMMENT ON COLUMN "invite_code"."created" IS 'Time of creation of the secret code';
146 COMMENT ON COLUMN "invite_code"."used" IS 'NULL, if not used yet, otherwise tells when this code was used to create a member account';
147 COMMENT ON COLUMN "invite_code"."member_id" IS 'References the member whose account was created with this code';
148 COMMENT ON COLUMN "invite_code"."comment" IS 'Comment on the code, which is to be used for administrative reasons only';
151 CREATE TABLE "setting" (
152 PRIMARY KEY ("member_id", "key"),
153 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
154 "key" TEXT NOT NULL,
155 "value" TEXT NOT NULL );
156 CREATE INDEX "setting_key_idx" ON "setting" ("key");
158 COMMENT ON TABLE "setting" IS 'Place to store a frontend specific setting for members as a string';
160 COMMENT ON COLUMN "setting"."key" IS 'Name of the setting, preceded by a frontend specific prefix';
163 CREATE TABLE "setting_map" (
164 PRIMARY KEY ("member_id", "key", "subkey"),
165 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
166 "key" TEXT NOT NULL,
167 "subkey" TEXT NOT NULL,
168 "value" TEXT NOT NULL );
169 CREATE INDEX "setting_map_key_idx" ON "setting_map" ("key");
171 COMMENT ON TABLE "setting_map" IS 'Place to store a frontend specific setting for members as a map of key value pairs';
173 COMMENT ON COLUMN "setting_map"."key" IS 'Name of the setting, preceded by a frontend specific prefix';
174 COMMENT ON COLUMN "setting_map"."subkey" IS 'Key of a map entry';
175 COMMENT ON COLUMN "setting_map"."value" IS 'Value of a map entry';
178 CREATE TABLE "member_relation_setting" (
179 PRIMARY KEY ("member_id", "key", "other_member_id"),
180 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
181 "key" TEXT NOT NULL,
182 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
183 "value" TEXT NOT NULL );
185 COMMENT ON TABLE "member_relation_setting" IS 'Place to store a frontend specific setting related to relations between members as a string';
188 CREATE TYPE "member_image_type" AS ENUM ('photo', 'avatar');
190 COMMENT ON TYPE "member_image_type" IS 'Types of images for a member';
193 CREATE TABLE "member_image" (
194 PRIMARY KEY ("member_id", "image_type", "scaled"),
195 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
196 "image_type" "member_image_type",
197 "scaled" BOOLEAN,
198 "content_type" TEXT,
199 "data" BYTEA NOT NULL );
201 COMMENT ON TABLE "member_image" IS 'Images of members';
203 COMMENT ON COLUMN "member_image"."scaled" IS 'FALSE for original image, TRUE for scaled version of the image';
206 CREATE TABLE "member_count" (
207 "calculated" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
208 "total_count" INT4 NOT NULL );
210 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';
212 COMMENT ON COLUMN "member_count"."calculated" IS 'timestamp indicating when the total member count and area member counts were calculated';
213 COMMENT ON COLUMN "member_count"."total_count" IS 'Total count of active(!) members';
216 CREATE TABLE "contact" (
217 PRIMARY KEY ("member_id", "other_member_id"),
218 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
219 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
220 "public" BOOLEAN NOT NULL DEFAULT FALSE,
221 CONSTRAINT "cant_save_yourself_as_contact"
222 CHECK ("member_id" != "other_member_id") );
224 COMMENT ON TABLE "contact" IS 'Contact lists';
226 COMMENT ON COLUMN "contact"."member_id" IS 'Member having the contact list';
227 COMMENT ON COLUMN "contact"."other_member_id" IS 'Member referenced in the contact list';
228 COMMENT ON COLUMN "contact"."public" IS 'TRUE = display contact publically';
231 CREATE TABLE "session" (
232 "ident" TEXT PRIMARY KEY,
233 "additional_secret" TEXT,
234 "expiry" TIMESTAMPTZ NOT NULL DEFAULT now() + '24 hours',
235 "member_id" INT8 REFERENCES "member" ("id") ON DELETE SET NULL,
236 "lang" TEXT );
237 CREATE INDEX "session_expiry_idx" ON "session" ("expiry");
239 COMMENT ON TABLE "session" IS 'Sessions, i.e. for a web-frontend';
241 COMMENT ON COLUMN "session"."ident" IS 'Secret session identifier (i.e. random string)';
242 COMMENT ON COLUMN "session"."additional_secret" IS 'Additional field to store a secret, which can be used against CSRF attacks';
243 COMMENT ON COLUMN "session"."member_id" IS 'Reference to member, who is logged in';
244 COMMENT ON COLUMN "session"."lang" IS 'Language code of the selected language';
247 CREATE TABLE "policy" (
248 "id" SERIAL4 PRIMARY KEY,
249 "index" INT4 NOT NULL,
250 "active" BOOLEAN NOT NULL DEFAULT TRUE,
251 "name" TEXT NOT NULL UNIQUE,
252 "description" TEXT NOT NULL DEFAULT '',
253 "admission_time" INTERVAL NOT NULL,
254 "discussion_time" INTERVAL NOT NULL,
255 "verification_time" INTERVAL NOT NULL,
256 "voting_time" INTERVAL NOT NULL,
257 "issue_quorum_num" INT4 NOT NULL,
258 "issue_quorum_den" INT4 NOT NULL,
259 "initiative_quorum_num" INT4 NOT NULL,
260 "initiative_quorum_den" INT4 NOT NULL,
261 "majority_num" INT4 NOT NULL DEFAULT 1,
262 "majority_den" INT4 NOT NULL DEFAULT 2,
263 "majority_strict" BOOLEAN NOT NULL DEFAULT TRUE );
264 CREATE INDEX "policy_active_idx" ON "policy" ("active");
266 COMMENT ON TABLE "policy" IS 'Policies for a particular proceeding type (timelimits, quorum)';
268 COMMENT ON COLUMN "policy"."index" IS 'Determines the order in listings';
269 COMMENT ON COLUMN "policy"."active" IS 'TRUE = policy can be used for new issues';
270 COMMENT ON COLUMN "policy"."admission_time" IS 'Maximum time an issue stays open without being "accepted"';
271 COMMENT ON COLUMN "policy"."discussion_time" IS 'Regular time until an issue is "half_frozen" after being "accepted"';
272 COMMENT ON COLUMN "policy"."verification_time" IS 'Regular time until an issue is "fully_frozen" after being "half_frozen"';
273 COMMENT ON COLUMN "policy"."voting_time" IS 'Time after an issue is "fully_frozen" but not "closed"';
274 COMMENT ON COLUMN "policy"."issue_quorum_num" IS 'Numerator of potential supporter quorum to be reached by one initiative of an issue to be "accepted"';
275 COMMENT ON COLUMN "policy"."issue_quorum_den" IS 'Denominator of potential supporter quorum to be reached by one initiative of an issue to be "accepted"';
276 COMMENT ON COLUMN "policy"."initiative_quorum_num" IS 'Numerator of satisfied supporter quorum to be reached by an initiative to be "admitted" for voting';
277 COMMENT ON COLUMN "policy"."initiative_quorum_den" IS 'Denominator of satisfied supporter quorum to be reached by an initiative to be "admitted" for voting';
278 COMMENT ON COLUMN "policy"."majority_num" IS 'Numerator of fraction of majority to be reached during voting by an initiative to be aggreed upon';
279 COMMENT ON COLUMN "policy"."majority_den" IS 'Denominator of fraction of majority to be reached during voting by an initiative to be aggreed upon';
280 COMMENT ON COLUMN "policy"."majority_strict" IS 'If TRUE, then the majority must be strictly greater than "majority_num"/"majority_den", otherwise it may also be equal.';
283 CREATE TABLE "area" (
284 "id" SERIAL4 PRIMARY KEY,
285 "active" BOOLEAN NOT NULL DEFAULT TRUE,
286 "name" TEXT NOT NULL,
287 "description" TEXT NOT NULL DEFAULT '',
288 "direct_member_count" INT4,
289 "member_weight" INT4,
290 "autoreject_weight" INT4,
291 "text_search_data" TSVECTOR );
292 CREATE INDEX "area_active_idx" ON "area" ("active");
293 CREATE INDEX "area_text_search_data_idx" ON "area" USING gin ("text_search_data");
294 CREATE TRIGGER "update_text_search_data"
295 BEFORE INSERT OR UPDATE ON "area"
296 FOR EACH ROW EXECUTE PROCEDURE
297 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
298 "name", "description" );
300 COMMENT ON TABLE "area" IS 'Subject areas';
302 COMMENT ON COLUMN "area"."active" IS 'TRUE means new issues can be created in this area';
303 COMMENT ON COLUMN "area"."direct_member_count" IS 'Number of active members of that area (ignoring their weight), as calculated from view "area_member_count"';
304 COMMENT ON COLUMN "area"."member_weight" IS 'Same as "direct_member_count" but respecting delegations';
305 COMMENT ON COLUMN "area"."autoreject_weight" IS 'Sum of weight of members using the autoreject feature';
308 CREATE TABLE "area_setting" (
309 PRIMARY KEY ("member_id", "key", "area_id"),
310 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
311 "key" TEXT NOT NULL,
312 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
313 "value" TEXT NOT NULL );
315 COMMENT ON TABLE "area_setting" IS 'Place for frontend to store area specific settings of members as strings';
318 CREATE TABLE "allowed_policy" (
319 PRIMARY KEY ("area_id", "policy_id"),
320 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
321 "policy_id" INT4 NOT NULL REFERENCES "policy" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
322 "default_policy" BOOLEAN NOT NULL DEFAULT FALSE );
323 CREATE UNIQUE INDEX "allowed_policy_one_default_per_area_idx" ON "allowed_policy" ("area_id") WHERE "default_policy";
325 COMMENT ON TABLE "allowed_policy" IS 'Selects which policies can be used in each area';
327 COMMENT ON COLUMN "allowed_policy"."default_policy" IS 'One policy per area can be set as default.';
330 CREATE TYPE "snapshot_event" AS ENUM ('periodic', 'end_of_admission', 'half_freeze', 'full_freeze');
332 COMMENT ON TYPE "snapshot_event" IS 'Reason for snapshots: ''periodic'' = due to periodic recalculation, ''end_of_admission'' = saved state at end of admission period, ''half_freeze'' = saved state at end of discussion period, ''full_freeze'' = saved state at end of verification period';
335 CREATE TABLE "issue" (
336 "id" SERIAL4 PRIMARY KEY,
337 "area_id" INT4 NOT NULL REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
338 "policy_id" INT4 NOT NULL REFERENCES "policy" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
339 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
340 "accepted" TIMESTAMPTZ,
341 "half_frozen" TIMESTAMPTZ,
342 "fully_frozen" TIMESTAMPTZ,
343 "closed" TIMESTAMPTZ,
344 "ranks_available" BOOLEAN NOT NULL DEFAULT FALSE,
345 "cleaned" TIMESTAMPTZ,
346 "admission_time" INTERVAL NOT NULL,
347 "discussion_time" INTERVAL NOT NULL,
348 "verification_time" INTERVAL NOT NULL,
349 "voting_time" INTERVAL NOT NULL,
350 "snapshot" TIMESTAMPTZ,
351 "latest_snapshot_event" "snapshot_event",
352 "population" INT4,
353 "vote_now" INT4,
354 "vote_later" INT4,
355 "voter_count" INT4,
356 CONSTRAINT "valid_state" CHECK (
357 ("accepted" ISNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL AND "closed" ISNULL AND "ranks_available" = FALSE) OR
358 ("accepted" ISNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL AND "closed" NOTNULL AND "ranks_available" = FALSE) OR
359 ("accepted" NOTNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL AND "closed" ISNULL AND "ranks_available" = FALSE) OR
360 ("accepted" NOTNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL AND "closed" NOTNULL AND "ranks_available" = FALSE) OR
361 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" ISNULL AND "closed" ISNULL AND "ranks_available" = FALSE) OR
362 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" ISNULL AND "closed" NOTNULL AND "ranks_available" = FALSE) OR
363 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" NOTNULL AND "closed" ISNULL AND "ranks_available" = FALSE) OR
364 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" NOTNULL AND "closed" NOTNULL AND "ranks_available" = FALSE) OR
365 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" NOTNULL AND "closed" NOTNULL AND "ranks_available" = TRUE) ),
366 CONSTRAINT "state_change_order" CHECK (
367 "created" <= "accepted" AND
368 "accepted" <= "half_frozen" AND
369 "half_frozen" <= "fully_frozen" AND
370 "fully_frozen" <= "closed" ),
371 CONSTRAINT "only_closed_issues_may_be_cleaned" CHECK (
372 "cleaned" ISNULL OR "closed" NOTNULL ),
373 CONSTRAINT "last_snapshot_on_full_freeze"
374 CHECK ("snapshot" = "fully_frozen"), -- NOTE: snapshot can be set, while frozen is NULL yet
375 CONSTRAINT "freeze_requires_snapshot"
376 CHECK ("fully_frozen" ISNULL OR "snapshot" NOTNULL),
377 CONSTRAINT "set_both_or_none_of_snapshot_and_latest_snapshot_event"
378 CHECK ("snapshot" NOTNULL = "latest_snapshot_event" NOTNULL) );
379 CREATE INDEX "issue_area_id_idx" ON "issue" ("area_id");
380 CREATE INDEX "issue_policy_id_idx" ON "issue" ("policy_id");
381 CREATE INDEX "issue_created_idx" ON "issue" ("created");
382 CREATE INDEX "issue_accepted_idx" ON "issue" ("accepted");
383 CREATE INDEX "issue_half_frozen_idx" ON "issue" ("half_frozen");
384 CREATE INDEX "issue_fully_frozen_idx" ON "issue" ("fully_frozen");
385 CREATE INDEX "issue_closed_idx" ON "issue" ("closed");
386 CREATE INDEX "issue_created_idx_open" ON "issue" ("created") WHERE "closed" ISNULL;
387 CREATE INDEX "issue_closed_idx_canceled" ON "issue" ("closed") WHERE "fully_frozen" ISNULL;
389 COMMENT ON TABLE "issue" IS 'Groups of initiatives';
391 COMMENT ON COLUMN "issue"."accepted" IS 'Point in time, when one initiative of issue reached the "issue_quorum"';
392 COMMENT ON COLUMN "issue"."half_frozen" IS 'Point in time, when "discussion_time" has elapsed, or members voted for voting; 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.';
393 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.';
394 COMMENT ON COLUMN "issue"."closed" IS 'Point in time, when "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.';
395 COMMENT ON COLUMN "issue"."ranks_available" IS 'TRUE = ranks have been calculated';
396 COMMENT ON COLUMN "issue"."cleaned" IS 'Point in time, when discussion data and votes had been deleted';
397 COMMENT ON COLUMN "issue"."admission_time" IS 'Copied from "policy" table at creation of issue';
398 COMMENT ON COLUMN "issue"."discussion_time" IS 'Copied from "policy" table at creation of issue';
399 COMMENT ON COLUMN "issue"."verification_time" IS 'Copied from "policy" table at creation of issue';
400 COMMENT ON COLUMN "issue"."voting_time" IS 'Copied from "policy" table at creation of issue';
401 COMMENT ON COLUMN "issue"."snapshot" IS 'Point in time, when snapshot tables have been updated and "population", "vote_now", "vote_later" and *_count values were precalculated';
402 COMMENT ON COLUMN "issue"."latest_snapshot_event" IS 'Event type of latest snapshot for issue; Can be used to select the latest snapshot data in the snapshot tables';
403 COMMENT ON COLUMN "issue"."population" IS 'Sum of "weight" column in table "direct_population_snapshot"';
404 COMMENT ON COLUMN "issue"."vote_now" IS 'Number of votes in favor of voting now, as calculated from table "direct_interest_snapshot"';
405 COMMENT ON COLUMN "issue"."vote_later" IS 'Number of votes against voting now, as calculated from table "direct_interest_snapshot"';
406 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';
409 CREATE TABLE "issue_setting" (
410 PRIMARY KEY ("member_id", "key", "issue_id"),
411 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
412 "key" TEXT NOT NULL,
413 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
414 "value" TEXT NOT NULL );
416 COMMENT ON TABLE "issue_setting" IS 'Place for frontend to store issue specific settings of members as strings';
419 CREATE TABLE "initiative" (
420 UNIQUE ("issue_id", "id"), -- index needed for foreign-key on table "vote"
421 "issue_id" INT4 NOT NULL REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
422 "id" SERIAL4 PRIMARY KEY,
423 "name" TEXT NOT NULL,
424 "discussion_url" TEXT,
425 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
426 "revoked" TIMESTAMPTZ,
427 "suggested_initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
428 "admitted" BOOLEAN,
429 "supporter_count" INT4,
430 "informed_supporter_count" INT4,
431 "satisfied_supporter_count" INT4,
432 "satisfied_informed_supporter_count" INT4,
433 "positive_votes" INT4,
434 "negative_votes" INT4,
435 "agreed" BOOLEAN,
436 "rank" INT4,
437 "text_search_data" TSVECTOR,
438 CONSTRAINT "non_revoked_initiatives_cant_suggest_other"
439 CHECK ("revoked" NOTNULL OR "suggested_initiative_id" ISNULL),
440 CONSTRAINT "revoked_initiatives_cant_be_admitted"
441 CHECK ("revoked" ISNULL OR "admitted" ISNULL),
442 CONSTRAINT "non_admitted_initiatives_cant_contain_voting_results"
443 CHECK (("admitted" NOTNULL AND "admitted" = TRUE) OR ("positive_votes" ISNULL AND "negative_votes" ISNULL AND "agreed" ISNULL)),
444 CONSTRAINT "all_or_none_of_positive_votes_negative_votes_and_agreed_must_be_null"
445 CHECK ("positive_votes" NOTNULL = "negative_votes" NOTNULL AND "positive_votes" NOTNULL = "agreed" NOTNULL),
446 CONSTRAINT "non_agreed_initiatives_cant_get_a_rank"
447 CHECK (("agreed" NOTNULL AND "agreed" = TRUE) OR "rank" ISNULL) );
448 CREATE INDEX "initiative_created_idx" ON "initiative" ("created");
449 CREATE INDEX "initiative_revoked_idx" ON "initiative" ("revoked");
450 CREATE INDEX "initiative_text_search_data_idx" ON "initiative" USING gin ("text_search_data");
451 CREATE TRIGGER "update_text_search_data"
452 BEFORE INSERT OR UPDATE ON "initiative"
453 FOR EACH ROW EXECUTE PROCEDURE
454 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
455 "name", "discussion_url");
457 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.';
459 COMMENT ON COLUMN "initiative"."discussion_url" IS 'URL pointing to a discussion platform for this initiative';
460 COMMENT ON COLUMN "initiative"."revoked" IS 'Point in time, when one initiator decided to revoke the initiative';
461 COMMENT ON COLUMN "initiative"."admitted" IS 'TRUE, if initiative reaches the "initiative_quorum" when freezing the issue';
462 COMMENT ON COLUMN "initiative"."supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
463 COMMENT ON COLUMN "initiative"."informed_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
464 COMMENT ON COLUMN "initiative"."satisfied_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
465 COMMENT ON COLUMN "initiative"."satisfied_informed_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
466 COMMENT ON COLUMN "initiative"."positive_votes" IS 'Calculated from table "direct_voter"';
467 COMMENT ON COLUMN "initiative"."negative_votes" IS 'Calculated from table "direct_voter"';
468 COMMENT ON COLUMN "initiative"."agreed" IS 'TRUE, if "positive_votes"/("positive_votes"+"negative_votes") is strictly greater or greater-equal than "majority_num"/"majority_den"';
469 COMMENT ON COLUMN "initiative"."rank" IS 'Rank of approved initiatives (winner is 1), calculated from table "direct_voter"';
472 CREATE TABLE "battle" (
473 PRIMARY KEY ("issue_id", "winning_initiative_id", "losing_initiative_id"),
474 "issue_id" INT4,
475 "winning_initiative_id" INT4,
476 FOREIGN KEY ("issue_id", "winning_initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
477 "losing_initiative_id" INT4,
478 FOREIGN KEY ("issue_id", "losing_initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
479 "count" INT4 NOT NULL);
481 COMMENT ON TABLE "battle" IS 'Number of members preferring one initiative to another; Filled by "battle_view" when closing an issue';
484 CREATE TABLE "initiative_setting" (
485 PRIMARY KEY ("member_id", "key", "initiative_id"),
486 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
487 "key" TEXT NOT NULL,
488 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
489 "value" TEXT NOT NULL );
491 COMMENT ON TABLE "initiative_setting" IS 'Place for frontend to store initiative specific settings of members as strings';
494 CREATE TABLE "draft" (
495 UNIQUE ("initiative_id", "id"), -- index needed for foreign-key on table "supporter"
496 "initiative_id" INT4 NOT NULL REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
497 "id" SERIAL8 PRIMARY KEY,
498 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
499 "author_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
500 "formatting_engine" TEXT,
501 "content" TEXT NOT NULL,
502 "text_search_data" TSVECTOR );
503 CREATE INDEX "draft_created_idx" ON "draft" ("created");
504 CREATE INDEX "draft_author_id_created_idx" ON "draft" ("author_id", "created");
505 CREATE INDEX "draft_text_search_data_idx" ON "draft" USING gin ("text_search_data");
506 CREATE TRIGGER "update_text_search_data"
507 BEFORE INSERT OR UPDATE ON "draft"
508 FOR EACH ROW EXECUTE PROCEDURE
509 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "content");
511 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.';
513 COMMENT ON COLUMN "draft"."formatting_engine" IS 'Allows different formatting engines (i.e. wiki formats) to be used';
514 COMMENT ON COLUMN "draft"."content" IS 'Text of the draft in a format depending on the field "formatting_engine"';
517 CREATE TABLE "rendered_draft" (
518 PRIMARY KEY ("draft_id", "format"),
519 "draft_id" INT8 REFERENCES "draft" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
520 "format" TEXT,
521 "content" TEXT NOT NULL );
523 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)';
526 CREATE TABLE "suggestion" (
527 UNIQUE ("initiative_id", "id"), -- index needed for foreign-key on table "opinion"
528 "initiative_id" INT4 NOT NULL REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
529 "id" SERIAL8 PRIMARY KEY,
530 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
531 "author_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
532 "name" TEXT NOT NULL,
533 "description" TEXT NOT NULL DEFAULT '',
534 "text_search_data" TSVECTOR,
535 "minus2_unfulfilled_count" INT4,
536 "minus2_fulfilled_count" INT4,
537 "minus1_unfulfilled_count" INT4,
538 "minus1_fulfilled_count" INT4,
539 "plus1_unfulfilled_count" INT4,
540 "plus1_fulfilled_count" INT4,
541 "plus2_unfulfilled_count" INT4,
542 "plus2_fulfilled_count" INT4 );
543 CREATE INDEX "suggestion_created_idx" ON "suggestion" ("created");
544 CREATE INDEX "suggestion_author_id_created_idx" ON "suggestion" ("author_id", "created");
545 CREATE INDEX "suggestion_text_search_data_idx" ON "suggestion" USING gin ("text_search_data");
546 CREATE TRIGGER "update_text_search_data"
547 BEFORE INSERT OR UPDATE ON "suggestion"
548 FOR EACH ROW EXECUTE PROCEDURE
549 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
550 "name", "description");
552 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';
554 COMMENT ON COLUMN "suggestion"."minus2_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
555 COMMENT ON COLUMN "suggestion"."minus2_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
556 COMMENT ON COLUMN "suggestion"."minus1_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
557 COMMENT ON COLUMN "suggestion"."minus1_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
558 COMMENT ON COLUMN "suggestion"."plus1_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
559 COMMENT ON COLUMN "suggestion"."plus1_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
560 COMMENT ON COLUMN "suggestion"."plus2_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
561 COMMENT ON COLUMN "suggestion"."plus2_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
564 CREATE TABLE "suggestion_setting" (
565 PRIMARY KEY ("member_id", "key", "suggestion_id"),
566 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
567 "key" TEXT NOT NULL,
568 "suggestion_id" INT8 REFERENCES "suggestion" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
569 "value" TEXT NOT NULL );
571 COMMENT ON TABLE "suggestion_setting" IS 'Place for frontend to store suggestion specific settings of members as strings';
574 CREATE TABLE "membership" (
575 PRIMARY KEY ("area_id", "member_id"),
576 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
577 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
578 "autoreject" BOOLEAN NOT NULL DEFAULT FALSE );
579 CREATE INDEX "membership_member_id_idx" ON "membership" ("member_id");
581 COMMENT ON TABLE "membership" IS 'Interest of members in topic areas';
583 COMMENT ON COLUMN "membership"."autoreject" IS 'TRUE = member votes against all initiatives, if he is neither direct_ or delegating_voter; Entries in the "interest" table can override this setting.';
586 CREATE TABLE "interest" (
587 PRIMARY KEY ("issue_id", "member_id"),
588 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
589 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
590 "autoreject" BOOLEAN,
591 "voting_requested" BOOLEAN );
592 CREATE INDEX "interest_member_id_idx" ON "interest" ("member_id");
594 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.';
596 COMMENT ON COLUMN "interest"."autoreject" IS 'TRUE = member votes against all initiatives in case of not explicitly taking part in the voting procedure';
597 COMMENT ON COLUMN "interest"."voting_requested" IS 'TRUE = member wants to vote now, FALSE = member wants to vote later, NULL = policy rules should apply';
600 CREATE TABLE "ignored_issue" (
601 PRIMARY KEY ("issue_id", "member_id"),
602 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
603 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
604 "new" BOOLEAN NOT NULL DEFAULT FALSE,
605 "accepted" BOOLEAN NOT NULL DEFAULT FALSE,
606 "half_frozen" BOOLEAN NOT NULL DEFAULT FALSE,
607 "fully_frozen" BOOLEAN NOT NULL DEFAULT FALSE );
608 CREATE INDEX "ignored_issue_member_id_idx" ON "ignored_issue" ("member_id");
610 COMMENT ON TABLE "ignored_issue" IS 'Table to store member specific options to ignore issues in selected states';
612 COMMENT ON COLUMN "ignored_issue"."new" IS 'Apply when issue is neither closed nor accepted';
613 COMMENT ON COLUMN "ignored_issue"."accepted" IS 'Apply when issue is accepted but not (half_)frozen or closed';
614 COMMENT ON COLUMN "ignored_issue"."half_frozen" IS 'Apply when issue is half_frozen but not fully_frozen or closed';
615 COMMENT ON COLUMN "ignored_issue"."fully_frozen" IS 'Apply when issue is fully_frozen (in voting) and not closed';
618 CREATE TABLE "initiator" (
619 PRIMARY KEY ("initiative_id", "member_id"),
620 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
621 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
622 "accepted" BOOLEAN );
623 CREATE INDEX "initiator_member_id_idx" ON "initiator" ("member_id");
625 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.';
627 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.';
630 CREATE TABLE "supporter" (
631 "issue_id" INT4 NOT NULL,
632 PRIMARY KEY ("initiative_id", "member_id"),
633 "initiative_id" INT4,
634 "member_id" INT4,
635 "draft_id" INT8 NOT NULL,
636 FOREIGN KEY ("issue_id", "member_id") REFERENCES "interest" ("issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE,
637 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE CASCADE ON UPDATE CASCADE );
638 CREATE INDEX "supporter_member_id_idx" ON "supporter" ("member_id");
640 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.';
642 COMMENT ON COLUMN "supporter"."draft_id" IS 'Latest seen draft, defaults to current draft of the initiative (implemented by trigger "default_for_draft_id")';
645 CREATE TABLE "opinion" (
646 "initiative_id" INT4 NOT NULL,
647 PRIMARY KEY ("suggestion_id", "member_id"),
648 "suggestion_id" INT8,
649 "member_id" INT4,
650 "degree" INT2 NOT NULL CHECK ("degree" >= -2 AND "degree" <= 2 AND "degree" != 0),
651 "fulfilled" BOOLEAN NOT NULL DEFAULT FALSE,
652 FOREIGN KEY ("initiative_id", "suggestion_id") REFERENCES "suggestion" ("initiative_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
653 FOREIGN KEY ("initiative_id", "member_id") REFERENCES "supporter" ("initiative_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
654 CREATE INDEX "opinion_member_id_initiative_id_idx" ON "opinion" ("member_id", "initiative_id");
656 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.';
658 COMMENT ON COLUMN "opinion"."degree" IS '2 = fulfillment required for support; 1 = fulfillment desired; -1 = fulfillment unwanted; -2 = fulfillment cancels support';
661 CREATE TYPE "delegation_scope" AS ENUM ('global', 'area', 'issue');
663 COMMENT ON TYPE "delegation_scope" IS 'Scope for delegations: ''global'', ''area'', or ''issue'' (order is relevant)';
666 CREATE TABLE "delegation" (
667 "id" SERIAL8 PRIMARY KEY,
668 "truster_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
669 "trustee_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
670 "scope" "delegation_scope" NOT NULL,
671 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
672 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
673 CONSTRAINT "cant_delegate_to_yourself" CHECK ("truster_id" != "trustee_id"),
674 CONSTRAINT "no_global_delegation_to_null"
675 CHECK ("trustee_id" NOTNULL OR "scope" != 'global'),
676 CONSTRAINT "area_id_and_issue_id_set_according_to_scope" CHECK (
677 ("scope" = 'global' AND "area_id" ISNULL AND "issue_id" ISNULL ) OR
678 ("scope" = 'area' AND "area_id" NOTNULL AND "issue_id" ISNULL ) OR
679 ("scope" = 'issue' AND "area_id" ISNULL AND "issue_id" NOTNULL) ),
680 UNIQUE ("area_id", "truster_id"),
681 UNIQUE ("issue_id", "truster_id") );
682 CREATE UNIQUE INDEX "delegation_global_truster_id_unique_idx"
683 ON "delegation" ("truster_id") WHERE "scope" = 'global';
684 CREATE INDEX "delegation_truster_id_idx" ON "delegation" ("truster_id");
685 CREATE INDEX "delegation_trustee_id_idx" ON "delegation" ("trustee_id");
687 COMMENT ON TABLE "delegation" IS 'Delegation of vote-weight to other members';
689 COMMENT ON COLUMN "delegation"."area_id" IS 'Reference to area, if delegation is area-wide, otherwise NULL';
690 COMMENT ON COLUMN "delegation"."issue_id" IS 'Reference to issue, if delegation is issue-wide, otherwise NULL';
693 CREATE TABLE "direct_population_snapshot" (
694 PRIMARY KEY ("issue_id", "event", "member_id"),
695 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
696 "event" "snapshot_event",
697 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
698 "weight" INT4 );
699 CREATE INDEX "direct_population_snapshot_member_id_idx" ON "direct_population_snapshot" ("member_id");
701 COMMENT ON TABLE "direct_population_snapshot" IS 'Snapshot of active members having either a "membership" in the "area" or an "interest" in the "issue"';
703 COMMENT ON COLUMN "direct_population_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
704 COMMENT ON COLUMN "direct_population_snapshot"."weight" IS 'Weight of member (1 or higher) according to "delegating_population_snapshot"';
707 CREATE TABLE "delegating_population_snapshot" (
708 PRIMARY KEY ("issue_id", "event", "member_id"),
709 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
710 "event" "snapshot_event",
711 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
712 "weight" INT4,
713 "scope" "delegation_scope" NOT NULL,
714 "delegate_member_ids" INT4[] NOT NULL );
715 CREATE INDEX "delegating_population_snapshot_member_id_idx" ON "delegating_population_snapshot" ("member_id");
717 COMMENT ON TABLE "direct_population_snapshot" IS 'Delegations increasing the weight of entries in the "direct_population_snapshot" table';
719 COMMENT ON COLUMN "delegating_population_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
720 COMMENT ON COLUMN "delegating_population_snapshot"."member_id" IS 'Delegating member';
721 COMMENT ON COLUMN "delegating_population_snapshot"."weight" IS 'Intermediate weight';
722 COMMENT ON COLUMN "delegating_population_snapshot"."delegate_member_ids" IS 'Chain of members who act as delegates; last entry referes to "member_id" column of table "direct_population_snapshot"';
725 CREATE TABLE "direct_interest_snapshot" (
726 PRIMARY KEY ("issue_id", "event", "member_id"),
727 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
728 "event" "snapshot_event",
729 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
730 "weight" INT4,
731 "voting_requested" BOOLEAN );
732 CREATE INDEX "direct_interest_snapshot_member_id_idx" ON "direct_interest_snapshot" ("member_id");
734 COMMENT ON TABLE "direct_interest_snapshot" IS 'Snapshot of active members having an "interest" in the "issue"';
736 COMMENT ON COLUMN "direct_interest_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
737 COMMENT ON COLUMN "direct_interest_snapshot"."weight" IS 'Weight of member (1 or higher) according to "delegating_interest_snapshot"';
738 COMMENT ON COLUMN "direct_interest_snapshot"."voting_requested" IS 'Copied from column "voting_requested" of table "interest"';
741 CREATE TABLE "delegating_interest_snapshot" (
742 PRIMARY KEY ("issue_id", "event", "member_id"),
743 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
744 "event" "snapshot_event",
745 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
746 "weight" INT4,
747 "scope" "delegation_scope" NOT NULL,
748 "delegate_member_ids" INT4[] NOT NULL );
749 CREATE INDEX "delegating_interest_snapshot_member_id_idx" ON "delegating_interest_snapshot" ("member_id");
751 COMMENT ON TABLE "delegating_interest_snapshot" IS 'Delegations increasing the weight of entries in the "direct_interest_snapshot" table';
753 COMMENT ON COLUMN "delegating_interest_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
754 COMMENT ON COLUMN "delegating_interest_snapshot"."member_id" IS 'Delegating member';
755 COMMENT ON COLUMN "delegating_interest_snapshot"."weight" IS 'Intermediate weight';
756 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"';
759 CREATE TABLE "direct_supporter_snapshot" (
760 "issue_id" INT4 NOT NULL,
761 PRIMARY KEY ("initiative_id", "event", "member_id"),
762 "initiative_id" INT4,
763 "event" "snapshot_event",
764 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
765 "informed" BOOLEAN NOT NULL,
766 "satisfied" BOOLEAN NOT NULL,
767 FOREIGN KEY ("issue_id", "initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
768 FOREIGN KEY ("issue_id", "event", "member_id") REFERENCES "direct_interest_snapshot" ("issue_id", "event", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
769 CREATE INDEX "direct_supporter_snapshot_member_id_idx" ON "direct_supporter_snapshot" ("member_id");
771 COMMENT ON TABLE "direct_supporter_snapshot" IS 'Snapshot of supporters of initiatives (weight is stored in "direct_interest_snapshot")';
773 COMMENT ON COLUMN "direct_supporter_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
774 COMMENT ON COLUMN "direct_supporter_snapshot"."informed" IS 'Supporter has seen the latest draft of the initiative';
775 COMMENT ON COLUMN "direct_supporter_snapshot"."satisfied" IS 'Supporter has no "critical_opinion"s';
778 CREATE TABLE "direct_voter" (
779 PRIMARY KEY ("issue_id", "member_id"),
780 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
781 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
782 "weight" INT4,
783 "autoreject" BOOLEAN NOT NULL DEFAULT FALSE );
784 CREATE INDEX "direct_voter_member_id_idx" ON "direct_voter" ("member_id");
786 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.';
788 COMMENT ON COLUMN "direct_voter"."weight" IS 'Weight of member (1 or higher) according to "delegating_voter" table';
789 COMMENT ON COLUMN "direct_voter"."autoreject" IS 'Votes were inserted due to "autoreject" feature';
792 CREATE TABLE "delegating_voter" (
793 PRIMARY KEY ("issue_id", "member_id"),
794 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
795 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
796 "weight" INT4,
797 "scope" "delegation_scope" NOT NULL,
798 "delegate_member_ids" INT4[] NOT NULL );
799 CREATE INDEX "delegating_voter_member_id_idx" ON "delegating_voter" ("member_id");
801 COMMENT ON TABLE "delegating_voter" IS 'Delegations increasing the weight of entries in the "direct_voter" table';
803 COMMENT ON COLUMN "delegating_voter"."member_id" IS 'Delegating member';
804 COMMENT ON COLUMN "delegating_voter"."weight" IS 'Intermediate weight';
805 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"';
808 CREATE TABLE "vote" (
809 "issue_id" INT4 NOT NULL,
810 PRIMARY KEY ("initiative_id", "member_id"),
811 "initiative_id" INT4,
812 "member_id" INT4,
813 "grade" INT4,
814 FOREIGN KEY ("issue_id", "initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
815 FOREIGN KEY ("issue_id", "member_id") REFERENCES "direct_voter" ("issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
816 CREATE INDEX "vote_member_id_idx" ON "vote" ("member_id");
818 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.';
820 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.';
823 CREATE TABLE "contingent" (
824 "time_frame" INTERVAL PRIMARY KEY,
825 "text_entry_limit" INT4,
826 "initiative_limit" INT4 );
828 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.';
830 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';
831 COMMENT ON COLUMN "contingent"."initiative_limit" IS 'Number of new initiatives to be opened by each member within a given time frame';
835 --------------------------------
836 -- Writing of history entries --
837 --------------------------------
839 CREATE FUNCTION "write_member_history_trigger"()
840 RETURNS TRIGGER
841 LANGUAGE 'plpgsql' VOLATILE AS $$
842 BEGIN
843 IF
844 NEW."active" != OLD."active" OR
845 NEW."name" != OLD."name"
846 THEN
847 INSERT INTO "member_history"
848 ("member_id", "active", "name")
849 VALUES (NEW."id", OLD."active", OLD."name");
850 END IF;
851 RETURN NULL;
852 END;
853 $$;
855 CREATE TRIGGER "write_member_history"
856 AFTER UPDATE ON "member" FOR EACH ROW EXECUTE PROCEDURE
857 "write_member_history_trigger"();
859 COMMENT ON FUNCTION "write_member_history_trigger"() IS 'Implementation of trigger "write_member_history" on table "member"';
860 COMMENT ON TRIGGER "write_member_history" ON "member" IS 'When changing certain fields of a member, create a history entry in "member_history" table';
864 ----------------------------
865 -- Additional constraints --
866 ----------------------------
869 CREATE FUNCTION "issue_requires_first_initiative_trigger"()
870 RETURNS TRIGGER
871 LANGUAGE 'plpgsql' VOLATILE AS $$
872 BEGIN
873 IF NOT EXISTS (
874 SELECT NULL FROM "initiative" WHERE "issue_id" = NEW."id"
875 ) THEN
876 --RAISE 'Cannot create issue without an initial initiative.' USING
877 -- ERRCODE = 'integrity_constraint_violation',
878 -- HINT = 'Create issue, initiative, and draft within the same transaction.';
879 RAISE EXCEPTION 'Cannot create issue without an initial initiative.';
880 END IF;
881 RETURN NULL;
882 END;
883 $$;
885 CREATE CONSTRAINT TRIGGER "issue_requires_first_initiative"
886 AFTER INSERT OR UPDATE ON "issue" DEFERRABLE INITIALLY DEFERRED
887 FOR EACH ROW EXECUTE PROCEDURE
888 "issue_requires_first_initiative_trigger"();
890 COMMENT ON FUNCTION "issue_requires_first_initiative_trigger"() IS 'Implementation of trigger "issue_requires_first_initiative" on table "issue"';
891 COMMENT ON TRIGGER "issue_requires_first_initiative" ON "issue" IS 'Ensure that new issues have at least one initiative';
894 CREATE FUNCTION "last_initiative_deletes_issue_trigger"()
895 RETURNS TRIGGER
896 LANGUAGE 'plpgsql' VOLATILE AS $$
897 DECLARE
898 "reference_lost" BOOLEAN;
899 BEGIN
900 IF TG_OP = 'DELETE' THEN
901 "reference_lost" := TRUE;
902 ELSE
903 "reference_lost" := NEW."issue_id" != OLD."issue_id";
904 END IF;
905 IF
906 "reference_lost" AND NOT EXISTS (
907 SELECT NULL FROM "initiative" WHERE "issue_id" = OLD."issue_id"
908 )
909 THEN
910 DELETE FROM "issue" WHERE "id" = OLD."issue_id";
911 END IF;
912 RETURN NULL;
913 END;
914 $$;
916 CREATE CONSTRAINT TRIGGER "last_initiative_deletes_issue"
917 AFTER UPDATE OR DELETE ON "initiative" DEFERRABLE INITIALLY DEFERRED
918 FOR EACH ROW EXECUTE PROCEDURE
919 "last_initiative_deletes_issue_trigger"();
921 COMMENT ON FUNCTION "last_initiative_deletes_issue_trigger"() IS 'Implementation of trigger "last_initiative_deletes_issue" on table "initiative"';
922 COMMENT ON TRIGGER "last_initiative_deletes_issue" ON "initiative" IS 'Removing the last initiative of an issue deletes the issue';
925 CREATE FUNCTION "initiative_requires_first_draft_trigger"()
926 RETURNS TRIGGER
927 LANGUAGE 'plpgsql' VOLATILE AS $$
928 BEGIN
929 IF NOT EXISTS (
930 SELECT NULL FROM "draft" WHERE "initiative_id" = NEW."id"
931 ) THEN
932 --RAISE 'Cannot create initiative without an initial draft.' USING
933 -- ERRCODE = 'integrity_constraint_violation',
934 -- HINT = 'Create issue, initiative and draft within the same transaction.';
935 RAISE EXCEPTION 'Cannot create initiative without an initial draft.';
936 END IF;
937 RETURN NULL;
938 END;
939 $$;
941 CREATE CONSTRAINT TRIGGER "initiative_requires_first_draft"
942 AFTER INSERT OR UPDATE ON "initiative" DEFERRABLE INITIALLY DEFERRED
943 FOR EACH ROW EXECUTE PROCEDURE
944 "initiative_requires_first_draft_trigger"();
946 COMMENT ON FUNCTION "initiative_requires_first_draft_trigger"() IS 'Implementation of trigger "initiative_requires_first_draft" on table "initiative"';
947 COMMENT ON TRIGGER "initiative_requires_first_draft" ON "initiative" IS 'Ensure that new initiatives have at least one draft';
950 CREATE FUNCTION "last_draft_deletes_initiative_trigger"()
951 RETURNS TRIGGER
952 LANGUAGE 'plpgsql' VOLATILE AS $$
953 DECLARE
954 "reference_lost" BOOLEAN;
955 BEGIN
956 IF TG_OP = 'DELETE' THEN
957 "reference_lost" := TRUE;
958 ELSE
959 "reference_lost" := NEW."initiative_id" != OLD."initiative_id";
960 END IF;
961 IF
962 "reference_lost" AND NOT EXISTS (
963 SELECT NULL FROM "draft" WHERE "initiative_id" = OLD."initiative_id"
964 )
965 THEN
966 DELETE FROM "initiative" WHERE "id" = OLD."initiative_id";
967 END IF;
968 RETURN NULL;
969 END;
970 $$;
972 CREATE CONSTRAINT TRIGGER "last_draft_deletes_initiative"
973 AFTER UPDATE OR DELETE ON "draft" DEFERRABLE INITIALLY DEFERRED
974 FOR EACH ROW EXECUTE PROCEDURE
975 "last_draft_deletes_initiative_trigger"();
977 COMMENT ON FUNCTION "last_draft_deletes_initiative_trigger"() IS 'Implementation of trigger "last_draft_deletes_initiative" on table "draft"';
978 COMMENT ON TRIGGER "last_draft_deletes_initiative" ON "draft" IS 'Removing the last draft of an initiative deletes the initiative';
981 CREATE FUNCTION "suggestion_requires_first_opinion_trigger"()
982 RETURNS TRIGGER
983 LANGUAGE 'plpgsql' VOLATILE AS $$
984 BEGIN
985 IF NOT EXISTS (
986 SELECT NULL FROM "opinion" WHERE "suggestion_id" = NEW."id"
987 ) THEN
988 RAISE EXCEPTION 'Cannot create a suggestion without an opinion.';
989 END IF;
990 RETURN NULL;
991 END;
992 $$;
994 CREATE CONSTRAINT TRIGGER "suggestion_requires_first_opinion"
995 AFTER INSERT OR UPDATE ON "suggestion" DEFERRABLE INITIALLY DEFERRED
996 FOR EACH ROW EXECUTE PROCEDURE
997 "suggestion_requires_first_opinion_trigger"();
999 COMMENT ON FUNCTION "suggestion_requires_first_opinion_trigger"() IS 'Implementation of trigger "suggestion_requires_first_opinion" on table "suggestion"';
1000 COMMENT ON TRIGGER "suggestion_requires_first_opinion" ON "suggestion" IS 'Ensure that new suggestions have at least one opinion';
1003 CREATE FUNCTION "last_opinion_deletes_suggestion_trigger"()
1004 RETURNS TRIGGER
1005 LANGUAGE 'plpgsql' VOLATILE AS $$
1006 DECLARE
1007 "reference_lost" BOOLEAN;
1008 BEGIN
1009 IF TG_OP = 'DELETE' THEN
1010 "reference_lost" := TRUE;
1011 ELSE
1012 "reference_lost" := NEW."suggestion_id" != OLD."suggestion_id";
1013 END IF;
1014 IF
1015 "reference_lost" AND NOT EXISTS (
1016 SELECT NULL FROM "opinion" WHERE "suggestion_id" = OLD."suggestion_id"
1017 )
1018 THEN
1019 DELETE FROM "suggestion" WHERE "id" = OLD."suggestion_id";
1020 END IF;
1021 RETURN NULL;
1022 END;
1023 $$;
1025 CREATE CONSTRAINT TRIGGER "last_opinion_deletes_suggestion"
1026 AFTER UPDATE OR DELETE ON "opinion" DEFERRABLE INITIALLY DEFERRED
1027 FOR EACH ROW EXECUTE PROCEDURE
1028 "last_opinion_deletes_suggestion_trigger"();
1030 COMMENT ON FUNCTION "last_opinion_deletes_suggestion_trigger"() IS 'Implementation of trigger "last_opinion_deletes_suggestion" on table "opinion"';
1031 COMMENT ON TRIGGER "last_opinion_deletes_suggestion" ON "opinion" IS 'Removing the last opinion of a suggestion deletes the suggestion';
1035 ---------------------------------------------------------------
1036 -- Ensure that votes are not modified when issues are frozen --
1037 ---------------------------------------------------------------
1039 -- NOTE: Frontends should ensure this anyway, but in case of programming
1040 -- errors the following triggers ensure data integrity.
1043 CREATE FUNCTION "forbid_changes_on_closed_issue_trigger"()
1044 RETURNS TRIGGER
1045 LANGUAGE 'plpgsql' VOLATILE AS $$
1046 DECLARE
1047 "issue_id_v" "issue"."id"%TYPE;
1048 "issue_row" "issue"%ROWTYPE;
1049 BEGIN
1050 IF TG_OP = 'DELETE' THEN
1051 "issue_id_v" := OLD."issue_id";
1052 ELSE
1053 "issue_id_v" := NEW."issue_id";
1054 END IF;
1055 SELECT INTO "issue_row" * FROM "issue"
1056 WHERE "id" = "issue_id_v" FOR SHARE;
1057 IF "issue_row"."closed" NOTNULL THEN
1058 RAISE EXCEPTION 'Tried to modify data belonging to a closed issue.';
1059 END IF;
1060 RETURN NULL;
1061 END;
1062 $$;
1064 CREATE TRIGGER "forbid_changes_on_closed_issue"
1065 AFTER INSERT OR UPDATE OR DELETE ON "direct_voter"
1066 FOR EACH ROW EXECUTE PROCEDURE
1067 "forbid_changes_on_closed_issue_trigger"();
1069 CREATE TRIGGER "forbid_changes_on_closed_issue"
1070 AFTER INSERT OR UPDATE OR DELETE ON "delegating_voter"
1071 FOR EACH ROW EXECUTE PROCEDURE
1072 "forbid_changes_on_closed_issue_trigger"();
1074 CREATE TRIGGER "forbid_changes_on_closed_issue"
1075 AFTER INSERT OR UPDATE OR DELETE ON "vote"
1076 FOR EACH ROW EXECUTE PROCEDURE
1077 "forbid_changes_on_closed_issue_trigger"();
1079 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"';
1080 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';
1081 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';
1082 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';
1086 --------------------------------------------------------------------
1087 -- Auto-retrieval of fields only needed for referential integrity --
1088 --------------------------------------------------------------------
1091 CREATE FUNCTION "autofill_issue_id_trigger"()
1092 RETURNS TRIGGER
1093 LANGUAGE 'plpgsql' VOLATILE AS $$
1094 BEGIN
1095 IF NEW."issue_id" ISNULL THEN
1096 SELECT "issue_id" INTO NEW."issue_id"
1097 FROM "initiative" WHERE "id" = NEW."initiative_id";
1098 END IF;
1099 RETURN NEW;
1100 END;
1101 $$;
1103 CREATE TRIGGER "autofill_issue_id" BEFORE INSERT ON "supporter"
1104 FOR EACH ROW EXECUTE PROCEDURE "autofill_issue_id_trigger"();
1106 CREATE TRIGGER "autofill_issue_id" BEFORE INSERT ON "vote"
1107 FOR EACH ROW EXECUTE PROCEDURE "autofill_issue_id_trigger"();
1109 COMMENT ON FUNCTION "autofill_issue_id_trigger"() IS 'Implementation of triggers "autofill_issue_id" on tables "supporter" and "vote"';
1110 COMMENT ON TRIGGER "autofill_issue_id" ON "supporter" IS 'Set "issue_id" field automatically, if NULL';
1111 COMMENT ON TRIGGER "autofill_issue_id" ON "vote" IS 'Set "issue_id" field automatically, if NULL';
1114 CREATE FUNCTION "autofill_initiative_id_trigger"()
1115 RETURNS TRIGGER
1116 LANGUAGE 'plpgsql' VOLATILE AS $$
1117 BEGIN
1118 IF NEW."initiative_id" ISNULL THEN
1119 SELECT "initiative_id" INTO NEW."initiative_id"
1120 FROM "suggestion" WHERE "id" = NEW."suggestion_id";
1121 END IF;
1122 RETURN NEW;
1123 END;
1124 $$;
1126 CREATE TRIGGER "autofill_initiative_id" BEFORE INSERT ON "opinion"
1127 FOR EACH ROW EXECUTE PROCEDURE "autofill_initiative_id_trigger"();
1129 COMMENT ON FUNCTION "autofill_initiative_id_trigger"() IS 'Implementation of trigger "autofill_initiative_id" on table "opinion"';
1130 COMMENT ON TRIGGER "autofill_initiative_id" ON "opinion" IS 'Set "initiative_id" field automatically, if NULL';
1134 -----------------------------------------------------
1135 -- Automatic calculation of certain default values --
1136 -----------------------------------------------------
1139 CREATE FUNCTION "copy_timings_trigger"()
1140 RETURNS TRIGGER
1141 LANGUAGE 'plpgsql' VOLATILE AS $$
1142 DECLARE
1143 "policy_row" "policy"%ROWTYPE;
1144 BEGIN
1145 SELECT * INTO "policy_row" FROM "policy"
1146 WHERE "id" = NEW."policy_id";
1147 IF NEW."admission_time" ISNULL THEN
1148 NEW."admission_time" := "policy_row"."admission_time";
1149 END IF;
1150 IF NEW."discussion_time" ISNULL THEN
1151 NEW."discussion_time" := "policy_row"."discussion_time";
1152 END IF;
1153 IF NEW."verification_time" ISNULL THEN
1154 NEW."verification_time" := "policy_row"."verification_time";
1155 END IF;
1156 IF NEW."voting_time" ISNULL THEN
1157 NEW."voting_time" := "policy_row"."voting_time";
1158 END IF;
1159 RETURN NEW;
1160 END;
1161 $$;
1163 CREATE TRIGGER "copy_timings" BEFORE INSERT OR UPDATE ON "issue"
1164 FOR EACH ROW EXECUTE PROCEDURE "copy_timings_trigger"();
1166 COMMENT ON FUNCTION "copy_timings_trigger"() IS 'Implementation of trigger "copy_timings" on table "issue"';
1167 COMMENT ON TRIGGER "copy_timings" ON "issue" IS 'If timing fields are NULL, copy values from policy.';
1170 CREATE FUNCTION "supporter_default_for_draft_id_trigger"()
1171 RETURNS TRIGGER
1172 LANGUAGE 'plpgsql' VOLATILE AS $$
1173 BEGIN
1174 IF NEW."draft_id" ISNULL THEN
1175 SELECT "id" INTO NEW."draft_id" FROM "current_draft"
1176 WHERE "initiative_id" = NEW."initiative_id";
1177 END IF;
1178 RETURN NEW;
1179 END;
1180 $$;
1182 CREATE TRIGGER "default_for_draft_id" BEFORE INSERT OR UPDATE ON "supporter"
1183 FOR EACH ROW EXECUTE PROCEDURE "supporter_default_for_draft_id_trigger"();
1185 COMMENT ON FUNCTION "supporter_default_for_draft_id_trigger"() IS 'Implementation of trigger "default_for_draft" on table "supporter"';
1186 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';
1190 ----------------------------------------
1191 -- Automatic creation of dependencies --
1192 ----------------------------------------
1195 CREATE FUNCTION "autocreate_interest_trigger"()
1196 RETURNS TRIGGER
1197 LANGUAGE 'plpgsql' VOLATILE AS $$
1198 BEGIN
1199 IF NOT EXISTS (
1200 SELECT NULL FROM "initiative" JOIN "interest"
1201 ON "initiative"."issue_id" = "interest"."issue_id"
1202 WHERE "initiative"."id" = NEW."initiative_id"
1203 AND "interest"."member_id" = NEW."member_id"
1204 ) THEN
1205 BEGIN
1206 INSERT INTO "interest" ("issue_id", "member_id")
1207 SELECT "issue_id", NEW."member_id"
1208 FROM "initiative" WHERE "id" = NEW."initiative_id";
1209 EXCEPTION WHEN unique_violation THEN END;
1210 END IF;
1211 RETURN NEW;
1212 END;
1213 $$;
1215 CREATE TRIGGER "autocreate_interest" BEFORE INSERT ON "supporter"
1216 FOR EACH ROW EXECUTE PROCEDURE "autocreate_interest_trigger"();
1218 COMMENT ON FUNCTION "autocreate_interest_trigger"() IS 'Implementation of trigger "autocreate_interest" on table "supporter"';
1219 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';
1222 CREATE FUNCTION "autocreate_supporter_trigger"()
1223 RETURNS TRIGGER
1224 LANGUAGE 'plpgsql' VOLATILE AS $$
1225 BEGIN
1226 IF NOT EXISTS (
1227 SELECT NULL FROM "suggestion" JOIN "supporter"
1228 ON "suggestion"."initiative_id" = "supporter"."initiative_id"
1229 WHERE "suggestion"."id" = NEW."suggestion_id"
1230 AND "supporter"."member_id" = NEW."member_id"
1231 ) THEN
1232 BEGIN
1233 INSERT INTO "supporter" ("initiative_id", "member_id")
1234 SELECT "initiative_id", NEW."member_id"
1235 FROM "suggestion" WHERE "id" = NEW."suggestion_id";
1236 EXCEPTION WHEN unique_violation THEN END;
1237 END IF;
1238 RETURN NEW;
1239 END;
1240 $$;
1242 CREATE TRIGGER "autocreate_supporter" BEFORE INSERT ON "opinion"
1243 FOR EACH ROW EXECUTE PROCEDURE "autocreate_supporter_trigger"();
1245 COMMENT ON FUNCTION "autocreate_supporter_trigger"() IS 'Implementation of trigger "autocreate_supporter" on table "opinion"';
1246 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.';
1250 ------------------------------------------
1251 -- Views and helper functions for views --
1252 ------------------------------------------
1255 CREATE VIEW "active_delegation" AS
1256 SELECT "delegation".* FROM "delegation"
1257 JOIN "member" ON "delegation"."truster_id" = "member"."id"
1258 WHERE "member"."active" = TRUE;
1260 COMMENT ON VIEW "active_delegation" IS 'Helper view for views "global_delegation", "area_delegation" and "issue_delegation": Contains delegations where the truster_id refers to an active member and includes those delegations where trustee_id is NULL';
1263 CREATE VIEW "global_delegation" AS
1264 SELECT "id", "truster_id", "trustee_id"
1265 FROM "active_delegation" WHERE "scope" = 'global';
1267 COMMENT ON VIEW "global_delegation" IS 'Global delegations from active members';
1270 CREATE VIEW "area_delegation" AS
1271 SELECT DISTINCT ON ("area"."id", "delegation"."truster_id")
1272 "area"."id" AS "area_id",
1273 "delegation"."id",
1274 "delegation"."truster_id",
1275 "delegation"."trustee_id",
1276 "delegation"."scope"
1277 FROM "area" JOIN "active_delegation" AS "delegation"
1278 ON "delegation"."scope" = 'global'
1279 OR "delegation"."area_id" = "area"."id"
1280 ORDER BY
1281 "area"."id",
1282 "delegation"."truster_id",
1283 "delegation"."scope" DESC;
1285 COMMENT ON VIEW "area_delegation" IS 'Resulting area delegations from active members; can include rows with trustee_id set to NULL';
1288 CREATE VIEW "issue_delegation" AS
1289 SELECT DISTINCT ON ("issue"."id", "delegation"."truster_id")
1290 "issue"."id" AS "issue_id",
1291 "delegation"."id",
1292 "delegation"."truster_id",
1293 "delegation"."trustee_id",
1294 "delegation"."scope"
1295 FROM "issue" JOIN "active_delegation" AS "delegation"
1296 ON "delegation"."scope" = 'global'
1297 OR "delegation"."area_id" = "issue"."area_id"
1298 OR "delegation"."issue_id" = "issue"."id"
1299 ORDER BY
1300 "issue"."id",
1301 "delegation"."truster_id",
1302 "delegation"."scope" DESC;
1304 COMMENT ON VIEW "issue_delegation" IS 'Resulting issue delegations from active members; can include rows with trustee_id set to NULL';
1307 CREATE FUNCTION "membership_weight_with_skipping"
1308 ( "area_id_p" "area"."id"%TYPE,
1309 "member_id_p" "member"."id"%TYPE,
1310 "skip_member_ids_p" INT4[] ) -- "member"."id"%TYPE[]
1311 RETURNS INT4
1312 LANGUAGE 'plpgsql' STABLE AS $$
1313 DECLARE
1314 "sum_v" INT4;
1315 "delegation_row" "area_delegation"%ROWTYPE;
1316 BEGIN
1317 "sum_v" := 1;
1318 FOR "delegation_row" IN
1319 SELECT "area_delegation".*
1320 FROM "area_delegation" LEFT JOIN "membership"
1321 ON "membership"."area_id" = "area_id_p"
1322 AND "membership"."member_id" = "area_delegation"."truster_id"
1323 WHERE "area_delegation"."area_id" = "area_id_p"
1324 AND "area_delegation"."trustee_id" = "member_id_p"
1325 AND "membership"."member_id" ISNULL
1326 LOOP
1327 IF NOT
1328 "skip_member_ids_p" @> ARRAY["delegation_row"."truster_id"]
1329 THEN
1330 "sum_v" := "sum_v" + "membership_weight_with_skipping"(
1331 "area_id_p",
1332 "delegation_row"."truster_id",
1333 "skip_member_ids_p" || "delegation_row"."truster_id"
1334 );
1335 END IF;
1336 END LOOP;
1337 RETURN "sum_v";
1338 END;
1339 $$;
1341 COMMENT ON FUNCTION "membership_weight_with_skipping"
1342 ( "area"."id"%TYPE,
1343 "member"."id"%TYPE,
1344 INT4[] )
1345 IS 'Helper function for "membership_weight" function';
1348 CREATE FUNCTION "membership_weight"
1349 ( "area_id_p" "area"."id"%TYPE,
1350 "member_id_p" "member"."id"%TYPE ) -- "member"."id"%TYPE[]
1351 RETURNS INT4
1352 LANGUAGE 'plpgsql' STABLE AS $$
1353 BEGIN
1354 RETURN "membership_weight_with_skipping"(
1355 "area_id_p",
1356 "member_id_p",
1357 ARRAY["member_id_p"]
1358 );
1359 END;
1360 $$;
1362 COMMENT ON FUNCTION "membership_weight"
1363 ( "area"."id"%TYPE,
1364 "member"."id"%TYPE )
1365 IS 'Calculates the potential voting weight of a member in a given area';
1368 CREATE VIEW "member_count_view" AS
1369 SELECT count(1) AS "total_count" FROM "member" WHERE "active";
1371 COMMENT ON VIEW "member_count_view" IS 'View used to update "member_count" table';
1374 CREATE VIEW "area_member_count" AS
1375 SELECT
1376 "area"."id" AS "area_id",
1377 count("member"."id") AS "direct_member_count",
1378 coalesce(
1379 sum(
1380 CASE WHEN "member"."id" NOTNULL THEN
1381 "membership_weight"("area"."id", "member"."id")
1382 ELSE 0 END
1383 )
1384 ) AS "member_weight",
1385 coalesce(
1386 sum(
1387 CASE WHEN "member"."id" NOTNULL AND "membership"."autoreject" THEN
1388 "membership_weight"("area"."id", "member"."id")
1389 ELSE 0 END
1390 )
1391 ) AS "autoreject_weight"
1392 FROM "area"
1393 LEFT JOIN "membership"
1394 ON "area"."id" = "membership"."area_id"
1395 LEFT JOIN "member"
1396 ON "membership"."member_id" = "member"."id"
1397 AND "member"."active"
1398 GROUP BY "area"."id";
1400 COMMENT ON VIEW "area_member_count" IS 'View used to update "member_count" column of table "area"';
1403 CREATE VIEW "opening_draft" AS
1404 SELECT "draft".* FROM (
1405 SELECT
1406 "initiative"."id" AS "initiative_id",
1407 min("draft"."id") AS "draft_id"
1408 FROM "initiative" JOIN "draft"
1409 ON "initiative"."id" = "draft"."initiative_id"
1410 GROUP BY "initiative"."id"
1411 ) AS "subquery"
1412 JOIN "draft" ON "subquery"."draft_id" = "draft"."id";
1414 COMMENT ON VIEW "opening_draft" IS 'First drafts of all initiatives';
1417 CREATE VIEW "current_draft" AS
1418 SELECT "draft".* FROM (
1419 SELECT
1420 "initiative"."id" AS "initiative_id",
1421 max("draft"."id") AS "draft_id"
1422 FROM "initiative" JOIN "draft"
1423 ON "initiative"."id" = "draft"."initiative_id"
1424 GROUP BY "initiative"."id"
1425 ) AS "subquery"
1426 JOIN "draft" ON "subquery"."draft_id" = "draft"."id";
1428 COMMENT ON VIEW "current_draft" IS 'All latest drafts for each initiative';
1431 CREATE VIEW "critical_opinion" AS
1432 SELECT * FROM "opinion"
1433 WHERE ("degree" = 2 AND "fulfilled" = FALSE)
1434 OR ("degree" = -2 AND "fulfilled" = TRUE);
1436 COMMENT ON VIEW "critical_opinion" IS 'Opinions currently causing dissatisfaction';
1439 CREATE VIEW "battle_view" AS
1440 SELECT
1441 "issue"."id" AS "issue_id",
1442 "winning_initiative"."id" AS "winning_initiative_id",
1443 "losing_initiative"."id" AS "losing_initiative_id",
1444 sum(
1445 CASE WHEN
1446 coalesce("better_vote"."grade", 0) >
1447 coalesce("worse_vote"."grade", 0)
1448 THEN "direct_voter"."weight" ELSE 0 END
1449 ) AS "count"
1450 FROM "issue"
1451 LEFT JOIN "direct_voter"
1452 ON "issue"."id" = "direct_voter"."issue_id"
1453 JOIN "initiative" AS "winning_initiative"
1454 ON "issue"."id" = "winning_initiative"."issue_id"
1455 AND "winning_initiative"."agreed"
1456 JOIN "initiative" AS "losing_initiative"
1457 ON "issue"."id" = "losing_initiative"."issue_id"
1458 AND "losing_initiative"."agreed"
1459 LEFT JOIN "vote" AS "better_vote"
1460 ON "direct_voter"."member_id" = "better_vote"."member_id"
1461 AND "winning_initiative"."id" = "better_vote"."initiative_id"
1462 LEFT JOIN "vote" AS "worse_vote"
1463 ON "direct_voter"."member_id" = "worse_vote"."member_id"
1464 AND "losing_initiative"."id" = "worse_vote"."initiative_id"
1465 WHERE "issue"."closed" NOTNULL
1466 AND "issue"."cleaned" ISNULL
1467 AND "winning_initiative"."id" != "losing_initiative"."id"
1468 GROUP BY
1469 "issue"."id",
1470 "winning_initiative"."id",
1471 "losing_initiative"."id";
1473 COMMENT ON VIEW "battle_view" IS 'Number of members preferring one initiative to another; Used to fill "battle" table';
1476 CREATE VIEW "expired_session" AS
1477 SELECT * FROM "session" WHERE now() > "expiry";
1479 CREATE RULE "delete" AS ON DELETE TO "expired_session" DO INSTEAD
1480 DELETE FROM "session" WHERE "ident" = OLD."ident";
1482 COMMENT ON VIEW "expired_session" IS 'View containing all expired sessions where DELETE is possible';
1483 COMMENT ON RULE "delete" ON "expired_session" IS 'Rule allowing DELETE on rows in "expired_session" view, i.e. DELETE FROM "expired_session"';
1486 CREATE VIEW "open_issue" AS
1487 SELECT * FROM "issue" WHERE "closed" ISNULL;
1489 COMMENT ON VIEW "open_issue" IS 'All open issues';
1492 CREATE VIEW "issue_with_ranks_missing" AS
1493 SELECT * FROM "issue"
1494 WHERE "fully_frozen" NOTNULL
1495 AND "closed" NOTNULL
1496 AND "ranks_available" = FALSE;
1498 COMMENT ON VIEW "issue_with_ranks_missing" IS 'Issues where voting was finished, but no ranks have been calculated yet';
1501 CREATE VIEW "member_contingent" AS
1502 SELECT
1503 "member"."id" AS "member_id",
1504 "contingent"."time_frame",
1505 CASE WHEN "contingent"."text_entry_limit" NOTNULL THEN
1506 (
1507 SELECT count(1) FROM "draft"
1508 WHERE "draft"."author_id" = "member"."id"
1509 AND "draft"."created" > now() - "contingent"."time_frame"
1510 ) + (
1511 SELECT count(1) FROM "suggestion"
1512 WHERE "suggestion"."author_id" = "member"."id"
1513 AND "suggestion"."created" > now() - "contingent"."time_frame"
1514 )
1515 ELSE NULL END AS "text_entry_count",
1516 "contingent"."text_entry_limit",
1517 CASE WHEN "contingent"."initiative_limit" NOTNULL THEN (
1518 SELECT count(1) FROM "opening_draft"
1519 WHERE "opening_draft"."author_id" = "member"."id"
1520 AND "opening_draft"."created" > now() - "contingent"."time_frame"
1521 ) ELSE NULL END AS "initiative_count",
1522 "contingent"."initiative_limit"
1523 FROM "member" CROSS JOIN "contingent";
1525 COMMENT ON VIEW "member_contingent" IS 'Actual counts of text entries and initiatives are calculated per member for each limit in the "contingent" table.';
1527 COMMENT ON COLUMN "member_contingent"."text_entry_count" IS 'Only calculated when "text_entry_limit" is not null in the same row';
1528 COMMENT ON COLUMN "member_contingent"."initiative_count" IS 'Only calculated when "initiative_limit" is not null in the same row';
1531 CREATE VIEW "member_contingent_left" AS
1532 SELECT
1533 "member_id",
1534 max("text_entry_limit" - "text_entry_count") AS "text_entries_left",
1535 max("initiative_limit" - "initiative_count") AS "initiatives_left"
1536 FROM "member_contingent" GROUP BY "member_id";
1538 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.';
1541 CREATE TYPE "timeline_event" AS ENUM (
1542 'issue_created',
1543 'issue_canceled',
1544 'issue_accepted',
1545 'issue_half_frozen',
1546 'issue_finished_without_voting',
1547 'issue_voting_started',
1548 'issue_finished_after_voting',
1549 'initiative_created',
1550 'initiative_revoked',
1551 'draft_created',
1552 'suggestion_created');
1554 COMMENT ON TYPE "timeline_event" IS 'Types of event in timeline tables';
1557 CREATE VIEW "timeline_issue" AS
1558 SELECT
1559 "created" AS "occurrence",
1560 'issue_created'::"timeline_event" AS "event",
1561 "id" AS "issue_id"
1562 FROM "issue"
1563 UNION ALL
1564 SELECT
1565 "closed" AS "occurrence",
1566 'issue_canceled'::"timeline_event" AS "event",
1567 "id" AS "issue_id"
1568 FROM "issue" WHERE "closed" NOTNULL AND "fully_frozen" ISNULL
1569 UNION ALL
1570 SELECT
1571 "accepted" AS "occurrence",
1572 'issue_accepted'::"timeline_event" AS "event",
1573 "id" AS "issue_id"
1574 FROM "issue" WHERE "accepted" NOTNULL
1575 UNION ALL
1576 SELECT
1577 "half_frozen" AS "occurrence",
1578 'issue_half_frozen'::"timeline_event" AS "event",
1579 "id" AS "issue_id"
1580 FROM "issue" WHERE "half_frozen" NOTNULL
1581 UNION ALL
1582 SELECT
1583 "fully_frozen" AS "occurrence",
1584 'issue_voting_started'::"timeline_event" AS "event",
1585 "id" AS "issue_id"
1586 FROM "issue"
1587 WHERE "fully_frozen" NOTNULL
1588 AND ("closed" ISNULL OR "closed" != "fully_frozen")
1589 UNION ALL
1590 SELECT
1591 "closed" AS "occurrence",
1592 CASE WHEN "fully_frozen" = "closed" THEN
1593 'issue_finished_without_voting'::"timeline_event"
1594 ELSE
1595 'issue_finished_after_voting'::"timeline_event"
1596 END AS "event",
1597 "id" AS "issue_id"
1598 FROM "issue" WHERE "closed" NOTNULL AND "fully_frozen" NOTNULL;
1600 COMMENT ON VIEW "timeline_issue" IS 'Helper view for "timeline" view';
1603 CREATE VIEW "timeline_initiative" AS
1604 SELECT
1605 "created" AS "occurrence",
1606 'initiative_created'::"timeline_event" AS "event",
1607 "id" AS "initiative_id"
1608 FROM "initiative"
1609 UNION ALL
1610 SELECT
1611 "revoked" AS "occurrence",
1612 'initiative_revoked'::"timeline_event" AS "event",
1613 "id" AS "initiative_id"
1614 FROM "initiative" WHERE "revoked" NOTNULL;
1616 COMMENT ON VIEW "timeline_initiative" IS 'Helper view for "timeline" view';
1619 CREATE VIEW "timeline_draft" AS
1620 SELECT
1621 "created" AS "occurrence",
1622 'draft_created'::"timeline_event" AS "event",
1623 "id" AS "draft_id"
1624 FROM "draft";
1626 COMMENT ON VIEW "timeline_draft" IS 'Helper view for "timeline" view';
1629 CREATE VIEW "timeline_suggestion" AS
1630 SELECT
1631 "created" AS "occurrence",
1632 'suggestion_created'::"timeline_event" AS "event",
1633 "id" AS "suggestion_id"
1634 FROM "suggestion";
1636 COMMENT ON VIEW "timeline_suggestion" IS 'Helper view for "timeline" view';
1639 CREATE VIEW "timeline" AS
1640 SELECT
1641 "occurrence",
1642 "event",
1643 "issue_id",
1644 NULL AS "initiative_id",
1645 NULL::INT8 AS "draft_id", -- TODO: Why do we need a type-cast here? Is this due to 32 bit architecture?
1646 NULL::INT8 AS "suggestion_id"
1647 FROM "timeline_issue"
1648 UNION ALL
1649 SELECT
1650 "occurrence",
1651 "event",
1652 NULL AS "issue_id",
1653 "initiative_id",
1654 NULL AS "draft_id",
1655 NULL AS "suggestion_id"
1656 FROM "timeline_initiative"
1657 UNION ALL
1658 SELECT
1659 "occurrence",
1660 "event",
1661 NULL AS "issue_id",
1662 NULL AS "initiative_id",
1663 "draft_id",
1664 NULL AS "suggestion_id"
1665 FROM "timeline_draft"
1666 UNION ALL
1667 SELECT
1668 "occurrence",
1669 "event",
1670 NULL AS "issue_id",
1671 NULL AS "initiative_id",
1672 NULL AS "draft_id",
1673 "suggestion_id"
1674 FROM "timeline_suggestion";
1676 COMMENT ON VIEW "timeline" IS 'Aggregation of different events in the system';
1680 --------------------------------------------------
1681 -- Set returning function for delegation chains --
1682 --------------------------------------------------
1685 CREATE TYPE "delegation_chain_loop_tag" AS ENUM
1686 ('first', 'intermediate', 'last', 'repetition');
1688 COMMENT ON TYPE "delegation_chain_loop_tag" IS 'Type for loop tags in "delegation_chain_row" type';
1691 CREATE TYPE "delegation_chain_row" AS (
1692 "index" INT4,
1693 "member_id" INT4,
1694 "member_active" BOOLEAN,
1695 "participation" BOOLEAN,
1696 "overridden" BOOLEAN,
1697 "scope_in" "delegation_scope",
1698 "scope_out" "delegation_scope",
1699 "disabled_out" BOOLEAN,
1700 "loop" "delegation_chain_loop_tag" );
1702 COMMENT ON TYPE "delegation_chain_row" IS 'Type of rows returned by "delegation_chain"(...) functions';
1704 COMMENT ON COLUMN "delegation_chain_row"."index" IS 'Index starting with 0 and counting up';
1705 COMMENT ON COLUMN "delegation_chain_row"."participation" IS 'In case of delegation chains for issues: interest, for areas: membership, for global delegation chains: always null';
1706 COMMENT ON COLUMN "delegation_chain_row"."overridden" IS 'True, if an entry with lower index has "participation" set to true';
1707 COMMENT ON COLUMN "delegation_chain_row"."scope_in" IS 'Scope of used incoming delegation';
1708 COMMENT ON COLUMN "delegation_chain_row"."scope_out" IS 'Scope of used outgoing delegation';
1709 COMMENT ON COLUMN "delegation_chain_row"."disabled_out" IS 'Outgoing delegation is explicitly disabled by a delegation with trustee_id set to NULL';
1710 COMMENT ON COLUMN "delegation_chain_row"."loop" IS 'Not null, if member is part of a loop, see "delegation_chain_loop_tag" type';
1713 CREATE FUNCTION "delegation_chain"
1714 ( "member_id_p" "member"."id"%TYPE,
1715 "area_id_p" "area"."id"%TYPE,
1716 "issue_id_p" "issue"."id"%TYPE,
1717 "simulate_trustee_id_p" "member"."id"%TYPE )
1718 RETURNS SETOF "delegation_chain_row"
1719 LANGUAGE 'plpgsql' STABLE AS $$
1720 DECLARE
1721 "issue_row" "issue"%ROWTYPE;
1722 "visited_member_ids" INT4[]; -- "member"."id"%TYPE[]
1723 "loop_member_id_v" "member"."id"%TYPE;
1724 "output_row" "delegation_chain_row";
1725 "output_rows" "delegation_chain_row"[];
1726 "delegation_row" "delegation"%ROWTYPE;
1727 "row_count" INT4;
1728 "i" INT4;
1729 "loop_v" BOOLEAN;
1730 BEGIN
1731 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
1732 "visited_member_ids" := '{}';
1733 "loop_member_id_v" := NULL;
1734 "output_rows" := '{}';
1735 "output_row"."index" := 0;
1736 "output_row"."member_id" := "member_id_p";
1737 "output_row"."member_active" := TRUE;
1738 "output_row"."participation" := FALSE;
1739 "output_row"."overridden" := FALSE;
1740 "output_row"."disabled_out" := FALSE;
1741 "output_row"."scope_out" := NULL;
1742 LOOP
1743 IF "visited_member_ids" @> ARRAY["output_row"."member_id"] THEN
1744 "loop_member_id_v" := "output_row"."member_id";
1745 ELSE
1746 "visited_member_ids" :=
1747 "visited_member_ids" || "output_row"."member_id";
1748 END IF;
1749 IF "output_row"."participation" THEN
1750 "output_row"."overridden" := TRUE;
1751 END IF;
1752 "output_row"."scope_in" := "output_row"."scope_out";
1753 IF EXISTS (
1754 SELECT NULL FROM "member"
1755 WHERE "id" = "output_row"."member_id" AND "active"
1756 ) THEN
1757 IF "area_id_p" ISNULL AND "issue_id_p" ISNULL THEN
1758 SELECT * INTO "delegation_row" FROM "delegation"
1759 WHERE "truster_id" = "output_row"."member_id"
1760 AND "scope" = 'global';
1761 ELSIF "area_id_p" NOTNULL AND "issue_id_p" ISNULL THEN
1762 "output_row"."participation" := EXISTS (
1763 SELECT NULL FROM "membership"
1764 WHERE "area_id" = "area_id_p"
1765 AND "member_id" = "output_row"."member_id"
1766 );
1767 SELECT * INTO "delegation_row" FROM "delegation"
1768 WHERE "truster_id" = "output_row"."member_id"
1769 AND ("scope" = 'global' OR "area_id" = "area_id_p")
1770 ORDER BY "scope" DESC;
1771 ELSIF "area_id_p" ISNULL AND "issue_id_p" NOTNULL THEN
1772 "output_row"."participation" := EXISTS (
1773 SELECT NULL FROM "interest"
1774 WHERE "issue_id" = "issue_id_p"
1775 AND "member_id" = "output_row"."member_id"
1776 );
1777 SELECT * INTO "delegation_row" FROM "delegation"
1778 WHERE "truster_id" = "output_row"."member_id"
1779 AND ("scope" = 'global' OR
1780 "area_id" = "issue_row"."area_id" OR
1781 "issue_id" = "issue_id_p"
1782 )
1783 ORDER BY "scope" DESC;
1784 ELSE
1785 RAISE EXCEPTION 'Either area_id or issue_id or both must be NULL.';
1786 END IF;
1787 ELSE
1788 "output_row"."member_active" := FALSE;
1789 "output_row"."participation" := FALSE;
1790 "output_row"."scope_out" := NULL;
1791 "delegation_row" := ROW(NULL);
1792 END IF;
1793 IF
1794 "output_row"."member_id" = "member_id_p" AND
1795 "simulate_trustee_id_p" NOTNULL
1796 THEN
1797 "output_row"."scope_out" := CASE
1798 WHEN "area_id_p" ISNULL AND "issue_id_p" ISNULL THEN 'global'
1799 WHEN "area_id_p" NOTNULL AND "issue_id_p" ISNULL THEN 'area'
1800 WHEN "area_id_p" ISNULL AND "issue_id_p" NOTNULL THEN 'issue'
1801 END;
1802 "output_rows" := "output_rows" || "output_row";
1803 "output_row"."member_id" := "simulate_trustee_id_p";
1804 ELSIF "delegation_row"."trustee_id" NOTNULL THEN
1805 "output_row"."scope_out" := "delegation_row"."scope";
1806 "output_rows" := "output_rows" || "output_row";
1807 "output_row"."member_id" := "delegation_row"."trustee_id";
1808 ELSIF "delegation_row"."scope" NOTNULL THEN
1809 "output_row"."scope_out" := "delegation_row"."scope";
1810 "output_row"."disabled_out" := TRUE;
1811 "output_rows" := "output_rows" || "output_row";
1812 EXIT;
1813 ELSE
1814 "output_row"."scope_out" := NULL;
1815 "output_rows" := "output_rows" || "output_row";
1816 EXIT;
1817 END IF;
1818 EXIT WHEN "loop_member_id_v" NOTNULL;
1819 "output_row"."index" := "output_row"."index" + 1;
1820 END LOOP;
1821 "row_count" := array_upper("output_rows", 1);
1822 "i" := 1;
1823 "loop_v" := FALSE;
1824 LOOP
1825 "output_row" := "output_rows"["i"];
1826 EXIT WHEN "output_row" ISNULL;
1827 IF "loop_v" THEN
1828 IF "i" + 1 = "row_count" THEN
1829 "output_row"."loop" := 'last';
1830 ELSIF "i" = "row_count" THEN
1831 "output_row"."loop" := 'repetition';
1832 ELSE
1833 "output_row"."loop" := 'intermediate';
1834 END IF;
1835 ELSIF "output_row"."member_id" = "loop_member_id_v" THEN
1836 "output_row"."loop" := 'first';
1837 "loop_v" := TRUE;
1838 END IF;
1839 IF "area_id_p" ISNULL AND "issue_id_p" ISNULL THEN
1840 "output_row"."participation" := NULL;
1841 END IF;
1842 RETURN NEXT "output_row";
1843 "i" := "i" + 1;
1844 END LOOP;
1845 RETURN;
1846 END;
1847 $$;
1849 COMMENT ON FUNCTION "delegation_chain"
1850 ( "member"."id"%TYPE,
1851 "area"."id"%TYPE,
1852 "issue"."id"%TYPE,
1853 "member"."id"%TYPE )
1854 IS 'Helper function for frontends to display delegation chains; Not part of internal voting logic';
1856 CREATE FUNCTION "delegation_chain"
1857 ( "member_id_p" "member"."id"%TYPE,
1858 "area_id_p" "area"."id"%TYPE,
1859 "issue_id_p" "issue"."id"%TYPE )
1860 RETURNS SETOF "delegation_chain_row"
1861 LANGUAGE 'plpgsql' STABLE AS $$
1862 DECLARE
1863 "result_row" "delegation_chain_row";
1864 BEGIN
1865 FOR "result_row" IN
1866 SELECT * FROM "delegation_chain"(
1867 "member_id_p", "area_id_p", "issue_id_p", NULL
1868 )
1869 LOOP
1870 RETURN NEXT "result_row";
1871 END LOOP;
1872 RETURN;
1873 END;
1874 $$;
1876 COMMENT ON FUNCTION "delegation_chain"
1877 ( "member"."id"%TYPE,
1878 "area"."id"%TYPE,
1879 "issue"."id"%TYPE )
1880 IS 'Shortcut for "delegation_chain"(...) function where 4th parameter is null';
1884 ------------------------------
1885 -- Comparison by vote count --
1886 ------------------------------
1888 CREATE FUNCTION "vote_ratio"
1889 ( "positive_votes_p" "initiative"."positive_votes"%TYPE,
1890 "negative_votes_p" "initiative"."negative_votes"%TYPE )
1891 RETURNS FLOAT8
1892 LANGUAGE 'plpgsql' STABLE AS $$
1893 BEGIN
1894 IF "positive_votes_p" > 0 AND "negative_votes_p" > 0 THEN
1895 RETURN
1896 "positive_votes_p"::FLOAT8 /
1897 ("positive_votes_p" + "negative_votes_p")::FLOAT8;
1898 ELSIF "positive_votes_p" > 0 THEN
1899 RETURN "positive_votes_p";
1900 ELSIF "negative_votes_p" > 0 THEN
1901 RETURN 1 - "negative_votes_p";
1902 ELSE
1903 RETURN 0.5;
1904 END IF;
1905 END;
1906 $$;
1908 COMMENT ON FUNCTION "vote_ratio"
1909 ( "initiative"."positive_votes"%TYPE,
1910 "initiative"."negative_votes"%TYPE )
1911 IS 'Returns a number, which can be used for comparison of initiatives based on count of approvals and disapprovals. Greater numbers indicate a better result. This function is NOT injective.';
1915 ------------------------------------------------
1916 -- Locking for snapshots and voting procedure --
1917 ------------------------------------------------
1920 CREATE FUNCTION "share_row_lock_issue_trigger"()
1921 RETURNS TRIGGER
1922 LANGUAGE 'plpgsql' VOLATILE AS $$
1923 BEGIN
1924 IF TG_OP = 'UPDATE' OR TG_OP = 'DELETE' THEN
1925 PERFORM NULL FROM "issue" WHERE "id" = OLD."issue_id" FOR SHARE;
1926 END IF;
1927 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
1928 PERFORM NULL FROM "issue" WHERE "id" = NEW."issue_id" FOR SHARE;
1929 RETURN NEW;
1930 ELSE
1931 RETURN OLD;
1932 END IF;
1933 END;
1934 $$;
1936 COMMENT ON FUNCTION "share_row_lock_issue_trigger"() IS 'Implementation of triggers "share_row_lock_issue" on multiple tables';
1939 CREATE FUNCTION "share_row_lock_issue_via_initiative_trigger"()
1940 RETURNS TRIGGER
1941 LANGUAGE 'plpgsql' VOLATILE AS $$
1942 BEGIN
1943 IF TG_OP = 'UPDATE' OR TG_OP = 'DELETE' THEN
1944 PERFORM NULL FROM "issue"
1945 JOIN "initiative" ON "issue"."id" = "initiative"."issue_id"
1946 WHERE "initiative"."id" = OLD."initiative_id"
1947 FOR SHARE OF "issue";
1948 END IF;
1949 IF TG_OP = 'INSERT' OR TG_OP = 'UPDATE' THEN
1950 PERFORM NULL FROM "issue"
1951 JOIN "initiative" ON "issue"."id" = "initiative"."issue_id"
1952 WHERE "initiative"."id" = NEW."initiative_id"
1953 FOR SHARE OF "issue";
1954 RETURN NEW;
1955 ELSE
1956 RETURN OLD;
1957 END IF;
1958 END;
1959 $$;
1961 COMMENT ON FUNCTION "share_row_lock_issue_trigger"() IS 'Implementation of trigger "share_row_lock_issue_via_initiative" on table "opinion"';
1964 CREATE TRIGGER "share_row_lock_issue"
1965 BEFORE INSERT OR UPDATE OR DELETE ON "initiative"
1966 FOR EACH ROW EXECUTE PROCEDURE
1967 "share_row_lock_issue_trigger"();
1969 CREATE TRIGGER "share_row_lock_issue"
1970 BEFORE INSERT OR UPDATE OR DELETE ON "interest"
1971 FOR EACH ROW EXECUTE PROCEDURE
1972 "share_row_lock_issue_trigger"();
1974 CREATE TRIGGER "share_row_lock_issue"
1975 BEFORE INSERT OR UPDATE OR DELETE ON "supporter"
1976 FOR EACH ROW EXECUTE PROCEDURE
1977 "share_row_lock_issue_trigger"();
1979 CREATE TRIGGER "share_row_lock_issue_via_initiative"
1980 BEFORE INSERT OR UPDATE OR DELETE ON "opinion"
1981 FOR EACH ROW EXECUTE PROCEDURE
1982 "share_row_lock_issue_via_initiative_trigger"();
1984 CREATE TRIGGER "share_row_lock_issue"
1985 BEFORE INSERT OR UPDATE OR DELETE ON "direct_voter"
1986 FOR EACH ROW EXECUTE PROCEDURE
1987 "share_row_lock_issue_trigger"();
1989 CREATE TRIGGER "share_row_lock_issue"
1990 BEFORE INSERT OR UPDATE OR DELETE ON "delegating_voter"
1991 FOR EACH ROW EXECUTE PROCEDURE
1992 "share_row_lock_issue_trigger"();
1994 CREATE TRIGGER "share_row_lock_issue"
1995 BEFORE INSERT OR UPDATE OR DELETE ON "vote"
1996 FOR EACH ROW EXECUTE PROCEDURE
1997 "share_row_lock_issue_trigger"();
1999 COMMENT ON TRIGGER "share_row_lock_issue" ON "initiative" IS 'See "lock_issue" function';
2000 COMMENT ON TRIGGER "share_row_lock_issue" ON "interest" IS 'See "lock_issue" function';
2001 COMMENT ON TRIGGER "share_row_lock_issue" ON "supporter" IS 'See "lock_issue" function';
2002 COMMENT ON TRIGGER "share_row_lock_issue_via_initiative" ON "opinion" IS 'See "lock_issue" function';
2003 COMMENT ON TRIGGER "share_row_lock_issue" ON "direct_voter" IS 'See "lock_issue" function';
2004 COMMENT ON TRIGGER "share_row_lock_issue" ON "delegating_voter" IS 'See "lock_issue" function';
2005 COMMENT ON TRIGGER "share_row_lock_issue" ON "vote" IS 'See "lock_issue" function';
2008 CREATE FUNCTION "lock_issue"
2009 ( "issue_id_p" "issue"."id"%TYPE )
2010 RETURNS VOID
2011 LANGUAGE 'plpgsql' VOLATILE AS $$
2012 BEGIN
2013 LOCK TABLE "member" IN SHARE MODE;
2014 LOCK TABLE "membership" IN SHARE MODE;
2015 LOCK TABLE "policy" IN SHARE MODE;
2016 PERFORM NULL FROM "issue" WHERE "id" = "issue_id_p" FOR UPDATE;
2017 -- NOTE: The row-level exclusive lock in combination with the
2018 -- share_row_lock_issue(_via_initiative)_trigger functions (which
2019 -- acquire a row-level share lock on the issue) ensure that no data
2020 -- is changed, which could affect calculation of snapshots or
2021 -- counting of votes. Table "delegation" must be table-level-locked,
2022 -- as it also contains issue- and global-scope delegations.
2023 LOCK TABLE "delegation" IN SHARE MODE;
2024 LOCK TABLE "direct_population_snapshot" IN EXCLUSIVE MODE;
2025 LOCK TABLE "delegating_population_snapshot" IN EXCLUSIVE MODE;
2026 LOCK TABLE "direct_interest_snapshot" IN EXCLUSIVE MODE;
2027 LOCK TABLE "delegating_interest_snapshot" IN EXCLUSIVE MODE;
2028 LOCK TABLE "direct_supporter_snapshot" IN EXCLUSIVE MODE;
2029 RETURN;
2030 END;
2031 $$;
2033 COMMENT ON FUNCTION "lock_issue"
2034 ( "issue"."id"%TYPE )
2035 IS 'Locks the issue and all other data which is used for calculating snapshots or counting votes.';
2039 -------------------------------
2040 -- Materialize member counts --
2041 -------------------------------
2043 CREATE FUNCTION "calculate_member_counts"()
2044 RETURNS VOID
2045 LANGUAGE 'plpgsql' VOLATILE AS $$
2046 BEGIN
2047 LOCK TABLE "member" IN SHARE MODE;
2048 LOCK TABLE "member_count" IN EXCLUSIVE MODE;
2049 LOCK TABLE "area" IN EXCLUSIVE MODE;
2050 LOCK TABLE "membership" IN SHARE MODE;
2051 DELETE FROM "member_count";
2052 INSERT INTO "member_count" ("total_count")
2053 SELECT "total_count" FROM "member_count_view";
2054 UPDATE "area" SET
2055 "direct_member_count" = "view"."direct_member_count",
2056 "member_weight" = "view"."member_weight",
2057 "autoreject_weight" = "view"."autoreject_weight"
2058 FROM "area_member_count" AS "view"
2059 WHERE "view"."area_id" = "area"."id";
2060 RETURN;
2061 END;
2062 $$;
2064 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 "area_member_count"';
2068 ------------------------------
2069 -- Calculation of snapshots --
2070 ------------------------------
2072 CREATE FUNCTION "weight_of_added_delegations_for_population_snapshot"
2073 ( "issue_id_p" "issue"."id"%TYPE,
2074 "member_id_p" "member"."id"%TYPE,
2075 "delegate_member_ids_p" "delegating_population_snapshot"."delegate_member_ids"%TYPE )
2076 RETURNS "direct_population_snapshot"."weight"%TYPE
2077 LANGUAGE 'plpgsql' VOLATILE AS $$
2078 DECLARE
2079 "issue_delegation_row" "issue_delegation"%ROWTYPE;
2080 "delegate_member_ids_v" "delegating_population_snapshot"."delegate_member_ids"%TYPE;
2081 "weight_v" INT4;
2082 "sub_weight_v" INT4;
2083 BEGIN
2084 "weight_v" := 0;
2085 FOR "issue_delegation_row" IN
2086 SELECT * FROM "issue_delegation"
2087 WHERE "trustee_id" = "member_id_p"
2088 AND "issue_id" = "issue_id_p"
2089 LOOP
2090 IF NOT EXISTS (
2091 SELECT NULL FROM "direct_population_snapshot"
2092 WHERE "issue_id" = "issue_id_p"
2093 AND "event" = 'periodic'
2094 AND "member_id" = "issue_delegation_row"."truster_id"
2095 ) AND NOT EXISTS (
2096 SELECT NULL FROM "delegating_population_snapshot"
2097 WHERE "issue_id" = "issue_id_p"
2098 AND "event" = 'periodic'
2099 AND "member_id" = "issue_delegation_row"."truster_id"
2100 ) THEN
2101 "delegate_member_ids_v" :=
2102 "member_id_p" || "delegate_member_ids_p";
2103 INSERT INTO "delegating_population_snapshot" (
2104 "issue_id",
2105 "event",
2106 "member_id",
2107 "scope",
2108 "delegate_member_ids"
2109 ) VALUES (
2110 "issue_id_p",
2111 'periodic',
2112 "issue_delegation_row"."truster_id",
2113 "issue_delegation_row"."scope",
2114 "delegate_member_ids_v"
2115 );
2116 "sub_weight_v" := 1 +
2117 "weight_of_added_delegations_for_population_snapshot"(
2118 "issue_id_p",
2119 "issue_delegation_row"."truster_id",
2120 "delegate_member_ids_v"
2121 );
2122 UPDATE "delegating_population_snapshot"
2123 SET "weight" = "sub_weight_v"
2124 WHERE "issue_id" = "issue_id_p"
2125 AND "event" = 'periodic'
2126 AND "member_id" = "issue_delegation_row"."truster_id";
2127 "weight_v" := "weight_v" + "sub_weight_v";
2128 END IF;
2129 END LOOP;
2130 RETURN "weight_v";
2131 END;
2132 $$;
2134 COMMENT ON FUNCTION "weight_of_added_delegations_for_population_snapshot"
2135 ( "issue"."id"%TYPE,
2136 "member"."id"%TYPE,
2137 "delegating_population_snapshot"."delegate_member_ids"%TYPE )
2138 IS 'Helper function for "create_population_snapshot" function';
2141 CREATE FUNCTION "create_population_snapshot"
2142 ( "issue_id_p" "issue"."id"%TYPE )
2143 RETURNS VOID
2144 LANGUAGE 'plpgsql' VOLATILE AS $$
2145 DECLARE
2146 "member_id_v" "member"."id"%TYPE;
2147 BEGIN
2148 DELETE FROM "direct_population_snapshot"
2149 WHERE "issue_id" = "issue_id_p"
2150 AND "event" = 'periodic';
2151 DELETE FROM "delegating_population_snapshot"
2152 WHERE "issue_id" = "issue_id_p"
2153 AND "event" = 'periodic';
2154 INSERT INTO "direct_population_snapshot"
2155 ("issue_id", "event", "member_id")
2156 SELECT
2157 "issue_id_p" AS "issue_id",
2158 'periodic'::"snapshot_event" AS "event",
2159 "member"."id" AS "member_id"
2160 FROM "issue"
2161 JOIN "area" ON "issue"."area_id" = "area"."id"
2162 JOIN "membership" ON "area"."id" = "membership"."area_id"
2163 JOIN "member" ON "membership"."member_id" = "member"."id"
2164 WHERE "issue"."id" = "issue_id_p"
2165 AND "member"."active"
2166 UNION
2167 SELECT
2168 "issue_id_p" AS "issue_id",
2169 'periodic'::"snapshot_event" AS "event",
2170 "member"."id" AS "member_id"
2171 FROM "interest" JOIN "member"
2172 ON "interest"."member_id" = "member"."id"
2173 WHERE "interest"."issue_id" = "issue_id_p"
2174 AND "member"."active";
2175 FOR "member_id_v" IN
2176 SELECT "member_id" FROM "direct_population_snapshot"
2177 WHERE "issue_id" = "issue_id_p"
2178 AND "event" = 'periodic'
2179 LOOP
2180 UPDATE "direct_population_snapshot" SET
2181 "weight" = 1 +
2182 "weight_of_added_delegations_for_population_snapshot"(
2183 "issue_id_p",
2184 "member_id_v",
2185 '{}'
2186 )
2187 WHERE "issue_id" = "issue_id_p"
2188 AND "event" = 'periodic'
2189 AND "member_id" = "member_id_v";
2190 END LOOP;
2191 RETURN;
2192 END;
2193 $$;
2195 COMMENT ON FUNCTION "create_population_snapshot"
2196 ( "issue"."id"%TYPE )
2197 IS 'This function creates a new ''periodic'' population snapshot for the given issue. It does neither lock any tables, nor updates precalculated values in other tables.';
2200 CREATE FUNCTION "weight_of_added_delegations_for_interest_snapshot"
2201 ( "issue_id_p" "issue"."id"%TYPE,
2202 "member_id_p" "member"."id"%TYPE,
2203 "delegate_member_ids_p" "delegating_interest_snapshot"."delegate_member_ids"%TYPE )
2204 RETURNS "direct_interest_snapshot"."weight"%TYPE
2205 LANGUAGE 'plpgsql' VOLATILE AS $$
2206 DECLARE
2207 "issue_delegation_row" "issue_delegation"%ROWTYPE;
2208 "delegate_member_ids_v" "delegating_interest_snapshot"."delegate_member_ids"%TYPE;
2209 "weight_v" INT4;
2210 "sub_weight_v" INT4;
2211 BEGIN
2212 "weight_v" := 0;
2213 FOR "issue_delegation_row" IN
2214 SELECT * FROM "issue_delegation"
2215 WHERE "trustee_id" = "member_id_p"
2216 AND "issue_id" = "issue_id_p"
2217 LOOP
2218 IF NOT EXISTS (
2219 SELECT NULL FROM "direct_interest_snapshot"
2220 WHERE "issue_id" = "issue_id_p"
2221 AND "event" = 'periodic'
2222 AND "member_id" = "issue_delegation_row"."truster_id"
2223 ) AND NOT EXISTS (
2224 SELECT NULL FROM "delegating_interest_snapshot"
2225 WHERE "issue_id" = "issue_id_p"
2226 AND "event" = 'periodic'
2227 AND "member_id" = "issue_delegation_row"."truster_id"
2228 ) THEN
2229 "delegate_member_ids_v" :=
2230 "member_id_p" || "delegate_member_ids_p";
2231 INSERT INTO "delegating_interest_snapshot" (
2232 "issue_id",
2233 "event",
2234 "member_id",
2235 "scope",
2236 "delegate_member_ids"
2237 ) VALUES (
2238 "issue_id_p",
2239 'periodic',
2240 "issue_delegation_row"."truster_id",
2241 "issue_delegation_row"."scope",
2242 "delegate_member_ids_v"
2243 );
2244 "sub_weight_v" := 1 +
2245 "weight_of_added_delegations_for_interest_snapshot"(
2246 "issue_id_p",
2247 "issue_delegation_row"."truster_id",
2248 "delegate_member_ids_v"
2249 );
2250 UPDATE "delegating_interest_snapshot"
2251 SET "weight" = "sub_weight_v"
2252 WHERE "issue_id" = "issue_id_p"
2253 AND "event" = 'periodic'
2254 AND "member_id" = "issue_delegation_row"."truster_id";
2255 "weight_v" := "weight_v" + "sub_weight_v";
2256 END IF;
2257 END LOOP;
2258 RETURN "weight_v";
2259 END;
2260 $$;
2262 COMMENT ON FUNCTION "weight_of_added_delegations_for_interest_snapshot"
2263 ( "issue"."id"%TYPE,
2264 "member"."id"%TYPE,
2265 "delegating_interest_snapshot"."delegate_member_ids"%TYPE )
2266 IS 'Helper function for "create_interest_snapshot" function';
2269 CREATE FUNCTION "create_interest_snapshot"
2270 ( "issue_id_p" "issue"."id"%TYPE )
2271 RETURNS VOID
2272 LANGUAGE 'plpgsql' VOLATILE AS $$
2273 DECLARE
2274 "member_id_v" "member"."id"%TYPE;
2275 BEGIN
2276 DELETE FROM "direct_interest_snapshot"
2277 WHERE "issue_id" = "issue_id_p"
2278 AND "event" = 'periodic';
2279 DELETE FROM "delegating_interest_snapshot"
2280 WHERE "issue_id" = "issue_id_p"
2281 AND "event" = 'periodic';
2282 DELETE FROM "direct_supporter_snapshot"
2283 WHERE "issue_id" = "issue_id_p"
2284 AND "event" = 'periodic';
2285 INSERT INTO "direct_interest_snapshot"
2286 ("issue_id", "event", "member_id", "voting_requested")
2287 SELECT
2288 "issue_id_p" AS "issue_id",
2289 'periodic' AS "event",
2290 "member"."id" AS "member_id",
2291 "interest"."voting_requested"
2292 FROM "interest" JOIN "member"
2293 ON "interest"."member_id" = "member"."id"
2294 WHERE "interest"."issue_id" = "issue_id_p"
2295 AND "member"."active";
2296 FOR "member_id_v" IN
2297 SELECT "member_id" FROM "direct_interest_snapshot"
2298 WHERE "issue_id" = "issue_id_p"
2299 AND "event" = 'periodic'
2300 LOOP
2301 UPDATE "direct_interest_snapshot" SET
2302 "weight" = 1 +
2303 "weight_of_added_delegations_for_interest_snapshot"(
2304 "issue_id_p",
2305 "member_id_v",
2306 '{}'
2307 )
2308 WHERE "issue_id" = "issue_id_p"
2309 AND "event" = 'periodic'
2310 AND "member_id" = "member_id_v";
2311 END LOOP;
2312 INSERT INTO "direct_supporter_snapshot"
2313 ( "issue_id", "initiative_id", "event", "member_id",
2314 "informed", "satisfied" )
2315 SELECT
2316 "issue_id_p" AS "issue_id",
2317 "initiative"."id" AS "initiative_id",
2318 'periodic' AS "event",
2319 "supporter"."member_id" AS "member_id",
2320 "supporter"."draft_id" = "current_draft"."id" AS "informed",
2321 NOT EXISTS (
2322 SELECT NULL FROM "critical_opinion"
2323 WHERE "initiative_id" = "initiative"."id"
2324 AND "member_id" = "supporter"."member_id"
2325 ) AS "satisfied"
2326 FROM "initiative"
2327 JOIN "supporter"
2328 ON "supporter"."initiative_id" = "initiative"."id"
2329 JOIN "current_draft"
2330 ON "initiative"."id" = "current_draft"."initiative_id"
2331 JOIN "direct_interest_snapshot"
2332 ON "supporter"."member_id" = "direct_interest_snapshot"."member_id"
2333 AND "initiative"."issue_id" = "direct_interest_snapshot"."issue_id"
2334 AND "event" = 'periodic'
2335 WHERE "initiative"."issue_id" = "issue_id_p";
2336 RETURN;
2337 END;
2338 $$;
2340 COMMENT ON FUNCTION "create_interest_snapshot"
2341 ( "issue"."id"%TYPE )
2342 IS 'This function creates a new ''periodic'' interest/supporter snapshot for the given issue. It does neither lock any tables, nor updates precalculated values in other tables.';
2345 CREATE FUNCTION "create_snapshot"
2346 ( "issue_id_p" "issue"."id"%TYPE )
2347 RETURNS VOID
2348 LANGUAGE 'plpgsql' VOLATILE AS $$
2349 DECLARE
2350 "initiative_id_v" "initiative"."id"%TYPE;
2351 "suggestion_id_v" "suggestion"."id"%TYPE;
2352 BEGIN
2353 PERFORM "lock_issue"("issue_id_p");
2354 PERFORM "create_population_snapshot"("issue_id_p");
2355 PERFORM "create_interest_snapshot"("issue_id_p");
2356 UPDATE "issue" SET
2357 "snapshot" = now(),
2358 "latest_snapshot_event" = 'periodic',
2359 "population" = (
2360 SELECT coalesce(sum("weight"), 0)
2361 FROM "direct_population_snapshot"
2362 WHERE "issue_id" = "issue_id_p"
2363 AND "event" = 'periodic'
2364 ),
2365 "vote_now" = (
2366 SELECT coalesce(sum("weight"), 0)
2367 FROM "direct_interest_snapshot"
2368 WHERE "issue_id" = "issue_id_p"
2369 AND "event" = 'periodic'
2370 AND "voting_requested" = TRUE
2371 ),
2372 "vote_later" = (
2373 SELECT coalesce(sum("weight"), 0)
2374 FROM "direct_interest_snapshot"
2375 WHERE "issue_id" = "issue_id_p"
2376 AND "event" = 'periodic'
2377 AND "voting_requested" = FALSE
2378 )
2379 WHERE "id" = "issue_id_p";
2380 FOR "initiative_id_v" IN
2381 SELECT "id" FROM "initiative" WHERE "issue_id" = "issue_id_p"
2382 LOOP
2383 UPDATE "initiative" SET
2384 "supporter_count" = (
2385 SELECT coalesce(sum("di"."weight"), 0)
2386 FROM "direct_interest_snapshot" AS "di"
2387 JOIN "direct_supporter_snapshot" AS "ds"
2388 ON "di"."member_id" = "ds"."member_id"
2389 WHERE "di"."issue_id" = "issue_id_p"
2390 AND "di"."event" = 'periodic'
2391 AND "ds"."initiative_id" = "initiative_id_v"
2392 AND "ds"."event" = 'periodic'
2393 ),
2394 "informed_supporter_count" = (
2395 SELECT coalesce(sum("di"."weight"), 0)
2396 FROM "direct_interest_snapshot" AS "di"
2397 JOIN "direct_supporter_snapshot" AS "ds"
2398 ON "di"."member_id" = "ds"."member_id"
2399 WHERE "di"."issue_id" = "issue_id_p"
2400 AND "di"."event" = 'periodic'
2401 AND "ds"."initiative_id" = "initiative_id_v"
2402 AND "ds"."event" = 'periodic'
2403 AND "ds"."informed"
2404 ),
2405 "satisfied_supporter_count" = (
2406 SELECT coalesce(sum("di"."weight"), 0)
2407 FROM "direct_interest_snapshot" AS "di"
2408 JOIN "direct_supporter_snapshot" AS "ds"
2409 ON "di"."member_id" = "ds"."member_id"
2410 WHERE "di"."issue_id" = "issue_id_p"
2411 AND "di"."event" = 'periodic'
2412 AND "ds"."initiative_id" = "initiative_id_v"
2413 AND "ds"."event" = 'periodic'
2414 AND "ds"."satisfied"
2415 ),
2416 "satisfied_informed_supporter_count" = (
2417 SELECT coalesce(sum("di"."weight"), 0)
2418 FROM "direct_interest_snapshot" AS "di"
2419 JOIN "direct_supporter_snapshot" AS "ds"
2420 ON "di"."member_id" = "ds"."member_id"
2421 WHERE "di"."issue_id" = "issue_id_p"
2422 AND "di"."event" = 'periodic'
2423 AND "ds"."initiative_id" = "initiative_id_v"
2424 AND "ds"."event" = 'periodic'
2425 AND "ds"."informed"
2426 AND "ds"."satisfied"
2427 )
2428 WHERE "id" = "initiative_id_v";
2429 FOR "suggestion_id_v" IN
2430 SELECT "id" FROM "suggestion"
2431 WHERE "initiative_id" = "initiative_id_v"
2432 LOOP
2433 UPDATE "suggestion" SET
2434 "minus2_unfulfilled_count" = (
2435 SELECT coalesce(sum("snapshot"."weight"), 0)
2436 FROM "issue" CROSS JOIN "opinion"
2437 JOIN "direct_interest_snapshot" AS "snapshot"
2438 ON "snapshot"."issue_id" = "issue"."id"
2439 AND "snapshot"."event" = "issue"."latest_snapshot_event"
2440 AND "snapshot"."member_id" = "opinion"."member_id"
2441 WHERE "issue"."id" = "issue_id_p"
2442 AND "opinion"."suggestion_id" = "suggestion_id_v"
2443 AND "opinion"."degree" = -2
2444 AND "opinion"."fulfilled" = FALSE
2445 ),
2446 "minus2_fulfilled_count" = (
2447 SELECT coalesce(sum("snapshot"."weight"), 0)
2448 FROM "issue" CROSS JOIN "opinion"
2449 JOIN "direct_interest_snapshot" AS "snapshot"
2450 ON "snapshot"."issue_id" = "issue"."id"
2451 AND "snapshot"."event" = "issue"."latest_snapshot_event"
2452 AND "snapshot"."member_id" = "opinion"."member_id"
2453 WHERE "issue"."id" = "issue_id_p"
2454 AND "opinion"."suggestion_id" = "suggestion_id_v"
2455 AND "opinion"."degree" = -2
2456 AND "opinion"."fulfilled" = TRUE
2457 ),
2458 "minus1_unfulfilled_count" = (
2459 SELECT coalesce(sum("snapshot"."weight"), 0)
2460 FROM "issue" CROSS JOIN "opinion"
2461 JOIN "direct_interest_snapshot" AS "snapshot"
2462 ON "snapshot"."issue_id" = "issue"."id"
2463 AND "snapshot"."event" = "issue"."latest_snapshot_event"
2464 AND "snapshot"."member_id" = "opinion"."member_id"
2465 WHERE "issue"."id" = "issue_id_p"
2466 AND "opinion"."suggestion_id" = "suggestion_id_v"
2467 AND "opinion"."degree" = -1
2468 AND "opinion"."fulfilled" = FALSE
2469 ),
2470 "minus1_fulfilled_count" = (
2471 SELECT coalesce(sum("snapshot"."weight"), 0)
2472 FROM "issue" CROSS JOIN "opinion"
2473 JOIN "direct_interest_snapshot" AS "snapshot"
2474 ON "snapshot"."issue_id" = "issue"."id"
2475 AND "snapshot"."event" = "issue"."latest_snapshot_event"
2476 AND "snapshot"."member_id" = "opinion"."member_id"
2477 WHERE "issue"."id" = "issue_id_p"
2478 AND "opinion"."suggestion_id" = "suggestion_id_v"
2479 AND "opinion"."degree" = -1
2480 AND "opinion"."fulfilled" = TRUE
2481 ),
2482 "plus1_unfulfilled_count" = (
2483 SELECT coalesce(sum("snapshot"."weight"), 0)
2484 FROM "issue" CROSS JOIN "opinion"
2485 JOIN "direct_interest_snapshot" AS "snapshot"
2486 ON "snapshot"."issue_id" = "issue"."id"
2487 AND "snapshot"."event" = "issue"."latest_snapshot_event"
2488 AND "snapshot"."member_id" = "opinion"."member_id"
2489 WHERE "issue"."id" = "issue_id_p"
2490 AND "opinion"."suggestion_id" = "suggestion_id_v"
2491 AND "opinion"."degree" = 1
2492 AND "opinion"."fulfilled" = FALSE
2493 ),
2494 "plus1_fulfilled_count" = (
2495 SELECT coalesce(sum("snapshot"."weight"), 0)
2496 FROM "issue" CROSS JOIN "opinion"
2497 JOIN "direct_interest_snapshot" AS "snapshot"
2498 ON "snapshot"."issue_id" = "issue"."id"
2499 AND "snapshot"."event" = "issue"."latest_snapshot_event"
2500 AND "snapshot"."member_id" = "opinion"."member_id"
2501 WHERE "issue"."id" = "issue_id_p"
2502 AND "opinion"."suggestion_id" = "suggestion_id_v"
2503 AND "opinion"."degree" = 1
2504 AND "opinion"."fulfilled" = TRUE
2505 ),
2506 "plus2_unfulfilled_count" = (
2507 SELECT coalesce(sum("snapshot"."weight"), 0)
2508 FROM "issue" CROSS JOIN "opinion"
2509 JOIN "direct_interest_snapshot" AS "snapshot"
2510 ON "snapshot"."issue_id" = "issue"."id"
2511 AND "snapshot"."event" = "issue"."latest_snapshot_event"
2512 AND "snapshot"."member_id" = "opinion"."member_id"
2513 WHERE "issue"."id" = "issue_id_p"
2514 AND "opinion"."suggestion_id" = "suggestion_id_v"
2515 AND "opinion"."degree" = 2
2516 AND "opinion"."fulfilled" = FALSE
2517 ),
2518 "plus2_fulfilled_count" = (
2519 SELECT coalesce(sum("snapshot"."weight"), 0)
2520 FROM "issue" CROSS JOIN "opinion"
2521 JOIN "direct_interest_snapshot" AS "snapshot"
2522 ON "snapshot"."issue_id" = "issue"."id"
2523 AND "snapshot"."event" = "issue"."latest_snapshot_event"
2524 AND "snapshot"."member_id" = "opinion"."member_id"
2525 WHERE "issue"."id" = "issue_id_p"
2526 AND "opinion"."suggestion_id" = "suggestion_id_v"
2527 AND "opinion"."degree" = 2
2528 AND "opinion"."fulfilled" = TRUE
2529 )
2530 WHERE "suggestion"."id" = "suggestion_id_v";
2531 END LOOP;
2532 END LOOP;
2533 RETURN;
2534 END;
2535 $$;
2537 COMMENT ON FUNCTION "create_snapshot"
2538 ( "issue"."id"%TYPE )
2539 IS 'This function creates a complete new ''periodic'' snapshot of population, interest and support for the given issue. All involved tables are locked, and after completion precalculated values in the source tables are updated.';
2542 CREATE FUNCTION "set_snapshot_event"
2543 ( "issue_id_p" "issue"."id"%TYPE,
2544 "event_p" "snapshot_event" )
2545 RETURNS VOID
2546 LANGUAGE 'plpgsql' VOLATILE AS $$
2547 DECLARE
2548 "event_v" "issue"."latest_snapshot_event"%TYPE;
2549 BEGIN
2550 SELECT "latest_snapshot_event" INTO "event_v" FROM "issue"
2551 WHERE "id" = "issue_id_p" FOR UPDATE;
2552 UPDATE "issue" SET "latest_snapshot_event" = "event_p"
2553 WHERE "id" = "issue_id_p";
2554 UPDATE "direct_population_snapshot" SET "event" = "event_p"
2555 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
2556 UPDATE "delegating_population_snapshot" SET "event" = "event_p"
2557 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
2558 UPDATE "direct_interest_snapshot" SET "event" = "event_p"
2559 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
2560 UPDATE "delegating_interest_snapshot" SET "event" = "event_p"
2561 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
2562 UPDATE "direct_supporter_snapshot" SET "event" = "event_p"
2563 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
2564 RETURN;
2565 END;
2566 $$;
2568 COMMENT ON FUNCTION "set_snapshot_event"
2569 ( "issue"."id"%TYPE,
2570 "snapshot_event" )
2571 IS 'Change "event" attribute of the previous ''periodic'' snapshot';
2575 ---------------------
2576 -- Freezing issues --
2577 ---------------------
2579 CREATE FUNCTION "freeze_after_snapshot"
2580 ( "issue_id_p" "issue"."id"%TYPE )
2581 RETURNS VOID
2582 LANGUAGE 'plpgsql' VOLATILE AS $$
2583 DECLARE
2584 "issue_row" "issue"%ROWTYPE;
2585 "policy_row" "policy"%ROWTYPE;
2586 "initiative_row" "initiative"%ROWTYPE;
2587 BEGIN
2588 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
2589 SELECT * INTO "policy_row"
2590 FROM "policy" WHERE "id" = "issue_row"."policy_id";
2591 PERFORM "set_snapshot_event"("issue_id_p", 'full_freeze');
2592 UPDATE "issue" SET
2593 "accepted" = coalesce("accepted", now()),
2594 "half_frozen" = coalesce("half_frozen", now()),
2595 "fully_frozen" = now()
2596 WHERE "id" = "issue_id_p";
2597 FOR "initiative_row" IN
2598 SELECT * FROM "initiative"
2599 WHERE "issue_id" = "issue_id_p" AND "revoked" ISNULL
2600 LOOP
2601 IF
2602 "initiative_row"."satisfied_supporter_count" > 0 AND
2603 "initiative_row"."satisfied_supporter_count" *
2604 "policy_row"."initiative_quorum_den" >=
2605 "issue_row"."population" * "policy_row"."initiative_quorum_num"
2606 THEN
2607 UPDATE "initiative" SET "admitted" = TRUE
2608 WHERE "id" = "initiative_row"."id";
2609 ELSE
2610 UPDATE "initiative" SET "admitted" = FALSE
2611 WHERE "id" = "initiative_row"."id";
2612 END IF;
2613 END LOOP;
2614 IF NOT EXISTS (
2615 SELECT NULL FROM "initiative"
2616 WHERE "issue_id" = "issue_id_p" AND "admitted" = TRUE
2617 ) THEN
2618 PERFORM "close_voting"("issue_id_p");
2619 END IF;
2620 RETURN;
2621 END;
2622 $$;
2624 COMMENT ON FUNCTION "freeze_after_snapshot"
2625 ( "issue"."id"%TYPE )
2626 IS 'This function freezes an issue (fully) and starts voting, but must only be called when "create_snapshot" was called in the same transaction.';
2629 CREATE FUNCTION "manual_freeze"("issue_id_p" "issue"."id"%TYPE)
2630 RETURNS VOID
2631 LANGUAGE 'plpgsql' VOLATILE AS $$
2632 DECLARE
2633 "issue_row" "issue"%ROWTYPE;
2634 BEGIN
2635 PERFORM "create_snapshot"("issue_id_p");
2636 PERFORM "freeze_after_snapshot"("issue_id_p");
2637 RETURN;
2638 END;
2639 $$;
2641 COMMENT ON FUNCTION "manual_freeze"
2642 ( "issue"."id"%TYPE )
2643 IS 'Freeze an issue manually (fully) and start voting';
2647 -----------------------
2648 -- Counting of votes --
2649 -----------------------
2652 CREATE FUNCTION "weight_of_added_vote_delegations"
2653 ( "issue_id_p" "issue"."id"%TYPE,
2654 "member_id_p" "member"."id"%TYPE,
2655 "delegate_member_ids_p" "delegating_voter"."delegate_member_ids"%TYPE )
2656 RETURNS "direct_voter"."weight"%TYPE
2657 LANGUAGE 'plpgsql' VOLATILE AS $$
2658 DECLARE
2659 "issue_delegation_row" "issue_delegation"%ROWTYPE;
2660 "delegate_member_ids_v" "delegating_voter"."delegate_member_ids"%TYPE;
2661 "weight_v" INT4;
2662 "sub_weight_v" INT4;
2663 BEGIN
2664 "weight_v" := 0;
2665 FOR "issue_delegation_row" IN
2666 SELECT * FROM "issue_delegation"
2667 WHERE "trustee_id" = "member_id_p"
2668 AND "issue_id" = "issue_id_p"
2669 LOOP
2670 IF NOT EXISTS (
2671 SELECT NULL FROM "direct_voter"
2672 WHERE "member_id" = "issue_delegation_row"."truster_id"
2673 AND "issue_id" = "issue_id_p"
2674 ) AND NOT EXISTS (
2675 SELECT NULL FROM "delegating_voter"
2676 WHERE "member_id" = "issue_delegation_row"."truster_id"
2677 AND "issue_id" = "issue_id_p"
2678 ) THEN
2679 "delegate_member_ids_v" :=
2680 "member_id_p" || "delegate_member_ids_p";
2681 INSERT INTO "delegating_voter" (
2682 "issue_id",
2683 "member_id",
2684 "scope",
2685 "delegate_member_ids"
2686 ) VALUES (
2687 "issue_id_p",
2688 "issue_delegation_row"."truster_id",
2689 "issue_delegation_row"."scope",
2690 "delegate_member_ids_v"
2691 );
2692 "sub_weight_v" := 1 +
2693 "weight_of_added_vote_delegations"(
2694 "issue_id_p",
2695 "issue_delegation_row"."truster_id",
2696 "delegate_member_ids_v"
2697 );
2698 UPDATE "delegating_voter"
2699 SET "weight" = "sub_weight_v"
2700 WHERE "issue_id" = "issue_id_p"
2701 AND "member_id" = "issue_delegation_row"."truster_id";
2702 "weight_v" := "weight_v" + "sub_weight_v";
2703 END IF;
2704 END LOOP;
2705 RETURN "weight_v";
2706 END;
2707 $$;
2709 COMMENT ON FUNCTION "weight_of_added_vote_delegations"
2710 ( "issue"."id"%TYPE,
2711 "member"."id"%TYPE,
2712 "delegating_voter"."delegate_member_ids"%TYPE )
2713 IS 'Helper function for "add_vote_delegations" function';
2716 CREATE FUNCTION "add_vote_delegations"
2717 ( "issue_id_p" "issue"."id"%TYPE )
2718 RETURNS VOID
2719 LANGUAGE 'plpgsql' VOLATILE AS $$
2720 DECLARE
2721 "member_id_v" "member"."id"%TYPE;
2722 BEGIN
2723 FOR "member_id_v" IN
2724 SELECT "member_id" FROM "direct_voter"
2725 WHERE "issue_id" = "issue_id_p"
2726 LOOP
2727 UPDATE "direct_voter" SET
2728 "weight" = "weight" + "weight_of_added_vote_delegations"(
2729 "issue_id_p",
2730 "member_id_v",
2731 '{}'
2732 )
2733 WHERE "member_id" = "member_id_v"
2734 AND "issue_id" = "issue_id_p";
2735 END LOOP;
2736 RETURN;
2737 END;
2738 $$;
2740 COMMENT ON FUNCTION "add_vote_delegations"
2741 ( "issue_id_p" "issue"."id"%TYPE )
2742 IS 'Helper function for "close_voting" function';
2745 CREATE FUNCTION "close_voting"("issue_id_p" "issue"."id"%TYPE)
2746 RETURNS VOID
2747 LANGUAGE 'plpgsql' VOLATILE AS $$
2748 DECLARE
2749 "issue_row" "issue"%ROWTYPE;
2750 "member_id_v" "member"."id"%TYPE;
2751 BEGIN
2752 PERFORM "lock_issue"("issue_id_p");
2753 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
2754 DELETE FROM "delegating_voter"
2755 WHERE "issue_id" = "issue_id_p";
2756 DELETE FROM "direct_voter"
2757 WHERE "issue_id" = "issue_id_p"
2758 AND "autoreject" = TRUE;
2759 DELETE FROM "direct_voter" USING "member"
2760 WHERE "direct_voter"."member_id" = "member"."id"
2761 AND "direct_voter"."issue_id" = "issue_id_p"
2762 AND "member"."active" = FALSE;
2763 UPDATE "direct_voter" SET "weight" = 1
2764 WHERE "issue_id" = "issue_id_p";
2765 PERFORM "add_vote_delegations"("issue_id_p");
2766 FOR "member_id_v" IN
2767 SELECT "interest"."member_id"
2768 FROM "interest"
2769 JOIN "member"
2770 ON "interest"."member_id" = "member"."id"
2771 LEFT JOIN "direct_voter"
2772 ON "interest"."member_id" = "direct_voter"."member_id"
2773 AND "interest"."issue_id" = "direct_voter"."issue_id"
2774 LEFT JOIN "delegating_voter"
2775 ON "interest"."member_id" = "delegating_voter"."member_id"
2776 AND "interest"."issue_id" = "delegating_voter"."issue_id"
2777 WHERE "interest"."issue_id" = "issue_id_p"
2778 AND "interest"."autoreject" = TRUE
2779 AND "member"."active"
2780 AND "direct_voter"."member_id" ISNULL
2781 AND "delegating_voter"."member_id" ISNULL
2782 UNION SELECT "membership"."member_id"
2783 FROM "membership"
2784 JOIN "member"
2785 ON "membership"."member_id" = "member"."id"
2786 LEFT JOIN "interest"
2787 ON "membership"."member_id" = "interest"."member_id"
2788 AND "interest"."issue_id" = "issue_id_p"
2789 LEFT JOIN "direct_voter"
2790 ON "membership"."member_id" = "direct_voter"."member_id"
2791 AND "direct_voter"."issue_id" = "issue_id_p"
2792 LEFT JOIN "delegating_voter"
2793 ON "membership"."member_id" = "delegating_voter"."member_id"
2794 AND "delegating_voter"."issue_id" = "issue_id_p"
2795 WHERE "membership"."area_id" = "issue_row"."area_id"
2796 AND "membership"."autoreject" = TRUE
2797 AND "member"."active"
2798 AND "interest"."autoreject" ISNULL
2799 AND "direct_voter"."member_id" ISNULL
2800 AND "delegating_voter"."member_id" ISNULL
2801 LOOP
2802 INSERT INTO "direct_voter"
2803 ("member_id", "issue_id", "weight", "autoreject") VALUES
2804 ("member_id_v", "issue_id_p", 1, TRUE);
2805 INSERT INTO "vote" (
2806 "member_id",
2807 "issue_id",
2808 "initiative_id",
2809 "grade"
2810 ) SELECT
2811 "member_id_v" AS "member_id",
2812 "issue_id_p" AS "issue_id",
2813 "id" AS "initiative_id",
2814 -1 AS "grade"
2815 FROM "initiative" WHERE "issue_id" = "issue_id_p";
2816 END LOOP;
2817 PERFORM "add_vote_delegations"("issue_id_p");
2818 UPDATE "issue" SET
2819 "closed" = now(),
2820 "voter_count" = (
2821 SELECT coalesce(sum("weight"), 0)
2822 FROM "direct_voter" WHERE "issue_id" = "issue_id_p"
2823 )
2824 WHERE "id" = "issue_id_p";
2825 UPDATE "initiative" SET
2826 "positive_votes" = "vote_counts"."positive_votes",
2827 "negative_votes" = "vote_counts"."negative_votes",
2828 "agreed" = CASE WHEN "majority_strict" THEN
2829 "vote_counts"."positive_votes" * "majority_den" >
2830 "majority_num" *
2831 ("vote_counts"."positive_votes"+"vote_counts"."negative_votes")
2832 ELSE
2833 "vote_counts"."positive_votes" * "majority_den" >=
2834 "majority_num" *
2835 ("vote_counts"."positive_votes"+"vote_counts"."negative_votes")
2836 END
2837 FROM
2838 ( SELECT
2839 "initiative"."id" AS "initiative_id",
2840 coalesce(
2841 sum(
2842 CASE WHEN "grade" > 0 THEN "direct_voter"."weight" ELSE 0 END
2843 ),
2844 0
2845 ) AS "positive_votes",
2846 coalesce(
2847 sum(
2848 CASE WHEN "grade" < 0 THEN "direct_voter"."weight" ELSE 0 END
2849 ),
2850 0
2851 ) AS "negative_votes"
2852 FROM "initiative"
2853 JOIN "issue" ON "initiative"."issue_id" = "issue"."id"
2854 JOIN "policy" ON "issue"."policy_id" = "policy"."id"
2855 LEFT JOIN "direct_voter"
2856 ON "direct_voter"."issue_id" = "initiative"."issue_id"
2857 LEFT JOIN "vote"
2858 ON "vote"."initiative_id" = "initiative"."id"
2859 AND "vote"."member_id" = "direct_voter"."member_id"
2860 WHERE "initiative"."issue_id" = "issue_id_p"
2861 AND "initiative"."admitted" -- NOTE: NULL case is handled too
2862 GROUP BY "initiative"."id"
2863 ) AS "vote_counts",
2864 "issue",
2865 "policy"
2866 WHERE "vote_counts"."initiative_id" = "initiative"."id"
2867 AND "issue"."id" = "initiative"."issue_id"
2868 AND "policy"."id" = "issue"."policy_id";
2869 -- NOTE: "closed" column of issue must be set at this point
2870 DELETE FROM "battle" WHERE "issue_id" = "issue_id_p";
2871 INSERT INTO "battle" (
2872 "issue_id",
2873 "winning_initiative_id", "losing_initiative_id",
2874 "count"
2875 ) SELECT
2876 "issue_id",
2877 "winning_initiative_id", "losing_initiative_id",
2878 "count"
2879 FROM "battle_view" WHERE "issue_id" = "issue_id_p";
2880 END;
2881 $$;
2883 COMMENT ON FUNCTION "close_voting"
2884 ( "issue"."id"%TYPE )
2885 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.';
2888 CREATE FUNCTION "defeat_strength"
2889 ( "positive_votes_p" INT4, "negative_votes_p" INT4 )
2890 RETURNS INT8
2891 LANGUAGE 'plpgsql' IMMUTABLE AS $$
2892 BEGIN
2893 IF "positive_votes_p" > "negative_votes_p" THEN
2894 RETURN ("positive_votes_p"::INT8 << 31) - "negative_votes_p"::INT8;
2895 ELSIF "positive_votes_p" = "negative_votes_p" THEN
2896 RETURN 0;
2897 ELSE
2898 RETURN -1;
2899 END IF;
2900 END;
2901 $$;
2903 COMMENT ON FUNCTION "defeat_strength"(INT4, INT4) IS 'Calculates defeat strength (INT8!) of a pairwise defeat primarily by the absolute number of votes for the winner and secondarily by the absolute number of votes for the loser';
2906 CREATE FUNCTION "array_init_string"("dim_p" INTEGER)
2907 RETURNS TEXT
2908 LANGUAGE 'plpgsql' IMMUTABLE AS $$
2909 DECLARE
2910 "i" INTEGER;
2911 "ary_text_v" TEXT;
2912 BEGIN
2913 IF "dim_p" >= 1 THEN
2914 "ary_text_v" := '{NULL';
2915 "i" := "dim_p";
2916 LOOP
2917 "i" := "i" - 1;
2918 EXIT WHEN "i" = 0;
2919 "ary_text_v" := "ary_text_v" || ',NULL';
2920 END LOOP;
2921 "ary_text_v" := "ary_text_v" || '}';
2922 RETURN "ary_text_v";
2923 ELSE
2924 RAISE EXCEPTION 'Dimension needs to be at least 1.';
2925 END IF;
2926 END;
2927 $$;
2929 COMMENT ON FUNCTION "array_init_string"(INTEGER) IS 'Needed for PostgreSQL < 8.4, due to missing "array_fill" function';
2932 CREATE FUNCTION "square_matrix_init_string"("dim_p" INTEGER)
2933 RETURNS TEXT
2934 LANGUAGE 'plpgsql' IMMUTABLE AS $$
2935 DECLARE
2936 "i" INTEGER;
2937 "row_text_v" TEXT;
2938 "ary_text_v" TEXT;
2939 BEGIN
2940 IF "dim_p" >= 1 THEN
2941 "row_text_v" := '{NULL';
2942 "i" := "dim_p";
2943 LOOP
2944 "i" := "i" - 1;
2945 EXIT WHEN "i" = 0;
2946 "row_text_v" := "row_text_v" || ',NULL';
2947 END LOOP;
2948 "row_text_v" := "row_text_v" || '}';
2949 "ary_text_v" := '{' || "row_text_v";
2950 "i" := "dim_p";
2951 LOOP
2952 "i" := "i" - 1;
2953 EXIT WHEN "i" = 0;
2954 "ary_text_v" := "ary_text_v" || ',' || "row_text_v";
2955 END LOOP;
2956 "ary_text_v" := "ary_text_v" || '}';
2957 RETURN "ary_text_v";
2958 ELSE
2959 RAISE EXCEPTION 'Dimension needs to be at least 1.';
2960 END IF;
2961 END;
2962 $$;
2964 COMMENT ON FUNCTION "square_matrix_init_string"(INTEGER) IS 'Needed for PostgreSQL < 8.4, due to missing "array_fill" function';
2967 CREATE FUNCTION "calculate_ranks"("issue_id_p" "issue"."id"%TYPE)
2968 RETURNS VOID
2969 LANGUAGE 'plpgsql' VOLATILE AS $$
2970 DECLARE
2971 "dimension_v" INTEGER;
2972 "vote_matrix" INT4[][]; -- absolute votes
2973 "matrix" INT8[][]; -- defeat strength / best paths
2974 "i" INTEGER;
2975 "j" INTEGER;
2976 "k" INTEGER;
2977 "battle_row" "battle"%ROWTYPE;
2978 "rank_ary" INT4[];
2979 "rank_v" INT4;
2980 "done_v" INTEGER;
2981 "winners_ary" INTEGER[];
2982 "initiative_id_v" "initiative"."id"%TYPE;
2983 BEGIN
2984 PERFORM NULL FROM "issue" WHERE "id" = "issue_id_p" FOR UPDATE;
2985 SELECT count(1) INTO "dimension_v" FROM "initiative"
2986 WHERE "issue_id" = "issue_id_p" AND "agreed";
2987 IF "dimension_v" = 1 THEN
2988 UPDATE "initiative" SET "rank" = 1
2989 WHERE "issue_id" = "issue_id_p" AND "agreed";
2990 ELSIF "dimension_v" > 1 THEN
2991 -- Create "vote_matrix" with absolute number of votes in pairwise
2992 -- comparison:
2993 "vote_matrix" := "square_matrix_init_string"("dimension_v"); -- TODO: replace by "array_fill" function (PostgreSQL 8.4)
2994 "i" := 1;
2995 "j" := 2;
2996 FOR "battle_row" IN
2997 SELECT * FROM "battle" WHERE "issue_id" = "issue_id_p"
2998 ORDER BY "winning_initiative_id", "losing_initiative_id"
2999 LOOP
3000 "vote_matrix"["i"]["j"] := "battle_row"."count";
3001 IF "j" = "dimension_v" THEN
3002 "i" := "i" + 1;
3003 "j" := 1;
3004 ELSE
3005 "j" := "j" + 1;
3006 IF "j" = "i" THEN
3007 "j" := "j" + 1;
3008 END IF;
3009 END IF;
3010 END LOOP;
3011 IF "i" != "dimension_v" OR "j" != "dimension_v" + 1 THEN
3012 RAISE EXCEPTION 'Wrong battle count (should not happen)';
3013 END IF;
3014 -- Store defeat strengths in "matrix" using "defeat_strength"
3015 -- function:
3016 "matrix" := "square_matrix_init_string"("dimension_v"); -- TODO: replace by "array_fill" function (PostgreSQL 8.4)
3017 "i" := 1;
3018 LOOP
3019 "j" := 1;
3020 LOOP
3021 IF "i" != "j" THEN
3022 "matrix"["i"]["j"] := "defeat_strength"(
3023 "vote_matrix"["i"]["j"],
3024 "vote_matrix"["j"]["i"]
3025 );
3026 END IF;
3027 EXIT WHEN "j" = "dimension_v";
3028 "j" := "j" + 1;
3029 END LOOP;
3030 EXIT WHEN "i" = "dimension_v";
3031 "i" := "i" + 1;
3032 END LOOP;
3033 -- Find best paths:
3034 "i" := 1;
3035 LOOP
3036 "j" := 1;
3037 LOOP
3038 IF "i" != "j" THEN
3039 "k" := 1;
3040 LOOP
3041 IF "i" != "k" AND "j" != "k" THEN
3042 IF "matrix"["j"]["i"] < "matrix"["i"]["k"] THEN
3043 IF "matrix"["j"]["i"] > "matrix"["j"]["k"] THEN
3044 "matrix"["j"]["k"] := "matrix"["j"]["i"];
3045 END IF;
3046 ELSE
3047 IF "matrix"["i"]["k"] > "matrix"["j"]["k"] THEN
3048 "matrix"["j"]["k"] := "matrix"["i"]["k"];
3049 END IF;
3050 END IF;
3051 END IF;
3052 EXIT WHEN "k" = "dimension_v";
3053 "k" := "k" + 1;
3054 END LOOP;
3055 END IF;
3056 EXIT WHEN "j" = "dimension_v";
3057 "j" := "j" + 1;
3058 END LOOP;
3059 EXIT WHEN "i" = "dimension_v";
3060 "i" := "i" + 1;
3061 END LOOP;
3062 -- Determine order of winners:
3063 "rank_ary" := "array_init_string"("dimension_v"); -- TODO: replace by "array_fill" function (PostgreSQL 8.4)
3064 "rank_v" := 1;
3065 "done_v" := 0;
3066 LOOP
3067 "winners_ary" := '{}';
3068 "i" := 1;
3069 LOOP
3070 IF "rank_ary"["i"] ISNULL THEN
3071 "j" := 1;
3072 LOOP
3073 IF
3074 "i" != "j" AND
3075 "rank_ary"["j"] ISNULL AND
3076 "matrix"["j"]["i"] > "matrix"["i"]["j"]
3077 THEN
3078 -- someone else is better
3079 EXIT;
3080 END IF;
3081 IF "j" = "dimension_v" THEN
3082 -- noone is better
3083 "winners_ary" := "winners_ary" || "i";
3084 EXIT;
3085 END IF;
3086 "j" := "j" + 1;
3087 END LOOP;
3088 END IF;
3089 EXIT WHEN "i" = "dimension_v";
3090 "i" := "i" + 1;
3091 END LOOP;
3092 "i" := 1;
3093 LOOP
3094 "rank_ary"["winners_ary"["i"]] := "rank_v";
3095 "done_v" := "done_v" + 1;
3096 EXIT WHEN "i" = array_upper("winners_ary", 1);
3097 "i" := "i" + 1;
3098 END LOOP;
3099 EXIT WHEN "done_v" = "dimension_v";
3100 "rank_v" := "rank_v" + 1;
3101 END LOOP;
3102 -- write preliminary ranks:
3103 "i" := 1;
3104 FOR "initiative_id_v" IN
3105 SELECT "id" FROM "initiative"
3106 WHERE "issue_id" = "issue_id_p" AND "agreed"
3107 ORDER BY "id"
3108 LOOP
3109 UPDATE "initiative" SET "rank" = "rank_ary"["i"]
3110 WHERE "id" = "initiative_id_v";
3111 "i" := "i" + 1;
3112 END LOOP;
3113 IF "i" != "dimension_v" + 1 THEN
3114 RAISE EXCEPTION 'Wrong winner count (should not happen)';
3115 END IF;
3116 -- straighten ranks (start counting with 1, no equal ranks):
3117 "rank_v" := 1;
3118 FOR "initiative_id_v" IN
3119 SELECT "id" FROM "initiative"
3120 WHERE "issue_id" = "issue_id_p" AND "rank" NOTNULL
3121 ORDER BY
3122 "rank",
3123 "vote_ratio"("positive_votes", "negative_votes") DESC,
3124 "id"
3125 LOOP
3126 UPDATE "initiative" SET "rank" = "rank_v"
3127 WHERE "id" = "initiative_id_v";
3128 "rank_v" := "rank_v" + 1;
3129 END LOOP;
3130 END IF;
3131 -- mark issue as finished
3132 UPDATE "issue" SET "ranks_available" = TRUE
3133 WHERE "id" = "issue_id_p";
3134 RETURN;
3135 END;
3136 $$;
3138 COMMENT ON FUNCTION "calculate_ranks"
3139 ( "issue"."id"%TYPE )
3140 IS 'Determine ranking (Votes have to be counted first)';
3144 -----------------------------
3145 -- Automatic state changes --
3146 -----------------------------
3149 CREATE FUNCTION "check_issue"
3150 ( "issue_id_p" "issue"."id"%TYPE )
3151 RETURNS VOID
3152 LANGUAGE 'plpgsql' VOLATILE AS $$
3153 DECLARE
3154 "issue_row" "issue"%ROWTYPE;
3155 "policy_row" "policy"%ROWTYPE;
3156 "voting_requested_v" BOOLEAN;
3157 BEGIN
3158 PERFORM "lock_issue"("issue_id_p");
3159 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
3160 -- only process open issues:
3161 IF "issue_row"."closed" ISNULL THEN
3162 SELECT * INTO "policy_row" FROM "policy"
3163 WHERE "id" = "issue_row"."policy_id";
3164 -- create a snapshot, unless issue is already fully frozen:
3165 IF "issue_row"."fully_frozen" ISNULL THEN
3166 PERFORM "create_snapshot"("issue_id_p");
3167 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
3168 END IF;
3169 -- eventually close or accept issues, which have not been accepted:
3170 IF "issue_row"."accepted" ISNULL THEN
3171 IF EXISTS (
3172 SELECT NULL FROM "initiative"
3173 WHERE "issue_id" = "issue_id_p"
3174 AND "supporter_count" > 0
3175 AND "supporter_count" * "policy_row"."issue_quorum_den"
3176 >= "issue_row"."population" * "policy_row"."issue_quorum_num"
3177 ) THEN
3178 -- accept issues, if supporter count is high enough
3179 PERFORM "set_snapshot_event"("issue_id_p", 'end_of_admission');
3180 "issue_row"."accepted" = now(); -- NOTE: "issue_row" used later
3181 UPDATE "issue" SET "accepted" = "issue_row"."accepted"
3182 WHERE "id" = "issue_row"."id";
3183 ELSIF
3184 now() >= "issue_row"."created" + "issue_row"."admission_time"
3185 THEN
3186 -- close issues, if admission time has expired
3187 PERFORM "set_snapshot_event"("issue_id_p", 'end_of_admission');
3188 UPDATE "issue" SET "closed" = now()
3189 WHERE "id" = "issue_row"."id";
3190 END IF;
3191 END IF;
3192 -- eventually half freeze issues:
3193 IF
3194 -- NOTE: issue can't be closed at this point, if it has been accepted
3195 "issue_row"."accepted" NOTNULL AND
3196 "issue_row"."half_frozen" ISNULL
3197 THEN
3198 SELECT
3199 CASE
3200 WHEN "vote_now" * 2 > "issue_row"."population" THEN
3201 TRUE
3202 WHEN "vote_later" * 2 > "issue_row"."population" THEN
3203 FALSE
3204 ELSE NULL
3205 END
3206 INTO "voting_requested_v"
3207 FROM "issue" WHERE "id" = "issue_id_p";
3208 IF
3209 "voting_requested_v" OR (
3210 "voting_requested_v" ISNULL AND
3211 now() >= "issue_row"."accepted" + "issue_row"."discussion_time"
3212 )
3213 THEN
3214 PERFORM "set_snapshot_event"("issue_id_p", 'half_freeze');
3215 "issue_row"."half_frozen" = now(); -- NOTE: "issue_row" used later
3216 UPDATE "issue" SET "half_frozen" = "issue_row"."half_frozen"
3217 WHERE "id" = "issue_row"."id";
3218 END IF;
3219 END IF;
3220 -- close issues after some time, if all initiatives have been revoked:
3221 IF
3222 "issue_row"."closed" ISNULL AND
3223 NOT EXISTS (
3224 -- all initiatives are revoked
3225 SELECT NULL FROM "initiative"
3226 WHERE "issue_id" = "issue_id_p" AND "revoked" ISNULL
3227 ) AND (
3228 NOT EXISTS (
3229 -- and no initiatives have been revoked lately
3230 SELECT NULL FROM "initiative"
3231 WHERE "issue_id" = "issue_id_p"
3232 AND now() < "revoked" + "issue_row"."verification_time"
3233 ) OR (
3234 -- or verification time has elapsed
3235 "issue_row"."half_frozen" NOTNULL AND
3236 "issue_row"."fully_frozen" ISNULL AND
3237 now() >= "issue_row"."half_frozen" + "issue_row"."verification_time"
3238 )
3239 )
3240 THEN
3241 "issue_row"."closed" = now(); -- NOTE: "issue_row" used later
3242 UPDATE "issue" SET "closed" = "issue_row"."closed"
3243 WHERE "id" = "issue_row"."id";
3244 END IF;
3245 -- fully freeze issue after verification time:
3246 IF
3247 "issue_row"."half_frozen" NOTNULL AND
3248 "issue_row"."fully_frozen" ISNULL AND
3249 "issue_row"."closed" ISNULL AND
3250 now() >= "issue_row"."half_frozen" + "issue_row"."verification_time"
3251 THEN
3252 PERFORM "freeze_after_snapshot"("issue_id_p");
3253 -- NOTE: "issue" might change, thus "issue_row" has to be updated below
3254 END IF;
3255 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
3256 -- close issue by calling close_voting(...) after voting time:
3257 IF
3258 "issue_row"."closed" ISNULL AND
3259 "issue_row"."fully_frozen" NOTNULL AND
3260 now() >= "issue_row"."fully_frozen" + "issue_row"."voting_time"
3261 THEN
3262 PERFORM "close_voting"("issue_id_p");
3263 END IF;
3264 END IF;
3265 RETURN;
3266 END;
3267 $$;
3269 COMMENT ON FUNCTION "check_issue"
3270 ( "issue"."id"%TYPE )
3271 IS 'Precalculate supporter counts etc. for a given issue, and check, if status change is required; At end of voting the ranking is not calculated by this function, but must be calculated in a seperate transaction using the "calculate_ranks" function.';
3274 CREATE FUNCTION "check_everything"()
3275 RETURNS VOID
3276 LANGUAGE 'plpgsql' VOLATILE AS $$
3277 DECLARE
3278 "issue_id_v" "issue"."id"%TYPE;
3279 BEGIN
3280 DELETE FROM "expired_session";
3281 PERFORM "calculate_member_counts"();
3282 FOR "issue_id_v" IN SELECT "id" FROM "open_issue" LOOP
3283 PERFORM "check_issue"("issue_id_v");
3284 END LOOP;
3285 FOR "issue_id_v" IN SELECT "id" FROM "issue_with_ranks_missing" LOOP
3286 PERFORM "calculate_ranks"("issue_id_v");
3287 END LOOP;
3288 RETURN;
3289 END;
3290 $$;
3292 COMMENT ON FUNCTION "check_everything"() IS 'Perform "check_issue" for every open issue, and if possible, automatically calculate ranks. Use this function only for development and debugging purposes, as long transactions with exclusive locking may result.';
3296 ----------------------
3297 -- Deletion of data --
3298 ----------------------
3301 CREATE FUNCTION "clean_issue"("issue_id_p" "issue"."id"%TYPE)
3302 RETURNS VOID
3303 LANGUAGE 'plpgsql' VOLATILE AS $$
3304 DECLARE
3305 "issue_row" "issue"%ROWTYPE;
3306 BEGIN
3307 SELECT * INTO "issue_row"
3308 FROM "issue" WHERE "id" = "issue_id_p"
3309 FOR UPDATE;
3310 IF "issue_row"."cleaned" ISNULL THEN
3311 UPDATE "issue" SET
3312 "closed" = NULL,
3313 "ranks_available" = FALSE
3314 WHERE "id" = "issue_id_p";
3315 DELETE FROM "delegating_voter"
3316 WHERE "issue_id" = "issue_id_p";
3317 DELETE FROM "direct_voter"
3318 WHERE "issue_id" = "issue_id_p";
3319 DELETE FROM "delegating_interest_snapshot"
3320 WHERE "issue_id" = "issue_id_p";
3321 DELETE FROM "direct_interest_snapshot"
3322 WHERE "issue_id" = "issue_id_p";
3323 DELETE FROM "delegating_population_snapshot"
3324 WHERE "issue_id" = "issue_id_p";
3325 DELETE FROM "direct_population_snapshot"
3326 WHERE "issue_id" = "issue_id_p";
3327 DELETE FROM "ignored_issue"
3328 WHERE "issue_id" = "issue_id_p";
3329 DELETE FROM "delegation"
3330 WHERE "issue_id" = "issue_id_p";
3331 DELETE FROM "supporter"
3332 WHERE "issue_id" = "issue_id_p";
3333 UPDATE "issue" SET
3334 "closed" = "issue_row"."closed",
3335 "ranks_available" = "issue_row"."ranks_available",
3336 "cleaned" = now()
3337 WHERE "id" = "issue_id_p";
3338 END IF;
3339 RETURN;
3340 END;
3341 $$;
3343 COMMENT ON FUNCTION "clean_issue"("issue"."id"%TYPE) IS 'Delete discussion data and votes belonging to an issue';
3346 CREATE FUNCTION "delete_member"("member_id_p" "member"."id"%TYPE)
3347 RETURNS VOID
3348 LANGUAGE 'plpgsql' VOLATILE AS $$
3349 BEGIN
3350 UPDATE "member" SET
3351 "last_login" = NULL,
3352 "login" = NULL,
3353 "password" = NULL,
3354 "active" = FALSE,
3355 "notify_email" = NULL,
3356 "notify_email_unconfirmed" = NULL,
3357 "notify_email_secret" = NULL,
3358 "notify_email_secret_expiry" = NULL,
3359 "notify_email_lock_expiry" = NULL,
3360 "password_reset_secret" = NULL,
3361 "password_reset_secret_expiry" = NULL,
3362 "organizational_unit" = NULL,
3363 "internal_posts" = NULL,
3364 "realname" = NULL,
3365 "birthday" = NULL,
3366 "address" = NULL,
3367 "email" = NULL,
3368 "xmpp_address" = NULL,
3369 "website" = NULL,
3370 "phone" = NULL,
3371 "mobile_phone" = NULL,
3372 "profession" = NULL,
3373 "external_memberships" = NULL,
3374 "external_posts" = NULL,
3375 "statement" = NULL
3376 WHERE "id" = "member_id_p";
3377 -- "text_search_data" is updated by triggers
3378 DELETE FROM "setting" WHERE "member_id" = "member_id_p";
3379 DELETE FROM "setting_map" WHERE "member_id" = "member_id_p";
3380 DELETE FROM "member_relation_setting" WHERE "member_id" = "member_id_p";
3381 DELETE FROM "member_image" WHERE "member_id" = "member_id_p";
3382 DELETE FROM "contact" WHERE "member_id" = "member_id_p";
3383 DELETE FROM "area_setting" WHERE "member_id" = "member_id_p";
3384 DELETE FROM "issue_setting" WHERE "member_id" = "member_id_p";
3385 DELETE FROM "initiative_setting" WHERE "member_id" = "member_id_p";
3386 DELETE FROM "suggestion_setting" WHERE "member_id" = "member_id_p";
3387 DELETE FROM "membership" WHERE "member_id" = "member_id_p";
3388 DELETE FROM "ignored_issue" WHERE "member_id" = "member_id_p";
3389 DELETE FROM "delegation" WHERE "truster_id" = "member_id_p";
3390 DELETE FROM "direct_voter" USING "issue"
3391 WHERE "direct_voter"."issue_id" = "issue"."id"
3392 AND "issue"."closed" ISNULL
3393 AND "member_id" = "member_id_p";
3394 RETURN;
3395 END;
3396 $$;
3398 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)';
3401 CREATE FUNCTION "delete_private_data"()
3402 RETURNS VOID
3403 LANGUAGE 'plpgsql' VOLATILE AS $$
3404 BEGIN
3405 UPDATE "member" SET
3406 "last_login" = NULL,
3407 "login" = NULL,
3408 "password" = NULL,
3409 "notify_email" = NULL,
3410 "notify_email_unconfirmed" = NULL,
3411 "notify_email_secret" = NULL,
3412 "notify_email_secret_expiry" = NULL,
3413 "notify_email_lock_expiry" = NULL,
3414 "password_reset_secret" = NULL,
3415 "password_reset_secret_expiry" = NULL,
3416 "organizational_unit" = NULL,
3417 "internal_posts" = NULL,
3418 "realname" = NULL,
3419 "birthday" = NULL,
3420 "address" = NULL,
3421 "email" = NULL,
3422 "xmpp_address" = NULL,
3423 "website" = NULL,
3424 "phone" = NULL,
3425 "mobile_phone" = NULL,
3426 "profession" = NULL,
3427 "external_memberships" = NULL,
3428 "external_posts" = NULL,
3429 "statement" = NULL;
3430 -- "text_search_data" is updated by triggers
3431 DELETE FROM "invite_code";
3432 DELETE FROM "setting";
3433 DELETE FROM "setting_map";
3434 DELETE FROM "member_relation_setting";
3435 DELETE FROM "member_image";
3436 DELETE FROM "contact";
3437 DELETE FROM "session";
3438 DELETE FROM "area_setting";
3439 DELETE FROM "issue_setting";
3440 DELETE FROM "initiative_setting";
3441 DELETE FROM "suggestion_setting";
3442 DELETE FROM "ignored_issue";
3443 DELETE FROM "direct_voter" USING "issue"
3444 WHERE "direct_voter"."issue_id" = "issue"."id"
3445 AND "issue"."closed" ISNULL;
3446 RETURN;
3447 END;
3448 $$;
3450 COMMENT ON FUNCTION "delete_private_data"() IS '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.';
3454 COMMIT;