@linkup-ai/abap-ai 2.0.0

package/dist/knowledge/abap/cloud-background-processing.md

@@ -0,0 +1,250 @@
+# ABAP Cloud Background Processing — application jobs, scheduling
+
+## Application Job Architecture
+
+```
+Job Catalog Entry (developer — defines the job class)
+  → Job Template (developer — defines default parameters)
+    → Job Scheduling (admin — creates schedule in Fiori app)
+      → Job Execution (runtime — framework calls the class)
+```
+
+Replaces SM36/SM37 and SUBMIT...VIA JOB.
+
+## Job Class Definition
+
+```abap
+CLASS zcl_order_cleanup_job DEFINITION PUBLIC FINAL CREATE PUBLIC.
+  PUBLIC SECTION.
+    INTERFACES if_apj_dt_exec_object.  " Design-time: parameter catalog
+    INTERFACES if_apj_rt_exec_object.  " Run-time: execute method
+ENDCLASS.
+
+CLASS zcl_order_cleanup_job IMPLEMENTATION.
+
+  METHOD if_apj_dt_exec_object~get_parameters.
+    " Define job parameters (shown in scheduling UI)
+    et_parameter_def = VALUE #(
+      ( selname     = 'P_STATUS'
+        kind        = if_apj_dt_exec_object=>parameter
+        datatype    = 'C'
+        length      = 1
+        param_text  = 'Status to clean up'
+        changeable_ind = abap_true )
+      ( selname     = 'P_DAYS'
+        kind        = if_apj_dt_exec_object=>parameter
+        datatype    = 'I'
+        param_text  = 'Older than (days)'
+        changeable_ind = abap_true )
+    ).
+
+    " Default values
+    et_parameter_val = VALUE #(
+      ( selname = 'P_STATUS' sign = 'I' option = 'EQ' low = 'D' )
+      ( selname = 'P_DAYS'   sign = 'I' option = 'EQ' low = '30' )
+    ).
+  ENDMETHOD.
+
+  METHOD if_apj_rt_exec_object~execute.
+    " Read parameters
+    DATA lv_status TYPE c LENGTH 1.
+    DATA lv_days TYPE i.
+
+    LOOP AT it_parameters INTO DATA(ls_param).
+      CASE ls_param-selname.
+        WHEN 'P_STATUS'. lv_status = ls_param-low.
+        WHEN 'P_DAYS'.   lv_days = CONV i( ls_param-low ).
+      ENDCASE.
+    ENDLOOP.
+
+    " Calculate cutoff date
+    DATA(lv_cutoff) = cl_abap_context_info=>get_system_date( ) - lv_days.
+
+    " Business logic
+    DELETE FROM ztab_order
+      WHERE status = @lv_status
+        AND created_at < @lv_cutoff.
+
+    DATA(lv_deleted) = sy-dbcnt.
+
+    " Log result (application log)
+    DATA(lo_log) = cl_bali_log=>create_with_header(
+      cl_bali_header_setter=>create(
+        iv_object = 'ZORDER' iv_subobject = 'CLEANUP' ) ).
+
+    lo_log->add_item( cl_bali_message_setter=>create(
+      iv_severity     = if_bali_constants=>c_severity_information
+      iv_message_text = |Deleted { lv_deleted } orders with status { lv_status } older than { lv_days } days| ) ).
+
+    cl_bali_log_db=>get_instance( )->save_log( lo_log ).
+  ENDMETHOD.
+
+ENDCLASS.
+```
+
+## Job Catalog Entry (ADT)
+
+```
+Object type: Application Job Catalog Entry
+Name: Z_JC_ORDER_CLEANUP
+Class: ZCL_ORDER_CLEANUP_JOB
+Description: Clean up old orders
+```
+
+Created in ADT: New → Other ABAP Repository Object → Application Job Catalog Entry.
+
+## Job Template (ADT)
+
+```
+Object type: Application Job Template
+Name: Z_JT_ORDER_CLEANUP
+Catalog Entry: Z_JC_ORDER_CLEANUP
+Description: Order cleanup - draft orders 30 days
+Parameters:
+  P_STATUS = 'D'
+  P_DAYS = '30'
+```
+
+## Schedule Job Programmatically
+
+```abap
+" Schedule a job to run immediately
+DATA(lv_job_name) = 'Z_ORDER_CLEANUP_' && sy-datum.
+
+cl_apj_rt_api=>schedule_job(
+  EXPORTING
+    iv_catalog_entry = 'Z_JC_ORDER_CLEANUP'
+    iv_template      = 'Z_JT_ORDER_CLEANUP'
+    iv_job_name      = CONV #( lv_job_name )
+    it_job_parameter = VALUE #(
+      ( selname = 'P_STATUS' sign = 'I' option = 'EQ' low = 'X' )
+      ( selname = 'P_DAYS'   sign = 'I' option = 'EQ' low = '7' ) )
+    iv_start_info    = VALUE cl_apj_rt_api=>ty_start_info(
+      start_immediately = abap_true )
+  IMPORTING
+    ev_jobcount = DATA(lv_jobcount)
+    ev_jobname  = DATA(lv_jobname) ).
+```
+
+## Schedule Recurring Job
+
+```abap
+" Every day at 02:00
+cl_apj_rt_api=>schedule_job(
+  EXPORTING
+    iv_catalog_entry = 'Z_JC_ORDER_CLEANUP'
+    iv_template      = 'Z_JT_ORDER_CLEANUP'
+    iv_job_name      = 'Z_DAILY_CLEANUP'
+    iv_start_info    = VALUE cl_apj_rt_api=>ty_start_info(
+      start_immediately = abap_false
+      timestamp         = CONV #( '20260315020000' ) )
+    iv_scheduling_info = VALUE cl_apj_rt_api=>ty_scheduling_info(
+      periodic          = abap_true
+      period_unit       = 'DAY'
+      period_value      = 1 )
+  IMPORTING
+    ev_jobcount = DATA(lv_jc)
+    ev_jobname  = DATA(lv_jn) ).
+```
+
+## Period Units
+
+| Unit | Description |
+|------|-------------|
+| `'MIN'` | Minutes |
+| `'HOR'` | Hours |
+| `'DAY'` | Days |
+| `'WEK'` | Weeks |
+| `'MON'` | Months |
+
+## Check Job Status
+
+```abap
+" Get job status
+cl_apj_rt_api=>get_job_status(
+  EXPORTING
+    iv_jobname  = lv_jobname
+    iv_jobcount = lv_jobcount
+  IMPORTING
+    ev_status   = DATA(lv_status)
+    ev_status_text = DATA(lv_status_text) ).
+
+" Status values:
+" F = Finished
+" A = Aborted
+" R = Running
+" S = Scheduled
+" P = Ready (planned)
+```
+
+## Cancel Job
+
+```abap
+cl_apj_rt_api=>cancel_job(
+  iv_jobname  = lv_jobname
+  iv_jobcount = lv_jobcount ).
+```
+
+## Using in RAP — Trigger Job from Action
+
+```abap
+METHOD scheduleCleanup.
+  " RAP action handler that schedules background processing
+  TRY.
+      cl_apj_rt_api=>schedule_job(
+        EXPORTING
+          iv_catalog_entry = 'Z_JC_ORDER_CLEANUP'
+          iv_template      = 'Z_JT_ORDER_CLEANUP'
+          iv_job_name      = |CLEANUP_{ sy-datum }_{ sy-uzeit }|
+          it_job_parameter = VALUE #(
+            ( selname = 'P_STATUS' sign = 'I' option = 'EQ' low = 'D' )
+            ( selname = 'P_DAYS'   sign = 'I' option = 'EQ' low = '30' ) )
+          iv_start_info = VALUE cl_apj_rt_api=>ty_start_info(
+            start_immediately = abap_true )
+        IMPORTING
+          ev_jobname = DATA(lv_job) ).
+
+      APPEND VALUE #(
+        %tky = keys[ 1 ]-%tky
+        %msg = new_message_with_text(
+          severity = if_abap_behv_message=>severity-success
+          text = |Cleanup job { lv_job } scheduled| ) )
+        TO reported-order.
+
+    CATCH cx_apj_rt INTO DATA(lx).
+      APPEND VALUE #(
+        %tky = keys[ 1 ]-%tky
+        %msg = new_message_with_text(
+          severity = if_abap_behv_message=>severity-error
+          text = lx->get_text( ) ) )
+        TO reported-order.
+  ENDTRY.
+ENDMETHOD.
+```
+
+## Fiori App — Job Scheduling
+
+Admin schedules jobs via Fiori app **Application Jobs** (F1609):
+- Select job template
+- Set parameters
+- Choose schedule (immediate / recurring / calendar)
+- Monitor execution and logs
+
+## Rules
+- Job class implements BOTH `if_apj_dt_exec_object` (params) AND `if_apj_rt_exec_object` (execute)
+- Job Catalog Entry + Job Template are design-time artifacts (created in ADT)
+- Job Scheduling is runtime (admin via Fiori app or `cl_apj_rt_api`)
+- Use application logging (`cl_bali_log`) inside jobs for monitoring
+- `cl_abap_context_info=>get_system_date()` instead of `sy-datum` in jobs
+- Parameters use SELECT-OPTIONS structure: selname, sign, option, low, high
+- Handle `cx_apj_rt` when scheduling programmatically
+
+## Anti-Patterns
+| Anti-Pattern | Correct |
+|---|---|
+| `SUBMIT report VIA JOB` | `cl_apj_rt_api=>schedule_job()` |
+| `CALL FUNCTION...IN BACKGROUND TASK` | Application Job |
+| SM36 / SM37 | Fiori app "Application Jobs" |
+| `sy-datum` in job class | `cl_abap_context_info=>get_system_date()` |
+| No logging in job | Use `cl_bali_log` for execution monitoring |
+| Hardcoded schedule in code | Use Job Template + admin scheduling |

