sql/debbugs_schema.sql

   1
   2 DROP TABLE bug_severity CASCADE;
   3 DROP TABLE bug_tag CASCADE;
   4 DROP TABLE tag CASCADE;
   5 DROP TABLE severity CASCADE;
   6 DROP TABLE bug CASCADE;
   7 DROP TABLE src_pkg CASCADE;
   8 DROP TABLE bug_ver CASCADE;
   9 DROP TABLE src_pkg_alias CASCADE;
  10 DROP TABLE src_ver CASCADE;
  11 DROP TABLE arch CASCADE;
  12 DROP TABLE bin_ver CASCADE;
  13 DROP TABLE bin_pkg CASCADE;
  14 DROP TABLE bug_blocks CASCADE;
  15 DROP TABLE bug_merged CASCADE;
  16 DROP VIEW bug_package CASCADE;
  17 DROP TABLE bug_srcpackage CASCADE;
  18 DROP TABLE bug_binpackage CASCADE;
  19 DROP VIEW  bug_package CASCADE;
  20 DROP VIEW binary_versions CASCADE;
  21 DROP TABLE suite CASCADE;
  22 DROP TABLE bin_associations CASCADE;
  23 DROP TABLE src_associations CASCADE;
  24 DROP TABLE maintainer CASCADE;
  25 DROP TABLE bug_message CASCADE;
  26 DROP TABLE message_correspondent CASCADE;
  27 DROP TABLE bug_submitter CASCADE;
  28 DROP TABLE bug_done_by CASCADE;
  29 DROP TABLE correspondent_full_name CASCADE;
  30 DROP TABLE correspondent CASCADE;
  31 DROP TABLE message_refs CASCADE;
  32 DROP TABLE message CASCADE;
  33 DROP TYPE message_correspondent_type CASCADE;
  34 DROP TABLE table_comments CASCADE;
  35 DROP TABLE column_comments CASCADE;
  36
  37 -- the following two tables are used to provide documentation about
  38 -- the tables and columns for DBIx::Class::Schema::Loader
  39 CREATE TABLE table_comments (
  40        table_name TEXT UNIQUE NOT NULL,
  41        comment_text TEXT NOT NULL
  42 );
  43 CREATE TABLE column_comments (
  44        table_name TEXT  NOT NULL,
  45        column_name TEXT  NOT NULL,
  46        comment_text TEXT NOT NULL
  47 );
  48 CREATE UNIQUE INDEX ON column_comments(table_name,column_name);
  49
  50 CREATE TABLE maintainer (
  51        id SERIAL PRIMARY KEY,
  52        name TEXT NOT NULL UNIQUE,
  53        created TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL,
  54        modified TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL
  55 );
  56 INSERT INTO table_comments  VALUES ('maintainer','Package maintainer names');
  57 INSERT INTO column_comments VALUES ('maintainer','id','Package maintainer id');
  58 INSERT INTO column_comments VALUES ('maintainer','name','Name of package maintainer');
  59 INSERT INTO column_comments VALUES ('maintainer','created','Time maintainer record created');
  60 INSERT INTO column_comments VALUES ('maintainer','modified','Time maintainer record modified');
  61
  62 -- bugs table
  63 CREATE TABLE bug (
  64        id INTEGER NOT NULL PRIMARY KEY,
  65        creation TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
  66        log_modified TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
  67        last_modified TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
  68        archived BOOLEAN NOT NULL DEFAULT FALSE,
  69        unarchived TIMESTAMP WITH TIME ZONE,
  70        forwarded TEXT NOT NULL DEFAULT '',
  71        summary TEXT NOT NULL DEFAULT '',
  72        outlook TEXT NOT NULL DEFAULT '',
  73        subject TEXT NOT NULL,
  74        done TEXT NOT NULL DEFAULT '',
  75        owner TEXT NOT NULL DEFAULT '',
  76        submitter TEXT NOT NULL DEFAULT '',
  77        unknown_packages TEXT NOT NULL DEfAULT ''
  78 );
  79 INSERT INTO table_comments VALUES ('bug','Bugs');
  80 INSERT INTO column_comments VALUES ('bug','id','Bug number');
  81 INSERT INTO column_comments VALUES ('bug','creation','Time bug created');
  82 INSERT INTO column_comments VALUES ('bug','log_modified','Time bug log was last modified');
  83 INSERT INTO column_comments VALUES ('bug','last_modified','Time bug status was last modified');
  84 INSERT INTO column_comments VALUES ('bug','archived','True if bug has been archived');
  85 INSERT INTO column_comments VALUES ('bug','unarchived','Time bug was last unarchived; null if bug has never been unarchived');
  86 INSERT INTO column_comments VALUES ('bug','forwarded','Where bug has been forwarded to; empty if it has not been forwarded');
  87 INSERT INTO column_comments VALUES ('bug','summary','Summary of the bug; empty if it has no summary');
  88 INSERT INTO column_comments VALUES ('bug','outlook','Outlook of the bug; empty if it has no outlook');
  89 INSERT INTO column_comments VALUES ('bug','subject','Subject of the bug');
  90 INSERT INTO column_comments VALUES ('bug','done','Individual who did the -done; empty if it has never been -done');
  91 INSERT INTO column_comments VALUES ('bug','owner','Individual who owns this bug; empty if no one owns it');
  92 INSERT INTO column_comments VALUES ('bug','submitter','Individual who submitted this bug; empty if there is no submitter');
  93 INSERT INTO column_comments VALUES ('bug','unknown_packages','Package name if the package is not known');
  94
  95
  96
  97 CREATE TABLE bug_blocks (
  98        id SERIAL PRIMARY KEY,
  99        bug INT NOT NULL REFERENCES bug,
 100        blocks INT NOT NULL REFERENCES bug,
 101        CONSTRAINT bug_doesnt_block_itself CHECK (bug <> blocks)
 102 );
 103 CREATE UNIQUE INDEX bug_blocks_bug_id_blocks_idx ON bug_blocks(bug,blocks);
 104 CREATE INDEX bug_blocks_bug_id_idx ON bug_blocks(bug);
 105 CREATE INDEX bug_blocks_blocks_idx ON bug_blocks(blocks);
 106 INSERT INTO table_comments VALUES ('bug_blocks','Bugs which block other bugs');
 107 INSERT INTO column_comments VALUES ('bug_blocks','bug','Bug number');
 108 INSERT INTO column_comments VALUES ('bug_blocks','blocks','Bug number which is blocked by bug');
 109
 110
 111 CREATE TABLE bug_merged (
 112        id SERIAL PRIMARY KEY,
 113        bug INT NOT NULL REFERENCES bug,
 114        merged INT NOT NULL REFERENCES bug,
 115        CONSTRAINT bug_doesnt_merged_itself CHECK (bug <> merged)
 116 );
 117 CREATE UNIQUE INDEX bug_merged_bug_id_merged_idx ON bug_merged(bug,merged);
 118 CREATE INDEX bug_merged_bug_id_idx ON bug_merged(bug);
 119 CREATE INDEX bug_merged_merged_idx ON bug_merged(merged);
 120 INSERT INTO table_comments  VALUES ('bug_merged','Bugs which are merged with other bugs');
 121 INSERT INTO column_comments VALUES ('bug_merged','bug','Bug number');
 122 INSERT INTO column_comments VALUES ('bug_merged','merged','Bug number which is merged with bug');
 123
 124 CREATE TABLE src_pkg (
 125        id SERIAL PRIMARY KEY,
 126        pkg TEXT NOT NULL UNIQUE,
 127        pseduopkg BOOLEAN DEFAULT FALSE,
 128        alias_of INT REFERENCES src_pkg ON UPDATE CASCADE ON DELETE CASCADE
 129        CONSTRAINT src_pkg_doesnt_alias_itself CHECK (id <> alias_of)
 130 );
 131 INSERT INTO table_comments VALUES ('src_pkg','Source packages');
 132 INSERT INTO column_comments VALUES ('src_pkg','id','Source package id');
 133 INSERT INTO column_comments VALUES ('src_pkg','pkg','Source package name');
 134 INSERT INTO column_comments VALUES ('src_pkg','pseudopkg','True if this is a pseudo package');
 135 INSERT INTO column_comments VALUES ('src_pkg','alias_of','Source package id which this source package is an alias of');
 136
 137
 138
 139 CREATE TABLE src_ver (
 140        id SERIAL PRIMARY KEY,
 141        src_pkg INT NOT NULL REFERENCES src_pkg
 142             ON UPDATE CASCADE ON DELETE CASCADE,
 143        ver public.debversion NOT NULL,
 144        maintainer_id INT REFERENCES maintainer
 145             ON UPDATE CASCADE ON DELETE SET NULL,
 146        upload_date TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
 147        based_on INT REFERENCES src_ver
 148             ON UPDATE CASCADE ON DELETE CASCADE
 149 );
 150 CREATE UNIQUE INDEX src_ver_src_pkg_id_ver ON src_ver(src_pkg,ver);
 151 INSERT INTO table_comments VALUES ('src_ver','Source Package versions');
 152 INSERT INTO column_comments VALUES ('src_ver','id','Source package version id');
 153 INSERT INTO column_comments VALUES ('src_ver','src_pkg','Source package id (matches src_pkg table)');
 154 INSERT INTO column_comments VALUES ('src_ver','ver','Version of the source package');
 155 INSERT INTO column_comments VALUES ('src_ver','maintainer_id','Maintainer id (matches maintainer table)');
 156 INSERT INTO column_comments VALUES ('src_ver','upload_date','Date this version of the source package was uploaded');
 157 INSERT INTO column_comments VALUES ('src_ver','based_on','Source package version this version is based on');
 158
 159
 160
 161 CREATE TABLE bug_ver (
 162        bug INT NOT NULL REFERENCES bug
 163          ON UPDATE CASCADE ON DELETE RESTRICT,
 164        ver_string TEXT,
 165        src_pkg INT REFERENCES src_pkg
 166             ON UPDATE CASCADE ON DELETE SET NULL,
 167        src_ver_id INT REFERENCES src_ver
 168             ON UPDATE CASCADE ON DELETE SET NULL,
 169        found BOOLEAN NOT NULL DEFAULT TRUE,
 170        creation TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
 171        last_modified TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW()
 172 );
 173 CREATE INDEX bug_ver_src_pkg_id_idx ON bug_ver(src_pkg);
 174 CREATE INDEX bug_ver_src_pkg_id_src_ver_id_idx ON bug_ver(src_pkg,src_ver_id);
 175 CREATE INDEX bug_ver_src_ver_id_idx ON bug_ver(src_ver_id);
 176 CREATE UNIQUE INDEX ON bug_ver(bug,ver_string,found);
 177 INSERT INTO table_comments VALUES ('bug_ver','Bug versions');
 178 INSERT INTO column_comments VALUES ('bug_ver','bug','Bug number');
 179 INSERT INTO column_comments VALUES ('bug_ver','ver_string','Version string');
 180 INSERT INTO column_comments VALUES ('bug_ver','src_pkg','Source package id (matches src_pkg table)');
 181 INSERT INTO column_comments VALUES ('bug_ver','src_ver_id','Source package version id (matches src_ver table)');
 182 INSERT INTO column_comments VALUES ('bug_ver','found','True if this is a found version; false if this is a fixed version');
 183 INSERT INTO column_comments VALUES ('bug_ver','creation','Time that this entry was created');
 184 INSERT INTO column_comments VALUES ('bug_ver','last_modified','Time that this entry was modified');
 185
 186
 187 CREATE TABLE arch (
 188        id SERIAL PRIMARY KEY,
 189        arch TEXT NOT NULL UNIQUE
 190 );
 191 INSERT INTO table_comments VALUES ('arch','Architectures');
 192 INSERT INTO column_comments VALUES ('arch','id','Architecture id');
 193 INSERT INTO column_comments VALUES ('arch','arch','Architecture name');
 194
 195
 196 CREATE TABLE bin_pkg (
 197        id SERIAL PRIMARY KEY,
 198        pkg TEXT NOT NULL UNIQUE
 199 );
 200 INSERT INTO table_comments VALUES ('bin_pkg','Binary packages');
 201 INSERT INTO column_comments VALUES ('bin_pkg','id','Binary package id');
 202 INSERT INTO column_comments VALUES ('bin_pkg','pkg','Binary package name');
 203
 204
 205 CREATE TABLE bin_ver(
 206        id SERIAL PRIMARY KEY,
 207        bin_pkg INT NOT NULL REFERENCES bin_pkg
 208             ON UPDATE CASCADE ON DELETE CASCADE,
 209        src_ver_id INT NOT NULL REFERENCES src_ver
 210             ON UPDATE CASCADE ON DELETE CASCADE,
 211        arch_id INT NOT NULL REFERENCES arch
 212             ON UPDATE CASCADE ON DELETE CASCADE,
 213        ver public.debversion NOT NULL
 214 );
 215 CREATE INDEX bin_ver_ver_idx ON bin_ver(ver);
 216 CREATE UNIQUE INDEX bin_ver_bin_pkg_id_arch_idx ON bin_ver(bin_pkg,arch_id,ver);
 217 CREATE UNIQUE INDEX bin_ver_src_ver_id_arch_idx ON bin_ver(src_ver_id,arch_id);
 218 CREATE INDEX bin_ver_bin_pkg_id_idx ON bin_ver(bin_pkg);
 219 CREATE INDEX bin_ver_src_ver_id_idx ON bin_ver(src_ver_id);
 220 INSERT INTO table_comments VALUES ('bin_ver','Binary versions');
 221 INSERT INTO column_comments VALUES ('bin_ver','id','Binary version id');
 222 INSERT INTO column_comments VALUES ('bin_ver','bin_pkg','Binary package id (matches bin_pkg)');
 223 INSERT INTO column_comments VALUES ('bin_ver','src_ver_id','Source version (matchines src_ver)');
 224 INSERT INTO column_comments VALUES ('bin_ver','arch_id','Architecture id (matches arch)');
 225 INSERT INTO column_comments VALUES ('bin_ver','ver','Binary version');
 226
 227 CREATE TABLE tag (
 228        id SERIAL PRIMARY KEY,
 229        tag TEXT NOT NULL UNIQUE,
 230        obsolete BOOLEAN DEFAULT FALSE
 231 );
 232 INSERT INTO table_comments VALUES ('tag','Bug tags');
 233 INSERT INTO column_comments VALUES ('tag','id','Tag id');
 234 INSERT INTO column_comments VALUES ('tag','tag','Tag name');
 235 INSERT INTO column_comments VALUES ('tag','obsolete','Whether a tag is obsolete (should not be set on new bugs)');
 236
 237 CREATE TABLE bug_tag (
 238        id SERIAL PRIMARY KEY,
 239        bug INT NOT NULL REFERENCES bug,
 240        tag_id INT NOT NULL REFERENCES tag
 241 );
 242 INSERT INTO table_comments VALUES ('bug_tag','Bug <-> tag mapping');
 243 INSERT INTO column_comments VALUES ('bug_tag','bug','Bug id (matches bug)');
 244 INSERT INTO column_comments VALUES ('bug_tag','tag_id','Tag id (matches tag)');
 245
 246 CREATE UNIQUE INDEX bug_tag_bug_tag_id ON bug_tag (bug,tag_id);
 247 CREATE INDEX bug_tag_tag_id ON bug_tag (tag_id);
 248 CREATE INDEX bug_tag_bug_id ON bug_tag (bug);
 249
 250
 251 CREATE TABLE severity (
 252        id SERIAL PRIMARY KEY,
 253        severity TEXT NOT NULL UNIQUE,
 254        ordering INT NOT NULL DEFAULT 5,
 255        strong BOOLEAN DEFAULT FALSE,
 256        obsolete BOOLEAN DEFAULT FALSE
 257 );
 258 INSERT INTO table_comments VALUES ('severity','Bug severity');
 259 INSERT INTO column_comments VALUES ('severity','id','Severity id');
 260 INSERT INTO column_comments VALUES ('severity','severity','Severity name');
 261 INSERT INTO column_comments VALUES ('severity','ordering','Severity ordering (more severe severities have higher numbers)');
 262 INSERT INTO column_comments VALUES ('severity','strong','True if severity is a strong severity');
 263 INSERT INTO column_comments VALUES ('severity','obsolete','Whether a severity level is obsolete (should not be set on new bugs)');
 264
 265 CREATE TABLE bug_severity(
 266        bug INT PRIMARY KEY REFERENCES bug,
 267        severity_id INT NOT NULL REFERENCES severity
 268 );
 269 INSERT INTO table_comments VALUES ('bug_severity','Bug <-> tag mapping');
 270 INSERT INTO column_comments VALUES ('bug_severity','bug','Bug id (matches bug)');
 271 INSERT INTO column_comments VALUES ('bug_severity','severity_id','Severity id (matches severity)');
 272
 273 CREATE TABLE bug_binpackage (
 274        id SERIAL PRIMARY KEY,
 275        bug INT NOT NULL REFERENCES bug,
 276        bin_pkg INT NOT NULL REFERENCES bin_pkg
 277 );
 278 CREATE UNIQUE INDEX bug_binpackage_id_pkg_id ON bug_binpackage(bug,bin_pkg);
 279 INSERT INTO table_comments VALUES ('bug_binpackage','Bug <-> binary package mapping');
 280 INSERT INTO column_comments VALUES ('bug_binpackage','bug','Bug id (matches bug)');
 281 INSERT INTO column_comments VALUES ('bug_binpackage','bin_pkg','Binary package id (matches bin_pkg)');
 282
 283 CREATE TABLE bug_srcpackage (
 284        id SERIAL PRIMARY KEY,
 285        bug INT NOT NULL REFERENCES bug,
 286        src_pkg INT NOT NULL REFERENCES src_pkg ON UPDATE CASCADE ON DELETE CASCADE
 287 );
 288 CREATE UNIQUE INDEX bug_srcpackage_id_pkg_id ON bug_srcpackage(bug,src_pkg);
 289 INSERT INTO table_comments VALUES ('bug_srcpackage','Bug <-> source package mapping');
 290 INSERT INTO column_comments VALUES ('bug_srcpackage','bug','Bug id (matches bug)');
 291 INSERT INTO column_comments VALUES ('bug_srcpackage','src_pkg','Source package id (matches src_pkg)');
 292
 293 CREATE VIEW bug_package (bug,pkg_id,pkg_type,package) AS
 294        SELECT b.bug,b.bin_pkg,'binary',bp.pkg FROM bug_binpackage b JOIN bin_pkg bp ON bp.id=b.bin_pkg UNION
 295               SELECT s.bug,s.src_pkg,'source',sp.pkg FROM bug_srcpackage s JOIN src_pkg sp ON sp.id=s.src_pkg;
 296
 297 CREATE VIEW binary_versions (src_pkg, src_ver, bin_pkg, arch, bin_ver) AS
 298        SELECT sp.pkg AS src_pkg, sv.ver AS src_ver, bp.pkg AS bin_pkg, a.arch AS arch, b.ver AS bin_ver,
 299        svb.ver AS src_ver_based_on, spb.pkg AS src_pkg_based_on
 300        FROM bin_ver b JOIN arch a ON b.arch_id = a.id
 301                       JOIN bin_pkg bp ON b.bin_pkg  = bp.id
 302                       JOIN src_ver sv ON b.src_ver_id  = sv.id
 303                       JOIN src_pkg sp ON sv.src_pkg = sp.id
 304                       LEFT OUTER JOIN src_ver svb ON sv.based_on = svb.id
 305                       LEFT OUTER JOIN src_pkg spb ON spb.id = svb.src_pkg;
 306
 307 CREATE TABLE suite (
 308        id SERIAL PRIMARY KEY,
 309        suite_name TEXT NOT NULL UNIQUE,
 310        version TEXT,
 311        codename TEXT,
 312        active BOOLEAN DEFAULT TRUE);
 313 CREATE INDEX ON suite(codename);
 314 CREATE INDEX ON suite(version);
 315 INSERT INTO table_comments VALUES ('suite','Debian Release Suite (stable, testing, etc.)');
 316 INSERT INTO column_comments VALUES ('suite','id','Suite id');
 317 INSERT INTO column_comments VALUES ('suite','suite_name','Suite name');
 318 INSERT INTO column_comments VALUES ('suite','version','Suite version; NULL if there is no appropriate version');
 319 INSERT INTO column_comments VALUES ('suite','codename','Suite codename');
 320 INSERT INTO column_comments VALUES ('suite','active','TRUE if the suite is still accepting uploads');
 321
 322 CREATE TABLE bin_associations (
 323        id SERIAL PRIMARY KEY,
 324        suite INT NOT NULL REFERENCES suite ON DELETE CASCADE ON UPDATE CASCADE,
 325        bin INT NOT NULL REFERENCES bin_ver ON DELETE CASCADE ON UPDATE CASCADE,
 326        created TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL,
 327        modified TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL
 328 );
 329 INSERT INTO table_comments VALUES ('bin_associations','Binary <-> suite associations');
 330 INSERT INTO column_comments VALUES ('bin_associations','id','Binary <-> suite association id');
 331 INSERT INTO column_comments VALUES ('bin_associations','suite','Suite id (matches suite)');
 332 INSERT INTO column_comments VALUES ('bin_associations','bin','Binary version id (matches bin_ver)');
 333 INSERT INTO column_comments VALUES ('bin_associations','created','Time this binary package entered this suite');
 334 INSERT INTO column_comments VALUES ('bin_associations','modified','Time this entry was modified');
 335
 336 CREATE TABLE src_associations (
 337        id SERIAL PRIMARY KEY,
 338        suite INT NOT NULL REFERENCES suite ON DELETE CASCADE ON UPDATE CASCADE,
 339        source INT NOT NULL REFERENCES src_ver ON DELETE CASCADE ON UPDATE CASCADE,
 340        created TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL,
 341        modified TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL
 342 );
 343 INSERT INTO table_comments VALUES ('src_associations','Source <-> suite associations');
 344 INSERT INTO column_comments VALUES ('src_associations','id','Source <-> suite association id');
 345 INSERT INTO column_comments VALUES ('src_associations','suite','Suite id (matches suite)');
 346 INSERT INTO column_comments VALUES ('src_associations','source','Source version id (matches src_ver)');
 347 INSERT INTO column_comments VALUES ('src_associations','created','Time this source package entered this suite');
 348 INSERT INTO column_comments VALUES ('src_associations','modified','Time this entry was modified');
 349
 350 CREATE TABLE message (
 351        id SERIAL PRIMARY KEY,
 352        msgid TEXT,
 353        from_complete TEXT,
 354        from_addr TEXT,
 355        to_complete TEXT,
 356        to_addr TEXT,
 357        subject TEXT NOT NULL DEFAULT '',
 358        sent_date TIMESTAMP WITH TIME ZONE,
 359        refs TEXT NOT NULL DEFAULT '',
 360        spam_score FLOAT,
 361        is_spam BOOLEAN DEFAULT FALSE
 362 );
 363 INSERT INTO table_comments VALUES ('message','Messages sent to bugs');
 364 INSERT INTO column_comments VALUES ('message','id','Message id');
 365 INSERT INTO column_comments VALUES ('message','msgid','Message id header');
 366 INSERT INTO column_comments VALUES ('message','from_complete','Complete from header of message');
 367 INSERT INTO column_comments VALUES ('message','from_addr','Address(es) of From: headers');
 368 INSERT INTO column_comments VALUES ('message','to_complete','Complete to header of message');
 369 INSERT INTO column_comments VALUES ('message','to_addr','Address(es) of To: header');
 370 INSERT INTO column_comments VALUES ('message','subject','Subject of the message');
 371 INSERT INTO column_comments VALUES ('message','sent_date','Time/date message was sent (from Date header)');
 372 INSERT INTO column_comments VALUES ('message','refs','Contents of References: header');
 373 INSERT INTO column_comments VALUES ('message','spam_score','Spam score from spamassassin');
 374 INSERT INTO column_comments VALUES ('message','is_spam','True if this message was spam and should not be shown');
 375
 376 CREATE INDEX ON message(msgid);
 377
 378 CREATE TABLE message_refs (
 379        id SERIAL PRIMARY KEY,
 380        message INT NOT NULL REFERENCES message ON DELETE CASCADE ON UPDATE CASCADE,
 381        refs INT NOT NULL REFERENCES message ON DELETE CASCADE ON UPDATE CASCADE,
 382        inferred BOOLEAN DEFAULT FALSE,
 383        primary_ref BOOLEAN DEFAULT FALSE,
 384        CONSTRAINT message_doesnt_reference_itself CHECK (message <> refs)
 385 );
 386 CREATE UNIQUE INDEX ON message_refs(message,refs);
 387 CREATE INDEX ON message_refs(refs);
 388 CREATE INDEX ON message_refs(message);
 389 INSERT INTO table_comments VALUES ('message_refs','Message references');
 390 INSERT INTO column_comments VALUES ('message_refs','message','Message id (matches message)');
 391 INSERT INTO column_comments VALUES ('message_refs','refs','Reference id (matches message)');
 392 INSERT INTO column_comments VALUES ('message_refs','inferred','TRUE if this message reference was reconstructed; primarily of use for messages which lack In-Reply-To: or References: headers');
 393 INSERT INTO column_comments VALUES ('message_refs','primary_ref','TRUE if this message->ref came from In-Reply-To: or similar.');
 394
 395
 396 CREATE TABLE correspondent (
 397        id SERIAL PRIMARY KEY,
 398        addr TEXT NOT NULL UNIQUE
 399 );
 400 INSERT INTO table_comments VALUES ('correspondent','Individual who has corresponded with the BTS');
 401 INSERT INTO column_comments VALUES ('correspondent','id','Correspondent ID');
 402 INSERT INTO column_comments VALUES ('correspondent','addr','Correspondent address');
 403
 404 CREATE TABLE correspondent_full_name(
 405        id SERIAL PRIMARY KEY,
 406        correspondent INT NOT NULL REFERENCES correspondent ON DELETE CASCADE ON UPDATE CASCADE,
 407        full_name TEXT NOT NULL UNIQUE
 408 );
 409
 410 INSERT INTO table_comments VALUES ('correspondent_full_name','Full names of BTS correspondents');
 411 INSERT INTO column_comments VALUES ('correspondent_full_name','id','Correspondent full name id');
 412 INSERT INTO column_comments VALUES ('correspondent_full_name','correpsondent','Correspondent ID (matches correspondent)');
 413 INSERT INTO column_comments VALUES ('correspondent_full_name','full_name','Correspondent full name (includes e-mail address)');
 414
 415 CREATE TABLE bug_submitter (
 416        id SERIAL PRIMARY KEY,
 417        bug INT NOT NULL REFERENCES bug ON DELETE CASCADE ON UPDATE CASCADE,
 418        submitter INT NOT NULL REFERENCES correspondent ON DELETE CASCADE ON UPDATE CASCADE
 419 );
 420 CREATE INDEX on bug_submitter(submitter);
 421 CREATE UNIQUE INDEX on bug_submitter(bug,submitter);
 422
 423 INSERT INTO table_comments  VALUES ('bug_submitter','Submitter of a bug (connects to correspondent)');
 424 INSERT INTO column_comments VALUES ('bug_submitter','id','Bug Submitter ID');
 425 INSERT INTO column_comments VALUES ('bug_submitter','bug','Bug which was submitted by this submitter');
 426 INSERT INTO column_comments VALUES ('bug_submitter','submitter','Bug submitter (connects to correspondent)');
 427
 428 CREATE TABLE bug_done_by (
 429        id SERIAL PRIMARY KEY,
 430        bug INT NOT NULL REFERENCES bug ON DELETE CASCADE ON UPDATE CASCADE,
 431        done_by INT NOT NULL REFERENCES correspondent ON DELETE CASCADE ON UPDATE CASCADE
 432 );
 433 CREATE INDEX on bug_done_by(done_by);
 434 CREATE UNIQUE INDEX on bug_done_by(bug,done_by);
 435
 436 INSERT INTO table_comments  VALUES ('bug_done_by','Correspondent who finished this bug (emailed -done)');
 437 INSERT INTO column_comments VALUES ('bug_done_by','id','Bug Done By ID');
 438 INSERT INTO column_comments VALUES ('bug_done_by','bug','Bug number which was done');
 439 INSERT INTO column_comments VALUES ('bug_done_by','done_by','Bug finisher (connects to correspondent)');
 440
 441 CREATE TYPE message_correspondent_type AS ENUM ('to','from','envfrom','cc');
 442
 443 CREATE TABLE message_correspondent (
 444        id SERIAL PRIMARY KEY,
 445        message INT NOT NULL REFERENCES message ON DELETE CASCADE ON UPDATE CASCADE,
 446        correspondent INT NOT NULL REFERENCES correspondent ON DELETE CASCADE ON UPDATE CASCADE,
 447        correspondent_type message_correspondent_type NOT NULL DEFAULT 'to'
 448 );
 449 INSERT INTO table_comments VALUES ('message_correspondent','Linkage between correspondent and message');
 450 INSERT INTO column_comments VALUES ('message_correspondent','message','Message id (matches message)');
 451 INSERT INTO column_comments VALUES ('message_correspondent','correspondent','Correspondent (matches correspondent)');
 452 INSERT INTO column_comments VALUES ('message_correspondent','correspondent_type','Type of correspondent (to, from, envfrom, cc, etc.)');
 453
 454 CREATE UNIQUE INDEX ON message_correspondent(message,correspondent,correspondent_type);
 455 CREATE INDEX ON message_correspondent(correspondent);
 456 CREATE INDEX ON message_correspondent(message);
 457
 458 CREATE TABLE bug_message (
 459        id SERIAL PRIMARY KEY,
 460        bug INT NOT NULL REFERENCES bug ON DELETE CASCADE ON UPDATE CASCADE,
 461        message INT NOT NULL REFERENCES message ON DELETE CASCADE ON UPDATE CASCADE,
 462        message_number INT NOT NULL,
 463        bug_log_offset INT,
 464        offset_valid TIMESTAMP WITH TIME ZONE
 465 );
 466 INSERT INTO table_comments VALUES ('bug_mesage','Mapping between a bug and a message');
 467 INSERT INTO column_comments VALUES ('bug_message','bug','Bug id (matches bug)');
 468 INSERT INTO column_comments VALUES ('bug_message','message','Message id (matches message)');
 469 INSERT INTO column_comments VALUES ('bug_message','message_number','Message number in the bug log');
 470 INSERT INTO column_comments VALUES ('bug_message','bug_log_offset','Byte offset in the bug log');
 471 INSERT INTO column_comments VALUES ('bug_message','offset_valid','Time offset was valid');
 472