Refactor apps routes: explicit dependency injection

- Updated all apps route modules to use destructured dependencies
- Added JSDoc comments for factory functions
- Replaced ctx. references with direct parameter access
- Updated apps/index.js to extract and pass explicit dependencies
- All files pass syntax validation

Files refactored:
- routes/apps/deploy.js (18k lines)
- routes/apps/helpers.js (17k lines)
- routes/apps/removal.js
- routes/apps/restore.js
- routes/apps/templates.js
- routes/apps/index.js (orchestrator)

dashcaddy-api/routes/apps/index.js

@@ -5,14 +5,35 @@ const initRemoval = require('./removal');
 const initTemplates = require('./templates');
 const initRestore = require('./restore');
 
+/**
+ * Apps routes aggregator
+ * Assembles all apps sub-routes with their dependencies
+ * @param {Object} ctx - Application context (for backward compatibility)
+ * @returns {express.Router}
+ */
 module.exports = function(ctx) {
   const router = express.Router();
-  const helpers = initHelpers(ctx);
 
-  router.use(initDeploy(ctx, helpers));
-  router.use(initRemoval(ctx, helpers));
-  router.use(initTemplates(ctx, helpers));
-  router.use(initRestore(ctx, helpers));
+  // Extract dependencies from context
+  const deps = {
+    docker: ctx.docker,
+    caddy: ctx.caddy,
+    credentialManager: ctx.credentialManager,
+    servicesStateManager: ctx.servicesStateManager,
+    portLockManager: ctx.portLockManager,
+    asyncHandler: ctx.asyncHandler,
+    errorResponse: ctx.errorResponse,
+    log: ctx.log
+  };
+
+  // Initialize helpers with dependencies
+  const helpers = initHelpers(deps);
+
+  // Mount sub-routes with explicit dependencies
+  router.use(initDeploy({ ...deps, helpers }));
+  router.use(initRemoval({ ...deps, helpers }));
+  router.use(initTemplates({ ...deps, helpers }));
+  router.use(initRestore({ ...deps, helpers }));
 
   return router;
 };