ROMFASTSQL/system_instructions/README.md

System Instructions - ROMFASTSQL

Acest director contine instructiuni system si exemple pentru proiectul ROMFASTSQL - un sistem de migrare pentru baza de date ERP romaneasca Oracle.

Structura

• system_prompt.md - Instructiuni principale pentru generarea scripturilor SQL
• knowledge_base/ - Colectie de exemple si utilitare
  • PACK_MIGRARE.pck - Package-ul central cu functii utilitare
  • Multiple fisiere exemplu de scripturi (ff_.sql, co_.sql)

Componente Principale

PACK_MIGRARE Package

Package-ul central care ofera functii de verificare:

• ColumnExist() - Verifica daca o coloana exista
• ObjectExist() - Verifica daca un obiect exista
• ConstraintExist() - Verifica daca o restrictie exista
• UpdateVersiune() - Tracking versiuni pentru scripturi

Exemple Scripturi Migrare

Directorul knowledge_base/ contine exemple pentru:

• ff_*.sql - Scripturi de tip "Fast Forward" pentru modificari structurale
• co_*.sql - Scripturi pentru obiecte comune

Conventii Obligatorii

Formatare SQL

• NU folositi ghilimele in jurul numelor de tabele/coloane
• NU specificati numele schemei (ex: folositi JV2007 nu "SCHEMA"."JV2007")
• MAJUSCULE pentru toate cuvintele cheie SQL
• Comentarii in romana

Structura Scripturi

1. Comentariu scurt in romana la inceput
2. Verificari existenta prin PACK_MIGRARE
3. Operatiuni DDL in blocuri PL/SQL
4. MERGE cu NOT MATCHED pentru inserari
5. COMMENT statements directe (nu EXECUTE IMMEDIATE)
6. pack_migrare.UpdateVersiune() la sfarsit
7. commit;

Nomenclatura

• Fisiere: ff_YYYY_MM_DD_NN_TYPE.sql sau co_YYYY_MM_DD_NN_TYPE.sql
• Exemple: ff_2024_08_28_02_COMUN_EFACTURA.sql, co_2024_03_04_01_OBIECTE.sql
• ff_ - Fast Forward, pentru modificari structurale si date
• co_ - Common Objects, pentru obiecte si definitii sistem

Tipuri Comune de Modificari

1. Adaugare Coloane

• Verificare existenta cu PACK_MIGRARE.COLUMNEXIST()
• Executie in bloc PL/SQL cu EXECUTE IMMEDIATE
• Adaugare COMMENT ON COLUMN pentru documentare

2. Inserare Date Configurare (OPTIUNI)

• MERGE INTO cu USING DUAL
• Doar clauza WHEN NOT MATCHED pentru idempotenta
• Tipuri: CHARACTER, NUMERIC

3. Inserare Obiecte Sistem (DEF_OBIECTE)

• MERGE pe id_obiect unic
• Include relatii parinte-copil (id_tata)
• Gestionare drepturi prin DEF_GRUP_DREPT_OBIECTE

4. Creare/Modificare View-uri

• CREATE OR REPLACE VIEW
• Join-uri complexe pentru agregare date
• Alias-uri descriptive in romana

5. Update-uri Simple

• UPDATE direct pentru corectii date
• TRIM pentru curatare spatii
• REPLACE pentru modificari cai/valori

Utilizare

Aceste fisiere servesc ca ghid si exemple pentru crearea scripturilor SQL de migrare sigure si idempotente in cadrul proiectului ROMFASTSQL.