# 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](running-locally.md) — first-run setup for developers (prereqs, profile, DB override, smoke check).
- [Tech stack](tech-stack.md) — library inventory by category (versions, where each is used, and why).
- [The runtime: BusinessBaseController & friends](runtime.md) — the metadata-driven dispatch loop.
- [Generic procedure dispatch](proc-dispatch.md) — `GenericProcedureCallController` deep dive.
- [Cache invalidation on metadata change](cache-invalidation.md) — synchronous `@CacheEvict`, and why similarly named JMS consumers are not cache-bust.
- [SQL templates (`xlyEntry/templesql/`)](sql-templates.md) — proc scaffolds engineers fill in.
- [Multi-service deployment](deployment.md) — `xlyApi` vs `xlyEntry` vs `xlyInterface`.
- [Metadata-management services (`xlyManage`)](management-services.md) — the `Gds*ServiceImpl` family behind the BACK builder.
- [BI / KPI / Charts engine](bi-engine.md) — the homebrewed dashboard layer.
- [Activiti integration](activiti.md) — version skew, schemas, custom delegates.
- [Known issues in stored procedures and functions](known-issues-in-stored-procedures.md) — consolidated index of code-level defects, comment drift, sealed-but-still-bound routines, and other audit signals surfaced while documenting the 1,861 auto-catalog routines.
