Skip to content

docs: strategy for scaling HUF execution backends#271

Open
esafwan wants to merge 2 commits into
developfrom
docs/scaling-huf-strategy
Open

docs: strategy for scaling HUF execution backends#271
esafwan wants to merge 2 commits into
developfrom
docs/scaling-huf-strategy

Conversation

@esafwan
Copy link
Copy Markdown
Contributor

@esafwan esafwan commented May 24, 2026

Summary

Adds a detailed scaling strategy document for HUF execution modes and deployment patterns.

What changed

  • Added docs/SCALING_HUF_STRATEGY.md
  • Linked the new scaling strategy from README.md

Covered in the document

  • Problem definition for scaling HUF beyond direct Frappe/MariaDB execution
  • Three execution backends:
    • Frappe Direct API
    • Frappe Redis Queue / Background Job
    • Temporal Executor
  • When each mode should be used
  • Example API behavior for each mode
  • Mermaid deployment diagrams for each mode
  • White Umbrella / Umbrella usage logic and recommended execution mode mapping
  • Temporal huf-executor concept, responsibilities, non-responsibilities, process model, and build plan
  • Frappe Cloud + external Temporal deployment model

Notes

This is documentation only. No runtime code or migration changes are included.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant