@ngockhoale/ukit 1.1.6

package/templates/.claude/skills/postgres/reference/fn_rpt_examples.sql

@@ -0,0 +1,239 @@
+-- =============================================
+-- REPORT FUNCTION EXAMPLES
+-- Pattern: fn_rpt_<name> - Returns TABLE
+-- =============================================
+
+
+-- =============================================
+-- Example 1: Simple Report Function
+-- Pattern: JOIN two views, return all columns
+-- =============================================
+
+DROP FUNCTION IF EXISTS qas.fn_rpt_billing;
+CREATE OR REPLACE FUNCTION qas.fn_rpt_billing()
+    RETURNS TABLE
+            (
+                modern_trade       VARCHAR,
+                branch             VARCHAR,
+                agreement_number   VARCHAR,
+                attach_file        VARCHAR,
+                attach_image       VARCHAR,
+                type_of_media      VARCHAR,
+                type_of_media_text VARCHAR,
+                start_date         VARCHAR,
+                due_date           VARCHAR,
+                status             VARCHAR,
+                amount             NUMERIC(16, 2),
+                paid_amount        NUMERIC(16, 2),
+                incoming_bill      NUMERIC(16, 2),
+                agreement_period   VARCHAR,
+                status_name        VARCHAR,
+                request_type       VARCHAR,
+                request_date       VARCHAR,
+                paid_status        VARCHAR,
+                paid_status_name   VARCHAR,
+                billing_number     VARCHAR,
+                remark             VARCHAR,
+                created_on         VARCHAR
+            )
+AS
+$$
+BEGIN
+    RETURN QUERY
+        SELECT a.modern_trade::VARCHAR,
+               a.branch::VARCHAR,
+               a.agreement_number::VARCHAR,
+               a.attach_file::VARCHAR,
+               a.attach_image::VARCHAR,
+               a.type_of_media::VARCHAR,
+               a.type_of_media_text::VARCHAR,
+               a.start_date::VARCHAR,
+               a.due_date::VARCHAR,
+               a.status::VARCHAR,
+               a.amount::NUMERIC(16, 2),
+               a.paid_amount::NUMERIC(16, 2),
+               a.incoming_bill::NUMERIC(16, 2),
+               a.agreement_period::VARCHAR,
+               a.status_name::VARCHAR,
+               a.request_type::VARCHAR,
+               a.request_date::VARCHAR,
+               a.paid_status::VARCHAR,
+               a.paid_status_name::VARCHAR,
+               b.billing_number::VARCHAR,
+               b.remark::VARCHAR,
+               b.created_on
+        FROM qas.v_billing b
+                 LEFT JOIN qas.v_agreement a ON a.agreement_number = b.agreement_number
+        ORDER BY b.created_on DESC, b.request_date DESC;
+END;
+$$ LANGUAGE plpgsql;
+
+SELECT * FROM qas.fn_rpt_billing();
+
+
+-- =============================================
+-- Example 2: Complex Report with UNION ALL
+-- Pattern: Multiple cases combined with empty placeholders
+-- =============================================
+
+DROP FUNCTION IF EXISTS qas.fn_rpt_output;
+CREATE OR REPLACE FUNCTION qas.fn_rpt_output()
+    RETURNS TABLE
+            (
+                modern_trade       VARCHAR,
+                branch             VARCHAR,
+                agreement_number   VARCHAR,
+                attach_file        VARCHAR,
+                attach_image       VARCHAR,
+                type_of_media      VARCHAR,
+                type_of_media_text VARCHAR,
+                start_date         VARCHAR,
+                due_date           VARCHAR,
+                status             VARCHAR,
+                amount             VARCHAR,
+                paid_amount        VARCHAR,
+                incoming_bill      VARCHAR,
+                agreement_period   VARCHAR,
+                status_name        VARCHAR,
+                request_type       VARCHAR,
+                request_date       VARCHAR,
+                paid_status        VARCHAR,
+                paid_status_name   VARCHAR,
+                billing_number     VARCHAR,
+                remark             VARCHAR,
+                created_on         VARCHAR,
+                progress           VARCHAR,
+                payment_progress   VARCHAR
+            )
+AS
+$$
+BEGIN
+    RETURN QUERY
+        SELECT *
+        FROM (
+                 -- Case 1: billing_count = 1
+                 SELECT a.modern_trade::VARCHAR,
+                        a.branch::VARCHAR,
+                        a.agreement_number::VARCHAR,
+                        a.attach_file::VARCHAR,
+                        a.attach_image::VARCHAR,
+                        a.type_of_media::VARCHAR,
+                        a.type_of_media_text::VARCHAR,
+                        a.start_date::VARCHAR,
+                        a.due_date::VARCHAR,
+                        a.status::VARCHAR,
+                        a.amount::NUMERIC(16, 2)::VARCHAR,
+                        a.paid_amount::NUMERIC(16, 2)::VARCHAR,
+                        a.incoming_bill::NUMERIC(16, 2)::VARCHAR,
+                        a.agreement_period::VARCHAR,
+                        a.status_name::VARCHAR,
+                        (CASE WHEN a.is_adhoc = TRUE THEN 'Adhoc' ELSE 'On Plan' END)::VARCHAR AS request_type,
+                        a.request_date::VARCHAR,
+                        a.paid_status::VARCHAR,
+                        a.paid_status_name::VARCHAR,
+                        b.billing_number::VARCHAR,
+                        a.remark::VARCHAR,
+                        a.created_on,
+                        a.progress::NUMERIC(16, 2)::VARCHAR,
+                        a.payment_progress::VARCHAR
+                 FROM qas.v_billing b
+                          LEFT JOIN qas.v_agreement a ON a.agreement_number = b.agreement_number
+                 WHERE a.billing_count = 1
+
+                 UNION ALL
+
+                 -- Case 2: billing_count > 1 (main record)
+                 SELECT a.modern_trade::VARCHAR,
+                        a.branch::VARCHAR,
+                        a.agreement_number::VARCHAR,
+                        a.attach_file::VARCHAR,
+                        a.attach_image::VARCHAR,
+                        a.type_of_media::VARCHAR,
+                        a.type_of_media_text::VARCHAR,
+                        a.start_date::VARCHAR,
+                        a.due_date::VARCHAR,
+                        a.status::VARCHAR,
+                        a.amount::NUMERIC(16, 2)::VARCHAR,
+                        a.paid_amount::NUMERIC(16, 2)::VARCHAR,
+                        a.incoming_bill::NUMERIC(16, 2)::VARCHAR,
+                        a.agreement_period::VARCHAR,
+                        a.status_name::VARCHAR,
+                        (CASE WHEN a.is_adhoc = TRUE THEN 'Adhoc' ELSE 'On Plan' END)::VARCHAR AS request_type,
+                        a.request_date::VARCHAR,
+                        a.paid_status::VARCHAR,
+                        a.paid_status_name::VARCHAR,
+                        ''::VARCHAR,  -- billing_number (empty for parent)
+                        ''::VARCHAR,  -- remark
+                        a.created_on,
+                        a.progress::NUMERIC(16, 2)::VARCHAR,
+                        a.payment_progress::VARCHAR
+                 FROM qas.v_agreement a
+                 WHERE a.billing_count > 1
+
+                 UNION ALL
+
+                 -- Case 3: billing_count > 1 (child records)
+                 SELECT ''::VARCHAR AS modern_trade,
+                        ''::VARCHAR AS branch,
+                        b.agreement_number AS agreement_number,
+                        ''::VARCHAR AS attach_file,
+                        ''::VARCHAR AS attach_image,
+                        ''::VARCHAR AS type_of_media,
+                        ''::VARCHAR AS type_of_media_text,
+                        ''::VARCHAR AS start_date,
+                        ''::VARCHAR AS due_date,
+                        ''::VARCHAR AS status,
+                        b.amount::NUMERIC(16, 2)::VARCHAR,
+                        ''::VARCHAR AS paid_amount,
+                        ''::VARCHAR AS incoming_bill,
+                        ''::VARCHAR AS agreement_period,
+                        ''::VARCHAR AS status_name,
+                        ''::VARCHAR AS request_type,
+                        b.request_date::VARCHAR,
+                        ''::VARCHAR AS paid_status,
+                        ''::VARCHAR AS paid_status_name,
+                        b.billing_number::VARCHAR,
+                        ''::VARCHAR AS remark,
+                        ''::VARCHAR AS created_on,
+                        ''::VARCHAR AS progress,
+                        ''::VARCHAR AS payment_progress
+                 FROM qas.v_billing b
+                          LEFT JOIN qas.v_agreement a ON a.agreement_number = b.agreement_number
+                 WHERE a.billing_count > 1
+
+                 UNION ALL
+
+                 -- Case 4: billing_count = 0
+                 SELECT a.modern_trade::VARCHAR,
+                        a.branch::VARCHAR,
+                        a.agreement_number::VARCHAR,
+                        a.attach_file::VARCHAR,
+                        a.attach_image::VARCHAR,
+                        a.type_of_media::VARCHAR,
+                        a.type_of_media_text::VARCHAR,
+                        a.start_date::VARCHAR,
+                        a.due_date::VARCHAR,
+                        a.status::VARCHAR,
+                        a.amount::NUMERIC(16, 2)::VARCHAR,
+                        a.paid_amount::NUMERIC(16, 2)::VARCHAR,
+                        a.incoming_bill::NUMERIC(16, 2)::VARCHAR,
+                        a.agreement_period::VARCHAR,
+                        a.status_name::VARCHAR,
+                        (CASE WHEN a.is_adhoc = TRUE THEN 'Adhoc' ELSE 'On Plan' END)::VARCHAR AS request_type,
+                        a.request_date::VARCHAR,
+                        a.paid_status::VARCHAR,
+                        a.paid_status_name::VARCHAR,
+                        b.billing_number::VARCHAR,
+                        a.remark::VARCHAR,
+                        a.created_on,
+                        a.progress::NUMERIC(16, 2)::VARCHAR,
+                        a.payment_progress::VARCHAR
+                 FROM qas.v_agreement a
+                          LEFT JOIN qas.v_billing b ON a.agreement_number = b.agreement_number
+                 WHERE a.billing_count = 0
+             ) AS t
+        ORDER BY agreement_number DESC, t.created_on DESC;
+END;
+$$ LANGUAGE plpgsql;
+
+SELECT * FROM qas.fn_rpt_output();

