Changes for page Data Structures

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

From version 13.2
edited by Kerem Yollu
on 2025/03/23 11:23
Change comment: There is no comment for this version
To version 6.2
edited by Kerem Yollu
on 2025/03/21 16:15
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,86 +1,150 @@
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 -Address table is made so that i can be populated from external source like open address,
11 +CREATE TABLE public.address
12 +(
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)
24 +)
9 9  
10 -{{diagram/}}
26 +TABLESPACE pg_default;
11 11  
12 -== Lookup Tables without references. ==
28 +ALTER TABLE IF EXISTS public.address
29 + OWNER to kpm_rw;
13 13  
14 -=== Company ===
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}}
15 15  
16 -* company_legal_form
17 -* company_relation
18 -* company_status
19 -* company_types
20 20  
21 -=== Project ===
22 22  
23 -* project_areas
24 -* project_type
25 -* project_company_role
26 -* projects_person_role
36 +* (((
37 +== Company_Type ==
38 +)))
39 +** {{code language="sql"}}-- Table: public.company_type
27 27  
28 -=== Task ===
41 +-- DROP TABLE IF EXISTS public.company_type;
29 29  
30 -* task_category
31 -* task_type
32 -* task_status
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;
33 33  
34 -=== User ===
53 +ALTER TABLE IF EXISTS public.company_type
54 + OWNER TO kpm_rw;
35 35  
36 -* user_role
37 -* user_type
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.';
38 38  
39 -=== Employee ===
59 +COMMENT ON COLUMN public.company_type.uid
60 + IS 'Unique ID for each company type';
40 40  
41 -* employee_role
42 -* employee_status
43 -* employee_departement (this one i am not shure, maybe departments should be in company ?)
62 +COMMENT ON COLUMN public.company_type.name
63 + IS 'Short name of the company type (e.g., Manufacturer, EMS, Partner)';
44 44  
45 -{{code language="sql"}}
46 -DO $$
47 -DECLARE
48 - tname TEXT;
49 -BEGIN
50 - FOREACH tname IN ARRAY ARRAY'TBALE_ONE','TABLE_TWO']
51 - LOOP
52 - EXECUTE format('
53 - CREATE TABLE IF NOT EXISTS public.%I (
54 - uid SERIAL PRIMARY KEY,
55 - name VARCHAR(100) NOT NULL,
56 - description VARCHAR(255),
57 - creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
58 - updated_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
59 - );
60 - ALTER TABLE public.%I OWNER TO kpm_rw;
61 - ', tname, tname);
62 - END LOOP;
63 -END$$;
64 -{{/code}}
65 +COMMENT ON COLUMN public.company_type.description
66 + IS 'Optional longer description of the company type';
65 65  
66 -== Lookup Tables with references. ==
68 +COMMENT ON COLUMN public.company_type.creation_date
69 + IS 'Timestamp when the entry was created';
67 67  
68 -=== Company ===
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 ==
69 69  
70 -* company_departements
76 +* {{code language="sql"}}-- Table: public.company_status
71 71  
72 -{{code language="sql"}}
73 -CREATE TABLE IF NOT EXISTS public.TABLE
78 +-- DROP TABLE IF EXISTS public.company_status;
79 +
80 +CREATE TABLE IF NOT EXISTS public.company_status
74 74  (
75 75   uid SERIAL PRIMARY KEY,
76 - OTHER_TABLE_uid INTEGER NOT NULL REFERENCES public.OTHER_TABLE(uid) ON DELETE CASCADE,
77 - name VARCHAR(100) NOT NULL,
78 - description VARCHAR(255),
83 + name VARCHAR(100) COLLATE pg_catalog."default" NOT NULL,
84 + description VARCHAR(255) COLLATE pg_catalog."default",
79 79   creation_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
80 80   updated_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP
81 81  )
82 82  TABLESPACE pg_default;
83 83  
84 -ALTER TABLE IF EXISTS public.TABLE
90 +ALTER TABLE IF EXISTS public.company_status
85 85   OWNER TO kpm_rw;
86 -{{/code}}
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.';
95 +
96 +COMMENT ON COLUMN public.company_status.uid
97 + IS 'Unique ID for each company status entry';
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)';{{/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 +