frappe-impl-controllers

What problem does it solve?

Building robust Document Controllers in a custom Frappe/ERPNext app can be complex due to multiple lifecycle hooks, validation patterns, and safe override strategies. This Skill provides structured workflows and best practices to implement controllers that coordinate validation, saving, submitting, and cross-document interactions in a maintainable way.

Core Features & Use Cases

• Document Controller scaffolding: define a controller class, connect it to the doctype lifecycle, and implement common hooks like validate, before_submit, on_submit, and on_update.
• Safe overrides and testing: guidelines for super() usage, extension patterns (override_doctype_class, hooks), and testing strategies with unit tests.
• Practical examples: step-by-step patterns including decision trees, validation workflows, and post-submit actions with real-world ERPNext scenarios.

Quick Start

Write a minimal Document Controller for a custom DocType by creating a Python class that extends Document, implements validate(), and triggers a simple on_submit workflow.