bench get-app https://github.com/ibrahim317/enhanced_kanban_view

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=ibrahim317%2Fenhanced_kanban_view)](https://frappegems.com/gems/apps/ibrahim317/enhanced_kanban_view)

🎯 Enhanced Kanban View

A powerful custom Frappe app that extends Kanban view functionality with advanced features for better workflow management and data validation. Inspired by Bitrix24's Kanban board system.

✨ Features

🔗 Link Field-Based Kanban Boards

• Automatically creates columns based on Link fields in your DocTypes
• Auto-syncs columns when linked records are created, renamed, or deleted

📋 Column Rules & Validation

• Define required fields for specific columns
• Show validation dialogs when moving cards between columns
• Auto-revert cards if validation fails

🎨 Enhanced User Experience

• Quick Entry Dialogs with field validation
• Smart field detection for rules
• Seamless Frappe integration

🚀 Installation

bench get-app https://github.com/ibrahim317/enhanced_kanban_view.git
bench --site your-site.com install-app enhanced_kanban_view
bench build

📖 Quick Start

1. Create Link Field-Based Kanban

1. Navigate to your DocType's List view
2. Click Kanban → "New Kanban Board"
3. Select your Link field
4. Columns auto-create based on linked records

2. Set Up Column Rules

1. Go to Kanban View > Menu > Create Kanban Board Rule
2. Choose target column
3. Add required fields in the "Required Fields" table

3. Validation Behavior

• Moving cards to columns with rules opens validation dialog
• Fill required fields to proceed
• Failed validation returns card to original position

🎥 Demo & Tutorial

📺 Watch the full demo and tutorial: Enhanced Kanban View Features & Usage

🏗️ Architecture

Core Components

• Kanban Board Rule: Defines validation rules for columns
• Kanban Rule Field: Child table for required fields
• Monkey Patches: Handle automatic column CRUD operations
• API Endpoints: Field validation and board configuration

Database Schema

Kanban Board Rule: {
  "kanban_board": "Link to Kanban Board",
  "kanban_board_column": "Link to Kanban Board Column", 
  "required_fields": "Table: Kanban Rule Field"
}

Kanban Rule Field: {
  "field_doctype": "Select: DocField|Custom Field",
  "field_name": "Select: Available Fields"
}

🔧 Configuration

• Hooks: CSS/JS, Monkey Patches, Document Events
• Permissions: System Manager access by default
• Customization: Standard and Custom Field support

🐛 Troubleshooting

Common Issues

• Columns not updating: Check linked DocType permissions and Link field config
• Validation dialogs missing: Verify Kanban Board Rules configuration
• Performance issues: Monitor database queries and consider indexing

🤝 Contributing

1. Fork the repository
2. Create feature branch
3. Make changes and test
4. Submit pull request

📄 License

MIT License - see LICENSE

🙏 Acknowledgments

• Bitrix24 - Design inspiration
• Frappe Framework team
• All contributors

📞 Support

• 📧 Email: i.aboelsoud21@gmail.com
• 🐛 Issues: GitHub issues
• 📖 Docs: Code comments and docstrings

---

Made with ❤️ for the Frappe/ERPNext community