naming-convention

name	naming-convention
description	Kiểm tra, đề xuất và tạo tên chuẩn cho các đối tượng ABAP (Dictionary, CDS, RAP), Fiori, Package và GitHub Repositories theo quy chuẩn của dự án FPT. Sử dụng khi người dùng yêu cầu tạo object mới, cấu trúc project hoặc review mã nguồn.

FPT Project Naming Convention Skill

Mục tiêu (Goal)

Đảm bảo tất cả các thành phần phần mềm (ABAP, Fiori, Packages, Git) được đặt tên tuân thủ tuyệt đối quy định của dự án.

Hướng dẫn (Instructions)

Khi người dùng yêu cầu tạo mới một đối tượng, hoặc nhờ kiểm tra tên của một đối tượng, hãy đối chiếu với bảng quy tắc bên dưới để đưa ra tên chính xác. Luôn giải thích ngắn gọn tại sao lại dùng Prefix/Suffix đó.

Quy tắc 1: ABAP Dictionary & Source Code (Eclipse Objects)

Tất cả các custom objects thường bắt đầu bằng Z cộng với Prefix.

• Database Tables: Dữ liệu thật (Persistent) dùng ZA_ (VD: ZA_Customer). Dữ liệu nháp (Draft) dùng ZD_ (VD: ZD_Customer).
• Class & Interface: Global Class (CL_), Global Interface (IF_), Exception (CX_).
• Các thành phần khác: Domain (DO_), Data Element (DE_), Table Type (TT_), Structure (ST_), Number Range (NR_), Message Class (MC_).

Quy tắc 2: Tầng CDS & RAP Model

• Interface CDS Entity: Prefix I_ (VD: ZI_Customer)
• Base CDS Entity / Root BDEF: Prefix R_ (VD: ZR_Customer)
• Projection CDS / Projection BDEF: Prefix C_ (VD: ZC_Customer)
• Custom Entity: Prefix CE_ (VD: ZCE_Customer)
• Metadata Extension: Tên giống hệt với CDS Entity liên quan (VD: ZC_Customer).
• RAP Source Code:
  • Behavior Pool: Prefix BP_ (VD: ZBP_Customer)
  • Handler Class: Prefix LHC_ (VD: ZLHC_Customer)
  • Saver Class: Prefix LSC_ (VD: ZLSC_Customer)

Quy tắc 3: Business Services (OData)

• Service Definition: Dành cho UI dùng UI_ (VD: ZUI_Customer), dành cho API dùng API_ (VD: ZAPI_Customer).
• Service Binding:
  • UI OData V2: Prefix UI_, Suffix _O2 (VD: ZUI_Customer_O2)
  • UI OData V4: Prefix UI_, Suffix _O4 (VD: ZUI_Customer_O4)
  • Web API V2: Prefix API_, Suffix _O2 (VD: ZAPI_Customer_O2)
  • Web API V4: Prefix API_, Suffix _O4 (VD: ZAPI_Customer_O4)

Quy tắc 4: Fiori & IAM

• Business Role: Prefix BR_
• Space: Prefix SP_
• Page: Prefix PA_

Quy tắc 5: Cấu trúc Package Hierarchy (ZFPT)

• ZFPT: Root Package.
• ZFPT_CORE: Core Function.
• ZFPT_INT: Integration (Package con VD: ZEBANKING, ZINVOICE).
• ZFPT_EH: Enhancement (Package con theo module VD: ZEH_FI, ZEH_SD).
• ZFPT_REPORT: Reports and Function (Package con theo module VD: ZREPORT_FI, ZREPORT_SD, ZREPORT_HR...).

Ví dụ (Examples)

• User: "Tôi muốn tạo một bảng chứa dữ liệu Hóa Đơn và một RAP model cho nó để làm Fiori app".
• AI Response: Dựa theo chuẩn dự án FPT, bạn cần tạo các object sau:
  1. Package: ZFPT_REPORT (hoặc ZREPORT_FI tùy ngữ cảnh).
  2. Table: ZA_Invoice (Persist), ZD_Invoice (Draft).
  3. Base CDS & BDEF: ZR_Invoice
  4. Projection CDS & BDEF: ZC_Invoice
  5. Metadata Extension: ZC_Invoice
  6. Behavior Pool: ZBP_Invoice
  7. Service Definition: ZUI_Invoice
  8. Service Binding: ZUI_Invoice_O4 (Khuyên dùng V4 cho Fiori).