liquid_feedback_core: core.sql annotate

liquid_feedback_core

annotate core.sql @ 490:16536937933e

Require new drafts or new suggestion in area for view "initiative_for_notification"

author	jbe
date	Sun Apr 03 18:00:07 2016 +0200 (2016-04-03)
parents	5abcd0043fff
children	aa94c7dbb20f

rev	line source
jbe@0	1
jbe@92	2 -- Execute the following command manually for PostgreSQL prior version 9.0:
jbe@92	3 -- CREATE LANGUAGE plpgsql;
jbe@0	4
jbe@0	5 -- NOTE: In PostgreSQL every UNIQUE constraint implies creation of an index
jbe@0	6
jbe@0	7 BEGIN;
jbe@0	8
jbe@5	9 CREATE VIEW "liquid_feedback_version" AS
jbe@460	10 SELECT * FROM (VALUES ('3.2.0', 3, 2, 0))
jbe@5	11 AS "subquery"("string", "major", "minor", "revision");
jbe@5	12
jbe@0	13
jbe@0	14
jbe@7	15 ----------------------
jbe@7	16 -- Full text search --
jbe@7	17 ----------------------
jbe@7	18
jbe@7	19
jbe@7	20 CREATE FUNCTION "text_search_query"("query_text_p" TEXT)
jbe@7	21 RETURNS TSQUERY
jbe@7	22 LANGUAGE 'plpgsql' IMMUTABLE AS $$
jbe@7	23 BEGIN
jbe@7	24 RETURN plainto_tsquery('pg_catalog.simple', "query_text_p");
jbe@7	25 END;
jbe@7	26 $$;
jbe@7	27
jbe@7	28 COMMENT ON FUNCTION "text_search_query"(TEXT) IS 'Usage: WHERE "text_search_data" @@ "text_search_query"(''<user query>'')';
jbe@7	29
jbe@7	30
jbe@7	31 CREATE FUNCTION "highlight"
jbe@7	32 ( "body_p" TEXT,
jbe@7	33 "query_text_p" TEXT )
jbe@7	34 RETURNS TEXT
jbe@7	35 LANGUAGE 'plpgsql' IMMUTABLE AS $$
jbe@7	36 BEGIN
jbe@7	37 RETURN ts_headline(
jbe@7	38 'pg_catalog.simple',
jbe@8	39 replace(replace("body_p", e'\\', e'\\\\'), '', e'\\'),
jbe@7	40 "text_search_query"("query_text_p"),
jbe@7	41 'StartSel=* StopSel=* HighlightAll=TRUE' );
jbe@7	42 END;
jbe@7	43 $$;
jbe@7	44
jbe@7	45 COMMENT ON FUNCTION "highlight"
jbe@7	46 ( "body_p" TEXT,
jbe@7	47 "query_text_p" TEXT )
jbe@7	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.';
jbe@7	49
jbe@7	50
jbe@7	51
jbe@0	52 -------------------------
jbe@0	53 -- Tables and indicies --
jbe@0	54 -------------------------
jbe@0	55
jbe@8	56
jbe@385	57 CREATE TABLE "temporary_transaction_data" (
jbe@385	58 PRIMARY KEY ("txid", "key"),
jbe@385	59 "txid" INT8 DEFAULT txid_current(),
jbe@383	60 "key" TEXT,
jbe@383	61 "value" TEXT NOT NULL );
jbe@383	62
jbe@385	63 COMMENT ON TABLE "temporary_transaction_data" IS 'Table to store temporary transaction data; shall be emptied before a transaction is committed';
jbe@385	64
jbe@385	65 COMMENT ON COLUMN "temporary_transaction_data"."txid" IS 'Value returned by function txid_current(); should be added to WHERE clause, when doing SELECT on this table, but ignored when doing DELETE on this table';
jbe@383	66
jbe@383	67
jbe@104	68 CREATE TABLE "system_setting" (
jbe@104	69 "member_ttl" INTERVAL );
jbe@104	70 CREATE UNIQUE INDEX "system_setting_singleton_idx" ON "system_setting" ((1));
jbe@104	71
jbe@104	72 COMMENT ON TABLE "system_setting" IS 'This table contains only one row with different settings in each column.';
jbe@104	73 COMMENT ON INDEX "system_setting_singleton_idx" IS 'This index ensures that "system_setting" only contains one row maximum.';
jbe@104	74
jbe@184	75 COMMENT ON COLUMN "system_setting"."member_ttl" IS 'Time after members get their "active" flag set to FALSE, if they do not show any activity.';
jbe@104	76
jbe@104	77
jbe@111	78 CREATE TABLE "contingent" (
jbe@293	79 PRIMARY KEY ("polling", "time_frame"),
jbe@293	80 "polling" BOOLEAN,
jbe@293	81 "time_frame" INTERVAL,
jbe@111	82 "text_entry_limit" INT4,
jbe@111	83 "initiative_limit" INT4 );
jbe@111	84
jbe@111	85 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.';
jbe@111	86
jbe@293	87 COMMENT ON COLUMN "contingent"."polling" IS 'Determines if settings are for creating initiatives and new drafts of initiatives with "polling" flag set';
jbe@111	88 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';
jbe@111	89 COMMENT ON COLUMN "contingent"."initiative_limit" IS 'Number of new initiatives to be opened by each member within a given time frame';
jbe@111	90
jbe@111	91
jbe@113	92 CREATE TYPE "notify_level" AS ENUM
jbe@113	93 ('none', 'voting', 'verification', 'discussion', 'all');
jbe@113	94
jbe@113	95 COMMENT ON TYPE "notify_level" IS 'Level of notification: ''none'' = no notifications, ''voting'' = notifications about finished issues and issues in voting, ''verification'' = notifications about finished issues, issues in voting and verification phase, ''discussion'' = notifications about everything except issues in admission phase, ''all'' = notifications about everything';
jbe@113	96
jbe@113	97
jbe@0	98 CREATE TABLE "member" (
jbe@0	99 "id" SERIAL4 PRIMARY KEY,
jbe@13	100 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
jbe@181	101 "invite_code" TEXT UNIQUE,
jbe@232	102 "invite_code_expiry" TIMESTAMPTZ,
jbe@182	103 "admin_comment" TEXT,
jbe@181	104 "activated" TIMESTAMPTZ,
jbe@184	105 "last_activity" DATE,
jbe@42	106 "last_login" TIMESTAMPTZ,
jbe@387	107 "last_delegation_check" TIMESTAMPTZ,
jbe@45	108 "login" TEXT UNIQUE,
jbe@0	109 "password" TEXT,
jbe@440	110 "authority" TEXT,
jbe@440	111 "authority_uid" TEXT,
jbe@440	112 "authority_login" TEXT,
jbe@99	113 "locked" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@181	114 "active" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@0	115 "admin" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@221	116 "lang" TEXT,
jbe@7	117 "notify_email" TEXT,
jbe@11	118 "notify_email_unconfirmed" TEXT,
jbe@11	119 "notify_email_secret" TEXT UNIQUE,
jbe@11	120 "notify_email_secret_expiry" TIMESTAMPTZ,
jbe@55	121 "notify_email_lock_expiry" TIMESTAMPTZ,
jbe@486	122 "disable_notifications" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@486	123 "notification_counter" INT4 NOT NULL DEFAULT 1,
jbe@486	124 "notification_sample_size" INT4 NOT NULL DEFAULT 3,
jbe@486	125 "notification_dow" INT4 CHECK ("notification_dow" BETWEEN 0 AND 6),
jbe@486	126 "notification_hour" INT4 CHECK ("notification_hour" BETWEEN 0 AND 23),
jbe@387	127 "login_recovery_expiry" TIMESTAMPTZ,
jbe@11	128 "password_reset_secret" TEXT UNIQUE,
jbe@11	129 "password_reset_secret_expiry" TIMESTAMPTZ,
jbe@225	130 "name" TEXT UNIQUE,
jbe@7	131 "identification" TEXT UNIQUE,
jbe@214	132 "authentication" TEXT,
jbe@7	133 "organizational_unit" TEXT,
jbe@7	134 "internal_posts" TEXT,
jbe@7	135 "realname" TEXT,
jbe@7	136 "birthday" DATE,
jbe@7	137 "address" TEXT,
jbe@7	138 "email" TEXT,
jbe@7	139 "xmpp_address" TEXT,
jbe@7	140 "website" TEXT,
jbe@7	141 "phone" TEXT,
jbe@7	142 "mobile_phone" TEXT,
jbe@7	143 "profession" TEXT,
jbe@7	144 "external_memberships" TEXT,
jbe@7	145 "external_posts" TEXT,
jbe@159	146 "formatting_engine" TEXT,
jbe@7	147 "statement" TEXT,
jbe@181	148 "text_search_data" TSVECTOR,
jbe@184	149 CONSTRAINT "active_requires_activated_and_last_activity"
jbe@225	150 CHECK ("active" = FALSE OR ("activated" NOTNULL AND "last_activity" NOTNULL)),
jbe@440	151 CONSTRAINT "authority_requires_uid_and_vice_versa"
jbe@447	152 CHECK (("authority" NOTNULL) = ("authority_uid" NOTNULL)),
jbe@440	153 CONSTRAINT "authority_uid_unique_per_authority"
jbe@440	154 UNIQUE ("authority", "authority_uid"),
jbe@440	155 CONSTRAINT "authority_login_requires_authority"
jbe@440	156 CHECK ("authority" NOTNULL OR "authority_login" ISNULL),
jbe@225	157 CONSTRAINT "name_not_null_if_activated"
jbe@225	158 CHECK ("activated" ISNULL OR "name" NOTNULL) );
jbe@440	159 CREATE INDEX "member_authority_login_idx" ON "member" ("authority_login");
jbe@0	160 CREATE INDEX "member_active_idx" ON "member" ("active");
jbe@8	161 CREATE INDEX "member_text_search_data_idx" ON "member" USING gin ("text_search_data");
jbe@7	162 CREATE TRIGGER "update_text_search_data"
jbe@7	163 BEFORE INSERT OR UPDATE ON "member"
jbe@7	164 FOR EACH ROW EXECUTE PROCEDURE
jbe@7	165 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
jbe@7	166 "name", "identification", "organizational_unit", "internal_posts",
jbe@7	167 "realname", "external_memberships", "external_posts", "statement" );
jbe@0	168
jbe@0	169 COMMENT ON TABLE "member" IS 'Users of the system, e.g. members of an organization';
jbe@0	170
jbe@181	171 COMMENT ON COLUMN "member"."created" IS 'Creation of member record and/or invite code';
jbe@181	172 COMMENT ON COLUMN "member"."invite_code" IS 'Optional invite code, to allow a member to initialize his/her account the first time';
jbe@232	173 COMMENT ON COLUMN "member"."invite_code_expiry" IS 'Expiry data/time for "invite_code"';
jbe@182	174 COMMENT ON COLUMN "member"."admin_comment" IS 'Hidden comment for administrative purposes';
jbe@207	175 COMMENT ON COLUMN "member"."activated" IS 'Timestamp of first activation of account (i.e. usage of "invite_code"); required to be set for "active" members';
jbe@184	176 COMMENT ON COLUMN "member"."last_activity" IS 'Date of last activity of member; required to be set for "active" members';
jbe@103	177 COMMENT ON COLUMN "member"."last_login" IS 'Timestamp of last login';
jbe@387	178 COMMENT ON COLUMN "member"."last_delegation_check" IS 'Timestamp of last delegation check (i.e. confirmation of all unit and area delegations)';
jbe@10	179 COMMENT ON COLUMN "member"."login" IS 'Login name';
jbe@10	180 COMMENT ON COLUMN "member"."password" IS 'Password (preferably as crypto-hash, depending on the frontend or access layer)';
jbe@440	181 COMMENT ON COLUMN "member"."authority" IS 'NULL if LiquidFeedback Core is authoritative for the member account; otherwise a string that indicates the source/authority of the external account (e.g. ''LDAP'' for an LDAP account)';
jbe@440	182 COMMENT ON COLUMN "member"."authority_uid" IS 'Unique identifier (unique per "authority") that allows to identify an external account (e.g. even if the login name changes)';
jbe@440	183 COMMENT ON COLUMN "member"."authority_login" IS 'Login name for external accounts (field is not unique!)';
jbe@99	184 COMMENT ON COLUMN "member"."locked" IS 'Locked members can not log in.';
jbe@184	185 COMMENT ON COLUMN "member"."active" IS 'Memberships, support and votes are taken into account when corresponding members are marked as active. Automatically set to FALSE, if "last_activity" is older than "system_setting"."member_ttl".';
jbe@10	186 COMMENT ON COLUMN "member"."admin" IS 'TRUE for admins, which can administrate other users and setup policies and areas';
jbe@221	187 COMMENT ON COLUMN "member"."lang" IS 'Language code of the preferred language of the member';
jbe@10	188 COMMENT ON COLUMN "member"."notify_email" IS 'Email address where notifications of the system are sent to';
jbe@10	189 COMMENT ON COLUMN "member"."notify_email_unconfirmed" IS 'Unconfirmed email address provided by the member to be copied into "notify_email" field after verification';
jbe@10	190 COMMENT ON COLUMN "member"."notify_email_secret" IS 'Secret sent to the address in "notify_email_unconformed"';
jbe@10	191 COMMENT ON COLUMN "member"."notify_email_secret_expiry" IS 'Expiry date/time for "notify_email_secret"';
jbe@55	192 COMMENT ON COLUMN "member"."notify_email_lock_expiry" IS 'Date/time until no further email confirmation mails may be sent (abuse protection)';
jbe@460	193 COMMENT ON COLUMN "member"."disable_notifications" IS 'TRUE if member does not want to receive notifications';
jbe@387	194 COMMENT ON COLUMN "member"."login_recovery_expiry" IS 'Date/time after which another login recovery attempt is allowed';
jbe@387	195 COMMENT ON COLUMN "member"."password_reset_secret" IS 'Secret string sent via e-mail for password recovery';
jbe@387	196 COMMENT ON COLUMN "member"."password_reset_secret_expiry" IS 'Date/time until the password recovery secret is valid, and date/time after which another password recovery attempt is allowed';
jbe@225	197 COMMENT ON COLUMN "member"."name" IS 'Distinct name of the member, may be NULL if account has not been activated yet';
jbe@10	198 COMMENT ON COLUMN "member"."identification" IS 'Optional identification number or code of the member';
jbe@214	199 COMMENT ON COLUMN "member"."authentication" IS 'Information about how this member was authenticated';
jbe@10	200 COMMENT ON COLUMN "member"."organizational_unit" IS 'Branch or division of the organization the member belongs to';
jbe@10	201 COMMENT ON COLUMN "member"."internal_posts" IS 'Posts (offices) of the member inside the organization';
jbe@10	202 COMMENT ON COLUMN "member"."realname" IS 'Real name of the member, may be identical with "name"';
jbe@10	203 COMMENT ON COLUMN "member"."email" IS 'Published email address of the member; not used for system notifications';
jbe@10	204 COMMENT ON COLUMN "member"."external_memberships" IS 'Other organizations the member is involved in';
jbe@10	205 COMMENT ON COLUMN "member"."external_posts" IS 'Posts (offices) outside the organization';
jbe@159	206 COMMENT ON COLUMN "member"."formatting_engine" IS 'Allows different formatting engines (i.e. wiki formats) to be used for "member"."statement"';
jbe@207	207 COMMENT ON COLUMN "member"."statement" IS 'Freely chosen text of the member for his/her profile';
jbe@7	208
jbe@7	209
jbe@13	210 CREATE TABLE "member_history" (
jbe@13	211 "id" SERIAL8 PRIMARY KEY,
jbe@13	212 "member_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@13	213 "until" TIMESTAMPTZ NOT NULL DEFAULT now(),
jbe@42	214 "active" BOOLEAN NOT NULL,
jbe@13	215 "name" TEXT NOT NULL );
jbe@45	216 CREATE INDEX "member_history_member_id_idx" ON "member_history" ("member_id");
jbe@13	217
jbe@57	218 COMMENT ON TABLE "member_history" IS 'Filled by trigger; keeps information about old names and active flag of members';
jbe@13	219
jbe@13	220 COMMENT ON COLUMN "member_history"."id" IS 'Primary key, which can be used to sort entries correctly (and time warp resistant)';
jbe@57	221 COMMENT ON COLUMN "member_history"."until" IS 'Timestamp until the data was valid';
jbe@13	222
jbe@13	223
jbe@159	224 CREATE TABLE "rendered_member_statement" (
jbe@159	225 PRIMARY KEY ("member_id", "format"),
jbe@461	226 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@159	227 "format" TEXT,
jbe@159	228 "content" TEXT NOT NULL );
jbe@159	229
jbe@159	230 COMMENT ON TABLE "rendered_member_statement" IS 'This table may be used by frontends to cache "rendered" member statements (e.g. HTML output generated from wiki text)';
jbe@9	231
jbe@9	232
jbe@9	233 CREATE TABLE "setting" (
jbe@9	234 PRIMARY KEY ("member_id", "key"),
jbe@9	235 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@9	236 "key" TEXT NOT NULL,
jbe@9	237 "value" TEXT NOT NULL );
jbe@9	238 CREATE INDEX "setting_key_idx" ON "setting" ("key");
jbe@9	239
jbe@38	240 COMMENT ON TABLE "setting" IS 'Place to store a frontend specific setting for members as a string';
jbe@9	241
jbe@9	242 COMMENT ON COLUMN "setting"."key" IS 'Name of the setting, preceded by a frontend specific prefix';
jbe@9	243
jbe@9	244
jbe@16	245 CREATE TABLE "setting_map" (
jbe@16	246 PRIMARY KEY ("member_id", "key", "subkey"),
jbe@16	247 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@16	248 "key" TEXT NOT NULL,
jbe@16	249 "subkey" TEXT NOT NULL,
jbe@16	250 "value" TEXT NOT NULL );
jbe@16	251 CREATE INDEX "setting_map_key_idx" ON "setting_map" ("key");
jbe@16	252
jbe@23	253 COMMENT ON TABLE "setting_map" IS 'Place to store a frontend specific setting for members as a map of key value pairs';
jbe@16	254
jbe@16	255 COMMENT ON COLUMN "setting_map"."key" IS 'Name of the setting, preceded by a frontend specific prefix';
jbe@16	256 COMMENT ON COLUMN "setting_map"."subkey" IS 'Key of a map entry';
jbe@16	257 COMMENT ON COLUMN "setting_map"."value" IS 'Value of a map entry';
jbe@16	258
jbe@16	259
jbe@23	260 CREATE TABLE "member_relation_setting" (
jbe@23	261 PRIMARY KEY ("member_id", "key", "other_member_id"),
jbe@23	262 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	263 "key" TEXT NOT NULL,
jbe@23	264 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	265 "value" TEXT NOT NULL );
jbe@23	266
jbe@38	267 COMMENT ON TABLE "member_relation_setting" IS 'Place to store a frontend specific setting related to relations between members as a string';
jbe@23	268
jbe@23	269
jbe@7	270 CREATE TYPE "member_image_type" AS ENUM ('photo', 'avatar');
jbe@7	271
jbe@7	272 COMMENT ON TYPE "member_image_type" IS 'Types of images for a member';
jbe@7	273
jbe@7	274
jbe@7	275 CREATE TABLE "member_image" (
jbe@7	276 PRIMARY KEY ("member_id", "image_type", "scaled"),
jbe@7	277 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@7	278 "image_type" "member_image_type",
jbe@7	279 "scaled" BOOLEAN,
jbe@7	280 "content_type" TEXT,
jbe@7	281 "data" BYTEA NOT NULL );
jbe@7	282
jbe@7	283 COMMENT ON TABLE "member_image" IS 'Images of members';
jbe@7	284
jbe@7	285 COMMENT ON COLUMN "member_image"."scaled" IS 'FALSE for original image, TRUE for scaled version of the image';
jbe@0	286
jbe@0	287
jbe@4	288 CREATE TABLE "member_count" (
jbe@341	289 "calculated" TIMESTAMPTZ NOT NULL DEFAULT now(),
jbe@5	290 "total_count" INT4 NOT NULL );
jbe@4	291
jbe@5	292 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';
jbe@4	293
jbe@5	294 COMMENT ON COLUMN "member_count"."calculated" IS 'timestamp indicating when the total member count and area member counts were calculated';
jbe@5	295 COMMENT ON COLUMN "member_count"."total_count" IS 'Total count of active(!) members';
jbe@4	296
jbe@4	297
jbe@0	298 CREATE TABLE "contact" (
jbe@0	299 PRIMARY KEY ("member_id", "other_member_id"),
jbe@0	300 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	301 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@11	302 "public" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@11	303 CONSTRAINT "cant_save_yourself_as_contact"
jbe@11	304 CHECK ("member_id" != "other_member_id") );
jbe@113	305 CREATE INDEX "contact_other_member_id_idx" ON "contact" ("other_member_id");
jbe@0	306
jbe@0	307 COMMENT ON TABLE "contact" IS 'Contact lists';
jbe@0	308
jbe@0	309 COMMENT ON COLUMN "contact"."member_id" IS 'Member having the contact list';
jbe@0	310 COMMENT ON COLUMN "contact"."other_member_id" IS 'Member referenced in the contact list';
jbe@0	311 COMMENT ON COLUMN "contact"."public" IS 'TRUE = display contact publically';
jbe@0	312
jbe@0	313
jbe@113	314 CREATE TABLE "ignored_member" (
jbe@113	315 PRIMARY KEY ("member_id", "other_member_id"),
jbe@113	316 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@113	317 "other_member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@113	318 CREATE INDEX "ignored_member_other_member_id_idx" ON "ignored_member" ("other_member_id");
jbe@113	319
jbe@113	320 COMMENT ON TABLE "ignored_member" IS 'Possibility to filter other members';
jbe@113	321
jbe@113	322 COMMENT ON COLUMN "ignored_member"."member_id" IS 'Member ignoring someone';
jbe@113	323 COMMENT ON COLUMN "ignored_member"."other_member_id" IS 'Member being ignored';
jbe@113	324
jbe@113	325
jbe@220	326 CREATE TABLE "session" (
jbe@220	327 "ident" TEXT PRIMARY KEY,
jbe@220	328 "additional_secret" TEXT,
jbe@220	329 "expiry" TIMESTAMPTZ NOT NULL DEFAULT now() + '24 hours',
jbe@461	330 "member_id" INT4 REFERENCES "member" ("id") ON DELETE SET NULL,
jbe@440	331 "authority" TEXT,
jbe@440	332 "authority_uid" TEXT,
jbe@440	333 "authority_login" TEXT,
jbe@387	334 "needs_delegation_check" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@220	335 "lang" TEXT );
jbe@220	336 CREATE INDEX "session_expiry_idx" ON "session" ("expiry");
jbe@220	337
jbe@220	338 COMMENT ON TABLE "session" IS 'Sessions, i.e. for a web-frontend or API layer';
jbe@220	339
jbe@220	340 COMMENT ON COLUMN "session"."ident" IS 'Secret session identifier (i.e. random string)';
jbe@220	341 COMMENT ON COLUMN "session"."additional_secret" IS 'Additional field to store a secret, which can be used against CSRF attacks';
jbe@220	342 COMMENT ON COLUMN "session"."member_id" IS 'Reference to member, who is logged in';
jbe@440	343 COMMENT ON COLUMN "session"."authority" IS 'Temporary store for "member"."authority" during member account creation';
jbe@440	344 COMMENT ON COLUMN "session"."authority_uid" IS 'Temporary store for "member"."authority_uid" during member account creation';
jbe@440	345 COMMENT ON COLUMN "session"."authority_login" IS 'Temporary store for "member"."authority_login" during member account creation';
jbe@387	346 COMMENT ON COLUMN "session"."needs_delegation_check" IS 'Set to TRUE, if member must perform a delegation check to proceed with login; see column "last_delegation_check" in "member" table';
jbe@220	347 COMMENT ON COLUMN "session"."lang" IS 'Language code of the selected language';
jbe@220	348
jbe@220	349
jbe@424	350 CREATE TYPE "defeat_strength" AS ENUM ('simple', 'tuple');
jbe@424	351
jbe@424	352 COMMENT ON TYPE "defeat_strength" IS 'How pairwise defeats are measured for the Schulze method: ''simple'' = only the number of winning votes, ''tuple'' = primarily the number of winning votes, secondarily the number of losing votes';
jbe@424	353
jbe@424	354
jbe@424	355 CREATE TYPE "tie_breaking" AS ENUM ('simple', 'variant1', 'variant2');
jbe@424	356
jbe@424	357 COMMENT ON TYPE "tie_breaking" IS 'Tie-breaker for the Schulze method: ''simple'' = only initiative ids are used, ''variant1'' = use initiative ids in variant 1 for tie breaking of the links (TBRL) and sequentially forbid shared links, ''variant2'' = use initiative ids in variant 2 for tie breaking of the links (TBRL) and sequentially forbid shared links';
jbe@424	358
jbe@424	359
jbe@0	360 CREATE TABLE "policy" (
jbe@0	361 "id" SERIAL4 PRIMARY KEY,
jbe@9	362 "index" INT4 NOT NULL,
jbe@0	363 "active" BOOLEAN NOT NULL DEFAULT TRUE,
jbe@0	364 "name" TEXT NOT NULL UNIQUE,
jbe@0	365 "description" TEXT NOT NULL DEFAULT '',
jbe@261	366 "polling" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@447	367 "min_admission_time" INTERVAL,
jbe@447	368 "max_admission_time" INTERVAL,
jbe@261	369 "discussion_time" INTERVAL,
jbe@261	370 "verification_time" INTERVAL,
jbe@261	371 "voting_time" INTERVAL,
jbe@292	372 "issue_quorum_num" INT4,
jbe@292	373 "issue_quorum_den" INT4,
jbe@0	374 "initiative_quorum_num" INT4 NOT NULL,
jbe@10	375 "initiative_quorum_den" INT4 NOT NULL,
jbe@424	376 "defeat_strength" "defeat_strength" NOT NULL DEFAULT 'tuple',
jbe@424	377 "tie_breaking" "tie_breaking" NOT NULL DEFAULT 'variant1',
jbe@167	378 "direct_majority_num" INT4 NOT NULL DEFAULT 1,
jbe@167	379 "direct_majority_den" INT4 NOT NULL DEFAULT 2,
jbe@167	380 "direct_majority_strict" BOOLEAN NOT NULL DEFAULT TRUE,
jbe@167	381 "direct_majority_positive" INT4 NOT NULL DEFAULT 0,
jbe@167	382 "direct_majority_non_negative" INT4 NOT NULL DEFAULT 0,
jbe@167	383 "indirect_majority_num" INT4 NOT NULL DEFAULT 1,
jbe@167	384 "indirect_majority_den" INT4 NOT NULL DEFAULT 2,
jbe@167	385 "indirect_majority_strict" BOOLEAN NOT NULL DEFAULT TRUE,
jbe@167	386 "indirect_majority_positive" INT4 NOT NULL DEFAULT 0,
jbe@167	387 "indirect_majority_non_negative" INT4 NOT NULL DEFAULT 0,
jbe@429	388 "no_reverse_beat_path" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@260	389 "no_multistage_majority" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@260	390 CONSTRAINT "timing" CHECK (
jbe@261	391 ( "polling" = FALSE AND
jbe@447	392 "min_admission_time" NOTNULL AND "max_admission_time" NOTNULL AND
jbe@454	393 "min_admission_time" <= "max_admission_time" AND
jbe@447	394 "discussion_time" NOTNULL AND
jbe@447	395 "verification_time" NOTNULL AND
jbe@447	396 "voting_time" NOTNULL ) OR
jbe@261	397 ( "polling" = TRUE AND
jbe@447	398 "min_admission_time" ISNULL AND "max_admission_time" ISNULL AND
jbe@447	399 "discussion_time" NOTNULL AND
jbe@447	400 "verification_time" NOTNULL AND
jbe@447	401 "voting_time" NOTNULL ) OR
jbe@447	402 ( "polling" = TRUE AND
jbe@447	403 "min_admission_time" ISNULL AND "max_admission_time" ISNULL AND
jbe@447	404 "discussion_time" ISNULL AND
jbe@447	405 "verification_time" ISNULL AND
jbe@447	406 "voting_time" ISNULL ) ),
jbe@292	407 CONSTRAINT "issue_quorum_if_and_only_if_not_polling" CHECK (
jbe@447	408 "polling" = ("issue_quorum_num" ISNULL) AND
jbe@447	409 "polling" = ("issue_quorum_den" ISNULL) ),
jbe@429	410 CONSTRAINT "no_reverse_beat_path_requires_tuple_defeat_strength" CHECK (
jbe@429	411 "defeat_strength" = 'tuple'::"defeat_strength" OR
jbe@429	412 "no_reverse_beat_path" = FALSE ) );
jbe@0	413 CREATE INDEX "policy_active_idx" ON "policy" ("active");
jbe@0	414
jbe@0	415 COMMENT ON TABLE "policy" IS 'Policies for a particular proceeding type (timelimits, quorum)';
jbe@0	416
jbe@9	417 COMMENT ON COLUMN "policy"."index" IS 'Determines the order in listings';
jbe@0	418 COMMENT ON COLUMN "policy"."active" IS 'TRUE = policy can be used for new issues';
jbe@447	419 COMMENT ON COLUMN "policy"."polling" IS 'TRUE = special policy for non-user-generated issues without issue quorum, where certain initiatives (those having the "polling" flag set) do not need to pass the initiative quorum; "min_admission_time" and "max_admission_time" MUST be set to NULL, the other timings may be set to NULL altogether, allowing individual timing for those issues';
jbe@447	420 COMMENT ON COLUMN "policy"."min_admission_time" IS 'Minimum duration of issue state ''admission''; Minimum time an issue stays open';
jbe@447	421 COMMENT ON COLUMN "policy"."max_admission_time" IS 'Maximum duration of issue state ''admission''; Maximum time an issue stays open without being "accepted"';
jbe@207	422 COMMENT ON COLUMN "policy"."discussion_time" IS 'Duration of issue state ''discussion''; Regular time until an issue is "half_frozen" after being "accepted"';
jbe@207	423 COMMENT ON COLUMN "policy"."verification_time" IS 'Duration of issue state ''verification''; Regular time until an issue is "fully_frozen" (e.g. entering issue state ''voting'') after being "half_frozen"';
jbe@207	424 COMMENT ON COLUMN "policy"."voting_time" IS 'Duration of issue state ''voting''; Time after an issue is "fully_frozen" but not "closed" (duration of issue state ''voting'')';
jbe@207	425 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" and enter issue state ''discussion''';
jbe@207	426 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" and enter issue state ''discussion''';
jbe@10	427 COMMENT ON COLUMN "policy"."initiative_quorum_num" IS 'Numerator of satisfied supporter quorum to be reached by an initiative to be "admitted" for voting';
jbe@10	428 COMMENT ON COLUMN "policy"."initiative_quorum_den" IS 'Denominator of satisfied supporter quorum to be reached by an initiative to be "admitted" for voting';
jbe@428	429 COMMENT ON COLUMN "policy"."defeat_strength" IS 'How pairwise defeats are measured for the Schulze method; see type "defeat_strength"; ''tuple'' is the recommended setting';
jbe@428	430 COMMENT ON COLUMN "policy"."tie_breaking" IS 'Tie-breaker for the Schulze method; see type "tie_breaking"; ''variant1'' or ''variant2'' are recommended';
jbe@167	431 COMMENT ON COLUMN "policy"."direct_majority_num" IS 'Numerator of fraction of neccessary direct majority for initiatives to be attainable as winner';
jbe@167	432 COMMENT ON COLUMN "policy"."direct_majority_den" IS 'Denominator of fraction of neccessary direct majority for initaitives to be attainable as winner';
jbe@167	433 COMMENT ON COLUMN "policy"."direct_majority_strict" IS 'If TRUE, then the direct majority must be strictly greater than "direct_majority_num"/"direct_majority_den", otherwise it may also be equal.';
jbe@167	434 COMMENT ON COLUMN "policy"."direct_majority_positive" IS 'Absolute number of "positive_votes" neccessary for an initiative to be attainable as winner';
jbe@167	435 COMMENT ON COLUMN "policy"."direct_majority_non_negative" IS 'Absolute number of sum of "positive_votes" and abstentions neccessary for an initiative to be attainable as winner';
jbe@167	436 COMMENT ON COLUMN "policy"."indirect_majority_num" IS 'Numerator of fraction of neccessary indirect majority (through beat path) for initiatives to be attainable as winner';
jbe@167	437 COMMENT ON COLUMN "policy"."indirect_majority_den" IS 'Denominator of fraction of neccessary indirect majority (through beat path) for initiatives to be attainable as winner';
jbe@167	438 COMMENT ON COLUMN "policy"."indirect_majority_strict" IS 'If TRUE, then the indirect majority must be strictly greater than "indirect_majority_num"/"indirect_majority_den", otherwise it may also be equal.';
jbe@167	439 COMMENT ON COLUMN "policy"."indirect_majority_positive" IS 'Absolute number of votes in favor of the winner neccessary in a beat path to the status quo for an initaitive to be attainable as winner';
jbe@167	440 COMMENT ON COLUMN "policy"."indirect_majority_non_negative" IS 'Absolute number of sum of votes in favor and abstentions in a beat path to the status quo for an initiative to be attainable as winner';
jbe@429	441 COMMENT ON COLUMN "policy"."no_reverse_beat_path" IS 'EXPERIMENTAL FEATURE: Causes initiatives with "reverse_beat_path" flag to not be "eligible", thus disallowing them to be winner. See comment on column "initiative"."reverse_beat_path". This option ensures both that a winning initiative is never tied in a (weak) condorcet paradox with the status quo and a winning initiative always beats the status quo directly with a simple majority.';
jbe@429	442 COMMENT ON COLUMN "policy"."no_multistage_majority" IS 'EXPERIMENTAL FEATURE: Causes initiatives with "multistage_majority" flag to not be "eligible", thus disallowing them to be winner. See comment on column "initiative"."multistage_majority". This disqualifies initiatives which could cause an instable result. An instable result in this meaning is a result such that repeating the ballot with same preferences but with the winner of the first ballot as status quo would lead to a different winner in the second ballot. If there are no direct majorities required for the winner, or if in direct comparison only simple majorities are required and "no_reverse_beat_path" is true, then results are always stable and this flag does not have any effect on the winner (but still affects the "eligible" flag of an "initiative").';
jbe@0	443
jbe@0	444
jbe@97	445 CREATE TABLE "unit" (
jbe@97	446 "id" SERIAL4 PRIMARY KEY,
jbe@97	447 "parent_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@97	448 "active" BOOLEAN NOT NULL DEFAULT TRUE,
jbe@97	449 "name" TEXT NOT NULL,
jbe@97	450 "description" TEXT NOT NULL DEFAULT '',
jbe@444	451 "external_reference" TEXT,
jbe@97	452 "member_count" INT4,
jbe@97	453 "text_search_data" TSVECTOR );
jbe@97	454 CREATE INDEX "unit_root_idx" ON "unit" ("id") WHERE "parent_id" ISNULL;
jbe@97	455 CREATE INDEX "unit_parent_id_idx" ON "unit" ("parent_id");
jbe@97	456 CREATE INDEX "unit_active_idx" ON "unit" ("active");
jbe@97	457 CREATE INDEX "unit_text_search_data_idx" ON "unit" USING gin ("text_search_data");
jbe@97	458 CREATE TRIGGER "update_text_search_data"
jbe@97	459 BEFORE INSERT OR UPDATE ON "unit"
jbe@97	460 FOR EACH ROW EXECUTE PROCEDURE
jbe@97	461 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
jbe@97	462 "name", "description" );
jbe@97	463
jbe@97	464 COMMENT ON TABLE "unit" IS 'Organizational units organized as trees; Delegations are not inherited through these trees.';
jbe@97	465
jbe@444	466 COMMENT ON COLUMN "unit"."parent_id" IS 'Parent id of tree node; Multiple roots allowed';
jbe@444	467 COMMENT ON COLUMN "unit"."active" IS 'TRUE means new issues can be created in areas of this unit';
jbe@444	468 COMMENT ON COLUMN "unit"."external_reference" IS 'Opaque data field to store an external reference';
jbe@444	469 COMMENT ON COLUMN "unit"."member_count" IS 'Count of members as determined by column "voting_right" in table "privilege"';
jbe@97	470
jbe@97	471
jbe@465	472 CREATE TABLE "subscription" (
jbe@465	473 PRIMARY KEY ("member_id", "unit_id"),
jbe@465	474 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@465	475 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@465	476 CREATE INDEX "subscription_unit_id_idx" ON "subscription" ("unit_id");
jbe@465	477
jbe@465	478 COMMENT ON TABLE "subscription" IS 'An entry in this table denotes that the member wishes to receive notifications regardless of his/her privileges in the given unit';
jbe@465	479
jbe@465	480
jbe@203	481 CREATE TABLE "unit_setting" (
jbe@203	482 PRIMARY KEY ("member_id", "key", "unit_id"),
jbe@203	483 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@203	484 "key" TEXT NOT NULL,
jbe@203	485 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@203	486 "value" TEXT NOT NULL );
jbe@203	487
jbe@203	488 COMMENT ON TABLE "unit_setting" IS 'Place for frontend to store unit specific settings of members as strings';
jbe@203	489
jbe@203	490
jbe@0	491 CREATE TABLE "area" (
jbe@0	492 "id" SERIAL4 PRIMARY KEY,
jbe@97	493 "unit_id" INT4 NOT NULL REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	494 "active" BOOLEAN NOT NULL DEFAULT TRUE,
jbe@0	495 "name" TEXT NOT NULL,
jbe@4	496 "description" TEXT NOT NULL DEFAULT '',
jbe@444	497 "external_reference" TEXT,
jbe@5	498 "direct_member_count" INT4,
jbe@5	499 "member_weight" INT4,
jbe@7	500 "text_search_data" TSVECTOR );
jbe@97	501 CREATE INDEX "area_unit_id_idx" ON "area" ("unit_id");
jbe@0	502 CREATE INDEX "area_active_idx" ON "area" ("active");
jbe@8	503 CREATE INDEX "area_text_search_data_idx" ON "area" USING gin ("text_search_data");
jbe@7	504 CREATE TRIGGER "update_text_search_data"
jbe@7	505 BEFORE INSERT OR UPDATE ON "area"
jbe@7	506 FOR EACH ROW EXECUTE PROCEDURE
jbe@7	507 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
jbe@7	508 "name", "description" );
jbe@0	509
jbe@0	510 COMMENT ON TABLE "area" IS 'Subject areas';
jbe@0	511
jbe@5	512 COMMENT ON COLUMN "area"."active" IS 'TRUE means new issues can be created in this area';
jbe@444	513 COMMENT ON COLUMN "area"."external_reference" IS 'Opaque data field to store an external reference';
jbe@5	514 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"';
jbe@5	515 COMMENT ON COLUMN "area"."member_weight" IS 'Same as "direct_member_count" but respecting delegations';
jbe@0	516
jbe@0	517
jbe@465	518 CREATE TABLE "ignored_area" (
jbe@465	519 PRIMARY KEY ("member_id", "area_id"),
jbe@465	520 "member_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@465	521 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@465	522 CREATE INDEX "ignored_area_area_id_idx" ON "ignored_area" ("area_id");
jbe@465	523
jbe@465	524 COMMENT ON TABLE "ignored_area" IS 'An entry in this table denotes that the member does not wish to receive notifications for the given subject area unless he/she declared interested in a particular issue';
jbe@465	525
jbe@465	526
jbe@23	527 CREATE TABLE "area_setting" (
jbe@23	528 PRIMARY KEY ("member_id", "key", "area_id"),
jbe@23	529 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	530 "key" TEXT NOT NULL,
jbe@23	531 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	532 "value" TEXT NOT NULL );
jbe@23	533
jbe@23	534 COMMENT ON TABLE "area_setting" IS 'Place for frontend to store area specific settings of members as strings';
jbe@23	535
jbe@23	536
jbe@9	537 CREATE TABLE "allowed_policy" (
jbe@9	538 PRIMARY KEY ("area_id", "policy_id"),
jbe@9	539 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@9	540 "policy_id" INT4 NOT NULL REFERENCES "policy" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@9	541 "default_policy" BOOLEAN NOT NULL DEFAULT FALSE );
jbe@9	542 CREATE UNIQUE INDEX "allowed_policy_one_default_per_area_idx" ON "allowed_policy" ("area_id") WHERE "default_policy";
jbe@9	543
jbe@9	544 COMMENT ON TABLE "allowed_policy" IS 'Selects which policies can be used in each area';
jbe@9	545
jbe@9	546 COMMENT ON COLUMN "allowed_policy"."default_policy" IS 'One policy per area can be set as default.';
jbe@9	547
jbe@9	548
jbe@21	549 CREATE TYPE "snapshot_event" AS ENUM ('periodic', 'end_of_admission', 'half_freeze', 'full_freeze');
jbe@21	550
jbe@21	551 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';
jbe@8	552
jbe@8	553
jbe@112	554 CREATE TYPE "issue_state" AS ENUM (
jbe@112	555 'admission', 'discussion', 'verification', 'voting',
jbe@389	556 'canceled_by_admin',
jbe@113	557 'canceled_revoked_before_accepted',
jbe@113	558 'canceled_issue_not_accepted',
jbe@113	559 'canceled_after_revocation_during_discussion',
jbe@113	560 'canceled_after_revocation_during_verification',
jbe@113	561 'canceled_no_initiative_admitted',
jbe@112	562 'finished_without_winner', 'finished_with_winner');
jbe@111	563
jbe@111	564 COMMENT ON TYPE "issue_state" IS 'State of issues';
jbe@111	565
jbe@111	566
jbe@0	567 CREATE TABLE "issue" (
jbe@0	568 "id" SERIAL4 PRIMARY KEY,
jbe@0	569 "area_id" INT4 NOT NULL REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	570 "policy_id" INT4 NOT NULL REFERENCES "policy" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
jbe@389	571 "admin_notice" TEXT,
jbe@444	572 "external_reference" TEXT,
jbe@111	573 "state" "issue_state" NOT NULL DEFAULT 'admission',
jbe@328	574 "phase_finished" TIMESTAMPTZ,
jbe@0	575 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
jbe@0	576 "accepted" TIMESTAMPTZ,
jbe@3	577 "half_frozen" TIMESTAMPTZ,
jbe@3	578 "fully_frozen" TIMESTAMPTZ,
jbe@0	579 "closed" TIMESTAMPTZ,
jbe@59	580 "cleaned" TIMESTAMPTZ,
jbe@447	581 "min_admission_time" INTERVAL,
jbe@447	582 "max_admission_time" INTERVAL,
jbe@22	583 "discussion_time" INTERVAL NOT NULL,
jbe@22	584 "verification_time" INTERVAL NOT NULL,
jbe@22	585 "voting_time" INTERVAL NOT NULL,
jbe@0	586 "snapshot" TIMESTAMPTZ,
jbe@8	587 "latest_snapshot_event" "snapshot_event",
jbe@0	588 "population" INT4,
jbe@4	589 "voter_count" INT4,
jbe@170	590 "status_quo_schulze_rank" INT4,
jbe@291	591 CONSTRAINT "admission_time_not_null_unless_instantly_accepted" CHECK (
jbe@447	592 ("min_admission_time" NOTNULL) = ("max_admission_time" NOTNULL) AND
jbe@452	593 ("min_admission_time" NOTNULL OR ("accepted" NOTNULL AND "accepted" = "created")) ),
jbe@340	594 CONSTRAINT "valid_state" CHECK (
jbe@340	595 (
jbe@340	596 ("accepted" ISNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL ) OR
jbe@340	597 ("accepted" NOTNULL AND "half_frozen" ISNULL AND "fully_frozen" ISNULL ) OR
jbe@340	598 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" ISNULL ) OR
jbe@340	599 ("accepted" NOTNULL AND "half_frozen" NOTNULL AND "fully_frozen" NOTNULL)
jbe@340	600 ) AND (
jbe@340	601 ("state" = 'admission' AND "closed" ISNULL AND "accepted" ISNULL) OR
jbe@340	602 ("state" = 'discussion' AND "closed" ISNULL AND "accepted" NOTNULL AND "half_frozen" ISNULL) OR
jbe@340	603 ("state" = 'verification' AND "closed" ISNULL AND "half_frozen" NOTNULL AND "fully_frozen" ISNULL) OR
jbe@340	604 ("state" = 'voting' AND "closed" ISNULL AND "fully_frozen" NOTNULL) OR
jbe@389	605 ("state" = 'canceled_by_admin' AND "closed" NOTNULL) OR
jbe@340	606 ("state" = 'canceled_revoked_before_accepted' AND "closed" NOTNULL AND "accepted" ISNULL) OR
jbe@340	607 ("state" = 'canceled_issue_not_accepted' AND "closed" NOTNULL AND "accepted" ISNULL) OR
jbe@340	608 ("state" = 'canceled_after_revocation_during_discussion' AND "closed" NOTNULL AND "half_frozen" ISNULL) OR
jbe@340	609 ("state" = 'canceled_after_revocation_during_verification' AND "closed" NOTNULL AND "fully_frozen" ISNULL) OR
jbe@340	610 ("state" = 'canceled_no_initiative_admitted' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" = "fully_frozen") OR
jbe@340	611 ("state" = 'finished_without_winner' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" != "fully_frozen") OR
jbe@340	612 ("state" = 'finished_with_winner' AND "closed" NOTNULL AND "fully_frozen" NOTNULL AND "closed" != "fully_frozen")
jbe@111	613 )),
jbe@328	614 CONSTRAINT "phase_finished_only_when_not_closed" CHECK (
jbe@328	615 "phase_finished" ISNULL OR "closed" ISNULL ),
jbe@3	616 CONSTRAINT "state_change_order" CHECK (
jbe@10	617 "created" <= "accepted" AND
jbe@10	618 "accepted" <= "half_frozen" AND
jbe@10	619 "half_frozen" <= "fully_frozen" AND
jbe@3	620 "fully_frozen" <= "closed" ),
jbe@61	621 CONSTRAINT "only_closed_issues_may_be_cleaned" CHECK (
jbe@61	622 "cleaned" ISNULL OR "closed" NOTNULL ),
jbe@10	623 CONSTRAINT "last_snapshot_on_full_freeze"
jbe@10	624 CHECK ("snapshot" = "fully_frozen"), -- NOTE: snapshot can be set, while frozen is NULL yet
jbe@10	625 CONSTRAINT "freeze_requires_snapshot"
jbe@10	626 CHECK ("fully_frozen" ISNULL OR "snapshot" NOTNULL),
jbe@10	627 CONSTRAINT "set_both_or_none_of_snapshot_and_latest_snapshot_event"
jbe@447	628 CHECK (("snapshot" NOTNULL) = ("latest_snapshot_event" NOTNULL)) );
jbe@0	629 CREATE INDEX "issue_area_id_idx" ON "issue" ("area_id");
jbe@0	630 CREATE INDEX "issue_policy_id_idx" ON "issue" ("policy_id");
jbe@16	631 CREATE INDEX "issue_created_idx" ON "issue" ("created");
jbe@16	632 CREATE INDEX "issue_accepted_idx" ON "issue" ("accepted");
jbe@16	633 CREATE INDEX "issue_half_frozen_idx" ON "issue" ("half_frozen");
jbe@16	634 CREATE INDEX "issue_fully_frozen_idx" ON "issue" ("fully_frozen");
jbe@16	635 CREATE INDEX "issue_closed_idx" ON "issue" ("closed");
jbe@0	636 CREATE INDEX "issue_created_idx_open" ON "issue" ("created") WHERE "closed" ISNULL;
jbe@16	637 CREATE INDEX "issue_closed_idx_canceled" ON "issue" ("closed") WHERE "fully_frozen" ISNULL;
jbe@0	638
jbe@0	639 COMMENT ON TABLE "issue" IS 'Groups of initiatives';
jbe@0	640
jbe@389	641 COMMENT ON COLUMN "issue"."admin_notice" IS 'Public notice by admin to explain manual interventions, or to announce corrections';
jbe@444	642 COMMENT ON COLUMN "issue"."external_reference" IS 'Opaque data field to store an external reference';
jbe@328	643 COMMENT ON COLUMN "issue"."phase_finished" IS 'Set to a value NOTNULL, if the current phase has finished, but calculations are pending; No changes in this issue shall be made by the frontend or API when this value is set';
jbe@170	644 COMMENT ON COLUMN "issue"."accepted" IS 'Point in time, when one initiative of issue reached the "issue_quorum"';
jbe@170	645 COMMENT ON COLUMN "issue"."half_frozen" IS 'Point in time, when "discussion_time" has elapsed; Frontends must ensure that for half_frozen issues a) initiatives are not revoked, b) no new drafts are created, c) no initiators are added or removed.';
jbe@170	646 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.';
jbe@447	647 COMMENT ON COLUMN "issue"."closed" IS 'Point in time, when "max_admission_time" or "voting_time" have elapsed, and issue is no longer active; Frontends must ensure that for closed issues additionally to the restrictions for half_frozen and fully_frozen issues a) no voter is added or removed to/from the direct_voter table, b) no votes are added, modified or removed.';
jbe@170	648 COMMENT ON COLUMN "issue"."cleaned" IS 'Point in time, when discussion data and votes had been deleted';
jbe@447	649 COMMENT ON COLUMN "issue"."min_admission_time" IS 'Copied from "policy" table at creation of issue';
jbe@447	650 COMMENT ON COLUMN "issue"."max_admission_time" IS 'Copied from "policy" table at creation of issue';
jbe@170	651 COMMENT ON COLUMN "issue"."discussion_time" IS 'Copied from "policy" table at creation of issue';
jbe@170	652 COMMENT ON COLUMN "issue"."verification_time" IS 'Copied from "policy" table at creation of issue';
jbe@170	653 COMMENT ON COLUMN "issue"."voting_time" IS 'Copied from "policy" table at creation of issue';
jbe@170	654 COMMENT ON COLUMN "issue"."snapshot" IS 'Point in time, when snapshot tables have been updated and "population" and *_count values were precalculated';
jbe@170	655 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';
jbe@170	656 COMMENT ON COLUMN "issue"."population" IS 'Sum of "weight" column in table "direct_population_snapshot"';
jbe@170	657 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';
jbe@170	658 COMMENT ON COLUMN "issue"."status_quo_schulze_rank" IS 'Schulze rank of status quo, as calculated by "calculate_ranks" function';
jbe@0	659
jbe@0	660
jbe@410	661 CREATE TABLE "issue_order_in_admission_state" (
jbe@400	662 "id" INT8 PRIMARY KEY, --REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@410	663 "order_in_area" INT4,
jbe@410	664 "order_in_unit" INT4 );
jbe@410	665
jbe@410	666 COMMENT ON TABLE "issue_order_in_admission_state" IS 'Ordering information for issues that are not stored in the "issue" table to avoid locking of multiple issues at once; Filled/updated by "lf_update_issue_order"';
jbe@410	667
jbe@410	668 COMMENT ON COLUMN "issue_order_in_admission_state"."id" IS 'References "issue" ("id") but has no referential integrity trigger associated, due to performance/locking issues';
jbe@410	669 COMMENT ON COLUMN "issue_order_in_admission_state"."order_in_area" IS 'Order of issues in admission state within a single area; NULL values sort last';
jbe@410	670 COMMENT ON COLUMN "issue_order_in_admission_state"."order_in_unit" IS 'Order of issues in admission state within all areas of a unit; NULL values sort last';
jbe@0	671
jbe@0	672
jbe@23	673 CREATE TABLE "issue_setting" (
jbe@23	674 PRIMARY KEY ("member_id", "key", "issue_id"),
jbe@23	675 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	676 "key" TEXT NOT NULL,
jbe@23	677 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	678 "value" TEXT NOT NULL );
jbe@23	679
jbe@23	680 COMMENT ON TABLE "issue_setting" IS 'Place for frontend to store issue specific settings of members as strings';
jbe@23	681
jbe@23	682
jbe@0	683 CREATE TABLE "initiative" (
jbe@0	684 UNIQUE ("issue_id", "id"), -- index needed for foreign-key on table "vote"
jbe@0	685 "issue_id" INT4 NOT NULL REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	686 "id" SERIAL4 PRIMARY KEY,
jbe@0	687 "name" TEXT NOT NULL,
jbe@261	688 "polling" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@0	689 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
jbe@0	690 "revoked" TIMESTAMPTZ,
jbe@112	691 "revoked_by_member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
jbe@14	692 "suggested_initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@444	693 "external_reference" TEXT,
jbe@0	694 "admitted" BOOLEAN,
jbe@0	695 "supporter_count" INT4,
jbe@0	696 "informed_supporter_count" INT4,
jbe@0	697 "satisfied_supporter_count" INT4,
jbe@0	698 "satisfied_informed_supporter_count" INT4,
jbe@313	699 "harmonic_weight" NUMERIC(12, 3),
jbe@352	700 "final_suggestion_order_calculated" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@414	701 "first_preference_votes" INT4,
jbe@0	702 "positive_votes" INT4,
jbe@0	703 "negative_votes" INT4,
jbe@167	704 "direct_majority" BOOLEAN,
jbe@167	705 "indirect_majority" BOOLEAN,
jbe@170	706 "schulze_rank" INT4,
jbe@167	707 "better_than_status_quo" BOOLEAN,
jbe@167	708 "worse_than_status_quo" BOOLEAN,
jbe@429	709 "reverse_beat_path" BOOLEAN,
jbe@154	710 "multistage_majority" BOOLEAN,
jbe@154	711 "eligible" BOOLEAN,
jbe@126	712 "winner" BOOLEAN,
jbe@0	713 "rank" INT4,
jbe@7	714 "text_search_data" TSVECTOR,
jbe@112	715 CONSTRAINT "all_or_none_of_revoked_and_revoked_by_member_id_must_be_null"
jbe@447	716 CHECK (("revoked" NOTNULL) = ("revoked_by_member_id" NOTNULL)),
jbe@14	717 CONSTRAINT "non_revoked_initiatives_cant_suggest_other"
jbe@14	718 CHECK ("revoked" NOTNULL OR "suggested_initiative_id" ISNULL),
jbe@0	719 CONSTRAINT "revoked_initiatives_cant_be_admitted"
jbe@0	720 CHECK ("revoked" ISNULL OR "admitted" ISNULL),
jbe@128	721 CONSTRAINT "non_admitted_initiatives_cant_contain_voting_results" CHECK (
jbe@128	722 ( "admitted" NOTNULL AND "admitted" = TRUE ) OR
jbe@414	723 ( "first_preference_votes" ISNULL AND
jbe@414	724 "positive_votes" ISNULL AND "negative_votes" ISNULL AND
jbe@167	725 "direct_majority" ISNULL AND "indirect_majority" ISNULL AND
jbe@173	726 "schulze_rank" ISNULL AND
jbe@167	727 "better_than_status_quo" ISNULL AND "worse_than_status_quo" ISNULL AND
jbe@429	728 "reverse_beat_path" ISNULL AND "multistage_majority" ISNULL AND
jbe@173	729 "eligible" ISNULL AND "winner" ISNULL AND "rank" ISNULL ) ),
jbe@173	730 CONSTRAINT "better_excludes_worse" CHECK (NOT ("better_than_status_quo" AND "worse_than_status_quo")),
jbe@175	731 CONSTRAINT "minimum_requirement_to_be_eligible" CHECK (
jbe@175	732 "eligible" = FALSE OR
jbe@175	733 ("direct_majority" AND "indirect_majority" AND "better_than_status_quo") ),
jbe@175	734 CONSTRAINT "winner_must_be_eligible" CHECK ("winner"=FALSE OR "eligible"=TRUE),
jbe@175	735 CONSTRAINT "winner_must_have_first_rank" CHECK ("winner"=FALSE OR "rank"=1),
jbe@176	736 CONSTRAINT "eligible_at_first_rank_is_winner" CHECK ("eligible"=FALSE OR "rank"!=1 OR "winner"=TRUE),
jbe@173	737 CONSTRAINT "unique_rank_per_issue" UNIQUE ("issue_id", "rank") );
jbe@16	738 CREATE INDEX "initiative_created_idx" ON "initiative" ("created");
jbe@16	739 CREATE INDEX "initiative_revoked_idx" ON "initiative" ("revoked");
jbe@8	740 CREATE INDEX "initiative_text_search_data_idx" ON "initiative" USING gin ("text_search_data");
jbe@7	741 CREATE TRIGGER "update_text_search_data"
jbe@7	742 BEFORE INSERT OR UPDATE ON "initiative"
jbe@7	743 FOR EACH ROW EXECUTE PROCEDURE
jbe@450	744 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "name");
jbe@0	745
jbe@10	746 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.';
jbe@0	747
jbe@289	748 COMMENT ON COLUMN "initiative"."polling" IS 'Initiative does not need to pass the initiative quorum (see "policy"."polling")';
jbe@210	749 COMMENT ON COLUMN "initiative"."revoked" IS 'Point in time, when one initiator decided to revoke the initiative';
jbe@210	750 COMMENT ON COLUMN "initiative"."revoked_by_member_id" IS 'Member, who decided to revoke the initiative';
jbe@444	751 COMMENT ON COLUMN "initiative"."external_reference" IS 'Opaque data field to store an external reference';
jbe@210	752 COMMENT ON COLUMN "initiative"."admitted" IS 'TRUE, if initiative reaches the "initiative_quorum" when freezing the issue';
jbe@0	753 COMMENT ON COLUMN "initiative"."supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
jbe@0	754 COMMENT ON COLUMN "initiative"."informed_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
jbe@0	755 COMMENT ON COLUMN "initiative"."satisfied_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
jbe@0	756 COMMENT ON COLUMN "initiative"."satisfied_informed_supporter_count" IS 'Calculated from table "direct_supporter_snapshot"';
jbe@320	757 COMMENT ON COLUMN "initiative"."harmonic_weight" IS 'Indicates the relevancy of the initiative, calculated from the potential supporters weighted with the harmonic series to avoid a large number of clones affecting other initiative''s sorting positions too much; shall be used as secondary sorting key after "admitted" as primary sorting key';
jbe@352	758 COMMENT ON COLUMN "initiative"."final_suggestion_order_calculated" IS 'Set to TRUE, when "proportional_order" of suggestions has been calculated the last time';
jbe@414	759 COMMENT ON COLUMN "initiative"."first_preference_votes" IS 'Number of direct and delegating voters who ranked this initiative as their first choice';
jbe@414	760 COMMENT ON COLUMN "initiative"."positive_votes" IS 'Number of direct and delegating voters who ranked this initiative better than the status quo';
jbe@414	761 COMMENT ON COLUMN "initiative"."negative_votes" IS 'Number of direct and delegating voters who ranked this initiative worse than the status quo';
jbe@210	762 COMMENT ON COLUMN "initiative"."direct_majority" IS 'TRUE, if "positive_votes"/("positive_votes"+"negative_votes") is strictly greater or greater-equal than "direct_majority_num"/"direct_majority_den", and "positive_votes" is greater-equal than "direct_majority_positive", and ("positive_votes"+abstentions) is greater-equal than "direct_majority_non_negative"';
jbe@210	763 COMMENT ON COLUMN "initiative"."indirect_majority" IS 'Same as "direct_majority", but also considering indirect beat paths';
jbe@411	764 COMMENT ON COLUMN "initiative"."schulze_rank" IS 'Schulze-Ranking';
jbe@411	765 COMMENT ON COLUMN "initiative"."better_than_status_quo" IS 'TRUE, if initiative has a schulze-ranking better than the status quo';
jbe@411	766 COMMENT ON COLUMN "initiative"."worse_than_status_quo" IS 'TRUE, if initiative has a schulze-ranking worse than the status quo (DEPRECATED, since schulze-ranking is unique per issue; use "better_than_status_quo"=FALSE)';
jbe@429	767 COMMENT ON COLUMN "initiative"."reverse_beat_path" IS 'TRUE, if there is a beat path (may include ties) from this initiative to the status quo; set to NULL if "policy"."defeat_strength" is set to ''simple''';
jbe@210	768 COMMENT ON COLUMN "initiative"."multistage_majority" IS 'TRUE, if either (a) this initiative has no better rank than the status quo, or (b) there exists a better ranked initiative X, which directly beats this initiative, and either more voters prefer X to this initiative than voters preferring X to the status quo or less voters prefer this initiative to X than voters preferring the status quo to X';
jbe@429	769 COMMENT ON COLUMN "initiative"."eligible" IS 'Initiative has a "direct_majority" and an "indirect_majority", is "better_than_status_quo" and depending on selected policy the initiative has no "reverse_beat_path" or "multistage_majority"';
jbe@411	770 COMMENT ON COLUMN "initiative"."winner" IS 'Winner is the "eligible" initiative with best "schulze_rank"';
jbe@210	771 COMMENT ON COLUMN "initiative"."rank" IS 'Unique ranking for all "admitted" initiatives per issue; lower rank is better; a winner always has rank 1, but rank 1 does not imply that an initiative is winner; initiatives with "direct_majority" AND "indirect_majority" always have a better (lower) rank than other initiatives';
jbe@0	772
jbe@0	773
jbe@61	774 CREATE TABLE "battle" (
jbe@126	775 "issue_id" INT4 NOT NULL,
jbe@61	776 "winning_initiative_id" INT4,
jbe@61	777 FOREIGN KEY ("issue_id", "winning_initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@61	778 "losing_initiative_id" INT4,
jbe@61	779 FOREIGN KEY ("issue_id", "losing_initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@126	780 "count" INT4 NOT NULL,
jbe@126	781 CONSTRAINT "initiative_ids_not_equal" CHECK (
jbe@126	782 "winning_initiative_id" != "losing_initiative_id" OR
jbe@126	783 ( ("winning_initiative_id" NOTNULL AND "losing_initiative_id" ISNULL) OR
jbe@126	784 ("winning_initiative_id" ISNULL AND "losing_initiative_id" NOTNULL) ) ) );
jbe@126	785 CREATE UNIQUE INDEX "battle_winning_losing_idx" ON "battle" ("issue_id", "winning_initiative_id", "losing_initiative_id");
jbe@126	786 CREATE UNIQUE INDEX "battle_winning_null_idx" ON "battle" ("issue_id", "winning_initiative_id") WHERE "losing_initiative_id" ISNULL;
jbe@126	787 CREATE UNIQUE INDEX "battle_null_losing_idx" ON "battle" ("issue_id", "losing_initiative_id") WHERE "winning_initiative_id" ISNULL;
jbe@126	788
jbe@126	789 COMMENT ON TABLE "battle" IS 'Number of members preferring one initiative to another; Filled by "battle_view" when closing an issue; NULL as initiative_id denotes virtual "status-quo" initiative';
jbe@61	790
jbe@61	791
jbe@113	792 CREATE TABLE "ignored_initiative" (
jbe@465	793 PRIMARY KEY ("member_id", "initiative_id"),
jbe@465	794 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@465	795 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@465	796 CREATE INDEX "ignored_initiative_initiative_id_idx" ON "ignored_initiative" ("initiative_id");
jbe@113	797
jbe@113	798 COMMENT ON TABLE "ignored_initiative" IS 'Possibility to filter initiatives';
jbe@113	799
jbe@113	800
jbe@23	801 CREATE TABLE "initiative_setting" (
jbe@23	802 PRIMARY KEY ("member_id", "key", "initiative_id"),
jbe@23	803 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	804 "key" TEXT NOT NULL,
jbe@23	805 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	806 "value" TEXT NOT NULL );
jbe@23	807
jbe@23	808 COMMENT ON TABLE "initiative_setting" IS 'Place for frontend to store initiative specific settings of members as strings';
jbe@23	809
jbe@23	810
jbe@0	811 CREATE TABLE "draft" (
jbe@0	812 UNIQUE ("initiative_id", "id"), -- index needed for foreign-key on table "supporter"
jbe@0	813 "initiative_id" INT4 NOT NULL REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	814 "id" SERIAL8 PRIMARY KEY,
jbe@0	815 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
jbe@0	816 "author_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
jbe@9	817 "formatting_engine" TEXT,
jbe@7	818 "content" TEXT NOT NULL,
jbe@444	819 "external_reference" TEXT,
jbe@7	820 "text_search_data" TSVECTOR );
jbe@16	821 CREATE INDEX "draft_created_idx" ON "draft" ("created");
jbe@9	822 CREATE INDEX "draft_author_id_created_idx" ON "draft" ("author_id", "created");
jbe@8	823 CREATE INDEX "draft_text_search_data_idx" ON "draft" USING gin ("text_search_data");
jbe@7	824 CREATE TRIGGER "update_text_search_data"
jbe@7	825 BEFORE INSERT OR UPDATE ON "draft"
jbe@7	826 FOR EACH ROW EXECUTE PROCEDURE
jbe@7	827 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "content");
jbe@0	828
jbe@10	829 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.';
jbe@0	830
jbe@444	831 COMMENT ON COLUMN "draft"."formatting_engine" IS 'Allows different formatting engines (i.e. wiki formats) to be used';
jbe@444	832 COMMENT ON COLUMN "draft"."content" IS 'Text of the draft in a format depending on the field "formatting_engine"';
jbe@444	833 COMMENT ON COLUMN "draft"."external_reference" IS 'Opaque data field to store an external reference';
jbe@9	834
jbe@0	835
jbe@63	836 CREATE TABLE "rendered_draft" (
jbe@63	837 PRIMARY KEY ("draft_id", "format"),
jbe@63	838 "draft_id" INT8 REFERENCES "draft" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@63	839 "format" TEXT,
jbe@63	840 "content" TEXT NOT NULL );
jbe@63	841
jbe@63	842 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)';
jbe@63	843
jbe@63	844
jbe@0	845 CREATE TABLE "suggestion" (
jbe@0	846 UNIQUE ("initiative_id", "id"), -- index needed for foreign-key on table "opinion"
jbe@0	847 "initiative_id" INT4 NOT NULL REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	848 "id" SERIAL8 PRIMARY KEY,
jbe@160	849 "draft_id" INT8 NOT NULL,
jbe@160	850 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE,
jbe@0	851 "created" TIMESTAMPTZ NOT NULL DEFAULT now(),
jbe@0	852 "author_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
jbe@0	853 "name" TEXT NOT NULL,
jbe@159	854 "formatting_engine" TEXT,
jbe@159	855 "content" TEXT NOT NULL DEFAULT '',
jbe@444	856 "external_reference" TEXT,
jbe@7	857 "text_search_data" TSVECTOR,
jbe@0	858 "minus2_unfulfilled_count" INT4,
jbe@0	859 "minus2_fulfilled_count" INT4,
jbe@0	860 "minus1_unfulfilled_count" INT4,
jbe@0	861 "minus1_fulfilled_count" INT4,
jbe@0	862 "plus1_unfulfilled_count" INT4,
jbe@0	863 "plus1_fulfilled_count" INT4,
jbe@0	864 "plus2_unfulfilled_count" INT4,
jbe@352	865 "plus2_fulfilled_count" INT4,
jbe@352	866 "proportional_order" INT4 );
jbe@16	867 CREATE INDEX "suggestion_created_idx" ON "suggestion" ("created");
jbe@9	868 CREATE INDEX "suggestion_author_id_created_idx" ON "suggestion" ("author_id", "created");
jbe@8	869 CREATE INDEX "suggestion_text_search_data_idx" ON "suggestion" USING gin ("text_search_data");
jbe@7	870 CREATE TRIGGER "update_text_search_data"
jbe@7	871 BEFORE INSERT OR UPDATE ON "suggestion"
jbe@7	872 FOR EACH ROW EXECUTE PROCEDURE
jbe@7	873 tsvector_update_trigger('text_search_data', 'pg_catalog.simple',
jbe@159	874 "name", "content");
jbe@0	875
jbe@10	876 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';
jbe@0	877
jbe@160	878 COMMENT ON COLUMN "suggestion"."draft_id" IS 'Draft, which the author has seen when composing the suggestion; should always be set by a frontend, but defaults to current draft of the initiative (implemented by trigger "default_for_draft_id")';
jbe@444	879 COMMENT ON COLUMN "suggestion"."external_reference" IS 'Opaque data field to store an external reference';
jbe@0	880 COMMENT ON COLUMN "suggestion"."minus2_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
jbe@0	881 COMMENT ON COLUMN "suggestion"."minus2_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
jbe@0	882 COMMENT ON COLUMN "suggestion"."minus1_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
jbe@0	883 COMMENT ON COLUMN "suggestion"."minus1_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
jbe@0	884 COMMENT ON COLUMN "suggestion"."plus1_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
jbe@0	885 COMMENT ON COLUMN "suggestion"."plus1_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
jbe@0	886 COMMENT ON COLUMN "suggestion"."plus2_unfulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
jbe@0	887 COMMENT ON COLUMN "suggestion"."plus2_fulfilled_count" IS 'Calculated from table "direct_supporter_snapshot", not requiring informed supporters';
jbe@378	888 COMMENT ON COLUMN "suggestion"."proportional_order" IS 'To be used for sorting suggestions within an initiative; NULL values sort last; updated by "lf_update_suggestion_order"';
jbe@0	889
jbe@0	890
jbe@159	891 CREATE TABLE "rendered_suggestion" (
jbe@159	892 PRIMARY KEY ("suggestion_id", "format"),
jbe@159	893 "suggestion_id" INT8 REFERENCES "suggestion" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@159	894 "format" TEXT,
jbe@159	895 "content" TEXT NOT NULL );
jbe@159	896
jbe@159	897 COMMENT ON TABLE "rendered_suggestion" IS 'This table may be used by frontends to cache "rendered" drafts (e.g. HTML output generated from wiki text)';
jbe@159	898
jbe@159	899
jbe@23	900 CREATE TABLE "suggestion_setting" (
jbe@23	901 PRIMARY KEY ("member_id", "key", "suggestion_id"),
jbe@23	902 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	903 "key" TEXT NOT NULL,
jbe@23	904 "suggestion_id" INT8 REFERENCES "suggestion" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@23	905 "value" TEXT NOT NULL );
jbe@23	906
jbe@23	907 COMMENT ON TABLE "suggestion_setting" IS 'Place for frontend to store suggestion specific settings of members as strings';
jbe@23	908
jbe@23	909
jbe@97	910 CREATE TABLE "privilege" (
jbe@97	911 PRIMARY KEY ("unit_id", "member_id"),
jbe@97	912 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@97	913 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@97	914 "admin_manager" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@97	915 "unit_manager" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@97	916 "area_manager" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@261	917 "member_manager" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@261	918 "initiative_right" BOOLEAN NOT NULL DEFAULT TRUE,
jbe@261	919 "voting_right" BOOLEAN NOT NULL DEFAULT TRUE,
jbe@261	920 "polling_right" BOOLEAN NOT NULL DEFAULT FALSE );
jbe@97	921
jbe@97	922 COMMENT ON TABLE "privilege" IS 'Members rights related to each unit';
jbe@97	923
jbe@289	924 COMMENT ON COLUMN "privilege"."admin_manager" IS 'Grant/revoke any privileges to/from other members';
jbe@289	925 COMMENT ON COLUMN "privilege"."unit_manager" IS 'Create and disable sub units';
jbe@289	926 COMMENT ON COLUMN "privilege"."area_manager" IS 'Create and disable areas and set area parameters';
jbe@289	927 COMMENT ON COLUMN "privilege"."member_manager" IS 'Adding/removing members from the unit, granting or revoking "initiative_right" and "voting_right"';
jbe@289	928 COMMENT ON COLUMN "privilege"."initiative_right" IS 'Right to create an initiative';
jbe@289	929 COMMENT ON COLUMN "privilege"."voting_right" IS 'Right to support initiatives, create and rate suggestions, and to vote';
jbe@289	930 COMMENT ON COLUMN "privilege"."polling_right" IS 'Right to create issues with policies having the "policy"."polling" flag set, and to add initiatives having the "initiative"."polling" flag set to those issues';
jbe@97	931
jbe@97	932
jbe@0	933 CREATE TABLE "membership" (
jbe@0	934 PRIMARY KEY ("area_id", "member_id"),
jbe@0	935 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@169	936 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@0	937 CREATE INDEX "membership_member_id_idx" ON "membership" ("member_id");
jbe@0	938
jbe@0	939 COMMENT ON TABLE "membership" IS 'Interest of members in topic areas';
jbe@0	940
jbe@0	941
jbe@0	942 CREATE TABLE "interest" (
jbe@0	943 PRIMARY KEY ("issue_id", "member_id"),
jbe@0	944 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@148	945 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@0	946 CREATE INDEX "interest_member_id_idx" ON "interest" ("member_id");
jbe@0	947
jbe@10	948 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.';
jbe@0	949
jbe@0	950
jbe@0	951 CREATE TABLE "initiator" (
jbe@0	952 PRIMARY KEY ("initiative_id", "member_id"),
jbe@0	953 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	954 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@14	955 "accepted" BOOLEAN );
jbe@0	956 CREATE INDEX "initiator_member_id_idx" ON "initiator" ("member_id");
jbe@0	957
jbe@10	958 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.';
jbe@0	959
jbe@14	960 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.';
jbe@0	961
jbe@0	962
jbe@0	963 CREATE TABLE "supporter" (
jbe@0	964 "issue_id" INT4 NOT NULL,
jbe@0	965 PRIMARY KEY ("initiative_id", "member_id"),
jbe@0	966 "initiative_id" INT4,
jbe@0	967 "member_id" INT4,
jbe@0	968 "draft_id" INT8 NOT NULL,
jbe@10	969 FOREIGN KEY ("issue_id", "member_id") REFERENCES "interest" ("issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@160	970 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE );
jbe@0	971 CREATE INDEX "supporter_member_id_idx" ON "supporter" ("member_id");
jbe@0	972
jbe@10	973 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.';
jbe@0	974
jbe@207	975 COMMENT ON COLUMN "supporter"."issue_id" IS 'WARNING: No index: For selections use column "initiative_id" and join via table "initiative" where neccessary';
jbe@160	976 COMMENT ON COLUMN "supporter"."draft_id" IS 'Latest seen draft; should always be set by a frontend, but defaults to current draft of the initiative (implemented by trigger "default_for_draft_id")';
jbe@84	977
jbe@0	978
jbe@0	979 CREATE TABLE "opinion" (
jbe@0	980 "initiative_id" INT4 NOT NULL,
jbe@0	981 PRIMARY KEY ("suggestion_id", "member_id"),
jbe@0	982 "suggestion_id" INT8,
jbe@0	983 "member_id" INT4,
jbe@0	984 "degree" INT2 NOT NULL CHECK ("degree" >= -2 AND "degree" <= 2 AND "degree" != 0),
jbe@0	985 "fulfilled" BOOLEAN NOT NULL DEFAULT FALSE,
jbe@42	986 FOREIGN KEY ("initiative_id", "suggestion_id") REFERENCES "suggestion" ("initiative_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	987 FOREIGN KEY ("initiative_id", "member_id") REFERENCES "supporter" ("initiative_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@10	988 CREATE INDEX "opinion_member_id_initiative_id_idx" ON "opinion" ("member_id", "initiative_id");
jbe@0	989
jbe@10	990 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.';
jbe@0	991
jbe@0	992 COMMENT ON COLUMN "opinion"."degree" IS '2 = fulfillment required for support; 1 = fulfillment desired; -1 = fulfillment unwanted; -2 = fulfillment cancels support';
jbe@0	993
jbe@0	994
jbe@97	995 CREATE TYPE "delegation_scope" AS ENUM ('unit', 'area', 'issue');
jbe@97	996
jbe@97	997 COMMENT ON TYPE "delegation_scope" IS 'Scope for delegations: ''unit'', ''area'', or ''issue'' (order is relevant)';
jbe@10	998
jbe@10	999
jbe@0	1000 CREATE TABLE "delegation" (
jbe@0	1001 "id" SERIAL8 PRIMARY KEY,
jbe@0	1002 "truster_id" INT4 NOT NULL REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@86	1003 "trustee_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@10	1004 "scope" "delegation_scope" NOT NULL,
jbe@97	1005 "unit_id" INT4 REFERENCES "unit" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	1006 "area_id" INT4 REFERENCES "area" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	1007 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	1008 CONSTRAINT "cant_delegate_to_yourself" CHECK ("truster_id" != "trustee_id"),
jbe@97	1009 CONSTRAINT "no_unit_delegation_to_null"
jbe@97	1010 CHECK ("trustee_id" NOTNULL OR "scope" != 'unit'),
jbe@10	1011 CONSTRAINT "area_id_and_issue_id_set_according_to_scope" CHECK (
jbe@97	1012 ("scope" = 'unit' AND "unit_id" NOTNULL AND "area_id" ISNULL AND "issue_id" ISNULL ) OR
jbe@97	1013 ("scope" = 'area' AND "unit_id" ISNULL AND "area_id" NOTNULL AND "issue_id" ISNULL ) OR
jbe@97	1014 ("scope" = 'issue' AND "unit_id" ISNULL AND "area_id" ISNULL AND "issue_id" NOTNULL) ),
jbe@97	1015 UNIQUE ("unit_id", "truster_id"),
jbe@74	1016 UNIQUE ("area_id", "truster_id"),
jbe@74	1017 UNIQUE ("issue_id", "truster_id") );
jbe@0	1018 CREATE INDEX "delegation_truster_id_idx" ON "delegation" ("truster_id");
jbe@0	1019 CREATE INDEX "delegation_trustee_id_idx" ON "delegation" ("trustee_id");
jbe@0	1020
jbe@0	1021 COMMENT ON TABLE "delegation" IS 'Delegation of vote-weight to other members';
jbe@0	1022
jbe@97	1023 COMMENT ON COLUMN "delegation"."unit_id" IS 'Reference to unit, if delegation is unit-wide, otherwise NULL';
jbe@0	1024 COMMENT ON COLUMN "delegation"."area_id" IS 'Reference to area, if delegation is area-wide, otherwise NULL';
jbe@0	1025 COMMENT ON COLUMN "delegation"."issue_id" IS 'Reference to issue, if delegation is issue-wide, otherwise NULL';
jbe@0	1026
jbe@0	1027
jbe@0	1028 CREATE TABLE "direct_population_snapshot" (
jbe@0	1029 PRIMARY KEY ("issue_id", "event", "member_id"),
jbe@0	1030 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	1031 "event" "snapshot_event",
jbe@45	1032 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
jbe@54	1033 "weight" INT4 );
jbe@0	1034 CREATE INDEX "direct_population_snapshot_member_id_idx" ON "direct_population_snapshot" ("member_id");
jbe@0	1035
jbe@389	1036 COMMENT ON TABLE "direct_population_snapshot" IS 'Snapshot of active members having either a "membership" in the "area" or an "interest" in the "issue"; for corrections refer to column "issue_notice" of "issue" table';
jbe@0	1037
jbe@148	1038 COMMENT ON COLUMN "direct_population_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
jbe@148	1039 COMMENT ON COLUMN "direct_population_snapshot"."weight" IS 'Weight of member (1 or higher) according to "delegating_population_snapshot"';
jbe@0	1040
jbe@0	1041
jbe@0	1042 CREATE TABLE "delegating_population_snapshot" (
jbe@0	1043 PRIMARY KEY ("issue_id", "event", "member_id"),
jbe@0	1044 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	1045 "event" "snapshot_event",
jbe@45	1046 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
jbe@8	1047 "weight" INT4,
jbe@10	1048 "scope" "delegation_scope" NOT NULL,
jbe@0	1049 "delegate_member_ids" INT4[] NOT NULL );
jbe@0	1050 CREATE INDEX "delegating_population_snapshot_member_id_idx" ON "delegating_population_snapshot" ("member_id");
jbe@0	1051
jbe@389	1052 COMMENT ON TABLE "direct_population_snapshot" IS 'Delegations increasing the weight of entries in the "direct_population_snapshot" table; for corrections refer to column "issue_notice" of "issue" table';
jbe@0	1053
jbe@0	1054 COMMENT ON COLUMN "delegating_population_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
jbe@0	1055 COMMENT ON COLUMN "delegating_population_snapshot"."member_id" IS 'Delegating member';
jbe@8	1056 COMMENT ON COLUMN "delegating_population_snapshot"."weight" IS 'Intermediate weight';
jbe@0	1057 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"';
jbe@0	1058
jbe@0	1059
jbe@0	1060 CREATE TABLE "direct_interest_snapshot" (
jbe@0	1061 PRIMARY KEY ("issue_id", "event", "member_id"),
jbe@0	1062 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	1063 "event" "snapshot_event",
jbe@45	1064 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
jbe@144	1065 "weight" INT4 );
jbe@0	1066 CREATE INDEX "direct_interest_snapshot_member_id_idx" ON "direct_interest_snapshot" ("member_id");
jbe@0	1067
jbe@389	1068 COMMENT ON TABLE "direct_interest_snapshot" IS 'Snapshot of active members having an "interest" in the "issue"; for corrections refer to column "issue_notice" of "issue" table';
jbe@0	1069
jbe@0	1070 COMMENT ON COLUMN "direct_interest_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
jbe@0	1071 COMMENT ON COLUMN "direct_interest_snapshot"."weight" IS 'Weight of member (1 or higher) according to "delegating_interest_snapshot"';
jbe@0	1072
jbe@0	1073
jbe@0	1074 CREATE TABLE "delegating_interest_snapshot" (
jbe@0	1075 PRIMARY KEY ("issue_id", "event", "member_id"),
jbe@0	1076 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@0	1077 "event" "snapshot_event",
jbe@45	1078 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
jbe@8	1079 "weight" INT4,
jbe@10	1080 "scope" "delegation_scope" NOT NULL,
jbe@0	1081 "delegate_member_ids" INT4[] NOT NULL );
jbe@0	1082 CREATE INDEX "delegating_interest_snapshot_member_id_idx" ON "delegating_interest_snapshot" ("member_id");
jbe@0	1083
jbe@389	1084 COMMENT ON TABLE "delegating_interest_snapshot" IS 'Delegations increasing the weight of entries in the "direct_interest_snapshot" table; for corrections refer to column "issue_notice" of "issue" table';
jbe@0	1085
jbe@0	1086 COMMENT ON COLUMN "delegating_interest_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
jbe@0	1087 COMMENT ON COLUMN "delegating_interest_snapshot"."member_id" IS 'Delegating member';
jbe@8	1088 COMMENT ON COLUMN "delegating_interest_snapshot"."weight" IS 'Intermediate weight';
jbe@0	1089 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"';
jbe@0	1090
jbe@0	1091
jbe@0	1092 CREATE TABLE "direct_supporter_snapshot" (
jbe@0	1093 "issue_id" INT4 NOT NULL,
jbe@0	1094 PRIMARY KEY ("initiative_id", "event", "member_id"),
jbe@0	1095 "initiative_id" INT4,
jbe@0	1096 "event" "snapshot_event",
jbe@45	1097 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
jbe@204	1098 "draft_id" INT8 NOT NULL,
jbe@0	1099 "informed" BOOLEAN NOT NULL,
jbe@0	1100 "satisfied" BOOLEAN NOT NULL,
jbe@0	1101 FOREIGN KEY ("issue_id", "initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@204	1102 FOREIGN KEY ("initiative_id", "draft_id") REFERENCES "draft" ("initiative_id", "id") ON DELETE NO ACTION ON UPDATE CASCADE,
jbe@0	1103 FOREIGN KEY ("issue_id", "event", "member_id") REFERENCES "direct_interest_snapshot" ("issue_id", "event", "member_id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@0	1104 CREATE INDEX "direct_supporter_snapshot_member_id_idx" ON "direct_supporter_snapshot" ("member_id");
jbe@0	1105
jbe@389	1106 COMMENT ON TABLE "direct_supporter_snapshot" IS 'Snapshot of supporters of initiatives (weight is stored in "direct_interest_snapshot"); for corrections refer to column "issue_notice" of "issue" table';
jbe@0	1107
jbe@207	1108 COMMENT ON COLUMN "direct_supporter_snapshot"."issue_id" IS 'WARNING: No index: For selections use column "initiative_id" and join via table "initiative" where neccessary';
jbe@0	1109 COMMENT ON COLUMN "direct_supporter_snapshot"."event" IS 'Reason for snapshot, see "snapshot_event" type for details';
jbe@0	1110 COMMENT ON COLUMN "direct_supporter_snapshot"."informed" IS 'Supporter has seen the latest draft of the initiative';
jbe@0	1111 COMMENT ON COLUMN "direct_supporter_snapshot"."satisfied" IS 'Supporter has no "critical_opinion"s';
jbe@0	1112
jbe@0	1113
jbe@113	1114 CREATE TABLE "non_voter" (
jbe@113	1115 PRIMARY KEY ("issue_id", "member_id"),
jbe@113	1116 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@113	1117 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE );
jbe@113	1118 CREATE INDEX "non_voter_member_id_idx" ON "non_voter" ("member_id");
jbe@113	1119
jbe@113	1120 COMMENT ON TABLE "non_voter" IS 'Members who decided to not vote directly on an issue';
jbe@113	1121
jbe@113	1122
jbe@0	1123 CREATE TABLE "direct_voter" (
jbe@0	1124 PRIMARY KEY ("issue_id", "member_id"),
jbe@0	1125 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@45	1126 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
jbe@285	1127 "weight" INT4,
jbe@285	1128 "comment_changed" TIMESTAMPTZ,
jbe@285	1129 "formatting_engine" TEXT,
jbe@285	1130 "comment" TEXT,
jbe@285	1131 "text_search_data" TSVECTOR );
jbe@0	1132 CREATE INDEX "direct_voter_member_id_idx" ON "direct_voter" ("member_id");
jbe@285	1133 CREATE INDEX "direct_voter_text_search_data_idx" ON "direct_voter" USING gin ("text_search_data");
jbe@285	1134 CREATE TRIGGER "update_text_search_data"
jbe@285	1135 BEFORE INSERT OR UPDATE ON "direct_voter"
jbe@285	1136 FOR EACH ROW EXECUTE PROCEDURE
jbe@285	1137 tsvector_update_trigger('text_search_data', 'pg_catalog.simple', "comment");
jbe@0	1138
jbe@389	1139 COMMENT ON TABLE "direct_voter" IS 'Members having directly voted for/against initiatives of an issue; frontends must ensure that no voters are added or removed to/from this table when the issue has been closed; for corrections refer to column "issue_notice" of "issue" table';
jbe@0	1140
jbe@285	1141 COMMENT ON COLUMN "direct_voter"."weight" IS 'Weight of member (1 or higher) according to "delegating_voter" table';
jbe@285	1142 COMMENT ON COLUMN "direct_voter"."comment_changed" IS 'Shall be set on comment change, to indicate a comment being modified after voting has been finished; Automatically set to NULL after voting phase; Automatically set to NULL by trigger, if "comment" is set to NULL';
jbe@285	1143 COMMENT ON COLUMN "direct_voter"."formatting_engine" IS 'Allows different formatting engines (i.e. wiki formats) to be used for "direct_voter"."comment"; Automatically set to NULL by trigger, if "comment" is set to NULL';
jbe@285	1144 COMMENT ON COLUMN "direct_voter"."comment" IS 'Is to be set or updated by the frontend, if comment was inserted or updated AFTER the issue has been closed. Otherwise it shall be set to NULL.';
jbe@285	1145
jbe@285	1146
jbe@285	1147 CREATE TABLE "rendered_voter_comment" (
jbe@285	1148 PRIMARY KEY ("issue_id", "member_id", "format"),
jbe@285	1149 FOREIGN KEY ("issue_id", "member_id")
jbe@285	1150 REFERENCES "direct_voter" ("issue_id", "member_id")
jbe@285	1151 ON DELETE CASCADE ON UPDATE CASCADE,
jbe@285	1152 "issue_id" INT4,
jbe@285	1153 "member_id" INT4,
jbe@285	1154 "format" TEXT,
jbe@285	1155 "content" TEXT NOT NULL );
jbe@285	1156
jbe@285	1157 COMMENT ON TABLE "rendered_voter_comment" IS 'This table may be used by frontends to cache "rendered" voter comments (e.g. HTML output generated from wiki text)';
jbe@0	1158
jbe@0	1159
jbe@0	1160 CREATE TABLE "delegating_voter" (
jbe@0	1161 PRIMARY KEY ("issue_id", "member_id"),
jbe@0	1162 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@45	1163 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE RESTRICT,
jbe@8	1164 "weight" INT4,
jbe@10	1165 "scope" "delegation_scope" NOT NULL,
jbe@0	1166 "delegate_member_ids" INT4[] NOT NULL );
jbe@52	1167 CREATE INDEX "delegating_voter_member_id_idx" ON "delegating_voter" ("member_id");
jbe@0	1168
jbe@389	1169 COMMENT ON TABLE "delegating_voter" IS 'Delegations increasing the weight of entries in the "direct_voter" table; for corrections refer to column "issue_notice" of "issue" table';
jbe@0	1170
jbe@0	1171 COMMENT ON COLUMN "delegating_voter"."member_id" IS 'Delegating member';
jbe@8	1172 COMMENT ON COLUMN "delegating_voter"."weight" IS 'Intermediate weight';
jbe@0	1173 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"';
jbe@0	1174
jbe@0	1175
jbe@0	1176 CREATE TABLE "vote" (
jbe@0	1177 "issue_id" INT4 NOT NULL,
jbe@0	1178 PRIMARY KEY ("initiative_id", "member_id"),
jbe@0	1179 "initiative_id" INT4,
jbe@0	1180 "member_id" INT4,
jbe@414	1181 "grade" INT4 NOT NULL,
jbe@414	1182 "first_preference" BOOLEAN,
jbe@0	1183 FOREIGN KEY ("issue_id", "initiative_id") REFERENCES "initiative" ("issue_id", "id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@414	1184 FOREIGN KEY ("issue_id", "member_id") REFERENCES "direct_voter" ("issue_id", "member_id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@414	1185 CONSTRAINT "first_preference_flag_only_set_on_positive_grades"
jbe@414	1186 CHECK ("grade" > 0 OR "first_preference" ISNULL) );
jbe@0	1187 CREATE INDEX "vote_member_id_idx" ON "vote" ("member_id");
jbe@0	1188
jbe@389	1189 COMMENT ON TABLE "vote" IS 'Manual and delegated votes without abstentions; frontends must ensure that no votes are added modified or removed when the issue has been closed; for corrections refer to column "issue_notice" of "issue" table';
jbe@0	1190
jbe@414	1191 COMMENT ON COLUMN "vote"."issue_id" IS 'WARNING: No index: For selections use column "initiative_id" and join via table "initiative" where neccessary';
jbe@414	1192 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.';
jbe@414	1193 COMMENT ON COLUMN "vote"."first_preference" IS 'Value is automatically set after voting is finished. For positive grades, this value is set to true for the highest (i.e. best) grade.';
jbe@0	1194
jbe@0	1195
jbe@112	1196 CREATE TYPE "event_type" AS ENUM (
jbe@112	1197 'issue_state_changed',
jbe@112	1198 'initiative_created_in_new_issue',
jbe@112	1199 'initiative_created_in_existing_issue',
jbe@112	1200 'initiative_revoked',
jbe@112	1201 'new_draft_created',
jbe@112	1202 'suggestion_created');
jbe@112	1203
jbe@112	1204 COMMENT ON TYPE "event_type" IS 'Type used for column "event" of table "event"';
jbe@112	1205
jbe@112	1206
jbe@112	1207 CREATE TABLE "event" (
jbe@112	1208 "id" SERIAL8 PRIMARY KEY,
jbe@112	1209 "occurrence" TIMESTAMPTZ NOT NULL DEFAULT now(),
jbe@112	1210 "event" "event_type" NOT NULL,
jbe@112	1211 "member_id" INT4 REFERENCES "member" ("id") ON DELETE RESTRICT ON UPDATE CASCADE,
jbe@112	1212 "issue_id" INT4 REFERENCES "issue" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@328	1213 "state" "issue_state",
jbe@112	1214 "initiative_id" INT4,
jbe@112	1215 "draft_id" INT8,
jbe@112	1216 "suggestion_id" INT8,
jbe@112	1217 FOREIGN KEY ("issue_id", "initiative_id")
jbe@112	1218 REFERENCES "initiative" ("issue_id", "id")
jbe@112	1219 ON DELETE CASCADE ON UPDATE CASCADE,
jbe@112	1220 FOREIGN KEY ("initiative_id", "draft_id")
jbe@112	1221 REFERENCES "draft" ("initiative_id", "id")
jbe@112	1222 ON DELETE CASCADE ON UPDATE CASCADE,
jbe@112	1223 FOREIGN KEY ("initiative_id", "suggestion_id")
jbe@112	1224 REFERENCES "suggestion" ("initiative_id", "id")
jbe@112	1225 ON DELETE CASCADE ON UPDATE CASCADE,
jbe@451	1226 CONSTRAINT "null_constr_for_issue_state_changed" CHECK (
jbe@112	1227 "event" != 'issue_state_changed' OR (
jbe@112	1228 "member_id" ISNULL AND
jbe@112	1229 "issue_id" NOTNULL AND
jbe@113	1230 "state" NOTNULL AND
jbe@112	1231 "initiative_id" ISNULL AND
jbe@112	1232 "draft_id" ISNULL AND
jbe@112	1233 "suggestion_id" ISNULL )),
jbe@451	1234 CONSTRAINT "null_constr_for_initiative_creation_or_revocation_or_new_draft" CHECK (
jbe@112	1235 "event" NOT IN (
jbe@112	1236 'initiative_created_in_new_issue',
jbe@112	1237 'initiative_created_in_existing_issue',
jbe@112	1238 'initiative_revoked',
jbe@112	1239 'new_draft_created'
jbe@112	1240 ) OR (
jbe@112	1241 "member_id" NOTNULL AND
jbe@112	1242 "issue_id" NOTNULL AND
jbe@113	1243 "state" NOTNULL AND
jbe@112	1244 "initiative_id" NOTNULL AND
jbe@112	1245 "draft_id" NOTNULL AND
jbe@112	1246 "suggestion_id" ISNULL )),
jbe@451	1247 CONSTRAINT "null_constr_for_suggestion_creation" CHECK (
jbe@112	1248 "event" != 'suggestion_created' OR (
jbe@112	1249 "member_id" NOTNULL AND
jbe@112	1250 "issue_id" NOTNULL AND
jbe@113	1251 "state" NOTNULL AND
jbe@112	1252 "initiative_id" NOTNULL AND
jbe@112	1253 "draft_id" ISNULL AND
jbe@112	1254 "suggestion_id" NOTNULL )) );
jbe@223	1255 CREATE INDEX "event_occurrence_idx" ON "event" ("occurrence");
jbe@112	1256
jbe@112	1257 COMMENT ON TABLE "event" IS 'Event table, automatically filled by triggers';
jbe@112	1258
jbe@114	1259 COMMENT ON COLUMN "event"."occurrence" IS 'Point in time, when event occurred';
jbe@114	1260 COMMENT ON COLUMN "event"."event" IS 'Type of event (see TYPE "event_type")';
jbe@114	1261 COMMENT ON COLUMN "event"."member_id" IS 'Member who caused the event, if applicable';
jbe@114	1262 COMMENT ON COLUMN "event"."state" IS 'If issue_id is set: state of affected issue; If state changed: new state';
jbe@114	1263
jbe@112	1264
jbe@222	1265 CREATE TABLE "notification_sent" (
jbe@222	1266 "event_id" INT8 NOT NULL );
jbe@222	1267 CREATE UNIQUE INDEX "notification_sent_singleton_idx" ON "notification_sent" ((1));
jbe@222	1268
jbe@222	1269 COMMENT ON TABLE "notification_sent" IS 'This table stores one row with the last event_id, for which notifications have been sent out';
jbe@222	1270 COMMENT ON INDEX "notification_sent_singleton_idx" IS 'This index ensures that "notification_sent" only contains one row maximum.';
jbe@222	1271
jbe@222	1272
jbe@486	1273 CREATE TABLE "initiative_notification_sent" (
jbe@486	1274 PRIMARY KEY ("member_id", "initiative_id"),
jbe@486	1275 "member_id" INT4 REFERENCES "member" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@486	1276 "initiative_id" INT4 REFERENCES "initiative" ("id") ON DELETE CASCADE ON UPDATE CASCADE,
jbe@486	1277 "last_draft_id" INT8 NOT NULL,
jbe@486	1278 "last_suggestion_id" INT8 NOT NULL );
jbe@486	1279 CREATE INDEX "initiative_notification_sent_initiative_idx" ON "initiative_notification_sent" ("initiative_id");
jbe@486	1280
jbe@486	1281
jbe@112	1282
jbe@112	1283 ----------------------------------------------
jbe@112	1284 -- Writing of history entries and event log --
jbe@112	1285 ----------------------------------------------
jbe@13	1286
jbe@181	1287
jbe@13	1288 CREATE FUNCTION "write_member_history_trigger"()
jbe@13	1289 RETURNS TRIGGER
jbe@13	1290 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@13	1291 BEGIN
jbe@42	1292 IF
jbe@230	1293 ( NEW."active" != OLD."active" OR
jbe@230	1294 NEW."name" != OLD."name" ) AND
jbe@230	1295 OLD."activated" NOTNULL
jbe@42	1296 THEN
jbe@42	1297 INSERT INTO "member_history"
jbe@57	1298 ("member_id", "active", "name")
jbe@57	1299 VALUES (NEW."id", OLD."active", OLD."name");
jbe@13	1300 END IF;
jbe@13	1301 RETURN NULL;
jbe@13	1302 END;
jbe@13	1303 $$;
jbe@13	1304
jbe@13	1305 CREATE TRIGGER "write_member_history"
jbe@13	1306 AFTER UPDATE ON "member" FOR EACH ROW EXECUTE PROCEDURE
jbe@13	1307 "write_member_history_trigger"();
jbe@13	1308
jbe@13	1309 COMMENT ON FUNCTION "write_member_history_trigger"() IS 'Implementation of trigger "write_member_history" on table "member"';
jbe@57	1310 COMMENT ON TRIGGER "write_member_history" ON "member" IS 'When changing certain fields of a member, create a history entry in "member_history" table';
jbe@13	1311
jbe@13	1312
jbe@112	1313 CREATE FUNCTION "write_event_issue_state_changed_trigger"()
jbe@112	1314 RETURNS TRIGGER
jbe@112	1315 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@112	1316 BEGIN
jbe@328	1317 IF NEW."state" != OLD."state" THEN
jbe@112	1318 INSERT INTO "event" ("event", "issue_id", "state")
jbe@112	1319 VALUES ('issue_state_changed', NEW."id", NEW."state");
jbe@112	1320 END IF;
jbe@112	1321 RETURN NULL;
jbe@112	1322 END;
jbe@112	1323 $$;
jbe@112	1324
jbe@112	1325 CREATE TRIGGER "write_event_issue_state_changed"
jbe@112	1326 AFTER UPDATE ON "issue" FOR EACH ROW EXECUTE PROCEDURE
jbe@112	1327 "write_event_issue_state_changed_trigger"();
jbe@112	1328
jbe@112	1329 COMMENT ON FUNCTION "write_event_issue_state_changed_trigger"() IS 'Implementation of trigger "write_event_issue_state_changed" on table "issue"';
jbe@112	1330 COMMENT ON TRIGGER "write_event_issue_state_changed" ON "issue" IS 'Create entry in "event" table on "state" change';
jbe@112	1331
jbe@112	1332
jbe@112	1333 CREATE FUNCTION "write_event_initiative_or_draft_created_trigger"()
jbe@112	1334 RETURNS TRIGGER
jbe@112	1335 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@112	1336 DECLARE
jbe@112	1337 "initiative_row" "initiative"%ROWTYPE;
jbe@113	1338 "issue_row" "issue"%ROWTYPE;
jbe@112	1339 "event_v" "event_type";
jbe@112	1340 BEGIN
jbe@112	1341 SELECT * INTO "initiative_row" FROM "initiative"
jbe@112	1342 WHERE "id" = NEW."initiative_id";
jbe@113	1343 SELECT * INTO "issue_row" FROM "issue"
jbe@113	1344 WHERE "id" = "initiative_row"."issue_id";
jbe@112	1345 IF EXISTS (
jbe@112	1346 SELECT NULL FROM "draft"
jbe@112	1347 WHERE "initiative_id" = NEW."initiative_id"
jbe@112	1348 AND "id" != NEW."id"
jbe@112	1349 ) THEN
jbe@112	1350 "event_v" := 'new_draft_created';
jbe@112	1351 ELSE
jbe@112	1352 IF EXISTS (
jbe@112	1353 SELECT NULL FROM "initiative"
jbe@112	1354 WHERE "issue_id" = "initiative_row"."issue_id"
jbe@112	1355 AND "id" != "initiative_row"."id"
jbe@112	1356 ) THEN
jbe@112	1357 "event_v" := 'initiative_created_in_existing_issue';
jbe@112	1358 ELSE
jbe@112	1359 "event_v" := 'initiative_created_in_new_issue';
jbe@112	1360 END IF;
jbe@112	1361 END IF;
jbe@112	1362 INSERT INTO "event" (
jbe@112	1363 "event", "member_id",
jbe@113	1364 "issue_id", "state", "initiative_id", "draft_id"
jbe@112	1365 ) VALUES (
jbe@112	1366 "event_v",
jbe@112	1367 NEW."author_id",
jbe@112	1368 "initiative_row"."issue_id",
jbe@113	1369 "issue_row"."state",
jbe@112	1370 "initiative_row"."id",
jbe@112	1371 NEW."id" );
jbe@112	1372 RETURN NULL;
jbe@112	1373 END;
jbe@112	1374 $$;
jbe@112	1375
jbe@112	1376 CREATE TRIGGER "write_event_initiative_or_draft_created"
jbe@112	1377 AFTER INSERT ON "draft" FOR EACH ROW EXECUTE PROCEDURE
jbe@112	1378 "write_event_initiative_or_draft_created_trigger"();
jbe@112	1379
jbe@112	1380 COMMENT ON FUNCTION "write_event_initiative_or_draft_created_trigger"() IS 'Implementation of trigger "write_event_initiative_or_draft_created" on table "issue"';
jbe@112	1381 COMMENT ON TRIGGER "write_event_initiative_or_draft_created" ON "draft" IS 'Create entry in "event" table on draft creation';
jbe@112	1382
jbe@112	1383
jbe@112	1384 CREATE FUNCTION "write_event_initiative_revoked_trigger"()
jbe@112	1385 RETURNS TRIGGER
jbe@112	1386 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@113	1387 DECLARE
jbe@231	1388 "issue_row" "issue"%ROWTYPE;
jbe@231	1389 "draft_id_v" "draft"."id"%TYPE;
jbe@112	1390 BEGIN
jbe@112	1391 IF OLD."revoked" ISNULL AND NEW."revoked" NOTNULL THEN
jbe@231	1392 SELECT * INTO "issue_row" FROM "issue"
jbe@231	1393 WHERE "id" = NEW."issue_id";
jbe@231	1394 SELECT "id" INTO "draft_id_v" FROM "current_draft"
jbe@231	1395 WHERE "initiative_id" = NEW."id";
jbe@112	1396 INSERT INTO "event" (
jbe@231	1397 "event", "member_id", "issue_id", "state", "initiative_id", "draft_id"
jbe@112	1398 ) VALUES (
jbe@112	1399 'initiative_revoked',
jbe@112	1400 NEW."revoked_by_member_id",
jbe@112	1401 NEW."issue_id",
jbe@113	1402 "issue_row"."state",
jbe@231	1403 NEW."id",
jbe@231	1404 "draft_id_v");
jbe@112	1405 END IF;
jbe@112	1406 RETURN NULL;
jbe@112	1407 END;
jbe@112	1408 $$;
jbe@112	1409
jbe@112	1410 CREATE TRIGGER "write_event_initiative_revoked"
jbe@112	1411 AFTER UPDATE ON "initiative" FOR EACH ROW EXECUTE PROCEDURE
jbe@112	1412 "write_event_initiative_revoked_trigger"();
jbe@112	1413
jbe@112	1414 COMMENT ON FUNCTION "write_event_initiative_revoked_trigger"() IS 'Implementation of trigger "write_event_initiative_revoked" on table "issue"';
jbe@112	1415 COMMENT ON TRIGGER "write_event_initiative_revoked" ON "initiative" IS 'Create entry in "event" table, when an initiative is revoked';
jbe@112	1416
jbe@112	1417
jbe@112	1418 CREATE FUNCTION "write_event_suggestion_created_trigger"()
jbe@112	1419 RETURNS TRIGGER
jbe@112	1420 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@112	1421 DECLARE
jbe@112	1422 "initiative_row" "initiative"%ROWTYPE;
jbe@113	1423 "issue_row" "issue"%ROWTYPE;
jbe@112	1424 BEGIN
jbe@112	1425 SELECT * INTO "initiative_row" FROM "initiative"
jbe@112	1426 WHERE "id" = NEW."initiative_id";
jbe@113	1427 SELECT * INTO "issue_row" FROM "issue"
jbe@113	1428 WHERE "id" = "initiative_row"."issue_id";
jbe@112	1429 INSERT INTO "event" (
jbe@112	1430 "event", "member_id",
jbe@113	1431 "issue_id", "state", "initiative_id", "suggestion_id"
jbe@112	1432 ) VALUES (
jbe@112	1433 'suggestion_created',
jbe@112	1434 NEW."author_id",
jbe@112	1435 "initiative_row"."issue_id",
jbe@113	1436 "issue_row"."state",
jbe@112	1437 "initiative_row"."id",
jbe@112	1438 NEW."id" );
jbe@112	1439 RETURN NULL;
jbe@112	1440 END;
jbe@112	1441 $$;
jbe@112	1442
jbe@112	1443 CREATE TRIGGER "write_event_suggestion_created"
jbe@112	1444 AFTER INSERT ON "suggestion" FOR EACH ROW EXECUTE PROCEDURE
jbe@112	1445 "write_event_suggestion_created_trigger"();
jbe@112	1446
jbe@112	1447 COMMENT ON FUNCTION "write_event_suggestion_created_trigger"() IS 'Implementation of trigger "write_event_suggestion_created" on table "issue"';
jbe@112	1448 COMMENT ON TRIGGER "write_event_suggestion_created" ON "suggestion" IS 'Create entry in "event" table on suggestion creation';
jbe@112	1449
jbe@112	1450
jbe@13	1451
jbe@0	1452 ----------------------------
jbe@0	1453 -- Additional constraints --
jbe@0	1454 ----------------------------
jbe@0	1455
jbe@0	1456
jbe@0	1457 CREATE FUNCTION "issue_requires_first_initiative_trigger"()
jbe@0	1458 RETURNS TRIGGER
jbe@0	1459 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1460 BEGIN
jbe@0	1461 IF NOT EXISTS (
jbe@0	1462 SELECT NULL FROM "initiative" WHERE "issue_id" = NEW."id"
jbe@0	1463 ) THEN
jbe@463	1464 RAISE EXCEPTION 'Cannot create issue without an initial initiative.' USING
jbe@463	1465 ERRCODE = 'integrity_constraint_violation',
jbe@463	1466 HINT = 'Create issue, initiative, and draft within the same transaction.';
jbe@0	1467 END IF;
jbe@0	1468 RETURN NULL;
jbe@0	1469 END;
jbe@0	1470 $$;
jbe@0	1471
jbe@0	1472 CREATE CONSTRAINT TRIGGER "issue_requires_first_initiative"
jbe@0	1473 AFTER INSERT OR UPDATE ON "issue" DEFERRABLE INITIALLY DEFERRED
jbe@0	1474 FOR EACH ROW EXECUTE PROCEDURE
jbe@0	1475 "issue_requires_first_initiative_trigger"();
jbe@0	1476
jbe@0	1477 COMMENT ON FUNCTION "issue_requires_first_initiative_trigger"() IS 'Implementation of trigger "issue_requires_first_initiative" on table "issue"';
jbe@0	1478 COMMENT ON TRIGGER "issue_requires_first_initiative" ON "issue" IS 'Ensure that new issues have at least one initiative';
jbe@0	1479
jbe@0	1480
jbe@0	1481 CREATE FUNCTION "last_initiative_deletes_issue_trigger"()
jbe@0	1482 RETURNS TRIGGER
jbe@0	1483 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1484 DECLARE
jbe@0	1485 "reference_lost" BOOLEAN;
jbe@0	1486 BEGIN
jbe@0	1487 IF TG_OP = 'DELETE' THEN
jbe@0	1488 "reference_lost" := TRUE;
jbe@0	1489 ELSE
jbe@0	1490 "reference_lost" := NEW."issue_id" != OLD."issue_id";
jbe@0	1491 END IF;
jbe@0	1492 IF
jbe@0	1493 "reference_lost" AND NOT EXISTS (
jbe@0	1494 SELECT NULL FROM "initiative" WHERE "issue_id" = OLD."issue_id"
jbe@0	1495 )
jbe@0	1496 THEN
jbe@0	1497 DELETE FROM "issue" WHERE "id" = OLD."issue_id";
jbe@0	1498 END IF;
jbe@0	1499 RETURN NULL;
jbe@0	1500 END;
jbe@0	1501 $$;
jbe@0	1502
jbe@0	1503 CREATE CONSTRAINT TRIGGER "last_initiative_deletes_issue"
jbe@0	1504 AFTER UPDATE OR DELETE ON "initiative" DEFERRABLE INITIALLY DEFERRED
jbe@0	1505 FOR EACH ROW EXECUTE PROCEDURE
jbe@0	1506 "last_initiative_deletes_issue_trigger"();
jbe@0	1507
jbe@0	1508 COMMENT ON FUNCTION "last_initiative_deletes_issue_trigger"() IS 'Implementation of trigger "last_initiative_deletes_issue" on table "initiative"';
jbe@0	1509 COMMENT ON TRIGGER "last_initiative_deletes_issue" ON "initiative" IS 'Removing the last initiative of an issue deletes the issue';
jbe@0	1510
jbe@0	1511
jbe@0	1512 CREATE FUNCTION "initiative_requires_first_draft_trigger"()
jbe@0	1513 RETURNS TRIGGER
jbe@0	1514 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1515 BEGIN
jbe@0	1516 IF NOT EXISTS (
jbe@0	1517 SELECT NULL FROM "draft" WHERE "initiative_id" = NEW."id"
jbe@0	1518 ) THEN
jbe@463	1519 RAISE EXCEPTION 'Cannot create initiative without an initial draft.' USING
jbe@463	1520 ERRCODE = 'integrity_constraint_violation',
jbe@463	1521 HINT = 'Create issue, initiative and draft within the same transaction.';
jbe@0	1522 END IF;
jbe@0	1523 RETURN NULL;
jbe@0	1524 END;
jbe@0	1525 $$;
jbe@0	1526
jbe@0	1527 CREATE CONSTRAINT TRIGGER "initiative_requires_first_draft"
jbe@0	1528 AFTER INSERT OR UPDATE ON "initiative" DEFERRABLE INITIALLY DEFERRED
jbe@0	1529 FOR EACH ROW EXECUTE PROCEDURE
jbe@0	1530 "initiative_requires_first_draft_trigger"();
jbe@0	1531
jbe@0	1532 COMMENT ON FUNCTION "initiative_requires_first_draft_trigger"() IS 'Implementation of trigger "initiative_requires_first_draft" on table "initiative"';
jbe@0	1533 COMMENT ON TRIGGER "initiative_requires_first_draft" ON "initiative" IS 'Ensure that new initiatives have at least one draft';
jbe@0	1534
jbe@0	1535
jbe@0	1536 CREATE FUNCTION "last_draft_deletes_initiative_trigger"()
jbe@0	1537 RETURNS TRIGGER
jbe@0	1538 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1539 DECLARE
jbe@0	1540 "reference_lost" BOOLEAN;
jbe@0	1541 BEGIN
jbe@0	1542 IF TG_OP = 'DELETE' THEN
jbe@0	1543 "reference_lost" := TRUE;
jbe@0	1544 ELSE
jbe@0	1545 "reference_lost" := NEW."initiative_id" != OLD."initiative_id";
jbe@0	1546 END IF;
jbe@0	1547 IF
jbe@0	1548 "reference_lost" AND NOT EXISTS (
jbe@0	1549 SELECT NULL FROM "draft" WHERE "initiative_id" = OLD."initiative_id"
jbe@0	1550 )
jbe@0	1551 THEN
jbe@0	1552 DELETE FROM "initiative" WHERE "id" = OLD."initiative_id";
jbe@0	1553 END IF;
jbe@0	1554 RETURN NULL;
jbe@0	1555 END;
jbe@0	1556 $$;
jbe@0	1557
jbe@0	1558 CREATE CONSTRAINT TRIGGER "last_draft_deletes_initiative"
jbe@0	1559 AFTER UPDATE OR DELETE ON "draft" DEFERRABLE INITIALLY DEFERRED
jbe@0	1560 FOR EACH ROW EXECUTE PROCEDURE
jbe@0	1561 "last_draft_deletes_initiative_trigger"();
jbe@0	1562
jbe@0	1563 COMMENT ON FUNCTION "last_draft_deletes_initiative_trigger"() IS 'Implementation of trigger "last_draft_deletes_initiative" on table "draft"';
jbe@0	1564 COMMENT ON TRIGGER "last_draft_deletes_initiative" ON "draft" IS 'Removing the last draft of an initiative deletes the initiative';
jbe@0	1565
jbe@0	1566
jbe@0	1567 CREATE FUNCTION "suggestion_requires_first_opinion_trigger"()
jbe@0	1568 RETURNS TRIGGER
jbe@0	1569 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1570 BEGIN
jbe@0	1571 IF NOT EXISTS (
jbe@0	1572 SELECT NULL FROM "opinion" WHERE "suggestion_id" = NEW."id"
jbe@0	1573 ) THEN
jbe@463	1574 RAISE EXCEPTION 'Cannot create a suggestion without an opinion.' USING
jbe@463	1575 ERRCODE = 'integrity_constraint_violation',
jbe@463	1576 HINT = 'Create suggestion and opinion within the same transaction.';
jbe@0	1577 END IF;
jbe@0	1578 RETURN NULL;
jbe@0	1579 END;
jbe@0	1580 $$;
jbe@0	1581
jbe@0	1582 CREATE CONSTRAINT TRIGGER "suggestion_requires_first_opinion"
jbe@0	1583 AFTER INSERT OR UPDATE ON "suggestion" DEFERRABLE INITIALLY DEFERRED
jbe@0	1584 FOR EACH ROW EXECUTE PROCEDURE
jbe@0	1585 "suggestion_requires_first_opinion_trigger"();
jbe@0	1586
jbe@0	1587 COMMENT ON FUNCTION "suggestion_requires_first_opinion_trigger"() IS 'Implementation of trigger "suggestion_requires_first_opinion" on table "suggestion"';
jbe@0	1588 COMMENT ON TRIGGER "suggestion_requires_first_opinion" ON "suggestion" IS 'Ensure that new suggestions have at least one opinion';
jbe@0	1589
jbe@0	1590
jbe@0	1591 CREATE FUNCTION "last_opinion_deletes_suggestion_trigger"()
jbe@0	1592 RETURNS TRIGGER
jbe@0	1593 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1594 DECLARE
jbe@0	1595 "reference_lost" BOOLEAN;
jbe@0	1596 BEGIN
jbe@0	1597 IF TG_OP = 'DELETE' THEN
jbe@0	1598 "reference_lost" := TRUE;
jbe@0	1599 ELSE
jbe@0	1600 "reference_lost" := NEW."suggestion_id" != OLD."suggestion_id";
jbe@0	1601 END IF;
jbe@0	1602 IF
jbe@0	1603 "reference_lost" AND NOT EXISTS (
jbe@0	1604 SELECT NULL FROM "opinion" WHERE "suggestion_id" = OLD."suggestion_id"
jbe@0	1605 )
jbe@0	1606 THEN
jbe@0	1607 DELETE FROM "suggestion" WHERE "id" = OLD."suggestion_id";
jbe@0	1608 END IF;
jbe@0	1609 RETURN NULL;
jbe@0	1610 END;
jbe@0	1611 $$;
jbe@0	1612
jbe@0	1613 CREATE CONSTRAINT TRIGGER "last_opinion_deletes_suggestion"
jbe@0	1614 AFTER UPDATE OR DELETE ON "opinion" DEFERRABLE INITIALLY DEFERRED
jbe@0	1615 FOR EACH ROW EXECUTE PROCEDURE
jbe@0	1616 "last_opinion_deletes_suggestion_trigger"();
jbe@0	1617
jbe@0	1618 COMMENT ON FUNCTION "last_opinion_deletes_suggestion_trigger"() IS 'Implementation of trigger "last_opinion_deletes_suggestion" on table "opinion"';
jbe@0	1619 COMMENT ON TRIGGER "last_opinion_deletes_suggestion" ON "opinion" IS 'Removing the last opinion of a suggestion deletes the suggestion';
jbe@0	1620
jbe@0	1621
jbe@284	1622 CREATE FUNCTION "non_voter_deletes_direct_voter_trigger"()
jbe@284	1623 RETURNS TRIGGER
jbe@284	1624 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@284	1625 BEGIN
jbe@284	1626 DELETE FROM "direct_voter"
jbe@284	1627 WHERE "issue_id" = NEW."issue_id" AND "member_id" = NEW."member_id";
jbe@284	1628 RETURN NULL;
jbe@284	1629 END;
jbe@284	1630 $$;
jbe@284	1631
jbe@284	1632 CREATE TRIGGER "non_voter_deletes_direct_voter"
jbe@284	1633 AFTER INSERT OR UPDATE ON "non_voter"
jbe@284	1634 FOR EACH ROW EXECUTE PROCEDURE
jbe@284	1635 "non_voter_deletes_direct_voter_trigger"();
jbe@284	1636
jbe@284	1637 COMMENT ON FUNCTION "non_voter_deletes_direct_voter_trigger"() IS 'Implementation of trigger "non_voter_deletes_direct_voter" on table "non_voter"';
jbe@284	1638 COMMENT ON TRIGGER "non_voter_deletes_direct_voter" ON "non_voter" IS 'An entry in the "non_voter" table deletes an entry in the "direct_voter" table (and vice versa due to trigger "direct_voter_deletes_non_voter" on table "direct_voter")';
jbe@284	1639
jbe@284	1640
jbe@284	1641 CREATE FUNCTION "direct_voter_deletes_non_voter_trigger"()
jbe@284	1642 RETURNS TRIGGER
jbe@284	1643 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@284	1644 BEGIN
jbe@284	1645 DELETE FROM "non_voter"
jbe@284	1646 WHERE "issue_id" = NEW."issue_id" AND "member_id" = NEW."member_id";
jbe@284	1647 RETURN NULL;
jbe@284	1648 END;
jbe@284	1649 $$;
jbe@284	1650
jbe@284	1651 CREATE TRIGGER "direct_voter_deletes_non_voter"
jbe@284	1652 AFTER INSERT OR UPDATE ON "direct_voter"
jbe@284	1653 FOR EACH ROW EXECUTE PROCEDURE
jbe@284	1654 "direct_voter_deletes_non_voter_trigger"();
jbe@284	1655
jbe@284	1656 COMMENT ON FUNCTION "direct_voter_deletes_non_voter_trigger"() IS 'Implementation of trigger "direct_voter_deletes_non_voter" on table "direct_voter"';
jbe@284	1657 COMMENT ON TRIGGER "direct_voter_deletes_non_voter" ON "direct_voter" IS 'An entry in the "direct_voter" table deletes an entry in the "non_voter" table (and vice versa due to trigger "non_voter_deletes_direct_voter" on table "non_voter")';
jbe@284	1658
jbe@284	1659
jbe@285	1660 CREATE FUNCTION "voter_comment_fields_only_set_when_voter_comment_is_set_trigger"()
jbe@285	1661 RETURNS TRIGGER
jbe@285	1662 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@285	1663 BEGIN
jbe@285	1664 IF NEW."comment" ISNULL THEN
jbe@285	1665 NEW."comment_changed" := NULL;
jbe@285	1666 NEW."formatting_engine" := NULL;
jbe@285	1667 END IF;
jbe@285	1668 RETURN NEW;
jbe@285	1669 END;
jbe@285	1670 $$;
jbe@285	1671
jbe@285	1672 CREATE TRIGGER "voter_comment_fields_only_set_when_voter_comment_is_set"
jbe@285	1673 BEFORE INSERT OR UPDATE ON "direct_voter"
jbe@285	1674 FOR EACH ROW EXECUTE PROCEDURE
jbe@285	1675 "voter_comment_fields_only_set_when_voter_comment_is_set_trigger"();
jbe@285	1676
jbe@285	1677 COMMENT ON FUNCTION "voter_comment_fields_only_set_when_voter_comment_is_set_trigger"() IS 'Implementation of trigger "voter_comment_fields_only_set_when_voter_comment_is_set" ON table "direct_voter"';
jbe@285	1678 COMMENT ON TRIGGER "voter_comment_fields_only_set_when_voter_comment_is_set" ON "direct_voter" IS 'If "comment" is set to NULL, then other comment related fields are also set to NULL.';
jbe@285	1679
jbe@0	1680
jbe@20	1681 ---------------------------------------------------------------
jbe@333	1682 -- Ensure that votes are not modified when issues are closed --
jbe@20	1683 ---------------------------------------------------------------
jbe@20	1684
jbe@20	1685 -- NOTE: Frontends should ensure this anyway, but in case of programming
jbe@20	1686 -- errors the following triggers ensure data integrity.
jbe@20	1687
jbe@20	1688
jbe@20	1689 CREATE FUNCTION "forbid_changes_on_closed_issue_trigger"()
jbe@20	1690 RETURNS TRIGGER
jbe@20	1691 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@20	1692 DECLARE
jbe@336	1693 "issue_id_v" "issue"."id"%TYPE;
jbe@336	1694 "issue_row" "issue"%ROWTYPE;
jbe@20	1695 BEGIN
jbe@383	1696 IF EXISTS (
jbe@385	1697 SELECT NULL FROM "temporary_transaction_data"
jbe@385	1698 WHERE "txid" = txid_current()
jbe@383	1699 AND "key" = 'override_protection_triggers'
jbe@383	1700 AND "value" = TRUE::TEXT
jbe@383	1701 ) THEN
jbe@383	1702 RETURN NULL;
jbe@383	1703 END IF;
jbe@32	1704 IF TG_OP = 'DELETE' THEN
jbe@32	1705 "issue_id_v" := OLD."issue_id";
jbe@32	1706 ELSE
jbe@32	1707 "issue_id_v" := NEW."issue_id";
jbe@32	1708 END IF;
jbe@20	1709 SELECT INTO "issue_row" * FROM "issue"
jbe@32	1710 WHERE "id" = "issue_id_v" FOR SHARE;
jbe@383	1711 IF (
jbe@383	1712 "issue_row"."closed" NOTNULL OR (
jbe@383	1713 "issue_row"."state" = 'voting' AND
jbe@383	1714 "issue_row"."phase_finished" NOTNULL
jbe@383	1715 )
jbe@383	1716 ) THEN
jbe@332	1717 IF
jbe@332	1718 TG_RELID = 'direct_voter'::regclass AND
jbe@332	1719 TG_OP = 'UPDATE'
jbe@332	1720 THEN
jbe@332	1721 IF
jbe@332	1722 OLD."issue_id" = NEW."issue_id" AND
jbe@332	1723 OLD."member_id" = NEW."member_id" AND
jbe@332	1724 OLD."weight" = NEW."weight"
jbe@332	1725 THEN
jbe@332	1726 RETURN NULL; -- allows changing of voter comment
jbe@332	1727 END IF;
jbe@332	1728 END IF;
jbe@463	1729 RAISE EXCEPTION 'Tried to modify data after voting has been closed.' USING
jbe@463	1730 ERRCODE = 'integrity_constraint_violation';
jbe@20	1731 END IF;
jbe@20	1732 RETURN NULL;
jbe@20	1733 END;
jbe@20	1734 $$;
jbe@20	1735
jbe@20	1736 CREATE TRIGGER "forbid_changes_on_closed_issue"
jbe@20	1737 AFTER INSERT OR UPDATE OR DELETE ON "direct_voter"
jbe@20	1738 FOR EACH ROW EXECUTE PROCEDURE
jbe@20	1739 "forbid_changes_on_closed_issue_trigger"();
jbe@20	1740
jbe@20	1741 CREATE TRIGGER "forbid_changes_on_closed_issue"
jbe@20	1742 AFTER INSERT OR UPDATE OR DELETE ON "delegating_voter"
jbe@20	1743 FOR EACH ROW EXECUTE PROCEDURE
jbe@20	1744 "forbid_changes_on_closed_issue_trigger"();
jbe@20	1745
jbe@20	1746 CREATE TRIGGER "forbid_changes_on_closed_issue"
jbe@20	1747 AFTER INSERT OR UPDATE OR DELETE ON "vote"
jbe@20	1748 FOR EACH ROW EXECUTE PROCEDURE
jbe@20	1749 "forbid_changes_on_closed_issue_trigger"();
jbe@20	1750
jbe@20	1751 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"';
jbe@20	1752 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';
jbe@20	1753 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';
jbe@20	1754 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';
jbe@20	1755
jbe@20	1756
jbe@20	1757
jbe@0	1758 --------------------------------------------------------------------
jbe@0	1759 -- Auto-retrieval of fields only needed for referential integrity --
jbe@0	1760 --------------------------------------------------------------------
jbe@0	1761
jbe@20	1762
jbe@0	1763 CREATE FUNCTION "autofill_issue_id_trigger"()
jbe@0	1764 RETURNS TRIGGER
jbe@0	1765 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1766 BEGIN
jbe@0	1767 IF NEW."issue_id" ISNULL THEN
jbe@0	1768 SELECT "issue_id" INTO NEW."issue_id"
jbe@0	1769 FROM "initiative" WHERE "id" = NEW."initiative_id";
jbe@0	1770 END IF;
jbe@0	1771 RETURN NEW;
jbe@0	1772 END;
jbe@0	1773 $$;
jbe@0	1774
jbe@0	1775 CREATE TRIGGER "autofill_issue_id" BEFORE INSERT ON "supporter"
jbe@0	1776 FOR EACH ROW EXECUTE PROCEDURE "autofill_issue_id_trigger"();
jbe@0	1777
jbe@0	1778 CREATE TRIGGER "autofill_issue_id" BEFORE INSERT ON "vote"
jbe@0	1779 FOR EACH ROW EXECUTE PROCEDURE "autofill_issue_id_trigger"();
jbe@0	1780
jbe@0	1781 COMMENT ON FUNCTION "autofill_issue_id_trigger"() IS 'Implementation of triggers "autofill_issue_id" on tables "supporter" and "vote"';
jbe@0	1782 COMMENT ON TRIGGER "autofill_issue_id" ON "supporter" IS 'Set "issue_id" field automatically, if NULL';
jbe@0	1783 COMMENT ON TRIGGER "autofill_issue_id" ON "vote" IS 'Set "issue_id" field automatically, if NULL';
jbe@0	1784
jbe@0	1785
jbe@0	1786 CREATE FUNCTION "autofill_initiative_id_trigger"()
jbe@0	1787 RETURNS TRIGGER
jbe@0	1788 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1789 BEGIN
jbe@0	1790 IF NEW."initiative_id" ISNULL THEN
jbe@0	1791 SELECT "initiative_id" INTO NEW."initiative_id"
jbe@0	1792 FROM "suggestion" WHERE "id" = NEW."suggestion_id";
jbe@0	1793 END IF;
jbe@0	1794 RETURN NEW;
jbe@0	1795 END;
jbe@0	1796 $$;
jbe@0	1797
jbe@0	1798 CREATE TRIGGER "autofill_initiative_id" BEFORE INSERT ON "opinion"
jbe@0	1799 FOR EACH ROW EXECUTE PROCEDURE "autofill_initiative_id_trigger"();
jbe@0	1800
jbe@0	1801 COMMENT ON FUNCTION "autofill_initiative_id_trigger"() IS 'Implementation of trigger "autofill_initiative_id" on table "opinion"';
jbe@0	1802 COMMENT ON TRIGGER "autofill_initiative_id" ON "opinion" IS 'Set "initiative_id" field automatically, if NULL';
jbe@0	1803
jbe@0	1804
jbe@0	1805
jbe@4	1806 -----------------------------------------------------
jbe@4	1807 -- Automatic calculation of certain default values --
jbe@4	1808 -----------------------------------------------------
jbe@0	1809
jbe@22	1810
jbe@22	1811 CREATE FUNCTION "copy_timings_trigger"()
jbe@22	1812 RETURNS TRIGGER
jbe@22	1813 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@22	1814 DECLARE
jbe@22	1815 "policy_row" "policy"%ROWTYPE;
jbe@22	1816 BEGIN
jbe@22	1817 SELECT * INTO "policy_row" FROM "policy"
jbe@22	1818 WHERE "id" = NEW."policy_id";
jbe@447	1819 IF NEW."min_admission_time" ISNULL THEN
jbe@447	1820 NEW."min_admission_time" := "policy_row"."min_admission_time";
jbe@447	1821 END IF;
jbe@447	1822 IF NEW."max_admission_time" ISNULL THEN
jbe@447	1823 NEW."max_admission_time" := "policy_row"."max_admission_time";
jbe@22	1824 END IF;
jbe@22	1825 IF NEW."discussion_time" ISNULL THEN
jbe@22	1826 NEW."discussion_time" := "policy_row"."discussion_time";
jbe@22	1827 END IF;
jbe@22	1828 IF NEW."verification_time" ISNULL THEN
jbe@22	1829 NEW."verification_time" := "policy_row"."verification_time";
jbe@22	1830 END IF;
jbe@22	1831 IF NEW."voting_time" ISNULL THEN
jbe@22	1832 NEW."voting_time" := "policy_row"."voting_time";
jbe@22	1833 END IF;
jbe@22	1834 RETURN NEW;
jbe@22	1835 END;
jbe@22	1836 $$;
jbe@22	1837
jbe@22	1838 CREATE TRIGGER "copy_timings" BEFORE INSERT OR UPDATE ON "issue"
jbe@22	1839 FOR EACH ROW EXECUTE PROCEDURE "copy_timings_trigger"();
jbe@22	1840
jbe@22	1841 COMMENT ON FUNCTION "copy_timings_trigger"() IS 'Implementation of trigger "copy_timings" on table "issue"';
jbe@22	1842 COMMENT ON TRIGGER "copy_timings" ON "issue" IS 'If timing fields are NULL, copy values from policy.';
jbe@22	1843
jbe@22	1844
jbe@160	1845 CREATE FUNCTION "default_for_draft_id_trigger"()
jbe@2	1846 RETURNS TRIGGER
jbe@2	1847 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@2	1848 BEGIN
jbe@2	1849 IF NEW."draft_id" ISNULL THEN
jbe@2	1850 SELECT "id" INTO NEW."draft_id" FROM "current_draft"
jbe@2	1851 WHERE "initiative_id" = NEW."initiative_id";
jbe@2	1852 END IF;
jbe@2	1853 RETURN NEW;
jbe@2	1854 END;
jbe@2	1855 $$;
jbe@2	1856
jbe@160	1857 CREATE TRIGGER "default_for_draft_id" BEFORE INSERT OR UPDATE ON "suggestion"
jbe@160	1858 FOR EACH ROW EXECUTE PROCEDURE "default_for_draft_id_trigger"();
jbe@2	1859 CREATE TRIGGER "default_for_draft_id" BEFORE INSERT OR UPDATE ON "supporter"
jbe@160	1860 FOR EACH ROW EXECUTE PROCEDURE "default_for_draft_id_trigger"();
jbe@160	1861
jbe@160	1862 COMMENT ON FUNCTION "default_for_draft_id_trigger"() IS 'Implementation of trigger "default_for_draft" on tables "supporter" and "suggestion"';
jbe@160	1863 COMMENT ON TRIGGER "default_for_draft_id" ON "suggestion" IS 'If "draft_id" is NULL, then use the current draft of the initiative as default';
jbe@160	1864 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';
jbe@2	1865
jbe@2	1866
jbe@0	1867
jbe@0	1868 ----------------------------------------
jbe@0	1869 -- Automatic creation of dependencies --
jbe@0	1870 ----------------------------------------
jbe@0	1871
jbe@22	1872
jbe@0	1873 CREATE FUNCTION "autocreate_interest_trigger"()
jbe@0	1874 RETURNS TRIGGER
jbe@0	1875 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1876 BEGIN
jbe@0	1877 IF NOT EXISTS (
jbe@0	1878 SELECT NULL FROM "initiative" JOIN "interest"
jbe@0	1879 ON "initiative"."issue_id" = "interest"."issue_id"
jbe@0	1880 WHERE "initiative"."id" = NEW."initiative_id"
jbe@0	1881 AND "interest"."member_id" = NEW."member_id"
jbe@0	1882 ) THEN
jbe@0	1883 BEGIN
jbe@0	1884 INSERT INTO "interest" ("issue_id", "member_id")
jbe@0	1885 SELECT "issue_id", NEW."member_id"
jbe@0	1886 FROM "initiative" WHERE "id" = NEW."initiative_id";
jbe@0	1887 EXCEPTION WHEN unique_violation THEN END;
jbe@0	1888 END IF;
jbe@0	1889 RETURN NEW;
jbe@0	1890 END;
jbe@0	1891 $$;
jbe@0	1892
jbe@0	1893 CREATE TRIGGER "autocreate_interest" BEFORE INSERT ON "supporter"
jbe@0	1894 FOR EACH ROW EXECUTE PROCEDURE "autocreate_interest_trigger"();
jbe@0	1895
jbe@0	1896 COMMENT ON FUNCTION "autocreate_interest_trigger"() IS 'Implementation of trigger "autocreate_interest" on table "supporter"';
jbe@0	1897 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';
jbe@0	1898
jbe@0	1899
jbe@0	1900 CREATE FUNCTION "autocreate_supporter_trigger"()
jbe@0	1901 RETURNS TRIGGER
jbe@0	1902 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	1903 BEGIN
jbe@0	1904 IF NOT EXISTS (
jbe@0	1905 SELECT NULL FROM "suggestion" JOIN "supporter"
jbe@0	1906 ON "suggestion"."initiative_id" = "supporter"."initiative_id"
jbe@0	1907 WHERE "suggestion"."id" = NEW."suggestion_id"
jbe@0	1908 AND "supporter"."member_id" = NEW."member_id"
jbe@0	1909 ) THEN
jbe@0	1910 BEGIN
jbe@0	1911 INSERT INTO "supporter" ("initiative_id", "member_id")
jbe@0	1912 SELECT "initiative_id", NEW."member_id"
jbe@0	1913 FROM "suggestion" WHERE "id" = NEW."suggestion_id";
jbe@0	1914 EXCEPTION WHEN unique_violation THEN END;
jbe@0	1915 END IF;
jbe@0	1916 RETURN NEW;
jbe@0	1917 END;
jbe@0	1918 $$;
jbe@0	1919
jbe@0	1920 CREATE TRIGGER "autocreate_supporter" BEFORE INSERT ON "opinion"
jbe@0	1921 FOR EACH ROW EXECUTE PROCEDURE "autocreate_supporter_trigger"();
jbe@0	1922
jbe@0	1923 COMMENT ON FUNCTION "autocreate_supporter_trigger"() IS 'Implementation of trigger "autocreate_supporter" on table "opinion"';
jbe@0	1924 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.';
jbe@0	1925
jbe@0	1926
jbe@0	1927
jbe@0	1928 ------------------------------------------
jbe@0	1929 -- Views and helper functions for views --
jbe@0	1930 ------------------------------------------
jbe@0	1931
jbe@5	1932
jbe@97	1933 CREATE VIEW "unit_delegation" AS
jbe@97	1934 SELECT
jbe@97	1935 "unit"."id" AS "unit_id",
jbe@97	1936 "delegation"."id",
jbe@97	1937 "delegation"."truster_id",
jbe@97	1938 "delegation"."trustee_id",
jbe@97	1939 "delegation"."scope"
jbe@97	1940 FROM "unit"
jbe@97	1941 JOIN "delegation"
jbe@97	1942 ON "delegation"."unit_id" = "unit"."id"
jbe@97	1943 JOIN "member"
jbe@97	1944 ON "delegation"."truster_id" = "member"."id"
jbe@97	1945 JOIN "privilege"
jbe@97	1946 ON "delegation"."unit_id" = "privilege"."unit_id"
jbe@97	1947 AND "delegation"."truster_id" = "privilege"."member_id"
jbe@97	1948 WHERE "member"."active" AND "privilege"."voting_right";
jbe@97	1949
jbe@97	1950 COMMENT ON VIEW "unit_delegation" IS 'Unit delegations where trusters are active and have voting right';
jbe@5	1951
jbe@5	1952
jbe@5	1953 CREATE VIEW "area_delegation" AS
jbe@70	1954 SELECT DISTINCT ON ("area"."id", "delegation"."truster_id")
jbe@70	1955 "area"."id" AS "area_id",
jbe@70	1956 "delegation"."id",
jbe@70	1957 "delegation"."truster_id",
jbe@70	1958 "delegation"."trustee_id",
jbe@70	1959 "delegation"."scope"
jbe@97	1960 FROM "area"
jbe@97	1961 JOIN "delegation"
jbe@97	1962 ON "delegation"."unit_id" = "area"."unit_id"
jbe@97	1963 OR "delegation"."area_id" = "area"."id"
jbe@97	1964 JOIN "member"
jbe@97	1965 ON "delegation"."truster_id" = "member"."id"
jbe@97	1966 JOIN "privilege"
jbe@97	1967 ON "area"."unit_id" = "privilege"."unit_id"
jbe@97	1968 AND "delegation"."truster_id" = "privilege"."member_id"
jbe@97	1969 WHERE "member"."active" AND "privilege"."voting_right"
jbe@70	1970 ORDER BY
jbe@70	1971 "area"."id",
jbe@70	1972 "delegation"."truster_id",
jbe@70	1973 "delegation"."scope" DESC;
jbe@70	1974
jbe@97	1975 COMMENT ON VIEW "area_delegation" IS 'Area delegations where trusters are active and have voting right';
jbe@5	1976
jbe@5	1977
jbe@5	1978 CREATE VIEW "issue_delegation" AS
jbe@70	1979 SELECT DISTINCT ON ("issue"."id", "delegation"."truster_id")
jbe@70	1980 "issue"."id" AS "issue_id",
jbe@70	1981 "delegation"."id",
jbe@70	1982 "delegation"."truster_id",
jbe@70	1983 "delegation"."trustee_id",
jbe@70	1984 "delegation"."scope"
jbe@97	1985 FROM "issue"
jbe@97	1986 JOIN "area"
jbe@97	1987 ON "area"."id" = "issue"."area_id"
jbe@97	1988 JOIN "delegation"
jbe@97	1989 ON "delegation"."unit_id" = "area"."unit_id"
jbe@97	1990 OR "delegation"."area_id" = "area"."id"
jbe@97	1991 OR "delegation"."issue_id" = "issue"."id"
jbe@97	1992 JOIN "member"
jbe@97	1993 ON "delegation"."truster_id" = "member"."id"
jbe@97	1994 JOIN "privilege"
jbe@97	1995 ON "area"."unit_id" = "privilege"."unit_id"
jbe@97	1996 AND "delegation"."truster_id" = "privilege"."member_id"
jbe@97	1997 WHERE "member"."active" AND "privilege"."voting_right"
jbe@70	1998 ORDER BY
jbe@70	1999 "issue"."id",
jbe@70	2000 "delegation"."truster_id",
jbe@70	2001 "delegation"."scope" DESC;
jbe@70	2002
jbe@97	2003 COMMENT ON VIEW "issue_delegation" IS 'Issue delegations where trusters are active and have voting right';
jbe@5	2004
jbe@5	2005
jbe@5	2006 CREATE FUNCTION "membership_weight_with_skipping"
jbe@5	2007 ( "area_id_p" "area"."id"%TYPE,
jbe@5	2008 "member_id_p" "member"."id"%TYPE,
jbe@5	2009 "skip_member_ids_p" INT4[] ) -- "member"."id"%TYPE[]
jbe@5	2010 RETURNS INT4
jbe@5	2011 LANGUAGE 'plpgsql' STABLE AS $$
jbe@5	2012 DECLARE
jbe@5	2013 "sum_v" INT4;
jbe@5	2014 "delegation_row" "area_delegation"%ROWTYPE;
jbe@5	2015 BEGIN
jbe@5	2016 "sum_v" := 1;
jbe@5	2017 FOR "delegation_row" IN
jbe@5	2018 SELECT "area_delegation".*
jbe@5	2019 FROM "area_delegation" LEFT JOIN "membership"
jbe@5	2020 ON "membership"."area_id" = "area_id_p"
jbe@5	2021 AND "membership"."member_id" = "area_delegation"."truster_id"
jbe@5	2022 WHERE "area_delegation"."area_id" = "area_id_p"
jbe@5	2023 AND "area_delegation"."trustee_id" = "member_id_p"
jbe@5	2024 AND "membership"."member_id" ISNULL
jbe@5	2025 LOOP
jbe@5	2026 IF NOT
jbe@5	2027 "skip_member_ids_p" @> ARRAY["delegation_row"."truster_id"]
jbe@5	2028 THEN
jbe@5	2029 "sum_v" := "sum_v" + "membership_weight_with_skipping"(
jbe@5	2030 "area_id_p",
jbe@5	2031 "delegation_row"."truster_id",
jbe@5	2032 "skip_member_ids_p" \|\| "delegation_row"."truster_id"
jbe@5	2033 );
jbe@5	2034 END IF;
jbe@5	2035 END LOOP;
jbe@5	2036 RETURN "sum_v";
jbe@5	2037 END;
jbe@5	2038 $$;
jbe@5	2039
jbe@8	2040 COMMENT ON FUNCTION "membership_weight_with_skipping"
jbe@8	2041 ( "area"."id"%TYPE,
jbe@8	2042 "member"."id"%TYPE,
jbe@8	2043 INT4[] )
jbe@8	2044 IS 'Helper function for "membership_weight" function';
jbe@8	2045
jbe@8	2046
jbe@5	2047 CREATE FUNCTION "membership_weight"
jbe@5	2048 ( "area_id_p" "area"."id"%TYPE,
jbe@5	2049 "member_id_p" "member"."id"%TYPE ) -- "member"."id"%TYPE[]
jbe@5	2050 RETURNS INT4
jbe@5	2051 LANGUAGE 'plpgsql' STABLE AS $$
jbe@5	2052 BEGIN
jbe@5	2053 RETURN "membership_weight_with_skipping"(
jbe@5	2054 "area_id_p",
jbe@5	2055 "member_id_p",
jbe@5	2056 ARRAY["member_id_p"]
jbe@5	2057 );
jbe@5	2058 END;
jbe@5	2059 $$;
jbe@5	2060
jbe@8	2061 COMMENT ON FUNCTION "membership_weight"
jbe@8	2062 ( "area"."id"%TYPE,
jbe@8	2063 "member"."id"%TYPE )
jbe@8	2064 IS 'Calculates the potential voting weight of a member in a given area';
jbe@8	2065
jbe@5	2066
jbe@4	2067 CREATE VIEW "member_count_view" AS
jbe@5	2068 SELECT count(1) AS "total_count" FROM "member" WHERE "active";
jbe@4	2069
jbe@4	2070 COMMENT ON VIEW "member_count_view" IS 'View used to update "member_count" table';
jbe@4	2071
jbe@4	2072
jbe@97	2073 CREATE VIEW "unit_member_count" AS
jbe@97	2074 SELECT
jbe@97	2075 "unit"."id" AS "unit_id",
jbe@248	2076 count("member"."id") AS "member_count"
jbe@97	2077 FROM "unit"
jbe@97	2078 LEFT JOIN "privilege"
jbe@97	2079 ON "privilege"."unit_id" = "unit"."id"
jbe@97	2080 AND "privilege"."voting_right"
jbe@97	2081 LEFT JOIN "member"
jbe@97	2082 ON "member"."id" = "privilege"."member_id"
jbe@97	2083 AND "member"."active"
jbe@97	2084 GROUP BY "unit"."id";
jbe@97	2085
jbe@97	2086 COMMENT ON VIEW "unit_member_count" IS 'View used to update "member_count" column of "unit" table';
jbe@97	2087
jbe@97	2088
jbe@4	2089 CREATE VIEW "area_member_count" AS
jbe@5	2090 SELECT
jbe@5	2091 "area"."id" AS "area_id",
jbe@5	2092 count("member"."id") AS "direct_member_count",
jbe@5	2093 coalesce(
jbe@5	2094 sum(
jbe@5	2095 CASE WHEN "member"."id" NOTNULL THEN
jbe@5	2096 "membership_weight"("area"."id", "member"."id")
jbe@5	2097 ELSE 0 END
jbe@5	2098 )
jbe@169	2099 ) AS "member_weight"
jbe@4	2100 FROM "area"
jbe@4	2101 LEFT JOIN "membership"
jbe@4	2102 ON "area"."id" = "membership"."area_id"
jbe@97	2103 LEFT JOIN "privilege"
jbe@97	2104 ON "privilege"."unit_id" = "area"."unit_id"
jbe@97	2105 AND "privilege"."member_id" = "membership"."member_id"
jbe@97	2106 AND "privilege"."voting_right"
jbe@4	2107 LEFT JOIN "member"
jbe@97	2108 ON "member"."id" = "privilege"."member_id" -- NOTE: no membership here!
jbe@4	2109 AND "member"."active"
jbe@4	2110 GROUP BY "area"."id";
jbe@4	2111
jbe@169	2112 COMMENT ON VIEW "area_member_count" IS 'View used to update "direct_member_count" and "member_weight" columns of table "area"';
jbe@4	2113
jbe@4	2114
jbe@9	2115 CREATE VIEW "opening_draft" AS
jbe@9	2116 SELECT "draft".* FROM (
jbe@9	2117 SELECT
jbe@9	2118 "initiative"."id" AS "initiative_id",
jbe@9	2119 min("draft"."id") AS "draft_id"
jbe@9	2120 FROM "initiative" JOIN "draft"
jbe@9	2121 ON "initiative"."id" = "draft"."initiative_id"
jbe@9	2122 GROUP BY "initiative"."id"
jbe@9	2123 ) AS "subquery"
jbe@9	2124 JOIN "draft" ON "subquery"."draft_id" = "draft"."id";
jbe@9	2125
jbe@9	2126 COMMENT ON VIEW "opening_draft" IS 'First drafts of all initiatives';
jbe@9	2127
jbe@9	2128
jbe@0	2129 CREATE VIEW "current_draft" AS
jbe@0	2130 SELECT "draft".* FROM (
jbe@0	2131 SELECT
jbe@0	2132 "initiative"."id" AS "initiative_id",
jbe@0	2133 max("draft"."id") AS "draft_id"
jbe@0	2134 FROM "initiative" JOIN "draft"
jbe@0	2135 ON "initiative"."id" = "draft"."initiative_id"
jbe@0	2136 GROUP BY "initiative"."id"
jbe@0	2137 ) AS "subquery"
jbe@0	2138 JOIN "draft" ON "subquery"."draft_id" = "draft"."id";
jbe@0	2139
jbe@0	2140 COMMENT ON VIEW "current_draft" IS 'All latest drafts for each initiative';
jbe@0	2141
jbe@0	2142
jbe@0	2143 CREATE VIEW "critical_opinion" AS
jbe@0	2144 SELECT * FROM "opinion"
jbe@0	2145 WHERE ("degree" = 2 AND "fulfilled" = FALSE)
jbe@0	2146 OR ("degree" = -2 AND "fulfilled" = TRUE);
jbe@0	2147
jbe@0	2148 COMMENT ON VIEW "critical_opinion" IS 'Opinions currently causing dissatisfaction';
jbe@0	2149
jbe@0	2150
jbe@392	2151 CREATE VIEW "issue_supporter_in_admission_state" AS
jbe@466	2152 SELECT DISTINCT -- TODO: DISTINCT needed?
jbe@410	2153 "area"."unit_id",
jbe@392	2154 "issue"."area_id",
jbe@392	2155 "issue"."id" AS "issue_id",
jbe@392	2156 "supporter"."member_id",
jbe@392	2157 "direct_interest_snapshot"."weight"
jbe@392	2158 FROM "issue"
jbe@410	2159 JOIN "area" ON "area"."id" = "issue"."area_id"
jbe@392	2160 JOIN "supporter" ON "supporter"."issue_id" = "issue"."id"
jbe@392	2161 JOIN "direct_interest_snapshot"
jbe@392	2162 ON "direct_interest_snapshot"."issue_id" = "issue"."id"
jbe@392	2163 AND "direct_interest_snapshot"."event" = "issue"."latest_snapshot_event"
jbe@392	2164 AND "direct_interest_snapshot"."member_id" = "supporter"."member_id"
jbe@392	2165 WHERE "issue"."state" = 'admission'::"issue_state";
jbe@392	2166
jbe@392	2167 COMMENT ON VIEW "issue_supporter_in_admission_state" IS 'Helper view for "lf_update_issue_order" to allow a (proportional) ordering of issues within an area';
jbe@392	2168
jbe@392	2169
jbe@352	2170 CREATE VIEW "initiative_suggestion_order_calculation" AS
jbe@352	2171 SELECT
jbe@352	2172 "initiative"."id" AS "initiative_id",
jbe@352	2173 ("issue"."closed" NOTNULL OR "issue"."fully_frozen" NOTNULL) AS "final"
jbe@352	2174 FROM "initiative" JOIN "issue"
jbe@352	2175 ON "initiative"."issue_id" = "issue"."id"
jbe@352	2176 WHERE ("issue"."closed" ISNULL AND "issue"."fully_frozen" ISNULL)
jbe@352	2177 OR ("initiative"."final_suggestion_order_calculated" = FALSE);
jbe@352	2178
jbe@352	2179 COMMENT ON VIEW "initiative_suggestion_order_calculation" IS 'Initiatives, where the "proportional_order" of its suggestions has to be calculated';
jbe@352	2180
jbe@360	2181 COMMENT ON COLUMN "initiative_suggestion_order_calculation"."final" IS 'Set to TRUE, if the issue is fully frozen or closed, and the calculation has to be done only once for one last time';
jbe@352	2182
jbe@352	2183
jbe@352	2184 CREATE VIEW "individual_suggestion_ranking" AS
jbe@352	2185 SELECT
jbe@352	2186 "opinion"."initiative_id",
jbe@352	2187 "opinion"."member_id",
jbe@352	2188 "direct_interest_snapshot"."weight",
jbe@352	2189 CASE WHEN
jbe@352	2190 ("opinion"."degree" = 2 AND "opinion"."fulfilled" = FALSE) OR
jbe@352	2191 ("opinion"."degree" = -2 AND "opinion"."fulfilled" = TRUE)
jbe@352	2192 THEN 1 ELSE
jbe@352	2193 CASE WHEN
jbe@352	2194 ("opinion"."degree" = 1 AND "opinion"."fulfilled" = FALSE) OR
jbe@352	2195 ("opinion"."degree" = -1 AND "opinion"."fulfilled" = TRUE)
jbe@352	2196 THEN 2 ELSE
jbe@352	2197 CASE WHEN
jbe@352	2198 ("opinion"."degree" = 2 AND "opinion"."fulfilled" = TRUE) OR
jbe@352	2199 ("opinion"."degree" = -2 AND "opinion"."fulfilled" = FALSE)
jbe@352	2200 THEN 3 ELSE 4 END
jbe@352	2201 END
jbe@352	2202 END AS "preference",
jbe@352	2203 "opinion"."suggestion_id"
jbe@352	2204 FROM "opinion"
jbe@352	2205 JOIN "initiative" ON "initiative"."id" = "opinion"."initiative_id"
jbe@352	2206 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
jbe@352	2207 JOIN "direct_interest_snapshot"
jbe@352	2208 ON "direct_interest_snapshot"."issue_id" = "issue"."id"
jbe@352	2209 AND "direct_interest_snapshot"."event" = "issue"."latest_snapshot_event"
jbe@352	2210 AND "direct_interest_snapshot"."member_id" = "opinion"."member_id";
jbe@352	2211
jbe@352	2212 COMMENT ON VIEW "individual_suggestion_ranking" IS 'Helper view for "lf_update_suggestion_order" to allow a proportional ordering of suggestions within an initiative';
jbe@352	2213
jbe@352	2214
jbe@126	2215 CREATE VIEW "battle_participant" AS
jbe@126	2216 SELECT "initiative"."id", "initiative"."issue_id"
jbe@126	2217 FROM "issue" JOIN "initiative"
jbe@126	2218 ON "issue"."id" = "initiative"."issue_id"
jbe@126	2219 WHERE "initiative"."admitted"
jbe@126	2220 UNION ALL
jbe@126	2221 SELECT NULL, "id" AS "issue_id"
jbe@126	2222 FROM "issue";
jbe@126	2223
jbe@126	2224 COMMENT ON VIEW "battle_participant" IS 'Helper view for "battle_view" containing admitted initiatives plus virtual "status-quo" initiative denoted by NULL reference';
jbe@126	2225
jbe@126	2226
jbe@61	2227 CREATE VIEW "battle_view" AS
jbe@0	2228 SELECT
jbe@0	2229 "issue"."id" AS "issue_id",
jbe@10	2230 "winning_initiative"."id" AS "winning_initiative_id",
jbe@10	2231 "losing_initiative"."id" AS "losing_initiative_id",
jbe@0	2232 sum(
jbe@0	2233 CASE WHEN
jbe@0	2234 coalesce("better_vote"."grade", 0) >
jbe@0	2235 coalesce("worse_vote"."grade", 0)
jbe@0	2236 THEN "direct_voter"."weight" ELSE 0 END
jbe@0	2237 ) AS "count"
jbe@0	2238 FROM "issue"
jbe@0	2239 LEFT JOIN "direct_voter"
jbe@0	2240 ON "issue"."id" = "direct_voter"."issue_id"
jbe@126	2241 JOIN "battle_participant" AS "winning_initiative"
jbe@10	2242 ON "issue"."id" = "winning_initiative"."issue_id"
jbe@126	2243 JOIN "battle_participant" AS "losing_initiative"
jbe@10	2244 ON "issue"."id" = "losing_initiative"."issue_id"
jbe@0	2245 LEFT JOIN "vote" AS "better_vote"
jbe@10	2246 ON "direct_voter"."member_id" = "better_vote"."member_id"
jbe@10	2247 AND "winning_initiative"."id" = "better_vote"."initiative_id"
jbe@0	2248 LEFT JOIN "vote" AS "worse_vote"
jbe@10	2249 ON "direct_voter"."member_id" = "worse_vote"."member_id"
jbe@10	2250 AND "losing_initiative"."id" = "worse_vote"."initiative_id"
jbe@328	2251 WHERE "issue"."state" = 'voting'
jbe@328	2252 AND "issue"."phase_finished" NOTNULL
jbe@126	2253 AND (
jbe@126	2254 "winning_initiative"."id" != "losing_initiative"."id" OR
jbe@126	2255 ( ("winning_initiative"."id" NOTNULL AND "losing_initiative"."id" ISNULL) OR
jbe@126	2256 ("winning_initiative"."id" ISNULL AND "losing_initiative"."id" NOTNULL) ) )
jbe@0	2257 GROUP BY
jbe@0	2258 "issue"."id",
jbe@10	2259 "winning_initiative"."id",
jbe@10	2260 "losing_initiative"."id";
jbe@0	2261
jbe@126	2262 COMMENT ON VIEW "battle_view" IS 'Number of members preferring one initiative (or status-quo) to another initiative (or status-quo); Used to fill "battle" table';
jbe@1	2263
jbe@1	2264
jbe@235	2265 CREATE VIEW "expired_session" AS
jbe@235	2266 SELECT * FROM "session" WHERE now() > "expiry";
jbe@235	2267
jbe@235	2268 CREATE RULE "delete" AS ON DELETE TO "expired_session" DO INSTEAD
jbe@235	2269 DELETE FROM "session" WHERE "ident" = OLD."ident";
jbe@235	2270
jbe@235	2271 COMMENT ON VIEW "expired_session" IS 'View containing all expired sessions where DELETE is possible';
jbe@235	2272 COMMENT ON RULE "delete" ON "expired_session" IS 'Rule allowing DELETE on rows in "expired_session" view, i.e. DELETE FROM "expired_session"';
jbe@235	2273
jbe@235	2274
jbe@0	2275 CREATE VIEW "open_issue" AS
jbe@0	2276 SELECT * FROM "issue" WHERE "closed" ISNULL;
jbe@0	2277
jbe@0	2278 COMMENT ON VIEW "open_issue" IS 'All open issues';
jbe@0	2279
jbe@0	2280
jbe@9	2281 CREATE VIEW "member_contingent" AS
jbe@9	2282 SELECT
jbe@9	2283 "member"."id" AS "member_id",
jbe@293	2284 "contingent"."polling",
jbe@9	2285 "contingent"."time_frame",
jbe@9	2286 CASE WHEN "contingent"."text_entry_limit" NOTNULL THEN
jbe@9	2287 (
jbe@9	2288 SELECT count(1) FROM "draft"
jbe@293	2289 JOIN "initiative" ON "initiative"."id" = "draft"."initiative_id"
jbe@9	2290 WHERE "draft"."author_id" = "member"."id"
jbe@293	2291 AND "initiative"."polling" = "contingent"."polling"
jbe@9	2292 AND "draft"."created" > now() - "contingent"."time_frame"
jbe@9	2293 ) + (
jbe@9	2294 SELECT count(1) FROM "suggestion"
jbe@293	2295 JOIN "initiative" ON "initiative"."id" = "suggestion"."initiative_id"
jbe@9	2296 WHERE "suggestion"."author_id" = "member"."id"
jbe@293	2297 AND "contingent"."polling" = FALSE
jbe@9	2298 AND "suggestion"."created" > now() - "contingent"."time_frame"
jbe@9	2299 )
jbe@9	2300 ELSE NULL END AS "text_entry_count",
jbe@9	2301 "contingent"."text_entry_limit",
jbe@9	2302 CASE WHEN "contingent"."initiative_limit" NOTNULL THEN (
jbe@293	2303 SELECT count(1) FROM "opening_draft" AS "draft"
jbe@293	2304 JOIN "initiative" ON "initiative"."id" = "draft"."initiative_id"
jbe@293	2305 WHERE "draft"."author_id" = "member"."id"
jbe@293	2306 AND "initiative"."polling" = "contingent"."polling"
jbe@293	2307 AND "draft"."created" > now() - "contingent"."time_frame"
jbe@9	2308 ) ELSE NULL END AS "initiative_count",
jbe@9	2309 "contingent"."initiative_limit"
jbe@9	2310 FROM "member" CROSS JOIN "contingent";
jbe@9	2311
jbe@9	2312 COMMENT ON VIEW "member_contingent" IS 'Actual counts of text entries and initiatives are calculated per member for each limit in the "contingent" table.';
jbe@9	2313
jbe@9	2314 COMMENT ON COLUMN "member_contingent"."text_entry_count" IS 'Only calculated when "text_entry_limit" is not null in the same row';
jbe@9	2315 COMMENT ON COLUMN "member_contingent"."initiative_count" IS 'Only calculated when "initiative_limit" is not null in the same row';
jbe@9	2316
jbe@9	2317
jbe@9	2318 CREATE VIEW "member_contingent_left" AS
jbe@9	2319 SELECT
jbe@9	2320 "member_id",
jbe@293	2321 "polling",
jbe@9	2322 max("text_entry_limit" - "text_entry_count") AS "text_entries_left",
jbe@9	2323 max("initiative_limit" - "initiative_count") AS "initiatives_left"
jbe@293	2324 FROM "member_contingent" GROUP BY "member_id", "polling";
jbe@9	2325
jbe@9	2326 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.';
jbe@9	2327
jbe@9	2328
jbe@113	2329 CREATE VIEW "event_seen_by_member" AS
jbe@113	2330 SELECT
jbe@113	2331 "member"."id" AS "seen_by_member_id",
jbe@113	2332 CASE WHEN "event"."state" IN (
jbe@113	2333 'voting',
jbe@113	2334 'finished_without_winner',
jbe@113	2335 'finished_with_winner'
jbe@113	2336 ) THEN
jbe@113	2337 'voting'::"notify_level"
jbe@113	2338 ELSE
jbe@113	2339 CASE WHEN "event"."state" IN (
jbe@113	2340 'verification',
jbe@113	2341 'canceled_after_revocation_during_verification',
jbe@113	2342 'canceled_no_initiative_admitted'
jbe@113	2343 ) THEN
jbe@113	2344 'verification'::"notify_level"
jbe@113	2345 ELSE
jbe@113	2346 CASE WHEN "event"."state" IN (
jbe@113	2347 'discussion',
jbe@113	2348 'canceled_after_revocation_during_discussion'
jbe@113	2349 ) THEN
jbe@113	2350 'discussion'::"notify_level"
jbe@113	2351 ELSE
jbe@113	2352 'all'::"notify_level"
jbe@113	2353 END
jbe@113	2354 END
jbe@113	2355 END AS "notify_level",
jbe@113	2356 "event".*
jbe@113	2357 FROM "member" CROSS JOIN "event"
jbe@113	2358 LEFT JOIN "issue"
jbe@113	2359 ON "event"."issue_id" = "issue"."id"
jbe@113	2360 LEFT JOIN "membership"
jbe@113	2361 ON "member"."id" = "membership"."member_id"
jbe@113	2362 AND "issue"."area_id" = "membership"."area_id"
jbe@113	2363 LEFT JOIN "interest"
jbe@113	2364 ON "member"."id" = "interest"."member_id"
jbe@113	2365 AND "event"."issue_id" = "interest"."issue_id"
jbe@113	2366 LEFT JOIN "ignored_member"
jbe@113	2367 ON "member"."id" = "ignored_member"."member_id"
jbe@113	2368 AND "event"."member_id" = "ignored_member"."other_member_id"
jbe@113	2369 LEFT JOIN "ignored_initiative"
jbe@113	2370 ON "member"."id" = "ignored_initiative"."member_id"
jbe@113	2371 AND "event"."initiative_id" = "ignored_initiative"."initiative_id"
jbe@113	2372 WHERE (
jbe@113	2373 "interest"."member_id" NOTNULL OR
jbe@113	2374 ( "membership"."member_id" NOTNULL AND
jbe@113	2375 "event"."event" IN (
jbe@113	2376 'issue_state_changed',
jbe@113	2377 'initiative_created_in_new_issue',
jbe@113	2378 'initiative_created_in_existing_issue',
jbe@113	2379 'initiative_revoked' ) ) )
jbe@113	2380 AND "ignored_member"."member_id" ISNULL
jbe@113	2381 AND "ignored_initiative"."member_id" ISNULL;
jbe@113	2382
jbe@222	2383 COMMENT ON VIEW "event_seen_by_member" IS 'Events as seen by a member, depending on its memberships, interests and support, but ignoring members "notify_level"';
jbe@222	2384
jbe@222	2385
jbe@473	2386 CREATE VIEW "updated_initiative" AS
jbe@473	2387 SELECT
jbe@486	2388 "supporter"."member_id" AS "seen_by_member_id",
jbe@477	2389 TRUE AS "supported",
jbe@477	2390 EXISTS (
jbe@477	2391 SELECT NULL FROM "draft"
jbe@477	2392 WHERE "draft"."initiative_id" = "initiative"."id"
jbe@477	2393 AND "draft"."id" > "supporter"."draft_id"
jbe@477	2394 ) AS "new_draft",
jbe@477	2395 ( SELECT count(1) FROM "suggestion"
jbe@488	2396 LEFT JOIN "opinion" ON
jbe@488	2397 "opinion"."member_id" = "supporter"."member_id" AND
jbe@488	2398 "opinion"."suggestion_id" = "suggestion"."id"
jbe@477	2399 WHERE "suggestion"."initiative_id" = "initiative"."id"
jbe@488	2400 AND "opinion"."member_id" ISNULL
jbe@477	2401 AND COALESCE(
jbe@486	2402 "suggestion"."id" > "sent"."last_suggestion_id",
jbe@477	2403 TRUE
jbe@477	2404 )
jbe@477	2405 ) AS "new_suggestion_count",
jbe@477	2406 FALSE AS "featured",
jbe@477	2407 NOT EXISTS (
jbe@477	2408 SELECT NULL FROM "initiative" AS "better_initiative"
jbe@477	2409 WHERE
jbe@484	2410 "better_initiative"."issue_id" = "initiative"."issue_id"
jbe@484	2411 AND
jbe@484	2412 ( COALESCE("better_initiative"."harmonic_weight", -1),
jbe@484	2413 -"better_initiative"."id" ) >
jbe@484	2414 ( COALESCE("initiative"."harmonic_weight", -1),
jbe@485	2415 -"initiative"."id" )
jbe@477	2416 ) AS "leading",
jbe@473	2417 "initiative".*
jbe@486	2418 FROM "supporter" JOIN "initiative"
jbe@486	2419 ON "supporter"."initiative_id" = "initiative"."id"
jbe@486	2420 LEFT JOIN "initiative_notification_sent" AS "sent"
jbe@486	2421 ON "sent"."member_id" = "supporter"."member_id"
jbe@486	2422 AND "sent"."initiative_id" = "initiative"."id"
jbe@473	2423 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
jbe@480	2424 WHERE "issue"."state" IN ('admission', 'discussion')
jbe@473	2425 AND (
jbe@473	2426 EXISTS (
jbe@473	2427 SELECT NULL FROM "draft"
jbe@473	2428 WHERE "draft"."initiative_id" = "initiative"."id"
jbe@473	2429 AND "draft"."id" > "supporter"."draft_id"
jbe@473	2430 ) OR EXISTS (
jbe@473	2431 SELECT NULL FROM "suggestion"
jbe@487	2432 LEFT JOIN "opinion" ON
jbe@487	2433 "opinion"."member_id" = "supporter"."member_id" AND
jbe@487	2434 "opinion"."suggestion_id" = "suggestion"."id"
jbe@473	2435 WHERE "suggestion"."initiative_id" = "initiative"."id"
jbe@487	2436 AND "opinion"."member_id" ISNULL
jbe@473	2437 AND COALESCE(
jbe@486	2438 "suggestion"."id" > "sent"."last_suggestion_id",
jbe@473	2439 TRUE
jbe@473	2440 )
jbe@473	2441 )
jbe@473	2442 );
jbe@473	2443
jbe@474	2444 CREATE FUNCTION "featured_initiative"
jbe@474	2445 ( "member_id_p" "member"."id"%TYPE,
jbe@474	2446 "area_id_p" "area"."id"%TYPE )
jbe@474	2447 RETURNS SETOF "initiative"
jbe@474	2448 LANGUAGE 'plpgsql' STABLE AS $$
jbe@474	2449 DECLARE
jbe@482	2450 "member_row" "member"%ROWTYPE;
jbe@474	2451 "member_id_v" "member"."id"%TYPE;
jbe@474	2452 "seed_v" TEXT;
jbe@474	2453 "result_row" "initiative"%ROWTYPE;
jbe@474	2454 "match_v" BOOLEAN;
jbe@474	2455 "initiative_id_ary" INT4[]; --"initiative"."id"%TYPE[]
jbe@474	2456 BEGIN
jbe@482	2457 SELECT INTO "member_row" * FROM "member" WHERE "id" = "member_id_p";
jbe@474	2458 "initiative_id_ary" := '{}';
jbe@474	2459 LOOP
jbe@474	2460 "match_v" := FALSE;
jbe@474	2461 FOR "member_id_v", "seed_v" IN
jbe@474	2462 SELECT * FROM (
jbe@474	2463 SELECT DISTINCT
jbe@474	2464 "supporter"."member_id",
jbe@482	2465 md5("member_id_p" \|\| '-' \|\| "member_row"."notification_counter" \|\| '-' \|\| "area_id_p" \|\| '-' \|\| "supporter"."member_id") AS "seed"
jbe@474	2466 FROM "supporter"
jbe@474	2467 JOIN "member" ON "member"."id" = "supporter"."member_id"
jbe@474	2468 JOIN "initiative" ON "initiative"."id" = "supporter"."initiative_id"
jbe@474	2469 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
jbe@474	2470 WHERE "supporter"."member_id" != "member_id_p"
jbe@474	2471 AND "issue"."area_id" = "area_id_p"
jbe@474	2472 AND "issue"."state" IN ('admission', 'discussion', 'verification')
jbe@474	2473 ) AS "subquery"
jbe@474	2474 ORDER BY "seed"
jbe@474	2475 LOOP
jbe@476	2476 SELECT "initiative".* INTO "result_row"
jbe@476	2477 FROM "initiative"
jbe@474	2478 JOIN "issue" ON "issue"."id" = "initiative"."issue_id"
jbe@474	2479 JOIN "supporter" ON "supporter"."initiative_id" = "initiative"."id"
jbe@474	2480 LEFT JOIN "supporter" AS "self_support" ON
jbe@474	2481 "self_support"."initiative_id" = "initiative"."id" AND
jbe@474	2482 "self_support"."member_id" = "member_id_p"
jbe@474	2483 WHERE "supporter"."member_id" = "member_id_v"
jbe@474	2484 AND "issue"."area_id" = "area_id_p"
jbe@474	2485 AND "issue"."state" IN ('admission', 'discussion', 'verification')
jbe@474	2486 AND "self_support"."member_id" ISNULL
jbe@476	2487 AND NOT "initiative_id_ary" @> ARRAY["initiative"."id"]
jbe@474	2488 ORDER BY md5("seed_v" \|\| '-' \|\| "initiative"."id")
jbe@476	2489 LIMIT 1;
jbe@476	2490 IF FOUND THEN
jbe@476	2491 "match_v" := TRUE;
jbe@476	2492 "initiative_id_ary" := "initiative_id_ary" \|\| "result_row"."id";
jbe@476	2493 RETURN NEXT "result_row";
jbe@486	2494 IF array_length("initiative_id_ary", 1) >= "member_row"."notification_sample_size" THEN
jbe@476	2495 RETURN;
jbe@474	2496 END IF;
jbe@476	2497 END IF;
jbe@474	2498 END LOOP;
jbe@474	2499 EXIT WHEN NOT "match_v";
jbe@474	2500 END LOOP;
jbe@474	2501 RETURN;
jbe@474	2502 END;
jbe@474	2503 $$;
jbe@474	2504
jbe@474	2505 CREATE VIEW "updated_or_featured_initiative" AS
jbe@474	2506 SELECT * FROM "updated_initiative"
jbe@474	2507 UNION ALL
jbe@474	2508 SELECT
jbe@474	2509 "member"."id" AS "seen_by_member_id",
jbe@477	2510 FALSE AS "supported",
jbe@489	2511 EXISTS (
jbe@489	2512 SELECT NULL FROM "draft"
jbe@489	2513 WHERE "draft"."initiative_id" = "initiative"."id"
jbe@489	2514 AND COALESCE(
jbe@489	2515 "draft"."id" > "sent"."last_draft_id",
jbe@489	2516 TRUE
jbe@489	2517 )
jbe@489	2518 ) AS "new_draft",
jbe@489	2519 ( SELECT count(1) FROM "suggestion"
jbe@489	2520 WHERE "suggestion"."initiative_id" = "initiative"."id"
jbe@489	2521 AND COALESCE(
jbe@489	2522 "suggestion"."id" > "sent"."last_suggestion_id",
jbe@489	2523 TRUE
jbe@489	2524 )
jbe@489	2525 ) AS "new_suggestion_count",
jbe@477	2526 TRUE AS "featured",
jbe@477	2527 NOT EXISTS (
jbe@477	2528 SELECT NULL FROM "initiative" AS "better_initiative"
jbe@477	2529 WHERE
jbe@484	2530 "better_initiative"."issue_id" = "initiative"."issue_id"
jbe@484	2531 AND
jbe@484	2532 ( COALESCE("better_initiative"."harmonic_weight", -1),
jbe@484	2533 -"better_initiative"."id" ) >
jbe@484	2534 ( COALESCE("initiative"."harmonic_weight", -1),
jbe@485	2535 -"initiative"."id" )
jbe@477	2536 ) AS "leading",
jbe@477	2537 "initiative".*
jbe@474	2538 FROM "member" CROSS JOIN "area"
jbe@477	2539 CROSS JOIN LATERAL
jbe@489	2540 "featured_initiative"("member"."id", "area"."id") AS "initiative"
jbe@489	2541 LEFT JOIN "initiative_notification_sent" AS "sent"
jbe@489	2542 ON "sent"."member_id" = "member"."id"
jbe@489	2543 AND "sent"."initiative_id" = "initiative"."id";
jbe@474	2544
jbe@474	2545 CREATE VIEW "leading_complement_initiative" AS
jbe@477	2546 SELECT * FROM (
jbe@477	2547 SELECT DISTINCT ON ("seen_by_member_id", "initiative"."issue_id")
jbe@489	2548 "uf_initiative"."seen_by_member_id",
jbe@489	2549 "supporter"."member_id" NOTNULL AS "supported",
jbe@489	2550 CASE WHEN "supporter"."member_id" NOTNULL THEN FALSE ELSE
jbe@489	2551 EXISTS (
jbe@489	2552 SELECT NULL FROM "draft"
jbe@489	2553 WHERE "draft"."initiative_id" = "initiative"."id"
jbe@489	2554 AND COALESCE(
jbe@489	2555 "draft"."id" > "sent"."last_draft_id",
jbe@489	2556 TRUE
jbe@489	2557 )
jbe@489	2558 )
jbe@489	2559 END AS "new_draft",
jbe@489	2560 CASE WHEN "supporter"."member_id" NOTNULL THEN 0 ELSE
jbe@489	2561 ( SELECT count(1) FROM "suggestion"
jbe@489	2562 WHERE "suggestion"."initiative_id" = "initiative"."id"
jbe@489	2563 AND COALESCE(
jbe@489	2564 "suggestion"."id" > "sent"."last_suggestion_id",
jbe@489	2565 TRUE
jbe@489	2566 )
jbe@489	2567 )
jbe@489	2568 END AS "new_suggestion_count",
jbe@477	2569 FALSE AS "featured",
jbe@477	2570 TRUE AS "leading",
jbe@477	2571 "initiative".*
jbe@489	2572 FROM "updated_or_featured_initiative" AS "uf_initiative"
jbe@489	2573 JOIN "initiative" ON
jbe@489	2574 "uf_initiative"."issue_id" = "initiative"."issue_id"
jbe@489	2575 LEFT JOIN "supporter" ON
jbe@489	2576 "supporter"."member_id" = "uf_initiative"."seen_by_member_id" AND
jbe@489	2577 "supporter"."initiative_id" = "initiative"."id"
jbe@489	2578 LEFT JOIN "initiative_notification_sent" AS "sent"
jbe@489	2579 ON "sent"."member_id" = "uf_initiative"."seen_by_member_id"
jbe@489	2580 AND "sent"."initiative_id" = "initiative"."id"
jbe@477	2581 ORDER BY
jbe@477	2582 "seen_by_member_id",
jbe@477	2583 "initiative"."issue_id",
jbe@477	2584 "initiative"."harmonic_weight" DESC,
jbe@477	2585 "initiative"."id"
jbe@477	2586 ) AS "subquery"
jbe@477	2587 WHERE NOT EXISTS (
jbe@477	2588 SELECT NULL FROM "updated_or_featured_initiative" AS "other"
jbe@477	2589 WHERE "other"."seen_by_member_id" = "subquery"."seen_by_member_id"
jbe@477	2590 AND "other"."id" = "subquery"."id"
jbe@477	2591 );
jbe@474	2592
jbe@490	2593 CREATE VIEW "unfiltered_initiative_for_notification" AS
jbe@474	2594 SELECT * FROM "updated_or_featured_initiative"
jbe@477	2595 UNION ALL
jbe@474	2596 SELECT * FROM "leading_complement_initiative";
jbe@474	2597
jbe@490	2598 CREATE VIEW "initiative_for_notification" AS
jbe@490	2599 SELECT "initiative1".*
jbe@490	2600 FROM "unfiltered_initiative_for_notification" "initiative1"
jbe@490	2601 JOIN "issue" AS "issue1" ON "initiative1"."issue_id" = "issue1"."id"
jbe@490	2602 WHERE EXISTS (
jbe@490	2603 SELECT NULL
jbe@490	2604 FROM "unfiltered_initiative_for_notification" "initiative2"
jbe@490	2605 JOIN "issue" AS "issue2" ON "initiative2"."issue_id" = "issue2"."id"
jbe@490	2606 WHERE "initiative1"."seen_by_member_id" = "initiative2"."seen_by_member_id"
jbe@490	2607 AND "issue1"."area_id" = "issue2"."area_id"
jbe@490	2608 AND ( "initiative2"."new_draft" OR "initiative2"."new_suggestion_count" > 0 )
jbe@490	2609 );
jbe@490	2610
jbe@473	2611
jbe@0	2612
jbe@242	2613 ------------------------------------------------------
jbe@242	2614 -- Row set returning function for delegation chains --
jbe@242	2615 ------------------------------------------------------
jbe@5	2616
jbe@5	2617
jbe@5	2618 CREATE TYPE "delegation_chain_loop_tag" AS ENUM
jbe@5	2619 ('first', 'intermediate', 'last', 'repetition');
jbe@5	2620
jbe@5	2621 COMMENT ON TYPE "delegation_chain_loop_tag" IS 'Type for loop tags in "delegation_chain_row" type';
jbe@5	2622
jbe@5	2623
jbe@5	2624 CREATE TYPE "delegation_chain_row" AS (
jbe@5	2625 "index" INT4,
jbe@5	2626 "member_id" INT4,
jbe@97	2627 "member_valid" BOOLEAN,
jbe@5	2628 "participation" BOOLEAN,
jbe@5	2629 "overridden" BOOLEAN,
jbe@5	2630 "scope_in" "delegation_scope",
jbe@5	2631 "scope_out" "delegation_scope",
jbe@86	2632 "disabled_out" BOOLEAN,
jbe@5	2633 "loop" "delegation_chain_loop_tag" );
jbe@5	2634
jbe@243	2635 COMMENT ON TYPE "delegation_chain_row" IS 'Type of rows returned by "delegation_chain" function';
jbe@5	2636
jbe@5	2637 COMMENT ON COLUMN "delegation_chain_row"."index" IS 'Index starting with 0 and counting up';
jbe@5	2638 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';
jbe@5	2639 COMMENT ON COLUMN "delegation_chain_row"."overridden" IS 'True, if an entry with lower index has "participation" set to true';
jbe@5	2640 COMMENT ON COLUMN "delegation_chain_row"."scope_in" IS 'Scope of used incoming delegation';
jbe@5	2641 COMMENT ON COLUMN "delegation_chain_row"."scope_out" IS 'Scope of used outgoing delegation';
jbe@86	2642 COMMENT ON COLUMN "delegation_chain_row"."disabled_out" IS 'Outgoing delegation is explicitly disabled by a delegation with trustee_id set to NULL';
jbe@5	2643 COMMENT ON COLUMN "delegation_chain_row"."loop" IS 'Not null, if member is part of a loop, see "delegation_chain_loop_tag" type';
jbe@5	2644
jbe@5	2645
jbe@242	2646 CREATE FUNCTION "delegation_chain_for_closed_issue"
jbe@242	2647 ( "member_id_p" "member"."id"%TYPE,
jbe@242	2648 "issue_id_p" "issue"."id"%TYPE )
jbe@242	2649 RETURNS SETOF "delegation_chain_row"
jbe@242	2650 LANGUAGE 'plpgsql' STABLE AS $$
jbe@242	2651 DECLARE
jbe@242	2652 "output_row" "delegation_chain_row";
jbe@242	2653 "direct_voter_row" "direct_voter"%ROWTYPE;
jbe@242	2654 "delegating_voter_row" "delegating_voter"%ROWTYPE;
jbe@242	2655 BEGIN
jbe@242	2656 "output_row"."index" := 0;
jbe@242	2657 "output_row"."member_id" := "member_id_p";
jbe@242	2658 "output_row"."member_valid" := TRUE;
jbe@242	2659 "output_row"."participation" := FALSE;
jbe@242	2660 "output_row"."overridden" := FALSE;
jbe@242	2661 "output_row"."disabled_out" := FALSE;
jbe@242	2662 LOOP
jbe@242	2663 SELECT INTO "direct_voter_row" * FROM "direct_voter"
jbe@242	2664 WHERE "issue_id" = "issue_id_p"
jbe@242	2665 AND "member_id" = "output_row"."member_id";
jbe@242	2666 IF "direct_voter_row"."member_id" NOTNULL THEN
jbe@242	2667 "output_row"."participation" := TRUE;
jbe@242	2668 "output_row"."scope_out" := NULL;
jbe@242	2669 "output_row"."disabled_out" := NULL;
jbe@242	2670 RETURN NEXT "output_row";
jbe@242	2671 RETURN;
jbe@242	2672 END IF;
jbe@242	2673 SELECT INTO "delegating_voter_row" * FROM "delegating_voter"
jbe@242	2674 WHERE "issue_id" = "issue_id_p"
jbe@242	2675 AND "member_id" = "output_row"."member_id";
jbe@242	2676 IF "delegating_voter_row"."member_id" ISNULL THEN
jbe@242	2677 RETURN;
jbe@242	2678 END IF;
jbe@242	2679 "output_row"."scope_out" := "delegating_voter_row"."scope";
jbe@242	2680 RETURN NEXT "output_row";
jbe@242	2681 "output_row"."member_id" := "delegating_voter_row"."delegate_member_ids"[1];
jbe@242	2682 "output_row"."scope_in" := "output_row"."scope_out";
jbe@242	2683 END LOOP;
jbe@242	2684 END;
jbe@242	2685 $$;
jbe@242	2686
jbe@242	2687 COMMENT ON FUNCTION "delegation_chain_for_closed_issue"
jbe@242	2688 ( "member"."id"%TYPE,
jbe@242	2689 "member"."id"%TYPE )
jbe@242	2690 IS 'Helper function for "delegation_chain" function, handling the special case of closed issues after voting';
jbe@242	2691
jbe@242	2692
jbe@5	2693 CREATE FUNCTION "delegation_chain"
jbe@5	2694 ( "member_id_p" "member"."id"%TYPE,
jbe@97	2695 "unit_id_p" "unit"."id"%TYPE,
jbe@5	2696 "area_id_p" "area"."id"%TYPE,
jbe@5	2697 "issue_id_p" "issue"."id"%TYPE,
jbe@255	2698 "simulate_trustee_id_p" "member"."id"%TYPE DEFAULT NULL,
jbe@255	2699 "simulate_default_p" BOOLEAN DEFAULT FALSE )
jbe@5	2700 RETURNS SETOF "delegation_chain_row"
jbe@5	2701 LANGUAGE 'plpgsql' STABLE AS $$
jbe@5	2702 DECLARE
jbe@97	2703 "scope_v" "delegation_scope";
jbe@97	2704 "unit_id_v" "unit"."id"%TYPE;
jbe@97	2705 "area_id_v" "area"."id"%TYPE;
jbe@241	2706 "issue_row" "issue"%ROWTYPE;
jbe@5	2707 "visited_member_ids" INT4[]; -- "member"."id"%TYPE[]
jbe@5	2708 "loop_member_id_v" "member"."id"%TYPE;
jbe@5	2709 "output_row" "delegation_chain_row";
jbe@5	2710 "output_rows" "delegation_chain_row"[];
jbe@255	2711 "simulate_v" BOOLEAN;
jbe@255	2712 "simulate_here_v" BOOLEAN;
jbe@5	2713 "delegation_row" "delegation"%ROWTYPE;
jbe@5	2714 "row_count" INT4;
jbe@5	2715 "i" INT4;
jbe@5	2716 "loop_v" BOOLEAN;
jbe@5	2717 BEGIN
jbe@255	2718 IF "simulate_trustee_id_p" NOTNULL AND "simulate_default_p" THEN
jbe@255	2719 RAISE EXCEPTION 'Both "simulate_trustee_id_p" is set, and "simulate_default_p" is true';
jbe@255	2720 END IF;
jbe@255	2721 IF "simulate_trustee_id_p" NOTNULL OR "simulate_default_p" THEN
jbe@255	2722 "simulate_v" := TRUE;
jbe@255	2723 ELSE
jbe@255	2724 "simulate_v" := FALSE;
jbe@255	2725 END IF;
jbe@97	2726 IF
jbe@97	2727 "unit_id_p" NOTNULL AND
jbe@97	2728 "area_id_p" ISNULL AND
jbe@97	2729 "issue_id_p" ISNULL
jbe@97	2730 THEN
jbe@97	2731 "scope_v" := 'unit';
jbe@97	2732 "unit_id_v" := "unit_id_p";
jbe@97	2733 ELSIF
jbe@97	2734 "unit_id_p" ISNULL AND
jbe@97	2735 "area_id_p" NOTNULL AND
jbe@97	2736 "issue_id_p" ISNULL
jbe@97	2737 THEN
jbe@97	2738 "scope_v" := 'area';
jbe@97	2739 "area_id_v" := "area_id_p";
jbe@97	2740 SELECT "unit_id" INTO "unit_id_v"
jbe@97	2741 FROM "area" WHERE "id" = "area_id_v";
jbe@97	2742 ELSIF
jbe@97	2743 "unit_id_p" ISNULL AND
jbe@97	2744 "area_id_p" ISNULL AND
jbe@97	2745 "issue_id_p" NOTNULL
jbe@97	2746 THEN
jbe@242	2747 SELECT INTO "issue_row" * FROM "issue" WHERE "id" = "issue_id_p";
jbe@242	2748 IF "issue_row"."id" ISNULL THEN
jbe@242	2749 RETURN;
jbe@242	2750 END IF;
jbe@242	2751 IF "issue_row"."closed" NOTNULL THEN
jbe@255	2752 IF "simulate_v" THEN
jbe@242	2753 RAISE EXCEPTION 'Tried to simulate delegation chain for closed issue.';
jbe@242	2754 END IF;
jbe@242	2755 FOR "output_row" IN
jbe@242	2756 SELECT * FROM
jbe@242	2757 "delegation_chain_for_closed_issue"("member_id_p", "issue_id_p")
jbe@242	2758 LOOP
jbe@242	2759 RETURN NEXT "output_row";
jbe@242	2760 END LOOP;
jbe@242	2761 RETURN;
jbe@242	2762 END IF;
jbe@97	2763 "scope_v" := 'issue';
jbe@97	2764 SELECT "area_id" INTO "area_id_v"
jbe@97	2765 FROM "issue" WHERE "id" = "issue_id_p";
jbe@97	2766 SELECT "unit_id" INTO "unit_id_v"
jbe@97	2767 FROM "area" WHERE "id" = "area_id_v";
jbe@97	2768 ELSE
jbe@97	2769 RAISE EXCEPTION 'Exactly one of unit_id_p, area_id_p, or issue_id_p must be NOTNULL.';
jbe@97	2770 END IF;
jbe@5	2771 "visited_member_ids" := '{}';
jbe@5	2772 "loop_member_id_v" := NULL;
jbe@5	2773 "output_rows" := '{}';
jbe@5	2774 "output_row"."index" := 0;
jbe@5	2775 "output_row"."member_id" := "member_id_p";
jbe@97	2776 "output_row"."member_valid" := TRUE;
jbe@5	2777 "output_row"."participation" := FALSE;
jbe@5	2778 "output_row"."overridden" := FALSE;
jbe@86	2779 "output_row"."disabled_out" := FALSE;
jbe@5	2780 "output_row"."scope_out" := NULL;
jbe@5	2781 LOOP
jbe@5	2782 IF "visited_member_ids" @> ARRAY["output_row"."member_id"] THEN
jbe@5	2783 "loop_member_id_v" := "output_row"."member_id";
jbe@5	2784 ELSE
jbe@5	2785 "visited_member_ids" :=
jbe@5	2786 "visited_member_ids" \|\| "output_row"."member_id";
jbe@5	2787 END IF;
jbe@241	2788 IF "output_row"."participation" ISNULL THEN
jbe@241	2789 "output_row"."overridden" := NULL;
jbe@241	2790 ELSIF "output_row"."participation" THEN
jbe@5	2791 "output_row"."overridden" := TRUE;
jbe@5	2792 END IF;
jbe@5	2793 "output_row"."scope_in" := "output_row"."scope_out";
jbe@255	2794 "output_row"."member_valid" := EXISTS (
jbe@97	2795 SELECT NULL FROM "member" JOIN "privilege"
jbe@97	2796 ON "privilege"."member_id" = "member"."id"
jbe@97	2797 AND "privilege"."unit_id" = "unit_id_v"
jbe@97	2798 WHERE "id" = "output_row"."member_id"
jbe@97	2799 AND "member"."active" AND "privilege"."voting_right"
jbe@255	2800 );
jbe@255	2801 "simulate_here_v" := (
jbe@255	2802 "simulate_v" AND
jbe@255	2803 "output_row"."member_id" = "member_id_p"
jbe@255	2804 );
jbe@255	2805 "delegation_row" := ROW(NULL);
jbe@255	2806 IF "output_row"."member_valid" OR "simulate_here_v" THEN
jbe@97	2807 IF "scope_v" = 'unit' THEN
jbe@255	2808 IF NOT "simulate_here_v" THEN
jbe@255	2809 SELECT * INTO "delegation_row" FROM "delegation"
jbe@255	2810 WHERE "truster_id" = "output_row"."member_id"
jbe@255	2811 AND "unit_id" = "unit_id_v";
jbe@255	2812 END IF;
jbe@97	2813 ELSIF "scope_v" = 'area' THEN
jbe@5	2814 "output_row"."participation" := EXISTS (
jbe@5	2815 SELECT NULL FROM "membership"
jbe@5	2816 WHERE "area_id" = "area_id_p"
jbe@5	2817 AND "member_id" = "output_row"."member_id"
jbe@5	2818 );
jbe@255	2819 IF "simulate_here_v" THEN
jbe@255	2820 IF "simulate_trustee_id_p" ISNULL THEN
jbe@255	2821 SELECT * INTO "delegation_row" FROM "delegation"
jbe@255	2822 WHERE "truster_id" = "output_row"."member_id"
jbe@255	2823 AND "unit_id" = "unit_id_v";
jbe@255	2824 END IF;
jbe@255	2825 ELSE
jbe@255	2826 SELECT * INTO "delegation_row" FROM "delegation"
jbe@255	2827 WHERE "truster_id" = "output_row"."member_id"
jbe@255	2828 AND (
jbe@255	2829 "unit_id" = "unit_id_v" OR
jbe@255	2830 "area_id" = "area_id_v"
jbe@255	2831 )
jbe@255	2832 ORDER BY "scope" DESC;
jbe@255	2833 END IF;
jbe@97	2834 ELSIF "scope_v" = 'issue' THEN
jbe@241	2835 IF "issue_row"."fully_frozen" ISNULL THEN
jbe@241	2836 "output_row"."participation" := EXISTS (
jbe@241	2837 SELECT NULL FROM "interest"
jbe@241	2838 WHERE "issue_id" = "issue_id_p"
jbe@241	2839 AND "member_id" = "output_row"."member_id"
jbe@241	2840 );
jbe@241	2841 ELSE
jbe@241	2842 IF "output_row"."member_id" = "member_id_p" THEN
jbe@241	2843 "output_row"."participation" := EXISTS (
jbe@241	2844 SELECT NULL FROM "direct_voter"
jbe@241	2845 WHERE "issue_id" = "issue_id_p"
jbe@241	2846 AND "member_id" = "output_row"."member_id"
jbe@241	2847 );
jbe@241	2848 ELSE
jbe@241	2849 "output_row"."participation" := NULL;
jbe@241	2850 END IF;
jbe@241	2851 END IF;
jbe@255	2852 IF "simulate_here_v" THEN
jbe@255	2853 IF "simulate_trustee_id_p" ISNULL THEN
jbe@255	2854 SELECT * INTO "delegation_row" FROM "delegation"
jbe@255	2855 WHERE "truster_id" = "output_row"."member_id"
jbe@255	2856 AND (
jbe@255	2857 "unit_id" = "unit_id_v" OR
jbe@255	2858 "area_id" = "area_id_v"
jbe@255	2859 )
jbe@255	2860 ORDER BY "scope" DESC;
jbe@255	2861 END IF;
jbe@255	2862 ELSE
jbe@255	2863 SELECT * INTO "delegation_row" FROM "delegation"
jbe@255	2864 WHERE "truster_id" = "output_row"."member_id"
jbe@255	2865 AND (
jbe@255	2866 "unit_id" = "unit_id_v" OR
jbe@255	2867 "area_id" = "area_id_v" OR
jbe@255	2868 "issue_id" = "issue_id_p"
jbe@255	2869 )
jbe@255	2870 ORDER BY "scope" DESC;
jbe@255	2871 END IF;
jbe@5	2872 END IF;
jbe@5	2873 ELSE
jbe@5	2874 "output_row"."participation" := FALSE;
jbe@5	2875 END IF;
jbe@255	2876 IF "simulate_here_v" AND "simulate_trustee_id_p" NOTNULL THEN
jbe@97	2877 "output_row"."scope_out" := "scope_v";
jbe@5	2878 "output_rows" := "output_rows" \|\| "output_row";
jbe@5	2879 "output_row"."member_id" := "simulate_trustee_id_p";
jbe@5	2880 ELSIF "delegation_row"."trustee_id" NOTNULL THEN
jbe@10	2881 "output_row"."scope_out" := "delegation_row"."scope";
jbe@5	2882 "output_rows" := "output_rows" \|\| "output_row";
jbe@5	2883 "output_row"."member_id" := "delegation_row"."trustee_id";
jbe@86	2884 ELSIF "delegation_row"."scope" NOTNULL THEN
jbe@86	2885 "output_row"."scope_out" := "delegation_row"."scope";
jbe@86	2886 "output_row"."disabled_out" := TRUE;
jbe@86	2887 "output_rows" := "output_rows" \|\| "output_row";
jbe@86	2888 EXIT;
jbe@5	2889 ELSE
jbe@5	2890 "output_row"."scope_out" := NULL;
jbe@5	2891 "output_rows" := "output_rows" \|\| "output_row";
jbe@5	2892 EXIT;
jbe@5	2893 END IF;
jbe@5	2894 EXIT WHEN "loop_member_id_v" NOTNULL;
jbe@5	2895 "output_row"."index" := "output_row"."index" + 1;
jbe@5	2896 END LOOP;
jbe@5	2897 "row_count" := array_upper("output_rows", 1);
jbe@5	2898 "i" := 1;
jbe@5	2899 "loop_v" := FALSE;
jbe@5	2900 LOOP
jbe@5	2901 "output_row" := "output_rows"["i"];
jbe@98	2902 EXIT WHEN "output_row" ISNULL; -- NOTE: ISNULL and NOT ... NOTNULL produce different results!
jbe@5	2903 IF "loop_v" THEN
jbe@5	2904 IF "i" + 1 = "row_count" THEN
jbe@5	2905 "output_row"."loop" := 'last';
jbe@5	2906 ELSIF "i" = "row_count" THEN
jbe@5	2907 "output_row"."loop" := 'repetition';
jbe@5	2908 ELSE
jbe@5	2909 "output_row"."loop" := 'intermediate';
jbe@5	2910 END IF;
jbe@5	2911 ELSIF "output_row"."member_id" = "loop_member_id_v" THEN
jbe@5	2912 "output_row"."loop" := 'first';
jbe@5	2913 "loop_v" := TRUE;
jbe@5	2914 END IF;
jbe@97	2915 IF "scope_v" = 'unit' THEN
jbe@5	2916 "output_row"."participation" := NULL;
jbe@5	2917 END IF;
jbe@5	2918 RETURN NEXT "output_row";
jbe@5	2919 "i" := "i" + 1;
jbe@5	2920 END LOOP;
jbe@5	2921 RETURN;
jbe@5	2922 END;
jbe@5	2923 $$;
jbe@5	2924
jbe@5	2925 COMMENT ON FUNCTION "delegation_chain"
jbe@5	2926 ( "member"."id"%TYPE,
jbe@97	2927 "unit"."id"%TYPE,
jbe@5	2928 "area"."id"%TYPE,
jbe@5	2929 "issue"."id"%TYPE,
jbe@255	2930 "member"."id"%TYPE,
jbe@255	2931 BOOLEAN )
jbe@242	2932 IS 'Shows a delegation chain for unit, area, or issue; See "delegation_chain_row" type for more information';
jbe@242	2933
jbe@242	2934
jbe@242	2935
jbe@242	2936 ---------------------------------------------------------
jbe@242	2937 -- Single row returning function for delegation chains --
jbe@242	2938 ---------------------------------------------------------
jbe@242	2939
jbe@242	2940
jbe@242	2941 CREATE TYPE "delegation_info_loop_type" AS ENUM
jbe@242	2942 ('own', 'first', 'first_ellipsis', 'other', 'other_ellipsis');
jbe@240	2943
jbe@243	2944 COMMENT ON TYPE "delegation_info_loop_type" IS 'Type of "delegation_loop" in "delegation_info_type"; ''own'' means loop to self, ''first'' means loop to first trustee, ''first_ellipsis'' means loop to ellipsis after first trustee, ''other'' means loop to other trustee, ''other_ellipsis'' means loop to ellipsis after other trustee''';
jbe@243	2945
jbe@243	2946
jbe@240	2947 CREATE TYPE "delegation_info_type" AS (
jbe@242	2948 "own_participation" BOOLEAN,
jbe@242	2949 "own_delegation_scope" "delegation_scope",
jbe@242	2950 "first_trustee_id" INT4,
jbe@240	2951 "first_trustee_participation" BOOLEAN,
jbe@242	2952 "first_trustee_ellipsis" BOOLEAN,
jbe@242	2953 "other_trustee_id" INT4,
jbe@240	2954 "other_trustee_participation" BOOLEAN,
jbe@242	2955 "other_trustee_ellipsis" BOOLEAN,
jbe@253	2956 "delegation_loop" "delegation_info_loop_type",
jbe@253	2957 "participating_member_id" INT4 );
jbe@240	2958
jbe@243	2959 COMMENT ON TYPE "delegation_info_type" IS 'Type of result returned by "delegation_info" function; For meaning of "participation" check comment on "delegation_chain_row" type';
jbe@243	2960
jbe@243	2961 COMMENT ON COLUMN "delegation_info_type"."own_participation" IS 'Member is directly participating';
jbe@243	2962 COMMENT ON COLUMN "delegation_info_type"."own_delegation_scope" IS 'Delegation scope of member';
jbe@243	2963 COMMENT ON COLUMN "delegation_info_type"."first_trustee_id" IS 'Direct trustee of member';
jbe@243	2964 COMMENT ON COLUMN "delegation_info_type"."first_trustee_participation" IS 'Direct trustee of member is participating';
jbe@243	2965 COMMENT ON COLUMN "delegation_info_type"."first_trustee_ellipsis" IS 'Ellipsis in delegation chain after "first_trustee"';
jbe@243	2966 COMMENT ON COLUMN "delegation_info_type"."other_trustee_id" IS 'Another relevant trustee (due to participation)';
jbe@243	2967 COMMENT ON COLUMN "delegation_info_type"."other_trustee_participation" IS 'Another trustee is participating (redundant field: if "other_trustee_id" is set, then "other_trustee_participation" is always TRUE, else "other_trustee_participation" is NULL)';
jbe@243	2968 COMMENT ON COLUMN "delegation_info_type"."other_trustee_ellipsis" IS 'Ellipsis in delegation chain after "other_trustee"';
jbe@243	2969 COMMENT ON COLUMN "delegation_info_type"."delegation_loop" IS 'Non-NULL value, if delegation chain contains a circle; See comment on "delegation_info_loop_type" for details';
jbe@253	2970 COMMENT ON COLUMN "delegation_info_type"."participating_member_id" IS 'First participating member in delegation chain';
jbe@243	2971
jbe@243	2972
jbe@240	2973 CREATE FUNCTION "delegation_info"
jbe@242	2974 ( "member_id_p" "member"."id"%TYPE,
jbe@242	2975 "unit_id_p" "unit"."id"%TYPE,
jbe@242	2976 "area_id_p" "area"."id"%TYPE,
jbe@242	2977 "issue_id_p" "issue"."id"%TYPE,
jbe@255	2978 "simulate_trustee_id_p" "member"."id"%TYPE DEFAULT NULL,
jbe@255	2979 "simulate_default_p" BOOLEAN DEFAULT FALSE )
jbe@240	2980 RETURNS "delegation_info_type"
jbe@240	2981 LANGUAGE 'plpgsql' STABLE AS $$
jbe@240	2982 DECLARE
jbe@242	2983 "current_row" "delegation_chain_row";
jbe@242	2984 "result" "delegation_info_type";
jbe@240	2985 BEGIN
jbe@242	2986 "result"."own_participation" := FALSE;
jbe@242	2987 FOR "current_row" IN
jbe@242	2988 SELECT * FROM "delegation_chain"(
jbe@242	2989 "member_id_p",
jbe@242	2990 "unit_id_p", "area_id_p", "issue_id_p",
jbe@255	2991 "simulate_trustee_id_p", "simulate_default_p")
jbe@242	2992 LOOP
jbe@253	2993 IF
jbe@253	2994 "result"."participating_member_id" ISNULL AND
jbe@253	2995 "current_row"."participation"
jbe@253	2996 THEN
jbe@253	2997 "result"."participating_member_id" := "current_row"."member_id";
jbe@253	2998 END IF;
jbe@242	2999 IF "current_row"."member_id" = "member_id_p" THEN
jbe@242	3000 "result"."own_participation" := "current_row"."participation";
jbe@242	3001 "result"."own_delegation_scope" := "current_row"."scope_out";
jbe@242	3002 IF "current_row"."loop" = 'first' THEN
jbe@242	3003 "result"."delegation_loop" := 'own';
jbe@242	3004 END IF;
jbe@242	3005 ELSIF
jbe@242	3006 "current_row"."member_valid" AND
jbe@242	3007 ( "current_row"."loop" ISNULL OR
jbe@242	3008 "current_row"."loop" != 'repetition' )
jbe@242	3009 THEN
jbe@242	3010 IF "result"."first_trustee_id" ISNULL THEN
jbe@242	3011 "result"."first_trustee_id" := "current_row"."member_id";
jbe@242	3012 "result"."first_trustee_participation" := "current_row"."participation";
jbe@242	3013 "result"."first_trustee_ellipsis" := FALSE;
jbe@242	3014 IF "current_row"."loop" = 'first' THEN
jbe@242	3015 "result"."delegation_loop" := 'first';
jbe@242	3016 END IF;
jbe@242	3017 ELSIF "result"."other_trustee_id" ISNULL THEN
jbe@247	3018 IF "current_row"."participation" AND NOT "current_row"."overridden" THEN
jbe@242	3019 "result"."other_trustee_id" := "current_row"."member_id";
jbe@242	3020 "result"."other_trustee_participation" := TRUE;
jbe@242	3021 "result"."other_trustee_ellipsis" := FALSE;
jbe@242	3022 IF "current_row"."loop" = 'first' THEN
jbe@242	3023 "result"."delegation_loop" := 'other';
jbe@240	3024 END IF;
jbe@240	3025 ELSE
jbe@242	3026 "result"."first_trustee_ellipsis" := TRUE;
jbe@242	3027 IF "current_row"."loop" = 'first' THEN
jbe@242	3028 "result"."delegation_loop" := 'first_ellipsis';
jbe@242	3029 END IF;
jbe@242	3030 END IF;
jbe@242	3031 ELSE
jbe@242	3032 "result"."other_trustee_ellipsis" := TRUE;
jbe@242	3033 IF "current_row"."loop" = 'first' THEN
jbe@242	3034 "result"."delegation_loop" := 'other_ellipsis';
jbe@240	3035 END IF;
jbe@240	3036 END IF;
jbe@240	3037 END IF;
jbe@242	3038 END LOOP;
jbe@240	3039 RETURN "result";
jbe@240	3040 END;
jbe@240	3041 $$;
jbe@240	3042
jbe@243	3043 COMMENT ON FUNCTION "delegation_info"
jbe@243	3044 ( "member"."id"%TYPE,
jbe@243	3045 "unit"."id"%TYPE,
jbe@243	3046 "area"."id"%TYPE,
jbe@243	3047 "issue"."id"%TYPE,
jbe@255	3048 "member"."id"%TYPE,
jbe@255	3049 BOOLEAN )
jbe@243	3050 IS 'Notable information about a delegation chain for unit, area, or issue; See "delegation_info_type" for more information';
jbe@243	3051
jbe@240	3052
jbe@240	3053
jbe@333	3054 ---------------------------
jbe@333	3055 -- Transaction isolation --
jbe@333	3056 ---------------------------
jbe@333	3057
jbe@344	3058
jbe@333	3059 CREATE FUNCTION "require_transaction_isolation"()
jbe@333	3060 RETURNS VOID
jbe@333	3061 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@333	3062 BEGIN
jbe@333	3063 IF
jbe@333	3064 current_setting('transaction_isolation') NOT IN
jbe@333	3065 ('repeatable read', 'serializable')
jbe@333	3066 THEN
jbe@463	3067 RAISE EXCEPTION 'Insufficient transaction isolation level' USING
jbe@463	3068 HINT = 'Consider using SET TRANSACTION ISOLATION LEVEL REPEATABLE READ.';
jbe@333	3069 END IF;
jbe@333	3070 RETURN;
jbe@333	3071 END;
jbe@333	3072 $$;
jbe@333	3073
jbe@344	3074 COMMENT ON FUNCTION "require_transaction_isolation"() IS 'Throws an exception, if transaction isolation level is too low to provide a consistent snapshot';
jbe@344	3075
jbe@333	3076
jbe@333	3077 CREATE FUNCTION "dont_require_transaction_isolation"()
jbe@333	3078 RETURNS VOID
jbe@333	3079 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@333	3080 BEGIN
jbe@333	3081 IF
jbe@333	3082 current_setting('transaction_isolation') IN
jbe@333	3083 ('repeatable read', 'serializable')
jbe@333	3084 THEN
jbe@333	3085 RAISE WARNING 'Unneccessary transaction isolation level: %',
jbe@333	3086 current_setting('transaction_isolation');
jbe@333	3087 END IF;
jbe@333	3088 RETURN;
jbe@333	3089 END;
jbe@333	3090 $$;
jbe@333	3091
jbe@344	3092 COMMENT ON FUNCTION "dont_require_transaction_isolation"() IS 'Raises a warning, if transaction isolation level is higher than READ COMMITTED';
jbe@344	3093
jbe@333	3094
jbe@333	3095
jbe@103	3096 ------------------------------------------------------------------------
jbe@103	3097 -- Regular tasks, except calculcation of snapshots and voting results --
jbe@103	3098 ------------------------------------------------------------------------
jbe@103	3099
jbe@333	3100
jbe@184	3101 CREATE FUNCTION "check_activity"()
jbe@103	3102 RETURNS VOID
jbe@103	3103 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@104	3104 DECLARE
jbe@104	3105 "system_setting_row" "system_setting"%ROWTYPE;
jbe@103	3106 BEGIN
jbe@333	3107 PERFORM "dont_require_transaction_isolation"();
jbe@104	3108 SELECT * INTO "system_setting_row" FROM "system_setting";
jbe@104	3109 IF "system_setting_row"."member_ttl" NOTNULL THEN
jbe@104	3110 UPDATE "member" SET "active" = FALSE
jbe@104	3111 WHERE "active" = TRUE
jbe@184	3112 AND "last_activity" < (now() - "system_setting_row"."member_ttl")::DATE;
jbe@104	3113 END IF;
jbe@103	3114 RETURN;
jbe@103	3115 END;
jbe@103	3116 $$;
jbe@103	3117
jbe@184	3118 COMMENT ON FUNCTION "check_activity"() IS 'Deactivates members when "last_activity" is older than "system_setting"."member_ttl".';
jbe@103	3119
jbe@4	3120
jbe@4	3121 CREATE FUNCTION "calculate_member_counts"()
jbe@4	3122 RETURNS VOID
jbe@4	3123 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@4	3124 BEGIN
jbe@333	3125 PERFORM "require_transaction_isolation"();
jbe@4	3126 DELETE FROM "member_count";
jbe@5	3127 INSERT INTO "member_count" ("total_count")
jbe@5	3128 SELECT "total_count" FROM "member_count_view";
jbe@97	3129 UPDATE "unit" SET "member_count" = "view"."member_count"
jbe@97	3130 FROM "unit_member_count" AS "view"
jbe@97	3131 WHERE "view"."unit_id" = "unit"."id";
jbe@5	3132 UPDATE "area" SET
jbe@5	3133 "direct_member_count" = "view"."direct_member_count",
jbe@169	3134 "member_weight" = "view"."member_weight"
jbe@5	3135 FROM "area_member_count" AS "view"
jbe@5	3136 WHERE "view"."area_id" = "area"."id";
jbe@4	3137 RETURN;
jbe@4	3138 END;
jbe@4	3139 $$;
jbe@4	3140
jbe@4	3141 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"';
jbe@4	3142
jbe@4	3143
jbe@4	3144
jbe@327	3145 ------------------------------------
jbe@327	3146 -- Calculation of harmonic weight --
jbe@327	3147 ------------------------------------
jbe@310	3148
jbe@312	3149
jbe@310	3150 CREATE VIEW "remaining_harmonic_supporter_weight" AS
jbe@310	3151 SELECT
jbe@310	3152 "direct_interest_snapshot"."issue_id",
jbe@310	3153 "direct_interest_snapshot"."event",
jbe@310	3154 "direct_interest_snapshot"."member_id",
jbe@310	3155 "direct_interest_snapshot"."weight" AS "weight_num",
jbe@310	3156 count("initiative"."id") AS "weight_den"
jbe@312	3157 FROM "issue"
jbe@312	3158 JOIN "direct_interest_snapshot"
jbe@312	3159 ON "issue"."id" = "direct_interest_snapshot"."issue_id"
jbe@312	3160 AND "issue"."latest_snapshot_event" = "direct_interest_snapshot"."event"
jbe@327	3161 JOIN "initiative"
jbe@327	3162 ON "issue"."id" = "initiative"."issue_id"
jbe@327	3163 AND "initiative"."harmonic_weight" ISNULL
jbe@310	3164 JOIN "direct_supporter_snapshot"
jbe@327	3165 ON "initiative"."id" = "direct_supporter_snapshot"."initiative_id"
jbe@310	3166 AND "direct_interest_snapshot"."event" = "direct_supporter_snapshot"."event"
jbe@310	3167 AND "direct_interest_snapshot"."member_id" = "direct_supporter_snapshot"."member_id"
jbe@321	3168 AND (
jbe@321	3169 "direct_supporter_snapshot"."satisfied" = TRUE OR
jbe@321	3170 coalesce("initiative"."admitted", FALSE) = FALSE
jbe@321	3171 )
jbe@310	3172 GROUP BY
jbe@310	3173 "direct_interest_snapshot"."issue_id",
jbe@310	3174 "direct_interest_snapshot"."event",
jbe@310	3175 "direct_interest_snapshot"."member_id",
jbe@310	3176 "direct_interest_snapshot"."weight";
jbe@310	3177
jbe@310	3178 COMMENT ON VIEW "remaining_harmonic_supporter_weight" IS 'Helper view for function "set_harmonic_initiative_weights"';
jbe@310	3179
jbe@310	3180
jbe@310	3181 CREATE VIEW "remaining_harmonic_initiative_weight_summands" AS
jbe@310	3182 SELECT
jbe@310	3183 "initiative"."issue_id",
jbe@310	3184 "initiative"."id" AS "initiative_id",
jbe@320	3185 "initiative"."admitted",
jbe@310	3186 sum("remaining_harmonic_supporter_weight"."weight_num") AS "weight_num",
jbe@310	3187 "remaining_harmonic_supporter_weight"."weight_den"
jbe@310	3188 FROM "remaining_harmonic_supporter_weight"
jbe@327	3189 JOIN "initiative"
jbe@327	3190 ON "remaining_harmonic_supporter_weight"."issue_id" = "initiative"."issue_id"
jbe@327	3191 AND "initiative"."harmonic_weight" ISNULL
jbe@310	3192 JOIN "direct_supporter_snapshot"
jbe@327	3193 ON "initiative"."id" = "direct_supporter_snapshot"."initiative_id"
jbe@310	3194 AND "remaining_harmonic_supporter_weight"."event" = "direct_supporter_snapshot"."event"
jbe@310	3195 AND "remaining_harmonic_supporter_weight"."member_id" = "direct_supporter_snapshot"."member_id"
jbe@321	3196 AND (
jbe@321	3197 "direct_supporter_snapshot"."satisfied" = TRUE OR
jbe@321	3198 coalesce("initiative"."admitted", FALSE) = FALSE
jbe@321	3199 )
jbe@310	3200 GROUP BY
jbe@310	3201 "initiative"."issue_id",
jbe@310	3202 "initiative"."id",
jbe@320	3203 "initiative"."admitted",
jbe@310	3204 "remaining_harmonic_supporter_weight"."weight_den";
jbe@310	3205
jbe@310	3206 COMMENT ON VIEW "remaining_harmonic_initiative_weight_summands" IS 'Helper view for function "set_harmonic_initiative_weights"';
jbe@310	3207
jbe@310	3208
jbe@349	3209 CREATE VIEW "remaining_harmonic_initiative_weight_dummies" AS
jbe@349	3210 SELECT
jbe@349	3211 "issue_id",
jbe@349	3212 "id" AS "initiative_id",
jbe@349	3213 "admitted",
jbe@349	3214 0 AS "weight_num",
jbe@349	3215 1 AS "weight_den"
jbe@349	3216 FROM "initiative"
jbe@349	3217 WHERE "harmonic_weight" ISNULL;
jbe@349	3218
jbe@349	3219 COMMENT ON VIEW "remaining_harmonic_initiative_weight_dummies" IS 'Helper view for function "set_harmonic_initiative_weights" providing dummy weights of zero value, which are needed for corner cases where there are no supporters for an initiative at all';
jbe@349	3220
jbe@349	3221
jbe@310	3222 CREATE FUNCTION "set_harmonic_initiative_weights"
jbe@310	3223 ( "issue_id_p" "issue"."id"%TYPE )
jbe@310	3224 RETURNS VOID
jbe@310	3225 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@310	3226 DECLARE
jbe@310	3227 "weight_row" "remaining_harmonic_initiative_weight_summands"%ROWTYPE;
jbe@310	3228 "i" INT4;
jbe@310	3229 "count_v" INT4;
jbe@310	3230 "summand_v" FLOAT;
jbe@310	3231 "id_ary" INT4[];
jbe@310	3232 "weight_ary" FLOAT[];
jbe@310	3233 "min_weight_v" FLOAT;
jbe@310	3234 BEGIN
jbe@333	3235 PERFORM "require_transaction_isolation"();
jbe@312	3236 UPDATE "initiative" SET "harmonic_weight" = NULL
jbe@312	3237 WHERE "issue_id" = "issue_id_p";
jbe@310	3238 LOOP
jbe@310	3239 "min_weight_v" := NULL;
jbe@310	3240 "i" := 0;
jbe@310	3241 "count_v" := 0;
jbe@310	3242 FOR "weight_row" IN
jbe@310	3243 SELECT * FROM "remaining_harmonic_initiative_weight_summands"
jbe@310	3244 WHERE "issue_id" = "issue_id_p"
jbe@320	3245 AND (
jbe@320	3246 coalesce("admitted", FALSE) = FALSE OR NOT EXISTS (
jbe@320	3247 SELECT NULL FROM "initiative"
jbe@320	3248 WHERE "issue_id" = "issue_id_p"
jbe@320	3249 AND "harmonic_weight" ISNULL
jbe@320	3250 AND coalesce("admitted", FALSE) = FALSE
jbe@320	3251 )
jbe@320	3252 )
jbe@349	3253 UNION ALL -- needed for corner cases
jbe@349	3254 SELECT * FROM "remaining_harmonic_initiative_weight_dummies"
jbe@349	3255 WHERE "issue_id" = "issue_id_p"
jbe@349	3256 AND (
jbe@349	3257 coalesce("admitted", FALSE) = FALSE OR NOT EXISTS (
jbe@349	3258 SELECT NULL FROM "initiative"
jbe@349	3259 WHERE "issue_id" = "issue_id_p"
jbe@349	3260 AND "harmonic_weight" ISNULL
jbe@349	3261 AND coalesce("admitted", FALSE) = FALSE
jbe@349	3262 )
jbe@349	3263 )
jbe@310	3264 ORDER BY "initiative_id" DESC, "weight_den" DESC
jbe@320	3265 -- NOTE: non-admitted initiatives placed first (at last positions),
jbe@320	3266 -- latest initiatives treated worse in case of tie
jbe@310	3267 LOOP
jbe@310	3268 "summand_v" := "weight_row"."weight_num"::FLOAT / "weight_row"."weight_den"::FLOAT;
jbe@310	3269 IF "i" = 0 OR "weight_row"."initiative_id" != "id_ary"["i"] THEN
jbe@310	3270 "i" := "i" + 1;
jbe@310	3271 "count_v" := "i";
jbe@310	3272 "id_ary"["i"] := "weight_row"."initiative_id";
jbe@310	3273 "weight_ary"["i"] := "summand_v";
jbe@310	3274 ELSE
jbe@310	3275 "weight_ary"["i"] := "weight_ary"["i"] + "summand_v";
jbe@310	3276 END IF;
jbe@310	3277 END LOOP;
jbe@310	3278 EXIT WHEN "count_v" = 0;
jbe@310	3279 "i" := 1;
jbe@310	3280 LOOP
jbe@313	3281 "weight_ary"["i"] := "weight_ary"["i"]::NUMERIC(18,9)::NUMERIC(12,3);
jbe@310	3282 IF "min_weight_v" ISNULL OR "weight_ary"["i"] < "min_weight_v" THEN
jbe@310	3283 "min_weight_v" := "weight_ary"["i"];
jbe@310	3284 END IF;
jbe@310	3285 "i" := "i" + 1;
jbe@310	3286 EXIT WHEN "i" > "count_v";
jbe@310	3287 END LOOP;
jbe@310	3288 "i" := 1;
jbe@310	3289 LOOP
jbe@310	3290 IF "weight_ary"["i"] = "min_weight_v" THEN
jbe@310	3291 UPDATE "initiative" SET "harmonic_weight" = "min_weight_v"
jbe@310	3292 WHERE "id" = "id_ary"["i"];
jbe@310	3293 EXIT;
jbe@310	3294 END IF;
jbe@310	3295 "i" := "i" + 1;
jbe@310	3296 END LOOP;
jbe@310	3297 END LOOP;
jbe@316	3298 UPDATE "initiative" SET "harmonic_weight" = 0
jbe@316	3299 WHERE "issue_id" = "issue_id_p" AND "harmonic_weight" ISNULL;
jbe@310	3300 END;
jbe@310	3301 $$;
jbe@310	3302
jbe@310	3303 COMMENT ON FUNCTION "set_harmonic_initiative_weights"
jbe@310	3304 ( "issue"."id"%TYPE )
jbe@310	3305 IS 'Calculates and sets "harmonic_weight" of initiatives in a given issue';
jbe@310	3306
jbe@310	3307
jbe@312	3308
jbe@0	3309 ------------------------------
jbe@0	3310 -- Calculation of snapshots --
jbe@0	3311 ------------------------------
jbe@0	3312
jbe@312	3313
jbe@0	3314 CREATE FUNCTION "weight_of_added_delegations_for_population_snapshot"
jbe@0	3315 ( "issue_id_p" "issue"."id"%TYPE,
jbe@0	3316 "member_id_p" "member"."id"%TYPE,
jbe@0	3317 "delegate_member_ids_p" "delegating_population_snapshot"."delegate_member_ids"%TYPE )
jbe@0	3318 RETURNS "direct_population_snapshot"."weight"%TYPE
jbe@0	3319 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	3320 DECLARE
jbe@0	3321 "issue_delegation_row" "issue_delegation"%ROWTYPE;
jbe@0	3322 "delegate_member_ids_v" "delegating_population_snapshot"."delegate_member_ids"%TYPE;
jbe@0	3323 "weight_v" INT4;
jbe@8	3324 "sub_weight_v" INT4;
jbe@0	3325 BEGIN
jbe@336	3326 PERFORM "require_transaction_isolation"();
jbe@0	3327 "weight_v" := 0;
jbe@0	3328 FOR "issue_delegation_row" IN
jbe@0	3329 SELECT * FROM "issue_delegation"
jbe@0	3330 WHERE "trustee_id" = "member_id_p"
jbe@0	3331 AND "issue_id" = "issue_id_p"
jbe@0	3332 LOOP
jbe@0	3333 IF NOT EXISTS (
jbe@0	3334 SELECT NULL FROM "direct_population_snapshot"
jbe@0	3335 WHERE "issue_id" = "issue_id_p"
jbe@0	3336 AND "event" = 'periodic'
jbe@0	3337 AND "member_id" = "issue_delegation_row"."truster_id"
jbe@0	3338 ) AND NOT EXISTS (
jbe@0	3339 SELECT NULL FROM "delegating_population_snapshot"
jbe@0	3340 WHERE "issue_id" = "issue_id_p"
jbe@0	3341 AND "event" = 'periodic'
jbe@0	3342 AND "member_id" = "issue_delegation_row"."truster_id"
jbe@0	3343 ) THEN
jbe@0	3344 "delegate_member_ids_v" :=
jbe@0	3345 "member_id_p" \|\| "delegate_member_ids_p";
jbe@10	3346 INSERT INTO "delegating_population_snapshot" (
jbe@10	3347 "issue_id",
jbe@10	3348 "event",
jbe@10	3349 "member_id",
jbe@10	3350 "scope",
jbe@10	3351 "delegate_member_ids"
jbe@10	3352 ) VALUES (
jbe@0	3353 "issue_id_p",
jbe@0	3354 'periodic',
jbe@0	3355 "issue_delegation_row"."truster_id",
jbe@10	3356 "issue_delegation_row"."scope",
jbe@0	3357 "delegate_member_ids_v"
jbe@0	3358 );
jbe@8	3359 "sub_weight_v" := 1 +
jbe@0	3360 "weight_of_added_delegations_for_population_snapshot"(
jbe@0	3361 "issue_id_p",
jbe@0	3362 "issue_delegation_row"."truster_id",
jbe@0	3363 "delegate_member_ids_v"
jbe@0	3364 );
jbe@8	3365 UPDATE "delegating_population_snapshot"
jbe@8	3366 SET "weight" = "sub_weight_v"
jbe@8	3367 WHERE "issue_id" = "issue_id_p"
jbe@8	3368 AND "event" = 'periodic'
jbe@8	3369 AND "member_id" = "issue_delegation_row"."truster_id";
jbe@8	3370 "weight_v" := "weight_v" + "sub_weight_v";
jbe@0	3371 END IF;
jbe@0	3372 END LOOP;
jbe@0	3373 RETURN "weight_v";
jbe@0	3374 END;
jbe@0	3375 $$;
jbe@0	3376
jbe@0	3377 COMMENT ON FUNCTION "weight_of_added_delegations_for_population_snapshot"
jbe@0	3378 ( "issue"."id"%TYPE,
jbe@0	3379 "member"."id"%TYPE,
jbe@0	3380 "delegating_population_snapshot"."delegate_member_ids"%TYPE )
jbe@0	3381 IS 'Helper function for "create_population_snapshot" function';
jbe@0	3382
jbe@0	3383
jbe@0	3384 CREATE FUNCTION "create_population_snapshot"
jbe@0	3385 ( "issue_id_p" "issue"."id"%TYPE )
jbe@0	3386 RETURNS VOID
jbe@0	3387 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	3388 DECLARE
jbe@0	3389 "member_id_v" "member"."id"%TYPE;
jbe@0	3390 BEGIN
jbe@336	3391 PERFORM "require_transaction_isolation"();
jbe@0	3392 DELETE FROM "direct_population_snapshot"
jbe@0	3393 WHERE "issue_id" = "issue_id_p"
jbe@0	3394 AND "event" = 'periodic';
jbe@0	3395 DELETE FROM "delegating_population_snapshot"
jbe@0	3396 WHERE "issue_id" = "issue_id_p"
jbe@0	3397 AND "event" = 'periodic';
jbe@0	3398 INSERT INTO "direct_population_snapshot"
jbe@54	3399 ("issue_id", "event", "member_id")
jbe@54	3400 SELECT
jbe@54	3401 "issue_id_p" AS "issue_id",
jbe@54	3402 'periodic'::"snapshot_event" AS "event",
jbe@54	3403 "member"."id" AS "member_id"
jbe@54	3404 FROM "issue"
jbe@54	3405 JOIN "area" ON "issue"."area_id" = "area"."id"
jbe@54	3406 JOIN "membership" ON "area"."id" = "membership"."area_id"
jbe@54	3407 JOIN "member" ON "membership"."member_id" = "member"."id"
jbe@97	3408 JOIN "privilege"
jbe@97	3409 ON "privilege"."unit_id" = "area"."unit_id"
jbe@97	3410 AND "privilege"."member_id" = "member"."id"
jbe@54	3411 WHERE "issue"."id" = "issue_id_p"
jbe@97	3412 AND "member"."active" AND "privilege"."voting_right"
jbe@54	3413 UNION
jbe@54	3414 SELECT
jbe@54	3415 "issue_id_p" AS "issue_id",
jbe@54	3416 'periodic'::"snapshot_event" AS "event",
jbe@54	3417 "member"."id" AS "member_id"
jbe@97	3418 FROM "issue"
jbe@97	3419 JOIN "area" ON "issue"."area_id" = "area"."id"
jbe@97	3420 JOIN "interest" ON "issue"."id" = "interest"."issue_id"
jbe@97	3421 JOIN "member" ON "interest"."member_id" = "member"."id"
jbe@97	3422 JOIN "privilege"
jbe@97	3423 ON "privilege"."unit_id" = "area"."unit_id"
jbe@97	3424 AND "privilege"."member_id" = "member"."id"
jbe@97	3425 WHERE "issue"."id" = "issue_id_p"
jbe@97	3426 AND "member"."active" AND "privilege"."voting_right";
jbe@0	3427 FOR "member_id_v" IN
jbe@0	3428 SELECT "member_id" FROM "direct_population_snapshot"
jbe@0	3429 WHERE "issue_id" = "issue_id_p"
jbe@0	3430 AND "event" = 'periodic'
jbe@0	3431 LOOP
jbe@0	3432 UPDATE "direct_population_snapshot" SET
jbe@0	3433 "weight" = 1 +
jbe@0	3434 "weight_of_added_delegations_for_population_snapshot"(
jbe@0	3435 "issue_id_p",
jbe@0	3436 "member_id_v",
jbe@0	3437 '{}'
jbe@0	3438 )
jbe@0	3439 WHERE "issue_id" = "issue_id_p"
jbe@0	3440 AND "event" = 'periodic'
jbe@0	3441 AND "member_id" = "member_id_v";
jbe@0	3442 END LOOP;
jbe@0	3443 RETURN;
jbe@0	3444 END;
jbe@0	3445 $$;
jbe@0	3446
jbe@0	3447 COMMENT ON FUNCTION "create_population_snapshot"
jbe@67	3448 ( "issue"."id"%TYPE )
jbe@0	3449 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.';
jbe@0	3450
jbe@0	3451
jbe@0	3452 CREATE FUNCTION "weight_of_added_delegations_for_interest_snapshot"
jbe@0	3453 ( "issue_id_p" "issue"."id"%TYPE,
jbe@0	3454 "member_id_p" "member"."id"%TYPE,
jbe@0	3455 "delegate_member_ids_p" "delegating_interest_snapshot"."delegate_member_ids"%TYPE )
jbe@0	3456 RETURNS "direct_interest_snapshot"."weight"%TYPE
jbe@0	3457 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	3458 DECLARE
jbe@0	3459 "issue_delegation_row" "issue_delegation"%ROWTYPE;
jbe@0	3460 "delegate_member_ids_v" "delegating_interest_snapshot"."delegate_member_ids"%TYPE;
jbe@0	3461 "weight_v" INT4;
jbe@8	3462 "sub_weight_v" INT4;
jbe@0	3463 BEGIN
jbe@336	3464 PERFORM "require_transaction_isolation"();
jbe@0	3465 "weight_v" := 0;
jbe@0	3466 FOR "issue_delegation_row" IN
jbe@0	3467 SELECT * FROM "issue_delegation"
jbe@0	3468 WHERE "trustee_id" = "member_id_p"
jbe@0	3469 AND "issue_id" = "issue_id_p"
jbe@0	3470 LOOP
jbe@0	3471 IF NOT EXISTS (
jbe@0	3472 SELECT NULL FROM "direct_interest_snapshot"
jbe@0	3473 WHERE "issue_id" = "issue_id_p"
jbe@0	3474 AND "event" = 'periodic'
jbe@0	3475 AND "member_id" = "issue_delegation_row"."truster_id"
jbe@0	3476 ) AND NOT EXISTS (
jbe@0	3477 SELECT NULL FROM "delegating_interest_snapshot"
jbe@0	3478 WHERE "issue_id" = "issue_id_p"
jbe@0	3479 AND "event" = 'periodic'
jbe@0	3480 AND "member_id" = "issue_delegation_row"."truster_id"
jbe@0	3481 ) THEN
jbe@0	3482 "delegate_member_ids_v" :=
jbe@0	3483 "member_id_p" \|\| "delegate_member_ids_p";
jbe@10	3484 INSERT INTO "delegating_interest_snapshot" (
jbe@10	3485 "issue_id",
jbe@10	3486 "event",
jbe@10	3487 "member_id",
jbe@10	3488 "scope",
jbe@10	3489 "delegate_member_ids"
jbe@10	3490 ) VALUES (
jbe@0	3491 "issue_id_p",
jbe@0	3492 'periodic',
jbe@0	3493 "issue_delegation_row"."truster_id",
jbe@10	3494 "issue_delegation_row"."scope",
jbe@0	3495 "delegate_member_ids_v"
jbe@0	3496 );
jbe@8	3497 "sub_weight_v" := 1 +
jbe@0	3498 "weight_of_added_delegations_for_interest_snapshot"(
jbe@0	3499 "issue_id_p",
jbe@0	3500 "issue_delegation_row"."truster_id",
jbe@0	3501 "delegate_member_ids_v"
jbe@0	3502 );
jbe@8	3503 UPDATE "delegating_interest_snapshot"
jbe@8	3504 SET "weight" = "sub_weight_v"
jbe@8	3505 WHERE "issue_id" = "issue_id_p"
jbe@8	3506 AND "event" = 'periodic'
jbe@8	3507 AND "member_id" = "issue_delegation_row"."truster_id";
jbe@8	3508 "weight_v" := "weight_v" + "sub_weight_v";
jbe@0	3509 END IF;
jbe@0	3510 END LOOP;
jbe@0	3511 RETURN "weight_v";
jbe@0	3512 END;
jbe@0	3513 $$;
jbe@0	3514
jbe@0	3515 COMMENT ON FUNCTION "weight_of_added_delegations_for_interest_snapshot"
jbe@0	3516 ( "issue"."id"%TYPE,
jbe@0	3517 "member"."id"%TYPE,
jbe@0	3518 "delegating_interest_snapshot"."delegate_member_ids"%TYPE )
jbe@0	3519 IS 'Helper function for "create_interest_snapshot" function';
jbe@0	3520
jbe@0	3521
jbe@0	3522 CREATE FUNCTION "create_interest_snapshot"
jbe@0	3523 ( "issue_id_p" "issue"."id"%TYPE )
jbe@0	3524 RETURNS VOID
jbe@0	3525 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	3526 DECLARE
jbe@0	3527 "member_id_v" "member"."id"%TYPE;
jbe@0	3528 BEGIN
jbe@336	3529 PERFORM "require_transaction_isolation"();
jbe@0	3530 DELETE FROM "direct_interest_snapshot"
jbe@0	3531 WHERE "issue_id" = "issue_id_p"
jbe@0	3532 AND "event" = 'periodic';
jbe@0	3533 DELETE FROM "delegating_interest_snapshot"
jbe@0	3534 WHERE "issue_id" = "issue_id_p"
jbe@0	3535 AND "event" = 'periodic';
jbe@0	3536 DELETE FROM "direct_supporter_snapshot"
jbe@325	3537 USING "initiative" -- NOTE: due to missing index on issue_id
jbe@325	3538 WHERE "initiative"."issue_id" = "issue_id_p"
jbe@325	3539 AND "direct_supporter_snapshot"."initiative_id" = "initiative"."id"
jbe@325	3540 AND "direct_supporter_snapshot"."event" = 'periodic';
jbe@0	3541 INSERT INTO "direct_interest_snapshot"
jbe@144	3542 ("issue_id", "event", "member_id")
jbe@0	3543 SELECT
jbe@0	3544 "issue_id_p" AS "issue_id",
jbe@0	3545 'periodic' AS "event",
jbe@144	3546 "member"."id" AS "member_id"
jbe@97	3547 FROM "issue"
jbe@97	3548 JOIN "area" ON "issue"."area_id" = "area"."id"
jbe@97	3549 JOIN "interest" ON "issue"."id" = "interest"."issue_id"
jbe@97	3550 JOIN "member" ON "interest"."member_id" = "member"."id"
jbe@97	3551 JOIN "privilege"
jbe@97	3552 ON "privilege"."unit_id" = "area"."unit_id"
jbe@97	3553 AND "privilege"."member_id" = "member"."id"
jbe@97	3554 WHERE "issue"."id" = "issue_id_p"
jbe@97	3555 AND "member"."active" AND "privilege"."voting_right";
jbe@0	3556 FOR "member_id_v" IN
jbe@0	3557 SELECT "member_id" FROM "direct_interest_snapshot"
jbe@0	3558 WHERE "issue_id" = "issue_id_p"
jbe@0	3559 AND "event" = 'periodic'
jbe@0	3560 LOOP
jbe@0	3561 UPDATE "direct_interest_snapshot" SET
jbe@0	3562 "weight" = 1 +
jbe@0	3563 "weight_of_added_delegations_for_interest_snapshot"(
jbe@0	3564 "issue_id_p",
jbe@0	3565 "member_id_v",
jbe@0	3566 '{}'
jbe@0	3567 )
jbe@0	3568 WHERE "issue_id" = "issue_id_p"
jbe@0	3569 AND "event" = 'periodic'
jbe@0	3570 AND "member_id" = "member_id_v";
jbe@0	3571 END LOOP;
jbe@0	3572 INSERT INTO "direct_supporter_snapshot"
jbe@0	3573 ( "issue_id", "initiative_id", "event", "member_id",
jbe@204	3574 "draft_id", "informed", "satisfied" )
jbe@0	3575 SELECT
jbe@96	3576 "issue_id_p" AS "issue_id",
jbe@96	3577 "initiative"."id" AS "initiative_id",
jbe@96	3578 'periodic' AS "event",
jbe@96	3579 "supporter"."member_id" AS "member_id",
jbe@204	3580 "supporter"."draft_id" AS "draft_id",
jbe@0	3581 "supporter"."draft_id" = "current_draft"."id" AS "informed",
jbe@0	3582 NOT EXISTS (
jbe@0	3583 SELECT NULL FROM "critical_opinion"
jbe@0	3584 WHERE "initiative_id" = "initiative"."id"
jbe@96	3585 AND "member_id" = "supporter"."member_id"
jbe@0	3586 ) AS "satisfied"
jbe@96	3587 FROM "initiative"
jbe@96	3588 JOIN "supporter"
jbe@0	3589 ON "supporter"."initiative_id" = "initiative"."id"
jbe@0	3590 JOIN "current_draft"
jbe@0	3591 ON "initiative"."id" = "current_draft"."initiative_id"
jbe@0	3592 JOIN "direct_interest_snapshot"
jbe@96	3593 ON "supporter"."member_id" = "direct_interest_snapshot"."member_id"
jbe@0	3594 AND "initiative"."issue_id" = "direct_interest_snapshot"."issue_id"
jbe@3	3595 AND "event" = 'periodic'
jbe@96	3596 WHERE "initiative"."issue_id" = "issue_id_p";
jbe@0	3597 RETURN;
jbe@0	3598 END;
jbe@0	3599 $$;
jbe@0	3600
jbe@0	3601 COMMENT ON FUNCTION "create_interest_snapshot"
jbe@0	3602 ( "issue"."id"%TYPE )
jbe@0	3603 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.';
jbe@0	3604
jbe@0	3605
jbe@0	3606 CREATE FUNCTION "create_snapshot"
jbe@0	3607 ( "issue_id_p" "issue"."id"%TYPE )
jbe@0	3608 RETURNS VOID
jbe@0	3609 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	3610 DECLARE
jbe@0	3611 "initiative_id_v" "initiative"."id"%TYPE;
jbe@0	3612 "suggestion_id_v" "suggestion"."id"%TYPE;
jbe@0	3613 BEGIN
jbe@333	3614 PERFORM "require_transaction_isolation"();
jbe@0	3615 PERFORM "create_population_snapshot"("issue_id_p");
jbe@0	3616 PERFORM "create_interest_snapshot"("issue_id_p");
jbe@0	3617 UPDATE "issue" SET
jbe@331	3618 "snapshot" = coalesce("phase_finished", now()),
jbe@8	3619 "latest_snapshot_event" = 'periodic',
jbe@0	3620 "population" = (
jbe@0	3621 SELECT coalesce(sum("weight"), 0)
jbe@0	3622 FROM "direct_population_snapshot"
jbe@0	3623 WHERE "issue_id" = "issue_id_p"
jbe@0	3624 AND "event" = 'periodic'
jbe@0	3625 )
jbe@0	3626 WHERE "id" = "issue_id_p";
jbe@0	3627 FOR "initiative_id_v" IN
jbe@0	3628 SELECT "id" FROM "initiative" WHERE "issue_id" = "issue_id_p"
jbe@0	3629 LOOP
jbe@0	3630 UPDATE "initiative" SET
jbe@0	3631 "supporter_count" = (
jbe@0	3632 SELECT coalesce(sum("di"."weight"), 0)
jbe@0	3633 FROM "direct_interest_snapshot" AS "di"
jbe@0	3634 JOIN "direct_supporter_snapshot" AS "ds"
jbe@0	3635 ON "di"."member_id" = "ds"."member_id"
jbe@0	3636 WHERE "di"."issue_id" = "issue_id_p"
jbe@0	3637 AND "di"."event" = 'periodic'
jbe@0	3638 AND "ds"."initiative_id" = "initiative_id_v"
jbe@0	3639 AND "ds"."event" = 'periodic'
jbe@0	3640 ),
jbe@0	3641 "informed_supporter_count" = (
jbe@0	3642 SELECT coalesce(sum("di"."weight"), 0)
jbe@0	3643 FROM "direct_interest_snapshot" AS "di"
jbe@0	3644 JOIN "direct_supporter_snapshot" AS "ds"
jbe@0	3645 ON "di"."member_id" = "ds"."member_id"
jbe@0	3646 WHERE "di"."issue_id" = "issue_id_p"
jbe@0	3647 AND "di"."event" = 'periodic'
jbe@0	3648 AND "ds"."initiative_id" = "initiative_id_v"
jbe@0	3649 AND "ds"."event" = 'periodic'
jbe@0	3650 AND "ds"."informed"
jbe@0	3651 ),
jbe@0	3652 "satisfied_supporter_count" = (
jbe@0	3653 SELECT coalesce(sum("di"."weight"), 0)
jbe@0	3654 FROM "direct_interest_snapshot" AS "di"
jbe@0	3655 JOIN "direct_supporter_snapshot" AS "ds"
jbe@0	3656 ON "di"."member_id" = "ds"."member_id"
jbe@0	3657 WHERE "di"."issue_id" = "issue_id_p"
jbe@0	3658 AND "di"."event" = 'periodic'
jbe@0	3659 AND "ds"."initiative_id" = "initiative_id_v"
jbe@0	3660 AND "ds"."event" = 'periodic'
jbe@0	3661 AND "ds"."satisfied"
jbe@0	3662 ),
jbe@0	3663 "satisfied_informed_supporter_count" = (
jbe@0	3664 SELECT coalesce(sum("di"."weight"), 0)
jbe@0	3665 FROM "direct_interest_snapshot" AS "di"
jbe@0	3666 JOIN "direct_supporter_snapshot" AS "ds"
jbe@0	3667 ON "di"."member_id" = "ds"."member_id"
jbe@0	3668 WHERE "di"."issue_id" = "issue_id_p"
jbe@0	3669 AND "di"."event" = 'periodic'
jbe@0	3670 AND "ds"."initiative_id" = "initiative_id_v"
jbe@0	3671 AND "ds"."event" = 'periodic'
jbe@0	3672 AND "ds"."informed"
jbe@0	3673 AND "ds"."satisfied"
jbe@0	3674 )
jbe@0	3675 WHERE "id" = "initiative_id_v";
jbe@0	3676 FOR "suggestion_id_v" IN
jbe@0	3677 SELECT "id" FROM "suggestion"
jbe@0	3678 WHERE "initiative_id" = "initiative_id_v"
jbe@0	3679 LOOP
jbe@0	3680 UPDATE "suggestion" SET
jbe@0	3681 "minus2_unfulfilled_count" = (
jbe@0	3682 SELECT coalesce(sum("snapshot"."weight"), 0)
jbe@36	3683 FROM "issue" CROSS JOIN "opinion"
jbe@36	3684 JOIN "direct_interest_snapshot" AS "snapshot"
jbe@36	3685 ON "snapshot"."issue_id" = "issue"."id"
jbe@36	3686 AND "snapshot"."event" = "issue"."latest_snapshot_event"
jbe@36	3687 AND "snapshot"."member_id" = "opinion"."member_id"
jbe@36	3688 WHERE "issue"."id" = "issue_id_p"
jbe@36	3689 AND "opinion"."suggestion_id" = "suggestion_id_v"
jbe@0	3690 AND "opinion"."degree" = -2
jbe@0	3691 AND "opinion"."fulfilled" = FALSE
jbe@0	3692 ),
jbe@0	3693 "minus2_fulfilled_count" = (
jbe@0	3694 SELECT coalesce(sum("snapshot"."weight"), 0)
jbe@36	3695 FROM "issue" CROSS JOIN "opinion"
jbe@36	3696 JOIN "direct_interest_snapshot" AS "snapshot"
jbe@36	3697 ON "snapshot"."issue_id" = "issue"."id"
jbe@36	3698 AND "snapshot"."event" = "issue"."latest_snapshot_event"
jbe@36	3699 AND "snapshot"."member_id" = "opinion"."member_id"
jbe@36	3700 WHERE "issue"."id" = "issue_id_p"
jbe@36	3701 AND "opinion"."suggestion_id" = "suggestion_id_v"
jbe@0	3702 AND "opinion"."degree" = -2
jbe@0	3703 AND "opinion"."fulfilled" = TRUE
jbe@0	3704 ),
jbe@0	3705 "minus1_unfulfilled_count" = (
jbe@0	3706 SELECT coalesce(sum("snapshot"."weight"), 0)
jbe@36	3707 FROM "issue" CROSS JOIN "opinion"
jbe@36	3708 JOIN "direct_interest_snapshot" AS "snapshot"
jbe@36	3709 ON "snapshot"."issue_id" = "issue"."id"
jbe@36	3710 AND "snapshot"."event" = "issue"."latest_snapshot_event"
jbe@36	3711 AND "snapshot"."member_id" = "opinion"."member_id"
jbe@36	3712 WHERE "issue"."id" = "issue_id_p"
jbe@36	3713 AND "opinion"."suggestion_id" = "suggestion_id_v"
jbe@0	3714 AND "opinion"."degree" = -1
jbe@0	3715 AND "opinion"."fulfilled" = FALSE
jbe@0	3716 ),
jbe@0	3717 "minus1_fulfilled_count" = (
jbe@0	3718 SELECT coalesce(sum("snapshot"."weight"), 0)
jbe@36	3719 FROM "issue" CROSS JOIN "opinion"
jbe@36	3720 JOIN "direct_interest_snapshot" AS "snapshot"
jbe@36	3721 ON "snapshot"."issue_id" = "issue"."id"
jbe@36	3722 AND "snapshot"."event" = "issue"."latest_snapshot_event"
jbe@36	3723 AND "snapshot"."member_id" = "opinion"."member_id"
jbe@36	3724 WHERE "issue"."id" = "issue_id_p"
jbe@36	3725 AND "opinion"."suggestion_id" = "suggestion_id_v"
jbe@0	3726 AND "opinion"."degree" = -1
jbe@0	3727 AND "opinion"."fulfilled" = TRUE
jbe@0	3728 ),
jbe@0	3729 "plus1_unfulfilled_count" = (
jbe@0	3730 SELECT coalesce(sum("snapshot"."weight"), 0)
jbe@36	3731 FROM "issue" CROSS JOIN "opinion"
jbe@36	3732 JOIN "direct_interest_snapshot" AS "snapshot"
jbe@36	3733 ON "snapshot"."issue_id" = "issue"."id"
jbe@36	3734 AND "snapshot"."event" = "issue"."latest_snapshot_event"
jbe@36	3735 AND "snapshot"."member_id" = "opinion"."member_id"
jbe@36	3736 WHERE "issue"."id" = "issue_id_p"
jbe@36	3737 AND "opinion"."suggestion_id" = "suggestion_id_v"
jbe@0	3738 AND "opinion"."degree" = 1
jbe@0	3739 AND "opinion"."fulfilled" = FALSE
jbe@0	3740 ),
jbe@0	3741 "plus1_fulfilled_count" = (
jbe@0	3742 SELECT coalesce(sum("snapshot"."weight"), 0)
jbe@36	3743 FROM "issue" CROSS JOIN "opinion"
jbe@36	3744 JOIN "direct_interest_snapshot" AS "snapshot"
jbe@36	3745 ON "snapshot"."issue_id" = "issue"."id"
jbe@36	3746 AND "snapshot"."event" = "issue"."latest_snapshot_event"
jbe@36	3747 AND "snapshot"."member_id" = "opinion"."member_id"
jbe@36	3748 WHERE "issue"."id" = "issue_id_p"
jbe@36	3749 AND "opinion"."suggestion_id" = "suggestion_id_v"
jbe@0	3750 AND "opinion"."degree" = 1
jbe@0	3751 AND "opinion"."fulfilled" = TRUE
jbe@0	3752 ),
jbe@0	3753 "plus2_unfulfilled_count" = (
jbe@0	3754 SELECT coalesce(sum("snapshot"."weight"), 0)
jbe@36	3755 FROM "issue" CROSS JOIN "opinion"
jbe@36	3756 JOIN "direct_interest_snapshot" AS "snapshot"
jbe@36	3757 ON "snapshot"."issue_id" = "issue"."id"
jbe@36	3758 AND "snapshot"."event" = "issue"."latest_snapshot_event"
jbe@36	3759 AND "snapshot"."member_id" = "opinion"."member_id"
jbe@36	3760 WHERE "issue"."id" = "issue_id_p"
jbe@36	3761 AND "opinion"."suggestion_id" = "suggestion_id_v"
jbe@0	3762 AND "opinion"."degree" = 2
jbe@0	3763 AND "opinion"."fulfilled" = FALSE
jbe@0	3764 ),
jbe@0	3765 "plus2_fulfilled_count" = (
jbe@0	3766 SELECT coalesce(sum("snapshot"."weight"), 0)
jbe@36	3767 FROM "issue" CROSS JOIN "opinion"
jbe@36	3768 JOIN "direct_interest_snapshot" AS "snapshot"
jbe@36	3769 ON "snapshot"."issue_id" = "issue"."id"
jbe@36	3770 AND "snapshot"."event" = "issue"."latest_snapshot_event"
jbe@36	3771 AND "snapshot"."member_id" = "opinion"."member_id"
jbe@36	3772 WHERE "issue"."id" = "issue_id_p"
jbe@36	3773 AND "opinion"."suggestion_id" = "suggestion_id_v"
jbe@0	3774 AND "opinion"."degree" = 2
jbe@0	3775 AND "opinion"."fulfilled" = TRUE
jbe@0	3776 )
jbe@0	3777 WHERE "suggestion"."id" = "suggestion_id_v";
jbe@0	3778 END LOOP;
jbe@0	3779 END LOOP;
jbe@0	3780 RETURN;
jbe@0	3781 END;
jbe@0	3782 $$;
jbe@0	3783
jbe@0	3784 COMMENT ON FUNCTION "create_snapshot"
jbe@0	3785 ( "issue"."id"%TYPE )
jbe@0	3786 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.';
jbe@0	3787
jbe@0	3788
jbe@0	3789 CREATE FUNCTION "set_snapshot_event"
jbe@0	3790 ( "issue_id_p" "issue"."id"%TYPE,
jbe@0	3791 "event_p" "snapshot_event" )
jbe@0	3792 RETURNS VOID
jbe@0	3793 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@21	3794 DECLARE
jbe@21	3795 "event_v" "issue"."latest_snapshot_event"%TYPE;
jbe@0	3796 BEGIN
jbe@333	3797 PERFORM "require_transaction_isolation"();
jbe@21	3798 SELECT "latest_snapshot_event" INTO "event_v" FROM "issue"
jbe@21	3799 WHERE "id" = "issue_id_p" FOR UPDATE;
jbe@8	3800 UPDATE "issue" SET "latest_snapshot_event" = "event_p"
jbe@8	3801 WHERE "id" = "issue_id_p";
jbe@3	3802 UPDATE "direct_population_snapshot" SET "event" = "event_p"
jbe@21	3803 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
jbe@3	3804 UPDATE "delegating_population_snapshot" SET "event" = "event_p"
jbe@21	3805 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
jbe@3	3806 UPDATE "direct_interest_snapshot" SET "event" = "event_p"
jbe@21	3807 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
jbe@3	3808 UPDATE "delegating_interest_snapshot" SET "event" = "event_p"
jbe@21	3809 WHERE "issue_id" = "issue_id_p" AND "event" = "event_v";
jbe@3	3810 UPDATE "direct_supporter_snapshot" SET "event" = "event_p"
jbe@325	3811 FROM "initiative" -- NOTE: due to missing index on issue_id
jbe@325	3812 WHERE "initiative"."issue_id" = "issue_id_p"
jbe@325	3813 AND "direct_supporter_snapshot"."initiative_id" = "initiative"."id"
jbe@325	3814 AND "direct_supporter_snapshot"."event" = "event_v";
jbe@0	3815 RETURN;
jbe@0	3816 END;
jbe@0	3817 $$;
jbe@0	3818
jbe@0	3819 COMMENT ON FUNCTION "set_snapshot_event"
jbe@0	3820 ( "issue"."id"%TYPE,
jbe@0	3821 "snapshot_event" )
jbe@0	3822 IS 'Change "event" attribute of the previous ''periodic'' snapshot';
jbe@0	3823
jbe@0	3824
jbe@0	3825
jbe@0	3826 -----------------------
jbe@0	3827 -- Counting of votes --
jbe@0	3828 -----------------------
jbe@0	3829
jbe@0	3830
jbe@5	3831 CREATE FUNCTION "weight_of_added_vote_delegations"
jbe@0	3832 ( "issue_id_p" "issue"."id"%TYPE,
jbe@0	3833 "member_id_p" "member"."id"%TYPE,
jbe@0	3834 "delegate_member_ids_p" "delegating_voter"."delegate_member_ids"%TYPE )
jbe@0	3835 RETURNS "direct_voter"."weight"%TYPE
jbe@0	3836 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	3837 DECLARE
jbe@0	3838 "issue_delegation_row" "issue_delegation"%ROWTYPE;
jbe@0	3839 "delegate_member_ids_v" "delegating_voter"."delegate_member_ids"%TYPE;
jbe@0	3840 "weight_v" INT4;
jbe@8	3841 "sub_weight_v" INT4;
jbe@0	3842 BEGIN
jbe@336	3843 PERFORM "require_transaction_isolation"();
jbe@0	3844 "weight_v" := 0;
jbe@0	3845 FOR "issue_delegation_row" IN
jbe@0	3846 SELECT * FROM "issue_delegation"
jbe@0	3847 WHERE "trustee_id" = "member_id_p"
jbe@0	3848 AND "issue_id" = "issue_id_p"
jbe@0	3849 LOOP
jbe@0	3850 IF NOT EXISTS (
jbe@0	3851 SELECT NULL FROM "direct_voter"
jbe@0	3852 WHERE "member_id" = "issue_delegation_row"."truster_id"
jbe@0	3853 AND "issue_id" = "issue_id_p"
jbe@0	3854 ) AND NOT EXISTS (
jbe@0	3855 SELECT NULL FROM "delegating_voter"
jbe@0	3856 WHERE "member_id" = "issue_delegation_row"."truster_id"
jbe@0	3857 AND "issue_id" = "issue_id_p"
jbe@0	3858 ) THEN
jbe@0	3859 "delegate_member_ids_v" :=
jbe@0	3860 "member_id_p" \|\| "delegate_member_ids_p";
jbe@10	3861 INSERT INTO "delegating_voter" (
jbe@10	3862 "issue_id",
jbe@10	3863 "member_id",
jbe@10	3864 "scope",
jbe@10	3865 "delegate_member_ids"
jbe@10	3866 ) VALUES (
jbe@5	3867 "issue_id_p",
jbe@5	3868 "issue_delegation_row"."truster_id",
jbe@10	3869 "issue_delegation_row"."scope",
jbe@5	3870 "delegate_member_ids_v"
jbe@5	3871 );
jbe@8	3872 "sub_weight_v" := 1 +
jbe@8	3873 "weight_of_added_vote_delegations"(
jbe@8	3874 "issue_id_p",
jbe@8	3875 "issue_delegation_row"."truster_id",
jbe@8	3876 "delegate_member_ids_v"
jbe@8	3877 );
jbe@8	3878 UPDATE "delegating_voter"
jbe@8	3879 SET "weight" = "sub_weight_v"
jbe@8	3880 WHERE "issue_id" = "issue_id_p"
jbe@8	3881 AND "member_id" = "issue_delegation_row"."truster_id";
jbe@8	3882 "weight_v" := "weight_v" + "sub_weight_v";
jbe@0	3883 END IF;
jbe@0	3884 END LOOP;
jbe@0	3885 RETURN "weight_v";
jbe@0	3886 END;
jbe@0	3887 $$;
jbe@0	3888
jbe@5	3889 COMMENT ON FUNCTION "weight_of_added_vote_delegations"
jbe@0	3890 ( "issue"."id"%TYPE,
jbe@0	3891 "member"."id"%TYPE,
jbe@0	3892 "delegating_voter"."delegate_member_ids"%TYPE )
jbe@0	3893 IS 'Helper function for "add_vote_delegations" function';
jbe@0	3894
jbe@0	3895
jbe@0	3896 CREATE FUNCTION "add_vote_delegations"
jbe@0	3897 ( "issue_id_p" "issue"."id"%TYPE )
jbe@0	3898 RETURNS VOID
jbe@0	3899 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	3900 DECLARE
jbe@0	3901 "member_id_v" "member"."id"%TYPE;
jbe@0	3902 BEGIN
jbe@336	3903 PERFORM "require_transaction_isolation"();
jbe@0	3904 FOR "member_id_v" IN
jbe@0	3905 SELECT "member_id" FROM "direct_voter"
jbe@0	3906 WHERE "issue_id" = "issue_id_p"
jbe@0	3907 LOOP
jbe@0	3908 UPDATE "direct_voter" SET
jbe@5	3909 "weight" = "weight" + "weight_of_added_vote_delegations"(
jbe@0	3910 "issue_id_p",
jbe@0	3911 "member_id_v",
jbe@0	3912 '{}'
jbe@0	3913 )
jbe@0	3914 WHERE "member_id" = "member_id_v"
jbe@0	3915 AND "issue_id" = "issue_id_p";
jbe@0	3916 END LOOP;
jbe@0	3917 RETURN;
jbe@0	3918 END;
jbe@0	3919 $$;
jbe@0	3920
jbe@0	3921 COMMENT ON FUNCTION "add_vote_delegations"
jbe@0	3922 ( "issue_id_p" "issue"."id"%TYPE )
jbe@0	3923 IS 'Helper function for "close_voting" function';
jbe@0	3924
jbe@0	3925
jbe@0	3926 CREATE FUNCTION "close_voting"("issue_id_p" "issue"."id"%TYPE)
jbe@0	3927 RETURNS VOID
jbe@0	3928 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	3929 DECLARE
jbe@97	3930 "area_id_v" "area"."id"%TYPE;
jbe@97	3931 "unit_id_v" "unit"."id"%TYPE;
jbe@0	3932 "member_id_v" "member"."id"%TYPE;
jbe@0	3933 BEGIN
jbe@333	3934 PERFORM "require_transaction_isolation"();
jbe@129	3935 SELECT "area_id" INTO "area_id_v" FROM "issue" WHERE "id" = "issue_id_p";
jbe@129	3936 SELECT "unit_id" INTO "unit_id_v" FROM "area" WHERE "id" = "area_id_v";
jbe@383	3937 -- override protection triggers:
jbe@385	3938 INSERT INTO "temporary_transaction_data" ("key", "value")
jbe@385	3939 VALUES ('override_protection_triggers', TRUE::TEXT);
jbe@285	3940 -- delete timestamp of voting comment:
jbe@285	3941 UPDATE "direct_voter" SET "comment_changed" = NULL
jbe@285	3942 WHERE "issue_id" = "issue_id_p";
jbe@169	3943 -- delete delegating votes (in cases of manual reset of issue state):
jbe@0	3944 DELETE FROM "delegating_voter"
jbe@0	3945 WHERE "issue_id" = "issue_id_p";
jbe@169	3946 -- delete votes from non-privileged voters:
jbe@97	3947 DELETE FROM "direct_voter"
jbe@97	3948 USING (
jbe@97	3949 SELECT
jbe@97	3950 "direct_voter"."member_id"
jbe@97	3951 FROM "direct_voter"
jbe@97	3952 JOIN "member" ON "direct_voter"."member_id" = "member"."id"
jbe@97	3953 LEFT JOIN "privilege"
jbe@97	3954 ON "privilege"."unit_id" = "unit_id_v"
jbe@97	3955 AND "privilege"."member_id" = "direct_voter"."member_id"
jbe@97	3956 WHERE "direct_voter"."issue_id" = "issue_id_p" AND (
jbe@97	3957 "member"."active" = FALSE OR
jbe@97	3958 "privilege"."voting_right" ISNULL OR
jbe@97	3959 "privilege"."voting_right" = FALSE
jbe@97	3960 )
jbe@97	3961 ) AS "subquery"
jbe@97	3962 WHERE "direct_voter"."issue_id" = "issue_id_p"
jbe@97	3963 AND "direct_voter"."member_id" = "subquery"."member_id";
jbe@169	3964 -- consider delegations:
jbe@0	3965 UPDATE "direct_voter" SET "weight" = 1
jbe@0	3966 WHERE "issue_id" = "issue_id_p";
jbe@0	3967 PERFORM "add_vote_delegations"("issue_id_p");
jbe@414	3968 -- mark first preferences:
jbe@414	3969 UPDATE "vote" SET "first_preference" = "subquery"."first_preference"
jbe@414	3970 FROM (
jbe@414	3971 SELECT
jbe@414	3972 "vote"."initiative_id",
jbe@414	3973 "vote"."member_id",
jbe@414	3974 CASE WHEN "vote"."grade" > 0 THEN
jbe@414	3975 CASE WHEN "vote"."grade" = max("agg"."grade") THEN TRUE ELSE FALSE END
jbe@414	3976 ELSE NULL
jbe@414	3977 END AS "first_preference"
jbe@415	3978 FROM "vote"
jbe@415	3979 JOIN "initiative" -- NOTE: due to missing index on issue_id
jbe@415	3980 ON "vote"."issue_id" = "initiative"."issue_id"
jbe@415	3981 JOIN "vote" AS "agg"
jbe@415	3982 ON "initiative"."id" = "agg"."initiative_id"
jbe@415	3983 AND "vote"."member_id" = "agg"."member_id"
jbe@433	3984 GROUP BY "vote"."initiative_id", "vote"."member_id", "vote"."grade"
jbe@414	3985 ) AS "subquery"
jbe@414	3986 WHERE "vote"."issue_id" = "issue_id_p"
jbe@414	3987 AND "vote"."initiative_id" = "subquery"."initiative_id"
jbe@414	3988 AND "vote"."member_id" = "subquery"."member_id";
jbe@385	3989 -- finish overriding protection triggers (avoids garbage):
jbe@385	3990 DELETE FROM "temporary_transaction_data"
jbe@385	3991 WHERE "key" = 'override_protection_triggers';
jbe@137	3992 -- materialize battle_view:
jbe@61	3993 -- NOTE: "closed" column of issue must be set at this point
jbe@61	3994 DELETE FROM "battle" WHERE "issue_id" = "issue_id_p";
jbe@61	3995 INSERT INTO "battle" (
jbe@61	3996 "issue_id",
jbe@61	3997 "winning_initiative_id", "losing_initiative_id",
jbe@61	3998 "count"
jbe@61	3999 ) SELECT
jbe@61	4000 "issue_id",
jbe@61	4001 "winning_initiative_id", "losing_initiative_id",
jbe@61	4002 "count"
jbe@61	4003 FROM "battle_view" WHERE "issue_id" = "issue_id_p";
jbe@331	4004 -- set voter count:
jbe@331	4005 UPDATE "issue" SET
jbe@331	4006 "voter_count" = (
jbe@331	4007 SELECT coalesce(sum("weight"), 0)
jbe@331	4008 FROM "direct_voter" WHERE "issue_id" = "issue_id_p"
jbe@331	4009 )
jbe@331	4010 WHERE "id" = "issue_id_p";
jbe@437	4011 -- copy "positive_votes" and "negative_votes" from "battle" table:
jbe@437	4012 -- NOTE: "first_preference_votes" is set to a default of 0 at this step
jbe@437	4013 UPDATE "initiative" SET
jbe@437	4014 "first_preference_votes" = 0,
jbe@437	4015 "positive_votes" = "battle_win"."count",
jbe@437	4016 "negative_votes" = "battle_lose"."count"
jbe@437	4017 FROM "battle" AS "battle_win", "battle" AS "battle_lose"
jbe@437	4018 WHERE
jbe@437	4019 "battle_win"."issue_id" = "issue_id_p" AND
jbe@437	4020 "battle_win"."winning_initiative_id" = "initiative"."id" AND
jbe@437	4021 "battle_win"."losing_initiative_id" ISNULL AND
jbe@437	4022 "battle_lose"."issue_id" = "issue_id_p" AND
jbe@437	4023 "battle_lose"."losing_initiative_id" = "initiative"."id" AND
jbe@437	4024 "battle_lose"."winning_initiative_id" ISNULL;
jbe@414	4025 -- calculate "first_preference_votes":
jbe@437	4026 -- NOTE: will only set values not equal to zero
jbe@437	4027 UPDATE "initiative" SET "first_preference_votes" = "subquery"."sum"
jbe@414	4028 FROM (
jbe@414	4029 SELECT "vote"."initiative_id", sum("direct_voter"."weight")
jbe@414	4030 FROM "vote" JOIN "direct_voter"
jbe@414	4031 ON "vote"."issue_id" = "direct_voter"."issue_id"
jbe@414	4032 AND "vote"."member_id" = "direct_voter"."member_id"
jbe@414	4033 WHERE "vote"."first_preference"
jbe@414	4034 GROUP BY "vote"."initiative_id"
jbe@414	4035 ) AS "subquery"
jbe@414	4036 WHERE "initiative"."issue_id" = "issue_id_p"
jbe@414	4037 AND "initiative"."admitted"
jbe@414	4038 AND "initiative"."id" = "subquery"."initiative_id";
jbe@0	4039 END;
jbe@0	4040 $$;
jbe@0	4041
jbe@0	4042 COMMENT ON FUNCTION "close_voting"
jbe@0	4043 ( "issue"."id"%TYPE )
jbe@0	4044 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.';
jbe@0	4045
jbe@0	4046
jbe@30	4047 CREATE FUNCTION "defeat_strength"
jbe@424	4048 ( "positive_votes_p" INT4,
jbe@424	4049 "negative_votes_p" INT4,
jbe@424	4050 "defeat_strength_p" "defeat_strength" )
jbe@30	4051 RETURNS INT8
jbe@30	4052 LANGUAGE 'plpgsql' IMMUTABLE AS $$
jbe@30	4053 BEGIN
jbe@424	4054 IF "defeat_strength_p" = 'simple'::"defeat_strength" THEN
jbe@424	4055 IF "positive_votes_p" > "negative_votes_p" THEN
jbe@424	4056 RETURN "positive_votes_p";
jbe@424	4057 ELSE
jbe@424	4058 RETURN 0;
jbe@424	4059 END IF;
jbe@30	4060 ELSE
jbe@424	4061 IF "positive_votes_p" > "negative_votes_p" THEN
jbe@424	4062 RETURN ("positive_votes_p"::INT8 << 31) - "negative_votes_p"::INT8;
jbe@424	4063 ELSIF "positive_votes_p" = "negative_votes_p" THEN
jbe@424	4064 RETURN 0;
jbe@424	4065 ELSE
jbe@424	4066 RETURN -1;
jbe@424	4067 END IF;
jbe@30	4068 END IF;
jbe@30	4069 END;
jbe@30	4070 $$;
jbe@30	4071
jbe@425	4072 COMMENT ON FUNCTION "defeat_strength"(INT4, INT4, "defeat_strength") IS 'Calculates defeat strength (INT8!) according to the "defeat_strength" option (see comment on type "defeat_strength")';
jbe@30	4073
jbe@30	4074
jbe@423	4075 CREATE FUNCTION "secondary_link_strength"
jbe@426	4076 ( "initiative1_ord_p" INT4,
jbe@426	4077 "initiative2_ord_p" INT4,
jbe@424	4078 "tie_breaking_p" "tie_breaking" )
jbe@423	4079 RETURNS INT8
jbe@423	4080 LANGUAGE 'plpgsql' IMMUTABLE AS $$
jbe@423	4081 BEGIN
jbe@426	4082 IF "initiative1_ord_p" = "initiative2_ord_p" THEN
jbe@423	4083 RAISE EXCEPTION 'Identical initiative ids passed to "secondary_link_strength" function (should not happen)';
jbe@423	4084 END IF;
jbe@423	4085 RETURN (
jbe@426	4086 CASE WHEN "tie_breaking_p" = 'simple'::"tie_breaking" THEN
jbe@426	4087 0
jbe@424	4088 ELSE
jbe@426	4089 CASE WHEN "initiative1_ord_p" < "initiative2_ord_p" THEN
jbe@426	4090 1::INT8 << 62
jbe@426	4091 ELSE 0 END
jbe@426	4092 +
jbe@426	4093 CASE WHEN "tie_breaking_p" = 'variant2'::"tie_breaking" THEN
jbe@426	4094 ("initiative2_ord_p"::INT8 << 31) - "initiative1_ord_p"::INT8
jbe@426	4095 ELSE
jbe@426	4096 "initiative2_ord_p"::INT8 - ("initiative1_ord_p"::INT8 << 31)
jbe@426	4097 END
jbe@424	4098 END
jbe@423	4099 );
jbe@423	4100 END;
jbe@423	4101 $$;
jbe@423	4102
jbe@424	4103 COMMENT ON FUNCTION "secondary_link_strength"(INT4, INT4, "tie_breaking") IS 'Calculates a secondary criterion for the defeat strength (tie-breaking of the links)';
jbe@423	4104
jbe@423	4105
jbe@426	4106 CREATE TYPE "link_strength" AS (
jbe@426	4107 "primary" INT8,
jbe@426	4108 "secondary" INT8 );
jbe@426	4109
jbe@428	4110 COMMENT ON TYPE "link_strength" IS 'Type to store the defeat strength of a link between two candidates plus a secondary criterion to create unique link strengths between the candidates (needed for tie-breaking ''variant1'' and ''variant2'')';
jbe@427	4111
jbe@427	4112
jbe@427	4113 CREATE FUNCTION "find_best_paths"("matrix_d" "link_strength"[][])
jbe@427	4114 RETURNS "link_strength"[][]
jbe@427	4115 LANGUAGE 'plpgsql' IMMUTABLE AS $$
jbe@427	4116 DECLARE
jbe@427	4117 "dimension_v" INT4;
jbe@427	4118 "matrix_p" "link_strength"[][];
jbe@427	4119 "i" INT4;
jbe@427	4120 "j" INT4;
jbe@427	4121 "k" INT4;
jbe@427	4122 BEGIN
jbe@427	4123 "dimension_v" := array_upper("matrix_d", 1);
jbe@427	4124 "matrix_p" := "matrix_d";
jbe@427	4125 "i" := 1;
jbe@427	4126 LOOP
jbe@427	4127 "j" := 1;
jbe@427	4128 LOOP
jbe@427	4129 IF "i" != "j" THEN
jbe@427	4130 "k" := 1;
jbe@427	4131 LOOP
jbe@427	4132 IF "i" != "k" AND "j" != "k" THEN
jbe@427	4133 IF "matrix_p"["j"]["i"] < "matrix_p"["i"]["k"] THEN
jbe@427	4134 IF "matrix_p"["j"]["i"] > "matrix_p"["j"]["k"] THEN
jbe@427	4135 "matrix_p"["j"]["k"] := "matrix_p"["j"]["i"];
jbe@427	4136 END IF;
jbe@427	4137 ELSE
jbe@427	4138 IF "matrix_p"["i"]["k"] > "matrix_p"["j"]["k"] THEN
jbe@427	4139 "matrix_p"["j"]["k"] := "matrix_p"["i"]["k"];
jbe@427	4140 END IF;
jbe@427	4141 END IF;
jbe@427	4142 END IF;
jbe@427	4143 EXIT WHEN "k" = "dimension_v";
jbe@427	4144 "k" := "k" + 1;
jbe@427	4145 END LOOP;
jbe@427	4146 END IF;
jbe@427	4147 EXIT WHEN "j" = "dimension_v";
jbe@427	4148 "j" := "j" + 1;
jbe@427	4149 END LOOP;
jbe@427	4150 EXIT WHEN "i" = "dimension_v";
jbe@427	4151 "i" := "i" + 1;
jbe@427	4152 END LOOP;
jbe@427	4153 RETURN "matrix_p";
jbe@427	4154 END;
jbe@427	4155 $$;
jbe@427	4156
jbe@428	4157 COMMENT ON FUNCTION "find_best_paths"("link_strength"[][]) IS 'Computes the strengths of the best beat-paths from a square matrix';
jbe@426	4158
jbe@426	4159
jbe@0	4160 CREATE FUNCTION "calculate_ranks"("issue_id_p" "issue"."id"%TYPE)
jbe@0	4161 RETURNS VOID
jbe@0	4162 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	4163 DECLARE
jbe@427	4164 "issue_row" "issue"%ROWTYPE;
jbe@427	4165 "policy_row" "policy"%ROWTYPE;
jbe@427	4166 "dimension_v" INT4;
jbe@427	4167 "matrix_a" INT4[][]; -- absolute votes
jbe@427	4168 "matrix_d" "link_strength"[][]; -- defeat strength (direct)
jbe@427	4169 "matrix_p" "link_strength"[][]; -- defeat strength (best path)
jbe@427	4170 "matrix_t" "link_strength"[][]; -- defeat strength (tie-breaking)
jbe@427	4171 "matrix_f" BOOLEAN[][]; -- forbidden link (tie-breaking)
jbe@427	4172 "matrix_b" BOOLEAN[][]; -- final order (who beats who)
jbe@427	4173 "i" INT4;
jbe@427	4174 "j" INT4;
jbe@427	4175 "m" INT4;
jbe@427	4176 "n" INT4;
jbe@427	4177 "battle_row" "battle"%ROWTYPE;
jbe@427	4178 "rank_ary" INT4[];
jbe@427	4179 "rank_v" INT4;
jbe@427	4180 "initiative_id_v" "initiative"."id"%TYPE;
jbe@0	4181 BEGIN
jbe@333	4182 PERFORM "require_transaction_isolation"();
jbe@155	4183 SELECT * INTO "issue_row"
jbe@331	4184 FROM "issue" WHERE "id" = "issue_id_p";
jbe@155	4185 SELECT * INTO "policy_row"
jbe@155	4186 FROM "policy" WHERE "id" = "issue_row"."policy_id";
jbe@126	4187 SELECT count(1) INTO "dimension_v"
jbe@126	4188 FROM "battle_participant" WHERE "issue_id" = "issue_id_p";
jbe@428	4189 -- create "matrix_a" with absolute number of votes in pairwise
jbe@170	4190 -- comparison:
jbe@427	4191 "matrix_a" := array_fill(NULL::INT4, ARRAY["dimension_v", "dimension_v"]);
jbe@170	4192 "i" := 1;
jbe@170	4193 "j" := 2;
jbe@170	4194 FOR "battle_row" IN
jbe@170	4195 SELECT * FROM "battle" WHERE "issue_id" = "issue_id_p"
jbe@170	4196 ORDER BY
jbe@411	4197 "winning_initiative_id" NULLS FIRST,
jbe@411	4198 "losing_initiative_id" NULLS FIRST
jbe@170	4199 LOOP
jbe@427	4200 "matrix_a"["i"]["j"] := "battle_row"."count";
jbe@170	4201 IF "j" = "dimension_v" THEN
jbe@170	4202 "i" := "i" + 1;
jbe@170	4203 "j" := 1;
jbe@170	4204 ELSE
jbe@170	4205 "j" := "j" + 1;
jbe@170	4206 IF "j" = "i" THEN
jbe@170	4207 "j" := "j" + 1;
jbe@170	4208 END IF;
jbe@170	4209 END IF;
jbe@170	4210 END LOOP;
jbe@170	4211 IF "i" != "dimension_v" OR "j" != "dimension_v" + 1 THEN
jbe@170	4212 RAISE EXCEPTION 'Wrong battle count (should not happen)';
jbe@170	4213 END IF;
jbe@428	4214 -- store direct defeat strengths in "matrix_d" using "defeat_strength"
jbe@427	4215 -- and "secondary_link_strength" functions:
jbe@427	4216 "matrix_d" := array_fill(NULL::INT8, ARRAY["dimension_v", "dimension_v"]);
jbe@170	4217 "i" := 1;
jbe@170	4218 LOOP
jbe@170	4219 "j" := 1;
jbe@0	4220 LOOP
jbe@170	4221 IF "i" != "j" THEN
jbe@427	4222 "matrix_d"["i"]["j"] := (
jbe@426	4223 "defeat_strength"(
jbe@427	4224 "matrix_a"["i"]["j"],
jbe@427	4225 "matrix_a"["j"]["i"],
jbe@426	4226 "policy_row"."defeat_strength"
jbe@426	4227 ),
jbe@426	4228 "secondary_link_strength"(
jbe@426	4229 "i",
jbe@426	4230 "j",
jbe@426	4231 "policy_row"."tie_breaking"
jbe@426	4232 )
jbe@426	4233 )::"link_strength";
jbe@0	4234 END IF;
jbe@170	4235 EXIT WHEN "j" = "dimension_v";
jbe@170	4236 "j" := "j" + 1;
jbe@0	4237 END LOOP;
jbe@170	4238 EXIT WHEN "i" = "dimension_v";
jbe@170	4239 "i" := "i" + 1;
jbe@170	4240 END LOOP;
jbe@428	4241 -- find best paths:
jbe@427	4242 "matrix_p" := "find_best_paths"("matrix_d");
jbe@428	4243 -- create partial order:
jbe@427	4244 "matrix_b" := array_fill(NULL::BOOLEAN, ARRAY["dimension_v", "dimension_v"]);
jbe@170	4245 "i" := 1;
jbe@170	4246 LOOP
jbe@427	4247 "j" := "i" + 1;
jbe@170	4248 LOOP
jbe@170	4249 IF "i" != "j" THEN
jbe@427	4250 IF "matrix_p"["i"]["j"] > "matrix_p"["j"]["i"] THEN
jbe@427	4251 "matrix_b"["i"]["j"] := TRUE;
jbe@427	4252 "matrix_b"["j"]["i"] := FALSE;
jbe@427	4253 ELSIF "matrix_p"["i"]["j"] < "matrix_p"["j"]["i"] THEN
jbe@427	4254 "matrix_b"["i"]["j"] := FALSE;
jbe@427	4255 "matrix_b"["j"]["i"] := TRUE;
jbe@427	4256 END IF;
jbe@170	4257 END IF;
jbe@170	4258 EXIT WHEN "j" = "dimension_v";
jbe@170	4259 "j" := "j" + 1;
jbe@170	4260 END LOOP;
jbe@427	4261 EXIT WHEN "i" = "dimension_v" - 1;
jbe@170	4262 "i" := "i" + 1;
jbe@170	4263 END LOOP;
jbe@428	4264 -- tie-breaking by forbidding shared weakest links in beat-paths
jbe@428	4265 -- (unless "tie_breaking" is set to 'simple', in which case tie-breaking
jbe@428	4266 -- is performed later by initiative id):
jbe@427	4267 IF "policy_row"."tie_breaking" != 'simple'::"tie_breaking" THEN
jbe@427	4268 "m" := 1;
jbe@427	4269 LOOP
jbe@427	4270 "n" := "m" + 1;
jbe@427	4271 LOOP
jbe@428	4272 -- only process those candidates m and n, which are tied:
jbe@427	4273 IF "matrix_b"["m"]["n"] ISNULL THEN
jbe@428	4274 -- start with beat-paths prior tie-breaking:
jbe@427	4275 "matrix_t" := "matrix_p";
jbe@428	4276 -- start with all links allowed:
jbe@427	4277 "matrix_f" := array_fill(FALSE, ARRAY["dimension_v", "dimension_v"]);
jbe@427	4278 LOOP
jbe@428	4279 -- determine (and forbid) that link that is the weakest link
jbe@428	4280 -- in both the best path from candidate m to candidate n and
jbe@428	4281 -- from candidate n to candidate m:
jbe@427	4282 "i" := 1;
jbe@427	4283 <<forbid_one_link>>
jbe@427	4284 LOOP
jbe@427	4285 "j" := 1;
jbe@427	4286 LOOP
jbe@427	4287 IF "i" != "j" THEN
jbe@427	4288 IF "matrix_d"["i"]["j"] = "matrix_t"["m"]["n"] THEN
jbe@427	4289 "matrix_f"["i"]["j"] := TRUE;
jbe@427	4290 -- exit for performance reasons,
jbe@428	4291 -- as exactly one link will be found:
jbe@427	4292 EXIT forbid_one_link;
jbe@427	4293 END IF;
jbe@427	4294 END IF;
jbe@427	4295 EXIT WHEN "j" = "dimension_v";
jbe@427	4296 "j" := "j" + 1;
jbe@427	4297 END LOOP;
jbe@427	4298 IF "i" = "dimension_v" THEN
jbe@428	4299 RAISE EXCEPTION 'Did not find shared weakest link for tie-breaking (should not happen)';
jbe@427	4300 END IF;
jbe@427	4301 "i" := "i" + 1;
jbe@427	4302 END LOOP;
jbe@428	4303 -- calculate best beat-paths while ignoring forbidden links:
jbe@427	4304 "i" := 1;
jbe@427	4305 LOOP
jbe@427	4306 "j" := 1;
jbe@427	4307 LOOP
jbe@427	4308 IF "i" != "j" THEN
jbe@427	4309 "matrix_t"["i"]["j"] := CASE
jbe@427	4310 WHEN "matrix_f"["i"]["j"]
jbe@431	4311 THEN ((-1::INT8) << 63, 0)::"link_strength" -- worst possible value
jbe@427	4312 ELSE "matrix_d"["i"]["j"] END;
jbe@427	4313 END IF;
jbe@427	4314 EXIT WHEN "j" = "dimension_v";
jbe@427	4315 "j" := "j" + 1;
jbe@427	4316 END LOOP;
jbe@427	4317 EXIT WHEN "i" = "dimension_v";
jbe@427	4318 "i" := "i" + 1;
jbe@427	4319 END LOOP;
jbe@427	4320 "matrix_t" := "find_best_paths"("matrix_t");
jbe@428	4321 -- extend partial order, if tie-breaking was successful:
jbe@427	4322 IF "matrix_t"["m"]["n"] > "matrix_t"["n"]["m"] THEN
jbe@427	4323 "matrix_b"["m"]["n"] := TRUE;
jbe@427	4324 "matrix_b"["n"]["m"] := FALSE;
jbe@427	4325 EXIT;
jbe@427	4326 ELSIF "matrix_t"["m"]["n"] < "matrix_t"["n"]["m"] THEN
jbe@427	4327 "matrix_b"["m"]["n"] := FALSE;
jbe@427	4328 "matrix_b"["n"]["m"] := TRUE;
jbe@427	4329 EXIT;
jbe@427	4330 END IF;
jbe@427	4331 END LOOP;
jbe@427	4332 END IF;
jbe@427	4333 EXIT WHEN "n" = "dimension_v";
jbe@427	4334 "n" := "n" + 1;
jbe@427	4335 END LOOP;
jbe@427	4336 EXIT WHEN "m" = "dimension_v" - 1;
jbe@427	4337 "m" := "m" + 1;
jbe@427	4338 END LOOP;
jbe@427	4339 END IF;
jbe@428	4340 -- store a unique ranking in "rank_ary":
jbe@170	4341 "rank_ary" := array_fill(NULL::INT4, ARRAY["dimension_v"]);
jbe@170	4342 "rank_v" := 1;
jbe@170	4343 LOOP
jbe@0	4344 "i" := 1;
jbe@428	4345 <<assign_next_rank>>
jbe@0	4346 LOOP
jbe@170	4347 IF "rank_ary"["i"] ISNULL THEN
jbe@170	4348 "j" := 1;
jbe@170	4349 LOOP
jbe@170	4350 IF
jbe@170	4351 "i" != "j" AND
jbe@170	4352 "rank_ary"["j"] ISNULL AND
jbe@427	4353 ( "matrix_b"["j"]["i"] OR
jbe@411	4354 -- tie-breaking by "id"
jbe@427	4355 ( "matrix_b"["j"]["i"] ISNULL AND
jbe@411	4356 "j" < "i" ) )
jbe@170	4357 THEN
jbe@170	4358 -- someone else is better
jbe@170	4359 EXIT;
jbe@170	4360 END IF;
jbe@428	4361 IF "j" = "dimension_v" THEN
jbe@170	4362 -- noone is better
jbe@411	4363 "rank_ary"["i"] := "rank_v";
jbe@428	4364 EXIT assign_next_rank;
jbe@170	4365 END IF;
jbe@428	4366 "j" := "j" + 1;
jbe@170	4367 END LOOP;
jbe@170	4368 END IF;
jbe@0	4369 "i" := "i" + 1;
jbe@411	4370 IF "i" > "dimension_v" THEN
jbe@411	4371 RAISE EXCEPTION 'Schulze ranking does not compute (should not happen)';
jbe@411	4372 END IF;
jbe@0	4373 END LOOP;
jbe@411	4374 EXIT WHEN "rank_v" = "dimension_v";
jbe@170	4375 "rank_v" := "rank_v" + 1;
jbe@170	4376 END LOOP;
jbe@170	4377 -- write preliminary results:
jbe@411	4378 "i" := 2; -- omit status quo with "i" = 1
jbe@170	4379 FOR "initiative_id_v" IN
jbe@170	4380 SELECT "id" FROM "initiative"
jbe@170	4381 WHERE "issue_id" = "issue_id_p" AND "admitted"
jbe@170	4382 ORDER BY "id"
jbe@170	4383 LOOP
jbe@170	4384 UPDATE "initiative" SET
jbe@170	4385 "direct_majority" =
jbe@170	4386 CASE WHEN "policy_row"."direct_majority_strict" THEN
jbe@170	4387 "positive_votes" * "policy_row"."direct_majority_den" >
jbe@170	4388 "policy_row"."direct_majority_num" * ("positive_votes"+"negative_votes")
jbe@170	4389 ELSE
jbe@170	4390 "positive_votes" * "policy_row"."direct_majority_den" >=
jbe@170	4391 "policy_row"."direct_majority_num" * ("positive_votes"+"negative_votes")
jbe@170	4392 END
jbe@170	4393 AND "positive_votes" >= "policy_row"."direct_majority_positive"
jbe@170	4394 AND "issue_row"."voter_count"-"negative_votes" >=
jbe@170	4395 "policy_row"."direct_majority_non_negative",
jbe@170	4396 "indirect_majority" =
jbe@170	4397 CASE WHEN "policy_row"."indirect_majority_strict" THEN
jbe@170	4398 "positive_votes" * "policy_row"."indirect_majority_den" >
jbe@170	4399 "policy_row"."indirect_majority_num" * ("positive_votes"+"negative_votes")
jbe@170	4400 ELSE
jbe@170	4401 "positive_votes" * "policy_row"."indirect_majority_den" >=
jbe@170	4402 "policy_row"."indirect_majority_num" * ("positive_votes"+"negative_votes")
jbe@170	4403 END
jbe@170	4404 AND "positive_votes" >= "policy_row"."indirect_majority_positive"
jbe@170	4405 AND "issue_row"."voter_count"-"negative_votes" >=
jbe@170	4406 "policy_row"."indirect_majority_non_negative",
jbe@171	4407 "schulze_rank" = "rank_ary"["i"],
jbe@411	4408 "better_than_status_quo" = "rank_ary"["i"] < "rank_ary"[1],
jbe@411	4409 "worse_than_status_quo" = "rank_ary"["i"] > "rank_ary"[1],
jbe@411	4410 "multistage_majority" = "rank_ary"["i"] >= "rank_ary"[1],
jbe@429	4411 "reverse_beat_path" = CASE WHEN "policy_row"."defeat_strength" = 'simple'::"defeat_strength"
jbe@429	4412 THEN NULL
jbe@429	4413 ELSE "matrix_p"[1]["i"]."primary" >= 0 END,
jbe@216	4414 "eligible" = FALSE,
jbe@250	4415 "winner" = FALSE,
jbe@250	4416 "rank" = NULL -- NOTE: in cases of manual reset of issue state
jbe@170	4417 WHERE "id" = "initiative_id_v";
jbe@170	4418 "i" := "i" + 1;
jbe@170	4419 END LOOP;
jbe@411	4420 IF "i" != "dimension_v" + 1 THEN
jbe@170	4421 RAISE EXCEPTION 'Wrong winner count (should not happen)';
jbe@0	4422 END IF;
jbe@170	4423 -- take indirect majorities into account:
jbe@170	4424 LOOP
jbe@170	4425 UPDATE "initiative" SET "indirect_majority" = TRUE
jbe@139	4426 FROM (
jbe@170	4427 SELECT "new_initiative"."id" AS "initiative_id"
jbe@170	4428 FROM "initiative" "old_initiative"
jbe@170	4429 JOIN "initiative" "new_initiative"
jbe@170	4430 ON "new_initiative"."issue_id" = "issue_id_p"
jbe@170	4431 AND "new_initiative"."indirect_majority" = FALSE
jbe@139	4432 JOIN "battle" "battle_win"
jbe@139	4433 ON "battle_win"."issue_id" = "issue_id_p"
jbe@170	4434 AND "battle_win"."winning_initiative_id" = "new_initiative"."id"
jbe@170	4435 AND "battle_win"."losing_initiative_id" = "old_initiative"."id"
jbe@139	4436 JOIN "battle" "battle_lose"
jbe@139	4437 ON "battle_lose"."issue_id" = "issue_id_p"
jbe@170	4438 AND "battle_lose"."losing_initiative_id" = "new_initiative"."id"
jbe@170	4439 AND "battle_lose"."winning_initiative_id" = "old_initiative"."id"
jbe@170	4440 WHERE "old_initiative"."issue_id" = "issue_id_p"
jbe@170	4441 AND "old_initiative"."indirect_majority" = TRUE
jbe@170	4442 AND CASE WHEN "policy_row"."indirect_majority_strict" THEN
jbe@170	4443 "battle_win"."count" * "policy_row"."indirect_majority_den" >
jbe@170	4444 "policy_row"."indirect_majority_num" *
jbe@170	4445 ("battle_win"."count"+"battle_lose"."count")
jbe@170	4446 ELSE
jbe@170	4447 "battle_win"."count" * "policy_row"."indirect_majority_den" >=
jbe@170	4448 "policy_row"."indirect_majority_num" *
jbe@170	4449 ("battle_win"."count"+"battle_lose"."count")
jbe@170	4450 END
jbe@170	4451 AND "battle_win"."count" >= "policy_row"."indirect_majority_positive"
jbe@170	4452 AND "issue_row"."voter_count"-"battle_lose"."count" >=
jbe@170	4453 "policy_row"."indirect_majority_non_negative"
jbe@139	4454 ) AS "subquery"
jbe@139	4455 WHERE "id" = "subquery"."initiative_id";
jbe@170	4456 EXIT WHEN NOT FOUND;
jbe@170	4457 END LOOP;
jbe@170	4458 -- set "multistage_majority" for remaining matching initiatives:
jbe@216	4459 UPDATE "initiative" SET "multistage_majority" = TRUE
jbe@170	4460 FROM (
jbe@170	4461 SELECT "losing_initiative"."id" AS "initiative_id"
jbe@170	4462 FROM "initiative" "losing_initiative"
jbe@170	4463 JOIN "initiative" "winning_initiative"
jbe@170	4464 ON "winning_initiative"."issue_id" = "issue_id_p"
jbe@170	4465 AND "winning_initiative"."admitted"
jbe@170	4466 JOIN "battle" "battle_win"
jbe@170	4467 ON "battle_win"."issue_id" = "issue_id_p"
jbe@170	4468 AND "battle_win"."winning_initiative_id" = "winning_initiative"."id"
jbe@170	4469 AND "battle_win"."losing_initiative_id" = "losing_initiative"."id"
jbe@170	4470 JOIN "battle" "battle_lose"
jbe@170	4471 ON "battle_lose"."issue_id" = "issue_id_p"
jbe@170	4472 AND "battle_lose"."losing_initiative_id" = "winning_initiative"."id"
jbe@170	4473 AND "battle_lose"."winning_initiative_id" = "losing_initiative"."id"
jbe@170	4474 WHERE "losing_initiative"."issue_id" = "issue_id_p"
jbe@170	4475 AND "losing_initiative"."admitted"
jbe@170	4476 AND "winning_initiative"."schulze_rank" <
jbe@170	4477 "losing_initiative"."schulze_rank"
jbe@170	4478 AND "battle_win"."count" > "battle_lose"."count"
jbe@170	4479 AND (
jbe@170	4480 "battle_win"."count" > "winning_initiative"."positive_votes" OR
jbe@170	4481 "battle_lose"."count" < "losing_initiative"."negative_votes" )
jbe@170	4482 ) AS "subquery"
jbe@170	4483 WHERE "id" = "subquery"."initiative_id";
jbe@170	4484 -- mark eligible initiatives:
jbe@170	4485 UPDATE "initiative" SET "eligible" = TRUE
jbe@171	4486 WHERE "issue_id" = "issue_id_p"
jbe@171	4487 AND "initiative"."direct_majority"
jbe@171	4488 AND "initiative"."indirect_majority"
jbe@171	4489 AND "initiative"."better_than_status_quo"
jbe@171	4490 AND (
jbe@171	4491 "policy_row"."no_multistage_majority" = FALSE OR
jbe@429	4492 "initiative"."multistage_majority" = FALSE )
jbe@429	4493 AND (
jbe@429	4494 "policy_row"."no_reverse_beat_path" = FALSE OR
jbe@429	4495 coalesce("initiative"."reverse_beat_path", FALSE) = FALSE );
jbe@170	4496 -- mark final winner:
jbe@170	4497 UPDATE "initiative" SET "winner" = TRUE
jbe@170	4498 FROM (
jbe@170	4499 SELECT "id" AS "initiative_id"
jbe@170	4500 FROM "initiative"
jbe@170	4501 WHERE "issue_id" = "issue_id_p" AND "eligible"
jbe@217	4502 ORDER BY
jbe@217	4503 "schulze_rank",
jbe@217	4504 "id"
jbe@170	4505 LIMIT 1
jbe@170	4506 ) AS "subquery"
jbe@170	4507 WHERE "id" = "subquery"."initiative_id";
jbe@173	4508 -- write (final) ranks:
jbe@173	4509 "rank_v" := 1;
jbe@173	4510 FOR "initiative_id_v" IN
jbe@173	4511 SELECT "id"
jbe@173	4512 FROM "initiative"
jbe@173	4513 WHERE "issue_id" = "issue_id_p" AND "admitted"
jbe@174	4514 ORDER BY
jbe@174	4515 "winner" DESC,
jbe@217	4516 "eligible" DESC,
jbe@174	4517 "schulze_rank",
jbe@174	4518 "id"
jbe@173	4519 LOOP
jbe@173	4520 UPDATE "initiative" SET "rank" = "rank_v"
jbe@173	4521 WHERE "id" = "initiative_id_v";
jbe@173	4522 "rank_v" := "rank_v" + 1;
jbe@173	4523 END LOOP;
jbe@170	4524 -- set schulze rank of status quo and mark issue as finished:
jbe@111	4525 UPDATE "issue" SET
jbe@411	4526 "status_quo_schulze_rank" = "rank_ary"[1],
jbe@111	4527 "state" =
jbe@139	4528 CASE WHEN EXISTS (
jbe@139	4529 SELECT NULL FROM "initiative"
jbe@139	4530 WHERE "issue_id" = "issue_id_p" AND "winner"
jbe@139	4531 ) THEN
jbe@139	4532 'finished_with_winner'::"issue_state"
jbe@139	4533 ELSE
jbe@121	4534 'finished_without_winner'::"issue_state"
jbe@111	4535 END,
jbe@331	4536 "closed" = "phase_finished",
jbe@331	4537 "phase_finished" = NULL
jbe@0	4538 WHERE "id" = "issue_id_p";
jbe@0	4539 RETURN;
jbe@0	4540 END;
jbe@0	4541 $$;
jbe@0	4542
jbe@0	4543 COMMENT ON FUNCTION "calculate_ranks"
jbe@0	4544 ( "issue"."id"%TYPE )
jbe@0	4545 IS 'Determine ranking (Votes have to be counted first)';
jbe@0	4546
jbe@0	4547
jbe@0	4548
jbe@0	4549 -----------------------------
jbe@0	4550 -- Automatic state changes --
jbe@0	4551 -----------------------------
jbe@0	4552
jbe@0	4553
jbe@331	4554 CREATE TYPE "check_issue_persistence" AS (
jbe@331	4555 "state" "issue_state",
jbe@331	4556 "phase_finished" BOOLEAN,
jbe@331	4557 "issue_revoked" BOOLEAN,
jbe@331	4558 "snapshot_created" BOOLEAN,
jbe@331	4559 "harmonic_weights_set" BOOLEAN,
jbe@331	4560 "closed_voting" BOOLEAN );
jbe@331	4561
jbe@336	4562 COMMENT ON TYPE "check_issue_persistence" IS 'Type of data returned by "check_issue" function, to be passed to subsequent calls of the same function';
jbe@336	4563
jbe@336	4564
jbe@0	4565 CREATE FUNCTION "check_issue"
jbe@331	4566 ( "issue_id_p" "issue"."id"%TYPE,
jbe@331	4567 "persist" "check_issue_persistence" )
jbe@331	4568 RETURNS "check_issue_persistence"
jbe@0	4569 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	4570 DECLARE
jbe@336	4571 "issue_row" "issue"%ROWTYPE;
jbe@336	4572 "policy_row" "policy"%ROWTYPE;
jbe@336	4573 "initiative_row" "initiative"%ROWTYPE;
jbe@336	4574 "state_v" "issue_state";
jbe@0	4575 BEGIN
jbe@333	4576 PERFORM "require_transaction_isolation"();
jbe@331	4577 IF "persist" ISNULL THEN
jbe@331	4578 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
jbe@331	4579 FOR UPDATE;
jbe@331	4580 IF "issue_row"."closed" NOTNULL THEN
jbe@331	4581 RETURN NULL;
jbe@0	4582 END IF;
jbe@331	4583 "persist"."state" := "issue_row"."state";
jbe@331	4584 IF
jbe@331	4585 ( "issue_row"."state" = 'admission' AND now() >=
jbe@447	4586 "issue_row"."created" + "issue_row"."max_admission_time" ) OR
jbe@331	4587 ( "issue_row"."state" = 'discussion' AND now() >=
jbe@331	4588 "issue_row"."accepted" + "issue_row"."discussion_time" ) OR
jbe@331	4589 ( "issue_row"."state" = 'verification' AND now() >=
jbe@331	4590 "issue_row"."half_frozen" + "issue_row"."verification_time" ) OR
jbe@331	4591 ( "issue_row"."state" = 'voting' AND now() >=
jbe@331	4592 "issue_row"."fully_frozen" + "issue_row"."voting_time" )
jbe@331	4593 THEN
jbe@331	4594 "persist"."phase_finished" := TRUE;
jbe@331	4595 ELSE
jbe@331	4596 "persist"."phase_finished" := FALSE;
jbe@0	4597 END IF;
jbe@0	4598 IF
jbe@24	4599 NOT EXISTS (
jbe@24	4600 -- all initiatives are revoked
jbe@24	4601 SELECT NULL FROM "initiative"
jbe@24	4602 WHERE "issue_id" = "issue_id_p" AND "revoked" ISNULL
jbe@24	4603 ) AND (
jbe@111	4604 -- and issue has not been accepted yet
jbe@331	4605 "persist"."state" = 'admission' OR
jbe@331	4606 -- or verification time has elapsed
jbe@331	4607 ( "persist"."state" = 'verification' AND
jbe@331	4608 "persist"."phase_finished" ) OR
jbe@331	4609 -- or no initiatives have been revoked lately
jbe@24	4610 NOT EXISTS (
jbe@24	4611 SELECT NULL FROM "initiative"
jbe@24	4612 WHERE "issue_id" = "issue_id_p"
jbe@24	4613 AND now() < "revoked" + "issue_row"."verification_time"
jbe@24	4614 )
jbe@24	4615 )
jbe@24	4616 THEN
jbe@331	4617 "persist"."issue_revoked" := TRUE;
jbe@331	4618 ELSE
jbe@331	4619 "persist"."issue_revoked" := FALSE;
jbe@24	4620 END IF;
jbe@331	4621 IF "persist"."phase_finished" OR "persist"."issue_revoked" THEN
jbe@331	4622 UPDATE "issue" SET "phase_finished" = now()
jbe@331	4623 WHERE "id" = "issue_row"."id";
jbe@331	4624 RETURN "persist";
jbe@331	4625 ELSIF
jbe@331	4626 "persist"."state" IN ('admission', 'discussion', 'verification')
jbe@3	4627 THEN
jbe@331	4628 RETURN "persist";
jbe@331	4629 ELSE
jbe@331	4630 RETURN NULL;
jbe@322	4631 END IF;
jbe@0	4632 END IF;
jbe@331	4633 IF
jbe@331	4634 "persist"."state" IN ('admission', 'discussion', 'verification') AND
jbe@331	4635 coalesce("persist"."snapshot_created", FALSE) = FALSE
jbe@331	4636 THEN
jbe@331	4637 PERFORM "create_snapshot"("issue_id_p");
jbe@331	4638 "persist"."snapshot_created" = TRUE;
jbe@331	4639 IF "persist"."phase_finished" THEN
jbe@331	4640 IF "persist"."state" = 'admission' THEN
jbe@331	4641 PERFORM "set_snapshot_event"("issue_id_p", 'end_of_admission');
jbe@331	4642 ELSIF "persist"."state" = 'discussion' THEN
jbe@331	4643 PERFORM "set_snapshot_event"("issue_id_p", 'half_freeze');
jbe@331	4644 ELSIF "persist"."state" = 'verification' THEN
jbe@331	4645 PERFORM "set_snapshot_event"("issue_id_p", 'full_freeze');
jbe@336	4646 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p";
jbe@336	4647 SELECT * INTO "policy_row" FROM "policy"
jbe@336	4648 WHERE "id" = "issue_row"."policy_id";
jbe@336	4649 FOR "initiative_row" IN
jbe@336	4650 SELECT * FROM "initiative"
jbe@336	4651 WHERE "issue_id" = "issue_id_p" AND "revoked" ISNULL
jbe@336	4652 FOR UPDATE
jbe@336	4653 LOOP
jbe@336	4654 IF
jbe@336	4655 "initiative_row"."polling" OR (
jbe@336	4656 "initiative_row"."satisfied_supporter_count" > 0 AND
jbe@336	4657 "initiative_row"."satisfied_supporter_count" *
jbe@336	4658 "policy_row"."initiative_quorum_den" >=
jbe@336	4659 "issue_row"."population" * "policy_row"."initiative_quorum_num"
jbe@336	4660 )
jbe@336	4661 THEN
jbe@336	4662 UPDATE "initiative" SET "admitted" = TRUE
jbe@336	4663 WHERE "id" = "initiative_row"."id";
jbe@336	4664 ELSE
jbe@336	4665 UPDATE "initiative" SET "admitted" = FALSE
jbe@336	4666 WHERE "id" = "initiative_row"."id";
jbe@336	4667 END IF;
jbe@336	4668 END LOOP;
jbe@331	4669 END IF;
jbe@331	4670 END IF;
jbe@331	4671 RETURN "persist";
jbe@331	4672 END IF;
jbe@331	4673 IF
jbe@331	4674 "persist"."state" IN ('admission', 'discussion', 'verification') AND
jbe@331	4675 coalesce("persist"."harmonic_weights_set", FALSE) = FALSE
jbe@331	4676 THEN
jbe@331	4677 PERFORM "set_harmonic_initiative_weights"("issue_id_p");
jbe@331	4678 "persist"."harmonic_weights_set" = TRUE;
jbe@332	4679 IF
jbe@332	4680 "persist"."phase_finished" OR
jbe@332	4681 "persist"."issue_revoked" OR
jbe@332	4682 "persist"."state" = 'admission'
jbe@332	4683 THEN
jbe@331	4684 RETURN "persist";
jbe@331	4685 ELSE
jbe@331	4686 RETURN NULL;
jbe@331	4687 END IF;
jbe@331	4688 END IF;
jbe@331	4689 IF "persist"."issue_revoked" THEN
jbe@331	4690 IF "persist"."state" = 'admission' THEN
jbe@331	4691 "state_v" := 'canceled_revoked_before_accepted';
jbe@331	4692 ELSIF "persist"."state" = 'discussion' THEN
jbe@331	4693 "state_v" := 'canceled_after_revocation_during_discussion';
jbe@331	4694 ELSIF "persist"."state" = 'verification' THEN
jbe@331	4695 "state_v" := 'canceled_after_revocation_during_verification';
jbe@331	4696 END IF;
jbe@331	4697 UPDATE "issue" SET
jbe@331	4698 "state" = "state_v",
jbe@331	4699 "closed" = "phase_finished",
jbe@331	4700 "phase_finished" = NULL
jbe@332	4701 WHERE "id" = "issue_id_p";
jbe@331	4702 RETURN NULL;
jbe@331	4703 END IF;
jbe@331	4704 IF "persist"."state" = 'admission' THEN
jbe@336	4705 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
jbe@336	4706 FOR UPDATE;
jbe@336	4707 SELECT * INTO "policy_row"
jbe@336	4708 FROM "policy" WHERE "id" = "issue_row"."policy_id";
jbe@447	4709 IF
jbe@447	4710 ( now() >=
jbe@447	4711 "issue_row"."created" + "issue_row"."min_admission_time" ) AND
jbe@447	4712 EXISTS (
jbe@447	4713 SELECT NULL FROM "initiative"
jbe@447	4714 WHERE "issue_id" = "issue_id_p"
jbe@447	4715 AND "supporter_count" > 0
jbe@447	4716 AND "supporter_count" * "policy_row"."issue_quorum_den"
jbe@447	4717 >= "issue_row"."population" * "policy_row"."issue_quorum_num"
jbe@447	4718 )
jbe@447	4719 THEN
jbe@336	4720 UPDATE "issue" SET
jbe@336	4721 "state" = 'discussion',
jbe@336	4722 "accepted" = coalesce("phase_finished", now()),
jbe@336	4723 "phase_finished" = NULL
jbe@336	4724 WHERE "id" = "issue_id_p";
jbe@336	4725 ELSIF "issue_row"."phase_finished" NOTNULL THEN
jbe@336	4726 UPDATE "issue" SET
jbe@336	4727 "state" = 'canceled_issue_not_accepted',
jbe@336	4728 "closed" = "phase_finished",
jbe@336	4729 "phase_finished" = NULL
jbe@336	4730 WHERE "id" = "issue_id_p";
jbe@336	4731 END IF;
jbe@331	4732 RETURN NULL;
jbe@331	4733 END IF;
jbe@332	4734 IF "persist"."phase_finished" THEN
jbe@443	4735 IF "persist"."state" = 'discussion' THEN
jbe@332	4736 UPDATE "issue" SET
jbe@332	4737 "state" = 'verification',
jbe@332	4738 "half_frozen" = "phase_finished",
jbe@332	4739 "phase_finished" = NULL
jbe@332	4740 WHERE "id" = "issue_id_p";
jbe@332	4741 RETURN NULL;
jbe@332	4742 END IF;
jbe@332	4743 IF "persist"."state" = 'verification' THEN
jbe@336	4744 SELECT * INTO "issue_row" FROM "issue" WHERE "id" = "issue_id_p"
jbe@336	4745 FOR UPDATE;
jbe@336	4746 SELECT * INTO "policy_row" FROM "policy"
jbe@336	4747 WHERE "id" = "issue_row"."policy_id";
jbe@336	4748 IF EXISTS (
jbe@336	4749 SELECT NULL FROM "initiative"
jbe@336	4750 WHERE "issue_id" = "issue_id_p" AND "admitted" = TRUE
jbe@336	4751 ) THEN
jbe@336	4752 UPDATE "issue" SET
jbe@343	4753 "state" = 'voting',
jbe@343	4754 "fully_frozen" = "phase_finished",
jbe@336	4755 "phase_finished" = NULL
jbe@336	4756 WHERE "id" = "issue_id_p";
jbe@336	4757 ELSE
jbe@336	4758 UPDATE "issue" SET
jbe@343	4759 "state" = 'canceled_no_initiative_admitted',
jbe@343	4760 "fully_frozen" = "phase_finished",
jbe@343	4761 "closed" = "phase_finished",
jbe@343	4762 "phase_finished" = NULL
jbe@336	4763 WHERE "id" = "issue_id_p";
jbe@336	4764 -- NOTE: The following DELETE statements have effect only when
jbe@336	4765 -- issue state has been manipulated
jbe@336	4766 DELETE FROM "direct_voter" WHERE "issue_id" = "issue_id_p";
jbe@336	4767 DELETE FROM "delegating_voter" WHERE "issue_id" = "issue_id_p";
jbe@336	4768 DELETE FROM "battle" WHERE "issue_id" = "issue_id_p";
jbe@336	4769 END IF;
jbe@332	4770 RETURN NULL;
jbe@332	4771 END IF;
jbe@332	4772 IF "persist"."state" = 'voting' THEN
jbe@332	4773 IF coalesce("persist"."closed_voting", FALSE) = FALSE THEN
jbe@332	4774 PERFORM "close_voting"("issue_id_p");
jbe@332	4775 "persist"."closed_voting" = TRUE;
jbe@332	4776 RETURN "persist";
jbe@332	4777 END IF;
jbe@332	4778 PERFORM "calculate_ranks"("issue_id_p");
jbe@332	4779 RETURN NULL;
jbe@332	4780 END IF;
jbe@331	4781 END IF;
jbe@331	4782 RAISE WARNING 'should not happen';
jbe@331	4783 RETURN NULL;
jbe@0	4784 END;
jbe@0	4785 $$;
jbe@0	4786
jbe@0	4787 COMMENT ON FUNCTION "check_issue"
jbe@331	4788 ( "issue"."id"%TYPE,
jbe@331	4789 "check_issue_persistence" )
jbe@336	4790 IS 'Precalculate supporter counts etc. for a given issue, and check, if status change is required, and perform the status change when necessary; Function must be called multiple times with the previous result as second parameter, until the result is NULL (see source code of function "check_everything")';
jbe@0	4791
jbe@0	4792
jbe@0	4793 CREATE FUNCTION "check_everything"()
jbe@0	4794 RETURNS VOID
jbe@0	4795 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@0	4796 DECLARE
jbe@0	4797 "issue_id_v" "issue"."id"%TYPE;
jbe@331	4798 "persist_v" "check_issue_persistence";
jbe@0	4799 BEGIN
jbe@333	4800 RAISE WARNING 'Function "check_everything" should only be used for development and debugging purposes';
jbe@235	4801 DELETE FROM "expired_session";
jbe@184	4802 PERFORM "check_activity"();
jbe@4	4803 PERFORM "calculate_member_counts"();
jbe@4	4804 FOR "issue_id_v" IN SELECT "id" FROM "open_issue" LOOP
jbe@331	4805 "persist_v" := NULL;
jbe@331	4806 LOOP
jbe@331	4807 "persist_v" := "check_issue"("issue_id_v", "persist_v");
jbe@331	4808 EXIT WHEN "persist_v" ISNULL;
jbe@331	4809 END LOOP;
jbe@0	4810 END LOOP;
jbe@0	4811 RETURN;
jbe@0	4812 END;
jbe@0	4813 $$;
jbe@0	4814
jbe@336	4815 COMMENT ON FUNCTION "check_everything"() IS 'Amongst other regular tasks this function performs "check_issue" for every open issue. Use this function only for development and debugging purposes, as you may run into locking and/or serialization problems in productive environments.';
jbe@0	4816
jbe@0	4817
jbe@0	4818
jbe@59	4819 ----------------------
jbe@59	4820 -- Deletion of data --
jbe@59	4821 ----------------------
jbe@59	4822
jbe@59	4823
jbe@59	4824 CREATE FUNCTION "clean_issue"("issue_id_p" "issue"."id"%TYPE)
jbe@59	4825 RETURNS VOID
jbe@59	4826 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@59	4827 BEGIN
jbe@385	4828 IF EXISTS (
jbe@385	4829 SELECT NULL FROM "issue" WHERE "id" = "issue_id_p" AND "cleaned" ISNULL
jbe@385	4830 ) THEN
jbe@385	4831 -- override protection triggers:
jbe@385	4832 INSERT INTO "temporary_transaction_data" ("key", "value")
jbe@385	4833 VALUES ('override_protection_triggers', TRUE::TEXT);
jbe@385	4834 -- clean data:
jbe@59	4835 DELETE FROM "delegating_voter"
jbe@59	4836 WHERE "issue_id" = "issue_id_p";
jbe@59	4837 DELETE FROM "direct_voter"
jbe@59	4838 WHERE "issue_id" = "issue_id_p";
jbe@59	4839 DELETE FROM "delegating_interest_snapshot"
jbe@59	4840 WHERE "issue_id" = "issue_id_p";
jbe@59	4841 DELETE FROM "direct_interest_snapshot"
jbe@59	4842 WHERE "issue_id" = "issue_id_p";
jbe@59	4843 DELETE FROM "delegating_population_snapshot"
jbe@59	4844 WHERE "issue_id" = "issue_id_p";
jbe@59	4845 DELETE FROM "direct_population_snapshot"
jbe@59	4846 WHERE "issue_id" = "issue_id_p";
jbe@113	4847 DELETE FROM "non_voter"
jbe@94	4848 WHERE "issue_id" = "issue_id_p";
jbe@59	4849 DELETE FROM "delegation"
jbe@59	4850 WHERE "issue_id" = "issue_id_p";
jbe@59	4851 DELETE FROM "supporter"
jbe@329	4852 USING "initiative" -- NOTE: due to missing index on issue_id
jbe@325	4853 WHERE "initiative"."issue_id" = "issue_id_p"
jbe@325	4854 AND "supporter"."initiative_id" = "initiative_id";
jbe@385	4855 -- mark issue as cleaned:
jbe@385	4856 UPDATE "issue" SET "cleaned" = now() WHERE "id" = "issue_id_p";
jbe@385	4857 -- finish overriding protection triggers (avoids garbage):
jbe@385	4858 DELETE FROM "temporary_transaction_data"
jbe@385	4859 WHERE "key" = 'override_protection_triggers';
jbe@59	4860 END IF;
jbe@59	4861 RETURN;
jbe@59	4862 END;
jbe@59	4863 $$;
jbe@59	4864
jbe@59	4865 COMMENT ON FUNCTION "clean_issue"("issue"."id"%TYPE) IS 'Delete discussion data and votes belonging to an issue';
jbe@8	4866
jbe@8	4867
jbe@54	4868 CREATE FUNCTION "delete_member"("member_id_p" "member"."id"%TYPE)
jbe@8	4869 RETURNS VOID
jbe@8	4870 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@8	4871 BEGIN
jbe@9	4872 UPDATE "member" SET
jbe@57	4873 "last_login" = NULL,
jbe@387	4874 "last_delegation_check" = NULL,
jbe@45	4875 "login" = NULL,
jbe@11	4876 "password" = NULL,
jbe@441	4877 "authority" = NULL,
jbe@441	4878 "authority_uid" = NULL,
jbe@441	4879 "authority_login" = NULL,
jbe@101	4880 "locked" = TRUE,
jbe@54	4881 "active" = FALSE,
jbe@11	4882 "notify_email" = NULL,
jbe@11	4883 "notify_email_unconfirmed" = NULL,
jbe@11	4884 "notify_email_secret" = NULL,
jbe@11	4885 "notify_email_secret_expiry" = NULL,
jbe@57	4886 "notify_email_lock_expiry" = NULL,
jbe@387	4887 "login_recovery_expiry" = NULL,
jbe@11	4888 "password_reset_secret" = NULL,
jbe@11	4889 "password_reset_secret_expiry" = NULL,
jbe@11	4890 "organizational_unit" = NULL,
jbe@11	4891 "internal_posts" = NULL,
jbe@11	4892 "realname" = NULL,
jbe@11	4893 "birthday" = NULL,
jbe@11	4894 "address" = NULL,
jbe@11	4895 "email" = NULL,
jbe@11	4896 "xmpp_address" = NULL,
jbe@11	4897 "website" = NULL,
jbe@11	4898 "phone" = NULL,
jbe@11	4899 "mobile_phone" = NULL,
jbe@11	4900 "profession" = NULL,
jbe@11	4901 "external_memberships" = NULL,
jbe@11	4902 "external_posts" = NULL,
jbe@45	4903 "statement" = NULL
jbe@45	4904 WHERE "id" = "member_id_p";
jbe@11	4905 -- "text_search_data" is updated by triggers
jbe@45	4906 DELETE FROM "setting" WHERE "member_id" = "member_id_p";
jbe@45	4907 DELETE FROM "setting_map" WHERE "member_id" = "member_id_p";
jbe@45	4908 DELETE FROM "member_relation_setting" WHERE "member_id" = "member_id_p";
jbe@45	4909 DELETE FROM "member_image" WHERE "member_id" = "member_id_p";
jbe@45	4910 DELETE FROM "contact" WHERE "member_id" = "member_id_p";
jbe@113	4911 DELETE FROM "ignored_member" WHERE "member_id" = "member_id_p";
jbe@235	4912 DELETE FROM "session" WHERE "member_id" = "member_id_p";
jbe@45	4913 DELETE FROM "area_setting" WHERE "member_id" = "member_id_p";
jbe@45	4914 DELETE FROM "issue_setting" WHERE "member_id" = "member_id_p";
jbe@113	4915 DELETE FROM "ignored_initiative" WHERE "member_id" = "member_id_p";
jbe@45	4916 DELETE FROM "initiative_setting" WHERE "member_id" = "member_id_p";
jbe@45	4917 DELETE FROM "suggestion_setting" WHERE "member_id" = "member_id_p";
jbe@54	4918 DELETE FROM "membership" WHERE "member_id" = "member_id_p";
jbe@54	4919 DELETE FROM "delegation" WHERE "truster_id" = "member_id_p";
jbe@113	4920 DELETE FROM "non_voter" WHERE "member_id" = "member_id_p";
jbe@57	4921 DELETE FROM "direct_voter" USING "issue"
jbe@57	4922 WHERE "direct_voter"."issue_id" = "issue"."id"
jbe@57	4923 AND "issue"."closed" ISNULL
jbe@57	4924 AND "member_id" = "member_id_p";
jbe@45	4925 RETURN;
jbe@45	4926 END;
jbe@45	4927 $$;
jbe@45	4928
jbe@57	4929 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)';
jbe@45	4930
jbe@45	4931
jbe@45	4932 CREATE FUNCTION "delete_private_data"()
jbe@45	4933 RETURNS VOID
jbe@45	4934 LANGUAGE 'plpgsql' VOLATILE AS $$
jbe@45	4935 BEGIN
jbe@385	4936 DELETE FROM "temporary_transaction_data";
jbe@226	4937 DELETE FROM "member" WHERE "activated" ISNULL;
jbe@50	4938 UPDATE "member" SET
jbe@206	4939 "invite_code" = NULL,
jbe@232	4940 "invite_code_expiry" = NULL,
jbe@228	4941 "admin_comment" = NULL,
jbe@57	4942 "last_login" = NULL,
jbe@387	4943 "last_delegation_check" = NULL,
jbe@50	4944 "login" = NULL,
jbe@50	4945 "password" = NULL,
jbe@441	4946 "authority" = NULL,
jbe@441	4947 "authority_uid" = NULL,
jbe@441	4948 "authority_login" = NULL,
jbe@238	4949 "lang" = NULL,
jbe@50	4950 "notify_email" = NULL,
jbe@50	4951 "notify_email_unconfirmed" = NULL,
jbe@50	4952 "notify_email_secret" = NULL,
jbe@50	4953 "notify_email_secret_expiry" = NULL,
jbe@57	4954 "notify_email_lock_expiry" = NULL,
jbe@238	4955 "notify_level" = NULL,
jbe@387	4956 "login_recovery_expiry" = NULL,
jbe@50	4957 "password_reset_secret" = NULL,
jbe@50	4958 "password_reset_secret_expiry" = NULL,
jbe@50	4959 "organizational_unit" = NULL,
jbe@50	4960 "internal_posts" = NULL,
jbe@50	4961 "realname" = NULL,
jbe@50	4962 "birthday" = NULL,
jbe@50	4963 "address" = NULL,
jbe@50	4964 "email" = NULL,
jbe@50	4965 "xmpp_address" = NULL,
jbe@50	4966 "website" = NULL,
jbe@50	4967 "phone" = NULL,
jbe@50	4968 "mobile_phone" = NULL,
jbe@50	4969 "profession" = NULL,
jbe@50	4970 "external_memberships" = NULL,
jbe@50	4971 "external_posts" = NULL,
jbe@238	4972 "formatting_engine" = NULL,
jbe@50	4973 "statement" = NULL;
jbe@50	4974 -- "text_search_data" is updated by triggers
jbe@50	4975 DELETE FROM "setting";
jbe@50	4976 DELETE FROM "setting_map";
jbe@50	4977 DELETE FROM "member_relation_setting";
jbe@50	4978 DELETE FROM "member_image";
jbe@50	4979 DELETE FROM "contact";
jbe@113	4980 DELETE FROM "ignored_member";
jbe@235	4981 DELETE FROM "session";
jbe@50	4982 DELETE FROM "area_setting";
jbe@50	4983 DELETE FROM "issue_setting";
jbe@113	4984 DELETE FROM "ignored_initiative";
jbe@50	4985 DELETE FROM "initiative_setting";
jbe@50	4986 DELETE FROM "suggestion_setting";
jbe@113	4987 DELETE FROM "non_voter";
jbe@8	4988 DELETE FROM "direct_voter" USING "issue"
jbe@8	4989 WHERE "direct_voter"."issue_id" = "issue"."id"
jbe@8	4990 AND "issue"."closed" ISNULL;
jbe@8	4991 RETURN;
jbe@8	4992 END;
jbe@8	4993 $$;
jbe@8	4994
jbe@273	4995 COMMENT ON FUNCTION "delete_private_data"() IS 'Used by lf_export script. DO NOT USE on productive database, but only on a copy! This function deletes all data which should not be publicly available, and can be used to create a database dump for publication. See source code to see which data is deleted. If you need a different behaviour, copy this function and modify lf_export accordingly, to avoid data-leaks after updating.';
jbe@8	4996
jbe@8	4997
jbe@8	4998
jbe@0	4999 COMMIT;