]> git.donarmstrong.com Git - debbugs.git/blob - sql/debbugs_schema.sql
add more documentation of the debbugs schema
[debbugs.git] / sql / debbugs_schema.sql
1
2 DROP TABLE bug_tag CASCADE;
3 DROP TABLE tag CASCADE;
4 DROP TABLE bug CASCADE;
5 DROP TYPE bug_severity CASCADE;
6 DROP TABLE src_pkg CASCADE;
7 DROP TABLE bug_ver CASCADE;
8 DROP TABLE src_pkg_alias CASCADE;
9 DROP TABLE src_ver CASCADE;
10 DROP TABLE arch CASCADE;
11 DROP TABLE bin_ver CASCADE;
12 DROP TABLE bin_pkg CASCADE;
13 DROP TABLE bug_blocks CASCADE;
14 DROP TABLE bug_merged CASCADE;
15 DROP VIEW bug_package CASCADE;
16 DROP TABLE bug_srcpackage CASCADE;
17 DROP TABLE bug_binpackage CASCADE;
18 DROP VIEW  bug_package CASCADE;
19 DROP VIEW binary_versions CASCADE;
20 DROP TABLE suite CASCADE;
21 DROP TABLE bin_associations CASCADE;
22 DROP TABLE src_associations CASCADE;
23 DROP TABLE maintainer CASCADE;
24 DROP TABLE bug_message CASCADE;
25 DROP TABLE message_corespondent CASCADE;
26 DROP TABLE corespondent CASCADE;
27 DROP TABLE message_refs CASCADE;
28 DROP TABLE message CASCADE;
29 DROP TYPE message_corespondent_type CASCADE;
30 DROP TABLE table_comments CASCADE;
31 DROP TABLE column_comments CASCADE;
32
33 -- the following two tables are used to provide documentation about
34 -- the tables and columns for DBIx::Class::Schema::Loader
35 CREATE TABLE table_comments (
36        table_name TEXT UNIQUE NOT NULL,
37        comment_text TEXT NOT NULL
38 );
39 CREATE TABLE column_comments (
40        table_name TEXT  NOT NULL,
41        column_name TEXT  NOT NULL,
42        comment_text TEXT NOT NULL
43 );
44 CREATE UNIQUE INDEX ON column_comments(table_name,column_name);
45
46 -- severities
47 CREATE TYPE bug_severity AS ENUM ('wishlist','minor','normal',
48        'important','serious','grave','critical');
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        unknown_packages TEXT NOT NULL DEfAULT '',
77        severity bug_severity DEFAULT 'normal'::bug_severity
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 did the -done; empty if it has never been -done');
92 INSERT INTO column_comments VALUES ('bug','unknown_packages','Package name if the package is not known');
93 INSERT INTO column_comments VALUES ('bug','severity','Bug severity');
94
95
96
97 CREATE TABLE bug_blocks (
98        bug_id INT NOT NULL REFERENCES bug,
99        blocks INT NOT NULL REFERENCES bug,
100        CONSTRAINT bug_doesnt_block_itself CHECK (bug_id <> blocks)
101 );
102 CREATE UNIQUE INDEX bug_blocks_bug_id_blocks_idx ON bug_blocks(bug_id,blocks);
103 CREATE INDEX bug_blocks_bug_id_idx ON bug_blocks(bug_id);
104 CREATE INDEX bug_blocks_blocks_idx ON bug_blocks(blocks);
105 INSERT INTO table_comments VALUES ('bug_blocks','Bugs which block other bugs');
106 INSERT INTO column_comments VALUES ('bug_blocks','bug_id','Bug number');
107 INSERT INTO column_comments VALUES ('bug_blocks','blocks','Bug number which is blocked by bug_id');
108
109
110 CREATE TABLE bug_merged (
111        bug_id INT NOT NULL REFERENCES bug,
112        merged INT NOT NULL REFERENCES bug,
113        CONSTRAINT bug_doesnt_merged_itself CHECK (bug_id <> merged)
114 );
115 CREATE UNIQUE INDEX bug_merged_bug_id_merged_idx ON bug_merged(bug_id,merged);
116 CREATE INDEX bug_merged_bug_id_idx ON bug_merged(bug_id);
117 CREATE INDEX bug_merged_merged_idx ON bug_merged(merged);
118 INSERT INTO table_comments  VALUES ('bug_merged','Bugs which are merged with other bugs');
119 INSERT INTO column_comments VALUES ('bug_merged','bug_id','Bug number');
120 INSERT INTO column_comments VALUES ('bug_merged','merged','Bug number which is merged with bug_id');
121
122 CREATE TABLE src_pkg (
123        id SERIAL PRIMARY KEY,
124        pkg TEXT NOT NULL UNIQUE,
125        pseduopkg BOOLEAN DEFAULT FALSE,
126        alias_of INT REFERENCES src_pkg ON UPDATE CASCADE ON DELETE CASCADE
127        CONSTRAINT src_pkg_doesnt_alias_itself CHECK (id <> alias_of)
128 );
129 INSERT INTO table_comments VALUES ('src_pkg','Source packages');
130 INSERT INTO column_comments VALUES ('src_pkg','id','Source package id');
131 INSERT INTO column_comments VALUES ('src_pkg','pkg','Source package name');
132 INSERT INTO column_comments VALUES ('src_pkg','pseudopkg','True if this is a pseudo package');
133 INSERT INTO column_comments VALUES ('src_pkg','alias_of','Source package id which this source package is an alias of');
134
135
136
137 CREATE TABLE src_ver (
138        id SERIAL PRIMARY KEY,
139        src_pkg_id INT NOT NULL REFERENCES src_pkg
140             ON UPDATE CASCADE ON DELETE CASCADE,
141        ver public.debversion NOT NULL,
142        maintainer_id INT REFERENCES maintainer
143             ON UPDATE CASCADE ON DELETE SET NULL,
144        upload_date TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
145        based_on INT REFERENCES src_ver
146             ON UPDATE CASCADE ON DELETE CASCADE
147 );
148 CREATE UNIQUE INDEX src_ver_src_pkg_id_ver ON src_ver(src_pkg_id,ver);
149 INSERT INTO table_comments VALUES ('src_ver','Source Package versions');
150 INSERT INTO column_comments VALUES ('src_ver','id','Source package version id');
151 INSERT INTO column_comments VALUES ('src_ver','src_pkg_id','Source package id (matches src_pkg table)');
152 INSERT INTO column_comments VALUES ('src_ver','ver','Version of the source package');
153 INSERT INTO column_comments VALUES ('src_ver','maintainer_id','Maintainer id (matches maintainer table)');
154 INSERT INTO column_comments VALUES ('src_ver','upload_date','Date this version of the source package was uploaded');
155 INSERT INTO column_comments VALUES ('src_ver','based_on','Source package version this version is based on');
156
157
158
159 CREATE TABLE bug_ver (
160        bug_id INT NOT NULL REFERENCES bug
161          ON UPDATE CASCADE ON DELETE RESTRICT,
162        ver_string TEXT,
163        src_pkg_id INT REFERENCES src_pkg
164             ON UPDATE CASCADE ON DELETE SET NULL,
165        src_ver_id INT REFERENCES src_ver
166             ON UPDATE CASCADE ON DELETE SET NULL,
167        found BOOLEAN NOT NULL DEFAULT TRUE,
168        creation TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
169        last_modified TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW()
170 );
171 CREATE INDEX bug_ver_src_pkg_id_idx ON bug_ver(src_pkg_id);
172 CREATE INDEX bug_ver_src_pkg_id_src_ver_id_idx ON bug_ver(src_pkg_id,src_ver_id);
173 CREATE INDEX bug_ver_src_ver_id_idx ON bug_ver(src_ver_id);
174 CREATE UNIQUE INDEX ON bug_ver(bug_id,ver_string,found);
175 INSERT INTO table_comments VALUES ('bug_ver','Bug versions');
176
177 CREATE TABLE arch (
178        id SERIAL PRIMARY KEY,
179        arch TEXT NOT NULL UNIQUE
180 );
181
182 CREATE TABLE bin_pkg (
183        id SERIAL PRIMARY KEY,
184        pkg TEXT NOT NULL UNIQUE
185 );
186
187 CREATE TABLE bin_ver(
188        id SERIAL PRIMARY KEY,
189        bin_pkg_id INT NOT NULL REFERENCES bin_pkg
190             ON UPDATE CASCADE ON DELETE CASCADE,
191        src_ver_id INT NOT NULL REFERENCES src_ver
192             ON UPDATE CASCADE ON DELETE CASCADE,
193        arch_id INT NOT NULL REFERENCES arch
194             ON UPDATE CASCADE ON DELETE CASCADE,
195        ver public.debversion NOT NULL
196 );
197 CREATE INDEX bin_ver_ver_idx ON bin_ver(ver);
198 CREATE UNIQUE INDEX bin_ver_bin_pkg_id_arch_idx ON bin_ver(bin_pkg_id,arch_id,ver);
199 CREATE UNIQUE INDEX bin_ver_src_ver_id_arch_idx ON bin_ver(src_ver_id,arch_id);
200 CREATE INDEX bin_ver_bin_pkg_id_idx ON bin_ver(bin_pkg_id);
201 CREATE INDEX bin_ver_src_ver_id_idx ON bin_ver(src_ver_id);
202
203 CREATE TABLE tag (
204        id SERIAL PRIMARY KEY,
205        tag TEXT NOT NULL UNIQUE,
206        obsolete BOOLEAN DEFAULT FALSE
207 );
208
209 CREATE TABLE bug_tag (
210        bug_id INT NOT NULL REFERENCES bug,
211        tag_id INT NOT NULL REFERENCES tag
212 );
213
214 CREATE UNIQUE INDEX bug_tag_bug_tag_id ON bug_tag (bug_id,tag_id);
215 CREATE INDEX bug_tag_tag_id ON bug_tag (tag_id);
216 CREATE INDEX bug_tag_bug_id ON bug_tag (bug_id);
217
218 CREATE TABLE bug_binpackage (
219        bug_id INT NOT NULL REFERENCES bug,
220        bin_pkg_id INT NOT NULL REFERENCES bin_pkg
221 );
222 CREATE UNIQUE INDEX bug_binpackage_id_pkg_id ON bug_binpackage(bug_id,bin_pkg_id);
223
224 CREATE TABLE bug_srcpackage (
225        bug_id INT NOT NULL REFERENCES bug,
226        src_pkg_id INT NOT NULL REFERENCES src_pkg ON UPDATE CASCADE ON DELETE CASCADE
227 );
228 CREATE UNIQUE INDEX bug_srcpackage_id_pkg_id ON bug_srcpackage(bug_id,src_pkg_id);
229
230 CREATE VIEW bug_package (bug_id,pkg_id,pkg_type,package) AS
231        SELECT b.bug_id,b.bin_pkg_id,'binary',bp.pkg FROM bug_binpackage b JOIN bin_pkg bp ON bp.id=b.bin_pkg_id UNION
232               SELECT s.bug_id,s.src_pkg_id,'source',sp.pkg FROM bug_srcpackage s JOIN src_pkg sp ON sp.id=s.src_pkg_id;
233
234 CREATE VIEW binary_versions (src_pkg, src_ver, bin_pkg, arch, bin_ver) AS
235        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
236        FROM bin_ver b JOIN arch a ON b.arch_id = a.id
237                       JOIN bin_pkg bp ON b.bin_pkg_id  = bp.id
238                       JOIN src_ver sv ON b.src_ver_id  = sv.id
239                       JOIN src_pkg sp ON sv.src_pkg_id = sp.id;
240
241 CREATE TABLE suite (
242        id SERIAL PRIMARY KEY,
243        suite_name TEXT NOT NULL UNIQUE,
244        version TEXT,
245        codename TEXT,
246        active BOOLEAN DEFAULT TRUE);
247 CREATE INDEX ON suite(codename);
248 CREATE INDEX ON suite(version);
249
250 CREATE TABLE bin_associations (
251        id SERIAL PRIMARY KEY,
252        suite INT NOT NULL REFERENCES suite ON DELETE CASCADE ON UPDATE CASCADE,
253        bin INT NOT NULL REFERENCES bin_ver ON DELETE CASCADE ON UPDATE CASCADE,
254        created TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL,
255        modified TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL
256 );
257
258 CREATE TABLE src_associations (
259        id SERIAL PRIMARY KEY,
260        suite INT NOT NULL REFERENCES suite ON DELETE CASCADE ON UPDATE CASCADE,
261        source INT NOT NULL REFERENCES src_ver ON DELETE CASCADE ON UPDATE CASCADE,
262        created TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL,
263        modified TIMESTAMP WITH TIME ZONE DEFAULT NOW() NOT NULL
264 );
265
266 CREATE TABLE message (
267        id SERIAL PRIMARY KEY,
268        msgid TEXT,
269        from_complete TEXT,
270        from_addr TEXT,
271        to_complete TEXT,
272        to_addr TEXT,
273        subject TEXT NOT NULL DEFAULT '',
274        sent_date TIMESTAMP WITH TIME ZONE,
275        refs TEXT NOT NULL DEFAULT '',
276        spam_score FLOAT,
277        is_spam BOOLEAN DEFAULT FALSE
278 );
279
280 CREATE TABLE message_refs (
281        message INT NOT NULL REFERENCES message ON DELETE CASCADE ON UPDATE CASCADE,
282        refs INT NOT NULL REFERENCES message ON DELETE CASCADE ON UPDATE CASCADE,
283        CONSTRAINT message_doesnt_reference_itself CHECK (message <> refs)
284 );
285
286 CREATE TABLE corespondent (
287        id SERIAL PRIMARY KEY,
288        addr TEXT NOT NULL UNIQUE
289 );
290
291 CREATE TYPE message_corespondent_type AS ENUM ('to','from','envfrom','cc');
292
293 CREATE TABLE message_corespondent (
294        message INT NOT NULL REFERENCES message ON DELETE CASCADE ON UPDATE CASCADE,
295        corespondent INT NOT NULL REFERENCES corespondent ON DELETE CASCADE ON UPDATE CASCADE,
296        corespondent_type message_corespondent_type NOT NULL DEFAULT 'to'
297 );
298
299 CREATE UNIQUE INDEX ON message_corespondent(message,corespondent,corespondent_type);
300 CREATE INDEX ON message_corespondent(corespondent);
301
302 CREATE TABLE bug_message (
303        bug INT NOT NULL REFERENCES bug ON DELETE CASCADE ON UPDATE CASCADE,
304        message INT NOT NULL REFERENCES message ON DELETE CASCADE ON UPDATE CASCADE,
305        message_number INT NOT NULL,
306        bug_log_offset INT
307 );
308