package/dist/knowledge/abap/cloud-communication.md

@@ -0,0 +1,265 @@
+# ABAP Cloud Communication — HTTP client, communication scenarios, outbound calls
+
+## Communication Scenario Architecture
+
+```
+ABAP Cloud App
+  → Communication Arrangement (config in Fiori launchpad)
+    → Communication System (target host + auth)
+      → Communication Scenario (defines what services are consumed)
+        → Outbound Service (HTTP, RFC, SOAP)
+```
+
+## Define Communication Scenario (Developer)
+
+```abap
+" 1. Create Communication Scenario in ADT:
+"    - Name: Z_CS_EXTERNAL_API
+"    - Allowed instances: 1 (or more)
+"    - Add Outbound Service:
+"      Service ID: Z_OS_EXT_API
+"      Service Type: HTTP
+"      URL path: /api/v1
+"      Default port: 443
+```
+
+## HTTP Client — Outbound Call (Cloud Pattern)
+
+```abap
+CLASS zcl_external_api DEFINITION PUBLIC FINAL CREATE PUBLIC.
+  PUBLIC SECTION.
+    METHODS call_api
+      IMPORTING iv_order_id TYPE numc10
+      RETURNING VALUE(rs_result) TYPE zs_api_result
+      RAISING   cx_static_check.
+ENDCLASS.
+
+CLASS zcl_external_api IMPLEMENTATION.
+  METHOD call_api.
+    " 1. Get HTTP destination from communication arrangement
+    DATA(lo_dest) = cl_http_destination_provider=>create_by_comm_arrangement(
+      comm_scenario  = 'Z_CS_EXTERNAL_API'
+      service_id     = 'Z_OS_EXT_API' ).
+
+    " 2. Create HTTP client
+    DATA(lo_client) = cl_web_http_client_manager=>create_by_http_destination( lo_dest ).
+
+    " 3. Build request
+    DATA(lo_request) = lo_client->get_http_request( ).
+    lo_request->set_uri_path( |/api/v1/orders/{ iv_order_id }| ).
+    lo_request->set_header_field(
+      i_name  = 'Accept'
+      i_value = 'application/json' ).
+
+    " 4. Execute
+    DATA(lo_response) = lo_client->execute( if_web_http_client=>get ).
+
+    " 5. Process response
+    DATA(lv_status) = lo_response->get_status( )-code.
+    DATA(lv_body) = lo_response->get_text( ).
+
+    IF lv_status <> 200.
+      RAISE EXCEPTION TYPE zcx_api_error
+        EXPORTING textid = zcx_api_error=>http_error
+                  mv_status = lv_status
+                  mv_body = lv_body.
+    ENDIF.
+
+    " 6. Parse JSON response
+    xco_cp_json=>data->from_string( lv_body )->write_to( REF #( rs_result ) ).
+
+    " 7. Close client
+    lo_client->close( ).
+  ENDMETHOD.
+ENDCLASS.
+```
+
+## HTTP Methods
+
+```abap
+" GET
+DATA(lo_resp) = lo_client->execute( if_web_http_client=>get ).
+
+" POST
+lo_request->set_text( lv_json_body ).
+lo_request->set_header_field( i_name = 'Content-Type' i_value = 'application/json' ).
+DATA(lo_resp) = lo_client->execute( if_web_http_client=>post ).
+
+" PUT
+DATA(lo_resp) = lo_client->execute( if_web_http_client=>put ).
+
+" PATCH
+DATA(lo_resp) = lo_client->execute( if_web_http_client=>patch ).
+
+" DELETE
+DATA(lo_resp) = lo_client->execute( if_web_http_client=>delete ).
+```
+
+## Response Handling
+
+```abap
+" Status code
+DATA(lv_status) = lo_response->get_status( )-code.     " 200, 404, 500
+DATA(lv_reason) = lo_response->get_status( )-reason.   " 'OK', 'Not Found'
+
+" Body
+DATA(lv_text) = lo_response->get_text( ).              " string
+DATA(lv_xstr) = lo_response->get_binary( ).            " xstring
+
+" Headers
+DATA(lv_content_type) = lo_response->get_header_field( 'Content-Type' ).
+
+" JSON → ABAP
+DATA ls_result TYPE zs_api_result.
+xco_cp_json=>data->from_string( lv_text )->write_to( REF #( ls_result ) ).
+
+" JSON → internal table
+DATA lt_items TYPE STANDARD TABLE OF zs_item.
+xco_cp_json=>data->from_string( lv_text )->write_to( REF #( lt_items ) ).
+```
+
+## POST with JSON Body
+
+```abap
+" ABAP → JSON
+DATA(lv_json) = xco_cp_json=>data->from_abap(
+  VALUE zs_order_request(
+    customer_id = 'CUST100'
+    amount = 500
+    items = VALUE #(
+      ( product_id = 'PROD001' quantity = 2 )
+      ( product_id = 'PROD002' quantity = 1 ) ) )
+)->to_string( ).
+
+" Set body and content type
+lo_request->set_text( lv_json ).
+lo_request->set_header_field( i_name = 'Content-Type' i_value = 'application/json' ).
+
+" Execute POST
+DATA(lo_response) = lo_client->execute( if_web_http_client=>post ).
+```
+
+## URL Parameters
+
+```abap
+" Query parameters
+lo_request->set_uri_path( '/api/v1/orders' ).
+lo_request->set_query(
+  i_query = |status=open&limit=50&offset=0| ).
+
+" Or build path with parameters
+lo_request->set_uri_path(
+  |/api/v1/orders?status=open&customer={ cl_web_http_utility=>encode_url( lv_customer ) }| ).
+```
+
+## Authentication Types (Communication Arrangement)
+
+| Type | Use |
+|------|-----|
+| **Basic Authentication** | User/password (simple, legacy) |
+| **OAuth 2.0 Client Credentials** | Machine-to-machine (most common for APIs) |
+| **OAuth 2.0 SAML Bearer** | User propagation (principal propagation) |
+| **Client Certificate** | mTLS |
+| **No Authentication** | Public APIs |
+
+Authentication is configured in the **Communication Arrangement** (Fiori launchpad), not in code.
+
+## Consume OData Service (Cloud)
+
+```abap
+" Create destination for OData service
+DATA(lo_dest) = cl_http_destination_provider=>create_by_comm_arrangement(
+  comm_scenario = 'Z_CS_ODATA_SRV'
+  service_id    = 'Z_OS_ODATA' ).
+
+" Create HTTP client
+DATA(lo_client) = cl_web_http_client_manager=>create_by_http_destination( lo_dest ).
+
+" OData GET
+DATA(lo_request) = lo_client->get_http_request( ).
+lo_request->set_uri_path( '/sap/opu/odata/sap/API_BUSINESS_PARTNER/A_BusinessPartner' ).
+lo_request->set_header_field( i_name = 'Accept' i_value = 'application/json' ).
+lo_request->set_query( '$top=10&$filter=BusinessPartner eq ''1000000''' ).
+
+DATA(lo_response) = lo_client->execute( if_web_http_client=>get ).
+DATA(lv_json) = lo_response->get_text( ).
+lo_client->close( ).
+```
+
+## Error Handling Pattern
+
+```abap
+METHOD call_api.
+  TRY.
+      DATA(lo_dest) = cl_http_destination_provider=>create_by_comm_arrangement(
+        comm_scenario = 'Z_CS_API'
+        service_id    = 'Z_OS_API' ).
+
+      DATA(lo_client) = cl_web_http_client_manager=>create_by_http_destination( lo_dest ).
+
+      DATA(lo_response) = lo_client->execute( if_web_http_client=>get ).
+      DATA(lv_status) = lo_response->get_status( )-code.
+
+      IF lv_status >= 400.
+        RAISE EXCEPTION TYPE zcx_api_error
+          EXPORTING mv_status = lv_status
+                    mv_body   = lo_response->get_text( ).
+      ENDIF.
+
+      rs_result = parse_response( lo_response->get_text( ) ).
+
+    CATCH cx_http_dest_provider_error INTO DATA(lx_dest).
+      " Communication arrangement not configured
+      RAISE EXCEPTION TYPE zcx_api_error
+        EXPORTING previous = lx_dest
+                  textid   = zcx_api_error=>comm_arrangement_missing.
+
+    CATCH cx_web_http_client_error INTO DATA(lx_http).
+      " Network/connection error
+      RAISE EXCEPTION TYPE zcx_api_error
+        EXPORTING previous = lx_http
+                  textid   = zcx_api_error=>connection_failed.
+
+    CLEANUP.
+      IF lo_client IS BOUND.
+        lo_client->close( ).
+      ENDIF.
+  ENDTRY.
+ENDMETHOD.
+```
+
+## Setup Steps (Admin — Fiori Launchpad)
+
+```
+1. Communication System (target)
+   - Host: api.example.com
+   - Port: 443
+   - Auth: OAuth 2.0 Client Credentials
+   - Token endpoint: https://auth.example.com/oauth/token
+   - Client ID / Secret
+
+2. Communication Arrangement
+   - Scenario: Z_CS_EXTERNAL_API
+   - Communication System: (from step 1)
+   - Outbound Service: Z_OS_EXT_API → active
+```
+
+## Rules
+- Cloud: ALWAYS use `cl_http_destination_provider=>create_by_comm_arrangement` — never hardcode URLs
+- Cloud: NEVER store credentials in code — always in Communication Arrangement
+- Always close HTTP client in CLEANUP or after use
+- Use XCO JSON for serialization/deserialization (no /ui2/cl_json in Cloud)
+- Handle both HTTP errors (status >= 400) and connection errors (exceptions)
+- URL-encode user input in query parameters: `cl_web_http_utility=>encode_url()`
+- Communication Scenario = developer artifact; Communication Arrangement = admin config
+
+## Anti-Patterns
+| Anti-Pattern | Correct |
+|---|---|
+| `cl_http_client=>create_by_url( 'https://...' )` | `cl_http_destination_provider=>create_by_comm_arrangement()` |
+| Hardcoded URLs in code | Communication Arrangement |
+| Credentials in source code | Communication System config |
+| `/ui2/cl_json=>serialize()` in Cloud | `xco_cp_json=>data->from_abap()` |
+| Missing `lo_client->close()` | Always close in CLEANUP block |
+| Missing error handling for HTTP status | Check `get_status()-code >= 400` |
+| `CALL FUNCTION 'HTTP_...'` | Cloud HTTP client classes |

