Changes for page Data Structures

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

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

Summary

Details

Page properties
Content
... ... @@ -1,26 +1,30 @@
1 1  = Data Structures for KPM and database relations =
2 2  
3 3  
4 -= Models =
4 += Core Entity Tables =
5 5  
6 -* (((
7 7  == Address ==
8 -)))
9 -** {{code language="sql" layout="LINENUMBERS"}}DROP TABLE IF EXISTS public.address;
10 10  
11 -CREATE TABLE public.address
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
12 12  (
13 13   uid SERIAL PRIMARY KEY,
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)
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
24 24  )
25 25  
26 26  TABLESPACE pg_default;
... ... @@ -29,124 +29,85 @@
29 29   OWNER to kpm_rw;
30 30  
31 31  COMMENT ON TABLE public.address
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}}
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.';
33 33  
38 +COMMENT ON COLUMN public.address.uid
39 + IS 'Unique ID for each address';
34 34  
41 +COMMENT ON COLUMN public.address.country
42 + IS 'ISO 3166-1 alpha-2 (e.g., ''CH'')';
35 35  
36 -* (((
37 -== Company_Type ==
38 -)))
39 -** {{code language="sql"}}-- Table: public.company_type
44 +COMMENT ON COLUMN public.address.region
45 + IS 'State or canton';
40 40  
41 --- DROP TABLE IF EXISTS public.company_type;
47 +COMMENT ON COLUMN public.address.unit
48 + IS 'Apartment/Suite/Floor/etc.';
42 42  
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;
50 +COMMENT ON COLUMN public.address.extra_address
51 + IS 'Any additional info (optional)';
52 52  
53 -ALTER TABLE IF EXISTS public.company_type
54 - OWNER TO kpm_rw;
53 +COMMENT ON COLUMN public.address.lon
54 + IS 'Optional: for geolocation';
55 55  
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.';
56 +COMMENT ON COLUMN public.address.lat
57 + IS 'Optional: for geolocation';
58 +{{/code}}
58 58  
59 -COMMENT ON COLUMN public.company_type.uid
60 - IS 'Unique ID for each company type';
60 +== Reference / Lookup Tables ==
61 61  
62 -COMMENT ON COLUMN public.company_type.name
63 - IS 'Short name of the company type (e.g., Manufacturer, EMS, Partner)';
62 +=== Company ===
64 64  
65 -COMMENT ON COLUMN public.company_type.description
66 - IS 'Optional longer description of the company type';
64 +* company_legal_form
65 +* company_relation
66 +* company_status
67 +* company_types
67 67  
68 -COMMENT ON COLUMN public.company_type.creation_date
69 - IS 'Timestamp when the entry was created';
69 +=== Project ===
70 70  
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 ==
71 +* project_areas
72 +* project_type
73 +* project_company_role
74 +* projects_person_role
75 75  
76 -* {{code language="sql"}}-- Table: public.company_status
76 +=== Task ===
77 77  
78 --- DROP TABLE IF EXISTS public.company_status;
78 +* task_category
79 +* task_type
80 +* task_status
79 79  
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;
82 +=== User ===
89 89  
90 -ALTER TABLE IF EXISTS public.company_status
91 - OWNER TO kpm_rw;
84 +* user_role
85 +* user_type
92 92  
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.';
87 +=== Employee ===
95 95  
96 -COMMENT ON COLUMN public.company_status.uid
97 - IS 'Unique ID for each company status entry';
89 +* employee_role
90 +* employee_status
91 +* employee_depar
98 98  
99 -COMMENT ON COLUMN public.company_status.name
100 - IS 'Short name of the status (e.g., Active, Archived, Lead)';
101 -
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)';
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$$;
110 110  {{/code}}
111 -)))
112 -* (((
113 -== Company_relation ==
114 114  
115 -* {{code language="sql"}}-- Table: public.company_relation
116 -
117 --- DROP TABLE IF EXISTS public.company_relation;
118 -
119 -CREATE TABLE IF NOT EXISTS public.company_relation
120 -(
121 - uid SERIAL PRIMARY KEY,
122 - name VARCHAR(100) COLLATE pg_catalog."default" NOT NULL,
123 - description VARCHAR(255) COLLATE pg_catalog."default",
124 - creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
125 - updated_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
126 -)
127 -TABLESPACE pg_default;
128 -
129 -ALTER TABLE IF EXISTS public.company_relation
130 - OWNER TO kpm_rw;
131 -
132 -COMMENT ON TABLE public.company_relation
133 - IS 'Reference table for types of relationships a company may have (e.g., customer, partner, supplier). Used by the company table.';
134 -
135 -COMMENT ON COLUMN public.company_relation.uid
136 - IS 'Unique ID for each company relation type';
137 -
138 -COMMENT ON COLUMN public.company_relation.name
139 - IS 'Short name of the relation type (e.g., Customer, Supplier, Partner)';
140 -
141 -COMMENT ON COLUMN public.company_relation.description
142 - IS 'Optional longer description of the relation type';
143 -
144 -COMMENT ON COLUMN public.company_relation.creation_date
145 - IS 'Timestamp when the entry was created';
146 -
147 -COMMENT ON COLUMN public.company_relation.updated_date
148 - IS 'Timestamp for when the entry was last updated (set via application logic or triggers)';
149 -{{/code}}
150 -
151 -
152 -)))
117 +== ==