liquid_feedback_core

annotate core.sql @ 520:053190248598

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

Impressum / About Us