Cronjob Documentation Progress¶

Last Updated: 2026-01-08
Source: docs/system-crontab.md

Executive Summary¶

This document tracks the progress of documenting all cronjobs defined in the system crontab. Cronjobs are production-critical workflows that run silently in the background. Undocumented cronjobs represent operational debt and risk.

Cronjob Coverage¶

Total cron entries detected: 164
Unique cronjob commands: 115
Documented (with code linkage): 95
Partially documented: 0
Undocumented: 20

Coverage Rate¶

Commands with located class files: 95/115 (82%)
Commands needing documentation: 20/115 (17%)

Risk Analysis¶

Critical Risk Commands (46)¶

These commands involve sales, payments, refunds, or stock mutations:

menzzo:v2:sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:v2:sales:update - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
sale:expedition:import - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:v2:sales:payment - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:v2:cart:addCouponToRule - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:v2:carts - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:v2:products:update:qty - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:products:sale-stock-and-views - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:saleproduct:switch - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:product:stock-value - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:asirgroup:sync-product-stock - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:google:shopping:sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:shopdeco:shopping:sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:lengow:sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:lengow:v2:sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sales:rdv - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:erp:shopping-feed:sync:sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:trusk:expedition-check - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sale:trusk-expedition-export - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:bigbuy:sale:expedition-check - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:v2:sales:fix:processing - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sale-product:mark-as-shipped - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sales:sale-product:find-sale-product-container - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sale:shipping:dropship - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:refund:alert - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:refund:check - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:asir-group:sale:expedition:generate-tickets - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
sale-product:calculate:shipping-amount - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:products:sync-stock-meublepromo - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:erp:meuble-promo:sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:erp:meuble-promo:sales:update - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:product:meduse:sync-stock - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sale:export-clients-information-for-google-ads - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sale-product:send-trustpilot-review-invitations - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:asir-non-printed-sales-email-notification - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:asir-group:sync-scanned-unshipped-asir-sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:notio:sync-product-stock - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
app:publish-products-managestock-and-qty-to-queue - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sale-product:send-prepared-emails - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:product:update-composed-product-qty - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:mauroferretti:sync-product-stock-url - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:sales:performance-alert - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
mosaikasa:sales:import - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
channable:sales:import - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
menzzo:cart:import-cancelled-sales - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION
temu:stock:update - ⚠️ REQUIRES IMMEDIATE DOCUMENTATION

High Risk Commands (40)¶

These commands have significant business impact:

menzzo:sync:shipping-rates - Documentation needed
menzzo:v2:products - Documentation needed
menzzo:v2:products:dispo - Documentation needed
menzzo:product:stat - Documentation needed
menzzo:v2:product:same:sku - Documentation needed
menzzo:marketing:product:generate-special-price - Documentation needed
menzzo:product:calculate-lowest-price-in-30-days - Documentation needed
menzzo:product:update-base-de-calcul-data - Documentation needed
menzzo:product:calculate-selling-price-without-tax - Documentation needed
menzzo:marketing:product:calculate-price - Documentation needed
menzzo:product:update-new-tag - Documentation needed
menzzo:product:product_monitoring - Documentation needed
menzzo:google:shopping:products - Documentation needed
menzzo:erp:les-tendances:sync:orders - Documentation needed
menzzo:products:sellsy - Documentation needed
menzzo:beyable:sync-data - Documentation needed
menzzo:sync:currency-rates - Documentation needed
menzzo:new-product:synchronise - Documentation needed
menzzo:new-product:archivate - Documentation needed
menzzo:new-product:missing-product-informations-alert - Documentation needed
menzzo:file:import-processor - Documentation needed
menzzo:cmp:import-products-from-api - Documentation needed
menzzo:erp:paris-prix:sync-orders - Documentation needed
menzzo:google:sync:check-product-status - Documentation needed
menzzo:product:addgroupdispo - Documentation needed
menzzo:products:sync-price-meublepromo - Documentation needed
meduse:sync:product-data - Documentation needed
meduse:sync:attributes - Documentation needed
menzzo:sync-asir-attribute-mapping-from-meduse - Documentation needed
menzzo:asirgroup:generate-asir-in-progress-product - Documentation needed
menzzo:notio:generate-notio-product-title-and-description - Documentation needed
menzzo:notio:translate-notio-product-description - Documentation needed
menzzo:tamdis:ship-orders-based-on-truck-depart - Documentation needed
menzzo:vir:ship-orders-based-on-truck-depart - Documentation needed
menzzo:product:meduse:sync-price - Documentation needed
app:product:update-correct-composed-prices - Documentation needed
menzzo:queue:sync-statuses - Documentation needed
menzzo:import-customer-reviews - Documentation needed
app:warehouse:sync-product-data - Documentation needed
menzzo:temu:sync-products - Documentation needed

Immediate TODO (Highest Priority)¶

🔴 Critical Priority¶

20 cronjobs with no matching Command class or unable to locate
46 critical cronjobs mutating sales, payments, refunds, or stock

🟡 High Priority¶

40 high-risk cronjobs with significant business impact
Add @doc.* annotations to all 95 located Command classes
Document business intent and side effects for all commands
Set up CI enforcement for documentation completeness

Documentation Tasks by Command¶

Commands Without Located Class Files¶

Commands Needing Documentation Enhancement¶

CI Enforcement Status¶

CI job created to validate cronjob documentation
CI checks for missing documentation files
CI checks for undocumented status
CI checks for unknown risk levels
CI checks documentation-progress.md sync

Regeneration Policy¶

All cronjob documentation MUST be marked needs-regeneration if:

The cron definition in system-crontab.md changes
The referenced Command class code changes
Command logic changes after last_verified date

Never silently update documentation. Always regenerate from the authoritative source.

How to Update This Report¶

This report is generated automatically by:

python3 tools/cronjob_doc_generator.py

Run this command whenever: - Cron entries are added, removed, or modified in system-crontab.md - Command classes are created or relocated - Documentation is completed for commands