Snapshot: new training tasks (balanced generation), docs

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

tasks_gen/train/G1926/spec.md

@@ -0,0 +1,67 @@
+# 1. Goal
+A go-kart circuit starts a race only when the booking is correct. The booking
+desk and the web shop of the circuit must use the same check. Create the
+interface that both programs use as the contract of the check.
+
+# 2. Open questions
+None.
+
+# 3. Context
+- The interface {{P}}IF_KART_CHECK does not exist. Create it in package $TMP.
+- The circuit returns one reason code for a booking. The reason codes are
+  OK, NO_NAME, TOO_YOUNG, TOO_OLD, BAD_LAPS, CLOSED and TOO_MANY.
+- The meaning of the reason codes is:
+  OK - the booking is correct.
+  NO_NAME - the driver name is empty.
+  TOO_YOUNG - the driver is younger than MIN_AGE.
+  TOO_OLD - the driver is older than MAX_AGE.
+  BAD_LAPS - the number of laps is outside MIN_LAPS and MAX_LAPS.
+  CLOSED - the booking time is outside the opening hours.
+  TOO_MANY - the group has more than MAX_DRIVERS bookings.
+- The circuit is open from 09:00:00 to 22:00:00.
+- The booking desk and the web shop read the reason codes and the limits from
+  the interface. No other object uses the interface.
+
+# 4. Contract
+- Create the interface {{P}}IF_KART_CHECK in package $TMP.
+- The interface is public.
+- The interface contains the types, the constants and the methods of the
+  business rules. Do not add other public components.
+
+# 5. Business rules
+1. The interface has the type TY_REASON. TY_REASON is a character type of
+   length 12.
+2. The interface has the structure type TY_BOOKING. The components are:
+   DRIVER_NAME (character, length 20), DRIVER_AGE (integer), LAPS (integer),
+   BOOKING_TIME (time).
+3. The interface has the table type TT_BOOKINGS. The row type is TY_BOOKING.
+   TT_BOOKINGS is a standard table with an empty key.
+4. The interface has the constant structure C_REASON. Each component has the
+   type TY_REASON. The components and the values are:
+   OK = 'OK', NO_NAME = 'NO_NAME', TOO_YOUNG = 'TOO_YOUNG',
+   TOO_OLD = 'TOO_OLD', BAD_LAPS = 'BAD_LAPS', CLOSED = 'CLOSED',
+   TOO_MANY = 'TOO_MANY'.
+5. The interface has the constant structure C_LIMIT. Each component has the
+   type i. The components and the values are:
+   MIN_AGE = 12, MAX_AGE = 75, MIN_LAPS = 5, MAX_LAPS = 30, MAX_DRIVERS = 8.
+6. The interface has the constant C_OPEN_FROM with the value '090000' and the
+   constant C_OPEN_TO with the value '220000'. Both constants have the type t.
+7. The interface has the method CHECK_BOOKING. The importing parameter
+   IS_BOOKING has the type TY_BOOKING. The returning parameter RV_REASON has
+   the type TY_REASON.
+8. The interface has the method CHECK_GROUP. The importing parameter
+   IT_BOOKINGS has the type TT_BOOKINGS. The returning parameter RV_REASON has
+   the type TY_REASON.
+9. The interface has the method IS_OPEN. The importing parameter IV_TIME has
+   the type t. The returning parameter RV_OPEN has the type ABAP_BOOL.
+
+# 6. Constraints
+- Release target: 8.16.
+- Coding standards: Clean ABAP. No comment that restates the code.
+- Out of scope: do not create other objects.
+
+# 7. Acceptance
+- The interface is active and has no syntax error.
+- The hidden tests pass.
+- Write your own ABAP Unit tests for the interface. Use a global test class,
+  for example {{P}}KART_CHECK_TEST.