4. Reference (Maintainer Track)

For Java developers maintaining or extending the framework itself.

This chapter is for the people who will modify BusinessBaseController, add a new metadata table to the gds* family, or wire in a new third-party integration.

• Running xlyEntry locally — first-run setup for developers (prereqs, profile, DB override, smoke check).
• Tech stack — library inventory by category (versions, where each is used, and why).
• The runtime: BusinessBaseController & friends — the metadata-driven dispatch loop.
• Generic procedure dispatch — GenericProcedureCallController deep dive.
• Cache invalidation on metadata change — ConsumerChangeGdsModuleThread and friends.
• SQL templates (xlyEntry/templesql/) — runtime SQL generation.
• Multi-service deployment — xlyApi vs xlyEntry vs xlyInterface.
• Activiti integration — version skew, schemas, custom delegates.

STUB. Each sub-page will be filled with a real code-trace once the matching slice exercises it.