feat: beam_barcode_resolver hook

[lauty95]

Add extension points to BEAM's scan pipeline so that other apps can handle barcode scans on custom forms

New hooks

• beam_barcode_resolver:
  Fallback barcode resolution for doctypes that aren't Item, Handling Unit, or standard ERPNext barcodes. Apps register a resolver function that receives the barcode string and returns a frappe._dict(doc=..., barcode=...) or None.

• beam_frm override in get_form_action():
  When a scanned Handling Unit or Item lands on a form that doesn't have a standard {Doctype} Item child table, get_item_details() would fail with a 404. The new has_frm_override check skips that call and builds a minimal target instead.

[github-actions]

📝 Draft Changelog Entry

Changelog

A new barcode resolver hook has been added to the scanning module. This hook provides additional functionality for barcode resolution within the beam scanning system.

This changelog entry was automatically generated by the Changelog Generator Action.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
__init__.py	1	0	100%
hooks.py	15	0	100%
install.py	24	24	0%	4, 6, 9–17, 20–21, 24, 27–28, 30–31, 33, 35–36, 38, 42–43
beam
__init__.py	0	0	100%
barcodes.py	105	38	63%	21, 30, 36–37, 44, 56, 78–79, 81–82, 88–90, 92–94, 101–103, 109, 119, 127, 134, 137–138, 144–145, 151, 157, 163, 169, 181, 184–187, 189–190
boot.py	12	12	0%	4, 6, 9–12, 17, 19–20, 24–25, 28
handling_unit.py	76	37	51%	29, 32, 53–55, 73, 84–85, 91–92, 94–95, 97–98, 100–101, 103, 105–108, 110–112, 114, 116, 118–119, 124, 126, 130, 132–133, 136, 138–139, 147
printing.py	93	55	40%	18–19, 48, 50–53, 62–66, 70–71, 83–87, 91, 97, 106–112, 114–115, 117, 122, 124–125, 140–145, 147–153, 160–163, 165–168
zpl_layout.py	246	246	0%	12–15, 17, 20, 36, 47–48, 51–52, 54–55, 58, 61, 64–67, 69–71, 77, 81–83, 86–87, 90–91, 93–94, 99, 101, 110–111, 113, 115, 118–120, 122–125, 128–129, 132, 140–141, 144–146, 154, 157, 161, 164, 167, 177–183, 185, 188, 193–196, 198, 201–206, 209–215, 217, 219, 222, 224–227, 231–233, 235–239, 241–245, 249–253, 258, 260, 263–269, 278–282, 285–292, 295–308, 311–313, 316–328, 331, 334–336, 339–353, 356–361, 364, 366, 369, 384, 386–387, 390–391, 393, 395, 397–399, 402, 411, 418–420, 423–424, 427, 429–433, 436, 439–442, 445–448, 451–453, 469, 471, 474–475, 496–501, 505, 507–508, 516–521, 524–525
beam/doctype
__init__.py	0	0	100%
beam/doctype/beam_settings
__init__.py	0	0	100%
beam_settings.py	17	5	70%	14–18
beam/doctype/handling_unit
__init__.py	9	3	66%	12–14
handling_unit.py	16	1	93%	16
test_handling_unit.py	3	0	100%
beam/overrides
network_printer_settings.py	40	32	20%	14–18, 24–34, 42–46, 49, 52–55, 57–62
stock_entry.py	91	16	82%	115–116, 121–128, 134–135, 151, 183, 186–187
beam/print_format
__init__.py	0	0	100%
beam/print_format/handling_unit_6x4_zpl_format
__init__.py	0	0	100%
beam/print_format/handling_unit_label
__init__.py	0	0	100%
beam/print_format/item_barcode
__init__.py	0	0	100%
beam/print_format/labelary_print_preview
__init__.py	0	0	100%
beam/print_format/microqr_serial_no
__init__.py	0	0	100%
beam/print_format/warehouse_barcode
__init__.py	0	0	100%
beam/report
__init__.py	0	0	100%
beam/report/handling_unit_traceability
__init__.py	0	0	100%
handling_unit_traceability.py	44	44	0%	4–6, 9–11, 30–32, 34–35, 37–38, 41–42, 45–46, 48–49, 51–52, 54–55, 57, 63–65, 67–69, 71, 74–77, 79–81, 83–86, 89–90
beam/scan
__init__.py	197	35	82%	23, 33, 89–91, 167–168, 178, 180–181, 185, 189–190, 193, 199, 234, 243, 272, 274, 302–303, 309–316, 323, 331, 345, 451, 459, 466
config.py	26	26	0%	4, 6, 9–17, 19–21, 23–26, 28–30, 32–35, 37
tests
conftest.py	24	0	100%
test_barcode_auto_generate.py	51	3	94%	23–25
test_handling_unit.py	467	59	87%	18–19, 21–22, 543, 567, 608, 618, 645, 648–649, 652–661, 668–671, 680–682, 684–685, 687–689, 697, 704, 706–712, 714, 724–727, 736–739, 741–743, 751, 758–760, 762
test_hooks_override.py	39	1	97%	41
test_item_barcode_print_format.py	14	0	100%
test_printing.py	40	0	100%
test_scan.py	24	0	100%
test_serial_number.py	54	0	100%
www
__init__.py	0	0	100%
TOTAL	1728	637	63%