Changes for page Data Structures

Last modified by Kerem Yollu on 2025/03/23 11:28

From version 12.3
edited by Kerem Yollu
on 2025/03/23 10:46
Change comment: There is no comment for this version
To version 7.1
edited by Kerem Yollu
on 2025/03/21 16:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,30 +1,26 @@
1 1  = Data Structures for KPM and database relations =
2 2  
3 3  
4 -= Core Entity Tables =
4 += Models =
5 5  
6 +* (((
6 6  == Address ==
8 +)))
9 +** {{code language="sql" layout="LINENUMBERS"}}DROP TABLE IF EXISTS public.address;
7 7  
8 -{{diagram/}}
9 -
10 -{{code language="SQL"}}
11 --- Table: public.address
12 -
13 --- DROP TABLE IF EXISTS public.address;
14 -
15 -CREATE TABLE IF NOT EXISTS public.address
11 +CREATE TABLE public.address
16 16  (
17 17   uid SERIAL PRIMARY KEY,
18 - country character(2) COLLATE pg_catalog."default" NOT NULL,
19 - region character varying(100) COLLATE pg_catalog."default",
20 - city character varying(100) COLLATE pg_catalog."default" NOT NULL,
21 - postcode character varying(20) COLLATE pg_catalog."default" NOT NULL,
22 - street character varying(255) COLLATE pg_catalog."default" NOT NULL,
23 - "number" character varying(20) COLLATE pg_catalog."default",
24 - unit character varying(50) COLLATE pg_catalog."default",
25 - extra_address character varying(255) COLLATE pg_catalog."default",
26 - lon double precision,
27 - lat double precision
14 + country CHAR(2) NOT NULL, -- ISO 3166-1 alpha-2 (e.g., 'CH')
15 + region VARCHAR(100), -- State or canton
16 + city VARCHAR(100) NOT NULL,
17 + postcode VARCHAR(20) NOT NULL,
18 + street VARCHAR(255) NOT NULL,
19 + number VARCHAR(20),
20 + unit VARCHAR(50), -- Apartment/Suite/Floor/etc.
21 + extra_address VARCHAR(255), -- Additional info
22 + lon DOUBLE PRECISION, -- Longitude (optional)
23 + lat DOUBLE PRECISION -- Latitude (optional)
28 28  )
29 29  
30 30  TABLESPACE pg_default;
... ... @@ -33,85 +33,160 @@
33 33   OWNER to kpm_rw;
34 34  
35 35  COMMENT ON TABLE public.address
36 - IS 'addresses table, instead of making use of addresses for ever company, customer and co... Prefer to make addresses table and then assign it to a company or a user etc.';
32 + IS 'addresses table, instead of making use of addresses for ever company, customer and co... Prefer to make addresses table and then assign it to a company or a user etc.';{{/code}}
37 37  
38 -COMMENT ON COLUMN public.address.uid
39 - IS 'Unique ID for each address';
40 40  
41 -COMMENT ON COLUMN public.address.country
42 - IS 'ISO 3166-1 alpha-2 (e.g., ''CH'')';
43 43  
44 -COMMENT ON COLUMN public.address.region
45 - IS 'State or canton';
36 +* (((
37 +== Company_Type ==
38 +)))
39 +** {{code language="sql"}}-- Table: public.company_type
46 46  
47 -COMMENT ON COLUMN public.address.unit
48 - IS 'Apartment/Suite/Floor/etc.';
41 +-- DROP TABLE IF EXISTS public.company_type;
49 49  
50 -COMMENT ON COLUMN public.address.extra_address
51 - IS 'Any additional info (optional)';
43 +CREATE TABLE IF NOT EXISTS public.company_type
44 +(
45 + uid SERIAL PRIMARY KEY,
46 + name VARCHAR(100) COLLATE pg_catalog."default" NOT NULL,
47 + description VARCHAR(255) COLLATE pg_catalog."default",
48 + creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
49 + updated_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
50 +)
51 +TABLESPACE pg_default;
52 52  
53 -COMMENT ON COLUMN public.address.lon
54 - IS 'Optional: for geolocation';
53 +ALTER TABLE IF EXISTS public.company_type
54 + OWNER TO kpm_rw;
55 55  
56 -COMMENT ON COLUMN public.address.lat
57 - IS 'Optional: for geolocation';
58 -{{/code}}
56 +COMMENT ON TABLE public.company_type
57 + IS 'Reference table for different types of companies (e.g., manufacturer, distributor, partner, etc.). Used by company table.';
59 59  
60 -== Reference / Lookup Tables ==
59 +COMMENT ON COLUMN public.company_type.uid
60 + IS 'Unique ID for each company type';
61 61  
62 -=== Company ===
62 +COMMENT ON COLUMN public.company_type.name
63 + IS 'Short name of the company type (e.g., Manufacturer, EMS, Partner)';
63 63  
64 -* company_legal_form
65 -* company_relation
66 -* company_status
67 -* company_types
65 +COMMENT ON COLUMN public.company_type.description
66 + IS 'Optional longer description of the company type';
68 68  
69 -=== Project ===
68 +COMMENT ON COLUMN public.company_type.creation_date
69 + IS 'Timestamp when the entry was created';
70 70  
71 -* project_areas
72 -* project_type
73 -* project_company_role
74 -* projects_person_role
71 +COMMENT ON COLUMN public.company_type.updated_date
72 + IS 'Timestamp for when the entry was last updated (set via application logic or triggers)';{{/code}}
73 +* (((
74 +== Company_status ==
75 75  
76 -=== Task ===
76 +* {{code language="sql"}}-- Table: public.company_status
77 77  
78 -* task_category
79 -* task_type
80 -* task_status
78 +-- DROP TABLE IF EXISTS public.company_status;
81 81  
82 -=== User ===
80 +CREATE TABLE IF NOT EXISTS public.company_status
81 +(
82 + uid SERIAL PRIMARY KEY,
83 + name VARCHAR(100) COLLATE pg_catalog."default" NOT NULL,
84 + description VARCHAR(255) COLLATE pg_catalog."default",
85 + creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
86 + updated_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
87 +)
88 +TABLESPACE pg_default;
83 83  
84 -* user_role
85 -* user_type
90 +ALTER TABLE IF EXISTS public.company_status
91 + OWNER TO kpm_rw;
86 86  
87 -=== Employee ===
93 +COMMENT ON TABLE public.company_status
94 + IS 'Reference table for the status or lifecycle stage of a company (e.g., Active, Inactive, Prospect). Used by the company table.';
88 88  
89 -* employee_role
90 -* employee_status
91 -* employee_depar
96 +COMMENT ON COLUMN public.company_status.uid
97 + IS 'Unique ID for each company status entry';
92 92  
93 -{{code language="sql"}}
94 -DO $$
95 -DECLARE
96 - tname TEXT;
97 -BEGIN
98 - FOREACH tname IN ARRAY ARRAY'company_legal_form','company_relation','company_status','company_type',
99 - 'task_status', 'task_type', 'task_category',
100 - 'user_role', 'user_type',
101 - 'project_type','project_areas', 'project_person_roles', 'project_company_role']
102 - LOOP
103 - EXECUTE format('
104 - CREATE TABLE IF NOT EXISTS public.%I (
105 - uid SERIAL PRIMARY KEY,
106 - name VARCHAR(100) NOT NULL,
107 - description VARCHAR(255),
108 - creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
109 - updated_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
110 - );
111 - ALTER TABLE public.%I OWNER TO kpm_rw;
112 - ', tname, tname);
113 - END LOOP;
114 -END$$;
115 -{{/code}}
99 +COMMENT ON COLUMN public.company_status.name
100 + IS 'Short name of the status (e.g., Active, Archived, Lead)';
116 116  
117 -== ==
102 +COMMENT ON COLUMN public.company_status.description
103 + IS 'Optional description for the company status';
104 +
105 +COMMENT ON COLUMN public.company_status.creation_date
106 + IS 'Timestamp when the entry was created';
107 +
108 +COMMENT ON COLUMN public.company_status.updated_date
109 + IS 'Timestamp for when the entry was last updated (set via application logic or triggers)';{{/code}}
110 +)))
111 +* (((
112 +== Company_relation ==
113 +
114 +* {{code language="sql"}}-- Table: public.company_relation
115 +
116 +-- DROP TABLE IF EXISTS public.company_relation;
117 +
118 +CREATE TABLE IF NOT EXISTS public.company_relation
119 +(
120 + uid SERIAL PRIMARY KEY,
121 + name VARCHAR(100) COLLATE pg_catalog."default" NOT NULL,
122 + description VARCHAR(255) COLLATE pg_catalog."default",
123 + creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
124 + updated_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
125 +)
126 +TABLESPACE pg_default;
127 +
128 +ALTER TABLE IF EXISTS public.company_relation
129 + OWNER TO kpm_rw;
130 +
131 +COMMENT ON TABLE public.company_relation
132 + IS 'Reference table for types of relationships a company may have (e.g., customer, partner, supplier). Used by the company table.';
133 +
134 +COMMENT ON COLUMN public.company_relation.uid
135 + IS 'Unique ID for each company relation type';
136 +
137 +COMMENT ON COLUMN public.company_relation.name
138 + IS 'Short name of the relation type (e.g., Customer, Supplier, Partner)';
139 +
140 +COMMENT ON COLUMN public.company_relation.description
141 + IS 'Optional longer description of the relation type';
142 +
143 +COMMENT ON COLUMN public.company_relation.creation_date
144 + IS 'Timestamp when the entry was created';
145 +
146 +COMMENT ON COLUMN public.company_relation.updated_date
147 + IS 'Timestamp for when the entry was last updated (set via application logic or triggers)';{{/code}}
148 +
149 +
150 +)))
151 +* (((
152 +== Company_legal_form ==
153 +
154 +* {{code language="sql"}}-- Table: public.company_legal_form
155 +
156 +-- DROP TABLE IF EXISTS public.company_legal_form;
157 +
158 +CREATE TABLE IF NOT EXISTS public.company_legal_form
159 +(
160 + uid SERIAL PRIMARY KEY,
161 + name VARCHAR(100) COLLATE pg_catalog."default" NOT NULL,
162 + description VARCHAR(255) COLLATE pg_catalog."default",
163 + creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
164 + updated_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
165 +)
166 +TABLESPACE pg_default;
167 +
168 +ALTER TABLE IF EXISTS public.company_legal_form
169 + OWNER TO kpm_rw;
170 +
171 +COMMENT ON TABLE public.company_legal_form
172 + IS 'Reference table for legal structures of companies (e.g., AG, GmbH, Ltd, Inc). Used by the company table.';
173 +
174 +COMMENT ON COLUMN public.company_legal_form.uid
175 + IS 'Unique ID for each legal form';
176 +
177 +COMMENT ON COLUMN public.company_legal_form.name
178 + IS 'Short name of the legal form (e.g., GmbH, AG, Ltd, Inc)';
179 +
180 +COMMENT ON COLUMN public.company_legal_form.description
181 + IS 'Optional longer description of the legal form';
182 +
183 +COMMENT ON COLUMN public.company_legal_form.creation_date
184 + IS 'Timestamp when the entry was created';
185 +
186 +COMMENT ON COLUMN public.company_legal_form.updated_date
187 + IS 'Timestamp for when the entry was last updated (set via application logic or triggers)';{{/code}}
188 +)))