package/dist/knowledge/abap/cloud-development.md

@@ -0,0 +1,176 @@
+# ABAP Cloud — language version, restricted statements, migration patterns
+
+## Language Versions
+
+| Version | Where | Access |
+|---------|-------|--------|
+| **ABAP for Cloud Development** | S/4HANA Cloud, BTP ABAP Environment | Released APIs only |
+| **Standard ABAP** | S/4HANA on-premise, ECC | All APIs (including unreleased) |
+| **ABAP for Key Users** | S/4HANA Cloud | Custom fields, custom logic (limited) |
+
+```abap
+" Set language version on class/program
+@AbapCatalog.compiler.abapLanguageVersion: #ABAP_FOR_CLOUD_DEVELOPMENT
+CLASS zcl_my_cloud_class DEFINITION PUBLIC FINAL CREATE PUBLIC.
+```
+
+## Prohibited Statements in Cloud
+
+```abap
+" === SCREEN / DYNPRO ===
+WRITE ...                        " prohibited — use CL_DEMO_OUTPUT or if_oo_adt_classrun
+CALL SCREEN ...                  " prohibited — use RAP + Fiori
+SET SCREEN ...                   " prohibited
+LEAVE TO SCREEN ...              " prohibited
+SELECTION-SCREEN ...             " prohibited
+PARAMETERS ...                   " prohibited
+SELECT-OPTIONS ...               " prohibited
+
+" === REPORTS / PROGRAMS ===
+REPORT ...                       " prohibited — use classes
+SUBMIT ...                       " prohibited — use application jobs
+CALL TRANSACTION ...             " prohibited
+LEAVE TO TRANSACTION ...         " prohibited
+MESSAGE ... DISPLAY LIKE ...     " prohibited
+
+" === DATABASE (legacy) ===
+SELECT ... ENDSELECT             " prohibited — use INTO TABLE
+EXEC SQL ... ENDEXEC             " prohibited — use ABAP SQL or AMDP
+OPEN CURSOR / FETCH / CLOSE      " prohibited — use PACKAGE SIZE
+
+" === FUNCTION MODULES (unreleased) ===
+CALL FUNCTION 'unreleased_FM'    " prohibited — only released FMs allowed
+CALL FUNCTION ... IN UPDATE TASK " prohibited — use RAP save sequence
+CALL FUNCTION ... STARTING NEW TASK  " prohibited — use application jobs
+
+" === FILE SYSTEM ===
+OPEN DATASET ...                 " prohibited — use XCO or cloud file APIs
+READ DATASET ...                 " prohibited
+TRANSFER ...                     " prohibited
+DELETE DATASET ...               " prohibited
+
+" === OTHER ===
+GENERATE SUBROUTINE POOL ...     " prohibited
+CALL 'system_function'           " prohibited
+SYSTEM-CALL ...                  " prohibited
+AUTHORITY-CHECK ...              " prohibited in RAP — use BDEF authorization
+```
+
+## Cloud Equivalents — Migration Patterns
+
+| Classic (Prohibited) | Cloud Equivalent |
+|---|---|
+| `WRITE` / `REPORT` | `if_oo_adt_classrun~main( )` for console output |
+| `CALL FUNCTION 'FM'` | Released class methods or wrapper |
+| `SELECT...ENDSELECT` | `SELECT...INTO TABLE @DATA(lt)` + `LOOP AT lt` |
+| `CALL TRANSACTION` | RAP + Fiori Elements |
+| `SUBMIT report` | Application Jobs (`cl_apj_rt_api`) |
+| `AUTHORITY-CHECK` | RAP BDEF `authorization master` |
+| `OPEN DATASET` | `xco_cp_file=>for( )` or cloud file APIs |
+| `READ TABLE...BINARY SEARCH` | `SORTED TABLE` + table expression |
+| `DESCRIBE TABLE...LINES` | `lines( itab )` |
+| `MOVE-CORRESPONDING` | `CORRESPONDING #( source )` |
+| `CREATE OBJECT` | `NEW zcl_class( )` |
+| `TRANSLATE...TO UPPER` | `to_upper( text )` |
+| `CONCATENATE...INTO` | String template `\| \|` or `&&` |
+| `CALL FUNCTION 'GUID_CREATE'` | `cl_system_uuid=>create_uuid_x16_static( )` |
+| `CALL FUNCTION 'POPUP_TO_CONFIRM'` | Fiori MessageBox (frontend) |
+| `SY-SUBRC after SELECT` | `IF lt IS INITIAL` or `SELECT SINGLE @abap_true` |
+| `MESSAGE e001(zmsg)` | Exception class with `if_t100_message` |
+
+## Console Output (classrun)
+
+```abap
+CLASS zcl_test DEFINITION PUBLIC FINAL CREATE PUBLIC.
+  PUBLIC SECTION.
+    INTERFACES if_oo_adt_classrun.
+ENDCLASS.
+
+CLASS zcl_test IMPLEMENTATION.
+  METHOD if_oo_adt_classrun~main.
+    SELECT * FROM ztab_order INTO TABLE @DATA(lt_orders).
+    out->write( lt_orders ).
+    out->write( |Found { lines( lt_orders ) } orders| ).
+  ENDMETHOD.
+ENDCLASS.
+```
+
+## Release Contracts (API Stability)
+
+| Contract | Meaning | Use |
+|:--------:|---------|-----|
+| **C0** | Not released | Cannot use in Cloud |
+| **C1** | Released for use | Safe to use in Cloud ABAP |
+| **C2** | Released for use as remote API | Callable via RFC/HTTP |
+| **C3** | Released for use in key user apps | Available in custom logic |
+
+```abap
+" Check if API is released:
+" ADT → Open class → check @API annotation or release state
+" Or: ATC check with cloud readiness profile
+```
+
+## ATC Cloud Readiness Check
+
+```abap
+" Run ATC in ADT:
+" 1. Right-click object → Run As → ABAP Test Cockpit
+" 2. Select check variant: ABAP_CLOUD_READINESS
+" 3. Review findings — each shows prohibited statement + suggested replacement
+
+" Or programmatically:
+" Use CDS view I_APIsForCloudDevelopment to query released APIs
+SELECT * FROM I_APIsForCloudDevelopment
+  WHERE ObjectType = 'CLAS'
+  INTO TABLE @DATA(lt_released).
+```
+
+## Environments
+
+| Environment | Language Version | Notes |
+|---|---|---|
+| **BTP ABAP Environment (Steampunk)** | Cloud only | No access to on-premise tables/FMs |
+| **S/4HANA Cloud, public edition** | Cloud only | No custom code except key user + developer extensibility |
+| **S/4HANA Cloud, private edition** | Cloud or Standard (opt-in) | Can enable Cloud for new development |
+| **S/4HANA on-premise** | Cloud or Standard (opt-in) | Tier 1 (Cloud) or Tier 2 (Standard) |
+
+## Tier Model (on-premise)
+
+```
+Tier 1 — ABAP for Cloud Development
+  ├── Released APIs only
+  ├── CDS view entities
+  ├── RAP business objects
+  └── Clean ABAP patterns
+
+Tier 2 — Standard ABAP (classic)
+  ├── All APIs (released + unreleased)
+  ├── Classic Dynpro / ALV / BAPI
+  └── Existing custom code
+```
+
+On S/4HANA on-premise, new development should target Tier 1 for future-proofing.
+
+## Rules
+- Cloud: ONLY use released APIs (check release state in ADT)
+- Cloud: ALL DB access via ABAP SQL or CDS — no native SQL, no EXEC SQL
+- Cloud: ALL UI via RAP + Fiori — no Dynpro, no ALV, no WRITE
+- Cloud: Background processing via Application Jobs — no SUBMIT, no SM36
+- Cloud: ALL business logic in classes — no reports, no function groups (except RAP handler)
+- Cloud: Use `if_oo_adt_classrun` for console testing (replaces WRITE/REPORT)
+- Cloud: Use exception classes for messages (replaces MESSAGE statement)
+- Run ATC with ABAP_CLOUD_READINESS before moving code to Cloud
+- New development on S/4HANA on-premise: target Tier 1 for upgrade path
+
+## Anti-Patterns
+| Anti-Pattern | Correct |
+|---|---|
+| `WRITE lv_value` | `out->write( lv_value )` via `if_oo_adt_classrun` |
+| `CALL FUNCTION 'unreleased'` | Find released class equivalent or wrap |
+| `SELECT...ENDSELECT` | `SELECT...INTO TABLE` + `LOOP AT` |
+| `AUTHORITY-CHECK OBJECT` in RAP | `authorization master ( global )` in BDEF |
+| Using unreleased CDS views (C0) | Use released I_* views (C1) |
+| `SUBMIT zreport` for background | Application Job with `cl_apj_rt_api` |
+| `MESSAGE e001(zmsg)` | Exception class implementing `if_t100_message` |
+| Code in FORM/PERFORM | Code in class methods |
+| Function group for business logic | Class + interface |