package/templates/.claude/skills/postgres/reference/utility_functions.sql

@@ -0,0 +1,94 @@
+-- =============================================
+-- UTILITY FUNCTION EXAMPLES
+-- Pattern: glb_fn_<name> - Global utility functions
+-- =============================================
+
+
+-- =============================================
+-- Convert Query Result to JSON
+-- =============================================
+
+DROP FUNCTION IF EXISTS public.glb_fn_convert_query_to_json;
+CREATE OR REPLACE FUNCTION public.glb_fn_convert_query_to_json(query_text TEXT)
+    RETURNS JSONB
+AS
+$$
+DECLARE
+    result   JSONB := '[]';
+    row_data RECORD;
+BEGIN
+    FOR row_data IN EXECUTE query_text
+        LOOP
+            result := result || jsonb_build_array(row_to_json(row_data));
+        END LOOP;
+
+    RETURN result;
+END;
+$$ LANGUAGE plpgsql;
+
+-- Usage
+SELECT public.glb_fn_convert_query_to_json('SELECT * FROM qas.collect_point');
+
+
+-- =============================================
+-- TABLE STRUCTURE TEMPLATE
+-- =============================================
+
+CREATE TABLE schema_name.table_name
+(
+    -- Primary key with UUID
+    id_table_name VARCHAR DEFAULT uuid_in(overlay(overlay(md5(random()::text || ':' || random()::text) placing '4' from 13) placing to_hex(floor(random() * (11 - 8 + 1) + 8)::int)::text from 17)::cstring) PRIMARY KEY,
+
+    -- VARCHAR columns
+    name          VARCHAR,
+    status        VARCHAR,
+    description   VARCHAR,
+
+    -- NUMERIC columns
+    amount        NUMERIC(16, 2),
+    quantity      NUMERIC(16, 2),
+
+    -- BOOLEAN columns
+    is_active     BOOLEAN DEFAULT TRUE,
+    is_deleted    BOOLEAN DEFAULT FALSE,
+
+    -- Audit columns
+    created_on    VARCHAR DEFAULT TO_CHAR(date_trunc('second', now() AT TIME ZONE 'Asia/Ho_Chi_Minh'), 'YYYY-MM-DD HH24:MI:SS')::character varying,
+    created_by    VARCHAR,
+    updated_on    VARCHAR,
+    updated_by    VARCHAR,
+    deleted_at    VARCHAR
+);
+
+
+-- =============================================
+-- VIEW TEMPLATE
+-- =============================================
+
+CREATE OR REPLACE VIEW schema_name.v_table_name AS
+SELECT t.id_table_name,
+       t.name,
+       t.status,
+       t.description,
+       COALESCE(t.amount, 0)::NUMERIC(16, 2)  AS amount,
+       COALESCE(t.quantity, 0)::NUMERIC(16, 2) AS quantity,
+       t.is_active,
+       t.created_on,
+       t.created_by
+FROM schema_name.table_name t
+WHERE t.deleted_at IS NULL
+  AND t.is_deleted = FALSE;
+
+
+-- =============================================
+-- INDEX TEMPLATES
+-- =============================================
+
+-- Single column index
+CREATE INDEX idx_table_column ON schema_name.table_name (column_name);
+
+-- Composite index
+CREATE INDEX idx_table_col1_col2 ON schema_name.table_name (column1, column2 DESC);
+
+-- Partial index (soft delete)
+CREATE INDEX idx_table_active ON schema_name.table_name (status) WHERE deleted_at IS NULL;

