-
Pass 4 of the routine-narrative job. While documenting xly's 1,861 stored procedures and functions, the narrative-writing subagents incidentally surfaced ~140 code-level defects, header/comment drift, sealed-but-still- bound routines, tenant-baked GUIDs, dead code, debug leakage, and naming inconsistencies — flagged in individual narrative pages but otherwise scattered. This new page (en/docs/reference/maintainer/known-issues-in-stored-procedures.md) collects them in one navigable index, deep-linking back to each routine's auto-catalog page where the per-routine evidence lives. Grouped by category: - Real correctness / runtime bugs (~40) - Header / comment drift (~35) - Sealed-but-still-bound (~25 families) - Tenant-baked GUIDs / hardcoded magic values (~30) - Dead code / unimplemented stubs (~30) - Debug leakage left in production (~15) - Naming / structural inconsistencies (~10) - Security-adjacent (3) Explicitly NOT a fix plan — flags are signals worth verifying, not confirmed defect tickets. Several are operationally invisible; others are likely intentional rollback-retained legacy. Methodology and "what this page is and is not" framing are in the page header. Also linked from reference/maintainer/index.md and added to mkdocs.yml nav.
-
en: every file:line citation, table-row count, endpoint, and diagram entity re-verified against xly-src and the live DB. Numerous small precision fixes across all wiki pages. api-reference/internal.md adds a new section enumerating the 52 non-framework controllers so readers can see what xly hardcoded vs. left to metadata. zh: parallel translation sync (38 modified + 3 new maintainer pages).
-
en: - new: api-reference/notifications.md, reference/maintainer/running-locally.md, reference/maintainer/tech-stack.md - concepts/index.md: add Mermaid architecture diagram - index.md: scope-note MongoDB store as plat-tier - concepts/api-surface.md: point "the four-table read" link at the reference/maintainer/runtime.md anchor that actually contains the section - maintainer/index.md, api-reference/index.md, mkdocs.yml: nav + cross-links zh: - mirror translations of the new en pages, plus zh api-reference/* section
-
Documents the xly (小羚羊) printing-industry ERP framework. Built with MkDocs Material; CJK search via jieba; 3,076 auto-generated catalog pages from recon/*.tsv plus hand-written prose for the framework's core mental model and end-to-end vertical slices. Phase 0 recon: stack, schema shape, framework metadata layer, scope. Phase 1 wiki: scaffold + auto-catalog + Slices 1-6 (Slice 7 deferred). Slice coverage: 1. CRUD module (Hello World) — observed network + cited source 2. Multi-tenancy & product editions — sBrandsId/sSubsidiaryId/sVersionFlowId 3. View-backed module (read-only report) 4. Custom field overlay (gdsconfigformcustomslave) 5. Per-customer SQL override (script/客户/<customer>/) 6. Hardware integration (xlyPlc, optional) 7. Workflow (deferred — Activiti tables empty in dev DB) Concepts: thesis, modules-forms-vtables, master/slave, semantic-FK, customization channels & layers, multi-tenancy, request lifecycle. Reference (Builder): define-form, define-vtable, permissions, attach-workflow (deferred). Reference (Maintainer): runtime, proc-dispatch, cache-invalidation, sql-templates, deployment, activiti.