Add Finance posting domain-knowledge pilot#57
Conversation
Adds three atomic domain-rule knowledge files under community/knowledge/finance/ as a pilot for Type-A (normative) Business Central domain knowledge: post through the posting engine, treat posted ledger entries as immutable, and treat the Dimension Set ID as the source of truth for dimensions. Includes a good/bad AL sample pair for the posting rule. These encode BC-specific invariants that LLMs reliably get wrong, fitting the existing remedial/atomic knowledge grain with no schema or contract changes. Passes the repo frontmatter validator and is discovered by the knowledge index. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
@JesperSchulz - for the Do Not Modify posted entries, should we note in that file that non financial fields can be modified? For example, Customer Ledger Entries have a wide variety of "operational" fields that are editable these days. |
Addresses review feedback from @JeremyVyska on PR #57: the immutability rule applies to financial content, not the whole entry. Reframes the Description around financial content and gives the operational-field exception (payment/application data, on-hold, applies-to, communication fields edited via CustEntry-Edit/VendEntry-Edit and the ledger entry pages) its own paragraph in Best Practice instead of understating it as a narrow set. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
Good call, thanks Jeremy. You're right that "narrow set" undersold it. I've reworked the file so the immutability rule is explicitly about financial content (amounts, accounts, posting date, quantities), and gave the operational fields their own paragraph in Best Practice -- due date, payment-discount dates, on-hold, applies-to ID, and recipient/communication fields, edited through |
Why
BCQuality has matured into a strong source of review knowledge, but its knowledge corpus today is entirely about writing AL well, not about the Business Central business domain. To help agents not just review but also write correct code, they need domain knowledge too. This PR is a small pilot to test one question before committing to that direction: does BC domain knowledge fit BCQuality's existing remedial/atomic grain, or does it need a new structure?
What
Three atomic domain-rule files under a new
community/knowledge/finance/folder, each encoding a Business Central posting invariant that LLMs reliably get wrong:Gen. Jnl.-Post Line, never by inserting intoG/L Entrydirectly. Ships a good/bad AL sample pair.Modify/Delete.Dimension Set IDis the source of truth, not the legacy global-dimension fields.Notes for reviewers
## Description/## Best Practice/## Anti Patternshape.financewas already a blesseddomainandapplication-areaalready existed, so the corpus was effectively built for this..alsamples are hand-written and demonstration-only, not derived from BaseApp, per the READ contract.community/to follow the documented community -> microsoft promotion path for content that has to prove itself first.Build-KnowledgeIndex.ps1with correct metadata.This is intended as a discussion artifact to evaluate the grain. A couple of open questions it surfaces: the near-redundancy between
domain: financeandapplication-area: [finance](may warrant awrite.mdconvention note before scaling), and the fact that consuming this for generation is a separate consumption-mode change still to be designed.