package/templates/.claude/skills/pptx/LICENSE.txt

@@ -0,0 +1,30 @@
+© 2025 Anthropic, PBC. All rights reserved.
+
+LICENSE: Use of these materials (including all code, prompts, assets, files,
+and other components of this Skill) is governed by your agreement with
+Anthropic regarding use of Anthropic's services. If no separate agreement
+exists, use is governed by Anthropic's Consumer Terms of Service or
+Commercial Terms of Service, as applicable:
+https://www.anthropic.com/legal/consumer-terms
+https://www.anthropic.com/legal/commercial-terms
+Your applicable agreement is referred to as the "Agreement." "Services" are
+as defined in the Agreement.
+
+ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the
+contrary, users may not:
+
+- Extract these materials from the Services or retain copies of these
+  materials outside the Services
+- Reproduce or copy these materials, except for temporary copies created
+  automatically during authorized use of the Services
+- Create derivative works based on these materials
+- Distribute, sublicense, or transfer these materials to any third party
+- Make, offer to sell, sell, or import any inventions embodied in these
+  materials
+- Reverse engineer, decompile, or disassemble these materials
+
+The receipt, viewing, or possession of these materials does not convey or
+imply any license or right beyond those expressly granted above.
+
+Anthropic retains all right, title, and interest in these materials,
+including all copyrights, patents, and other intellectual property rights.