ServiceManaged serviceImplementation runbookv2.0.0source-verified

Request, test and release a business-rule change

Describe a rule using examples and acceptance checks, then verify the delivered behavior and update its operator guide.

For
business-owner
Owner
Service documentation owner
Applies to
Feeding Frenzy source inspected 2026-09-10
Reviewed
2026-09-10
Change requestAcceptance examplesRelease record

Before you start

  • The current workflow and the exact result that needs to change.
  • A decision-maker for the rule and an operator who can validate it.
  • Representative examples, including exceptions. This is the service procedure; no universal in-product change-request button is assumed.
Implementation runbook: follow these steps with your service team. This is not a standard admin-screen procedure.
01

Specify the change in operational terms

  1. State current and desired behavior

    For example: “Account group A needs a minimum order quantity of 12 for product X; other accounts retain the existing minimum.” Name the applicable account/product/channel context.

  2. Provide examples

    Supply a should-pass case, should-fail case and unaffected case. Include quantities, dates and amounts so the result is objectively checkable. Use approved sample records rather than vague statements such as make checkout smarter.

  3. Identify the affected layers

    Decide whether the rule belongs in data configuration, pricing logic, workflow, permission, integration or presentation. Buffaly-assisted implementation still needs one authoritative rule, not contradictory copies in UI and service.

  4. Approve the scope

    Agree who approves the behavior, who implements it and which historical records or ongoing subscriptions should remain unchanged. A request to change future pricing is not automatically a request to rebill existing customers.

02

Deliver and verify the change

  1. Implement against the agreed examples

    The service team makes the scoped change and records the affected contract/configuration. Preserve explicit validation and visible failure behavior.

  2. Test the actual workflow

    Run the positive, negative and unaffected cases in the appropriate test environment. Verify the saved record, totals and downstream integration outcome, not only a successful build.

  3. Review and release

    The business owner reviews the evidence. Record the release version, operating responsibility and recovery plan, then deploy through the installation’s approved process.

  4. Update this manual

    Change the affected task steps, fields, examples and source references. Re-test navigation/search so an operator can find the new procedure. Documentation updates are part of the change, not a separate marketing exercise.

Fields & records

Field / recordMeaning or use
Rule statementWho/what it applies to, condition, outcome and exceptions.
Acceptance exampleConcrete inputs and expected output or rejection.
Release recordVersion, approval, evidence and operating owner.

Verify the result

  • The requested and unaffected examples both behave as agreed.
  • Operator documentation matches the released controls and result.
  • The team can trace the rule to its authoritative implementation and release.

Troubleshooting

What you seeWhat to check or do
Request cannot be testedAdd concrete examples and expected outcomes before implementation.
UI accepts a value the service rejectsFix the authoritative contract/flow; do not hide the rejection with client-only behavior.
Existing customers changed unintentionallyDefine historical/ongoing-record scope explicitly and test it.

Version & scope

Service implementation procedure, grounded in the current software contracts. Source verification is not a claim that a live payment, message, customer transaction or full operator run occurred.

Public guides describe shared controls, records and configuration boundaries using fictional data. Tenant URLs, credentials, customer records, provider identifiers and installation-only procedures belong in customer-controlled documentation and are excluded from public pages and search.

Version
2.0.0
Change source
Current Feeding Frenzy forms/services plus reconciled Wiki topics
Feedback key
guide:changing-a-rule
Was this guide helpful?

Feedback records only the page, guide ID and yes/no choice. It never records documentation search text.

Implementation references (2)
  • FeedingFrenzy.Commerce/Baskets/Quotes.cs
  • FeedingFrenzy.Admin/wwwroot/kScripts/Products/Product.Edit.ks.html
← All documentationSoftware feature map ↗