README.md

@@ -12,6 +12,33 @@ bench get-app $URL_OF_THIS_REPO --branch develop
 bench install-app makap_backend
 ```
 
+### Setting up a site for Makap Uganda
+
+`bench migrate` creates the custom fields, roles and role profiles. Company setup is a separate, manual step, because it creates accounts and must never run by accident. Run it as a dry run first, read the plan it prints, then apply it:
+
+```bash
+bench --site $SITE execute makap_backend.makap_backend.setup_uganda.run
+bench --site $SITE execute makap_backend.makap_backend.setup_uganda.run --kwargs "{'confirm': 1}"
+```
+
+It creates a UGX company on the Standard chart, a July–June fiscal year, VAT 18% templates, stage WIP, Quarantine, Returns Hold and Rejected warehouses, and sets Manufacturing Settings to backflush on transferred material. It never deletes anything. Remove any older company by hand once the new one has been checked.
+
+### Defaults Makap still has to confirm
+
+The code ships with these defaults; each one is a business decision, not a technical one:
+
+- **Roll identity:** one Batch per physical roll (Batch → Roll Details).
+- **Cylinder ownership:** recorded per cylinder (Makap, Customer, or Charged to Customer).
+- **Consumption costing:** backflush on "Material Transferred for Manufacture", so the Work Order Cost Variance report shows actual use.
+- **Company:** "Makap Uganda Limited" (MUL), fiscal year July–June.
+- **EFRIS:** not integrated. Sales Invoices carry a manual fiscalisation status until the integration route is chosen.
+
+### Running tests
+
+```bash
+bench --site $TEST_SITE run-tests --app makap_backend
+```
+
 ### Contributing
 
 This app uses `pre-commit` for code formatting and linting. Please [install pre-commit](https://pre-commit.com/#installation) and enable it for this repository:

makap_backend/makap_backend/doctype/order_closure_and_margin_view/order_closure_and_margin_view.py

@@ -1,7 +1,6 @@
 import frappe
 from frappe.model.document import Document
 
-
 # Dimensions that gate Operating Close. Collection is deliberately excluded —
 # per the package, a legitimate credit sale can be Operating Closed while the
 # receivable remains open (Operating Reopen != Accounting Period Reopen).

makap_backend/makap_backend/setup_extensions.py

@@ -1,7 +1,6 @@
 import frappe
 from frappe.custom.doctype.custom_field.custom_field import create_custom_fields
 
-
 FIELDS = [
     # Module 2 — commercial/product linkage
     ("Item", "makap_requires_packaging_specification", "Requires Packaging Specification", "Check", None, 0),