Break a monolith function into modules

This function is doing too many things and is difficult to test and maintain: [Paste code]. Decompose it into smaller, single-responsibility functions or modules with clearly defined inputs and outputs. Explain the reasoning behind each split, define the interfaces between the resulting units, ensure each part is independently testable, and confirm that the original external behaviour is fully preserved.