Installation Guide

Prerequisites

• OS: Ubuntu 22.04 LTS (recommended)
• Python: 3.11+
• Node.js: 18+
• Yarn
• Redis
• MariaDB: 10.6+
• ERPNext: v15 (installed via bench)

Installation Steps

• Clone the App into your bench:

cd frappe-bench/apps git clone https://github.com/yourusername/agency_management.git

• Install the App on your site:

bench new-app agency_management bench --site my.db install-app agency_management cd .. bench --site my.db install-app agency_management

• Apply Migrations and Restart:

bench migrate bench restart

Module 1: Agency Management

Agency DocType

• Fields: Territory, Primary Contact, Is Active
• Linked Agency Item child table

Agency Item (Child Table)

• Fields: Item Code, Min Order Qty, Lead Time (Days)

Validations

• Prevent adding items if Agency is Inactive
• Button “Create Supplier”: generates a Supplier from the Agency.
• Inactive Agencies show in red on list view.

Script Report: Agency Lead Time

• Displays Agency → Item mappings
• Includes Min Order Qty and Lead Time

Module 2: Manufacturer–Item Mapping

Manufacture DocType

• Fields: Description, Is Blocked

Manufacture Item DocType

• Fields: Manufacturer, Item Code, Part Number, Price, Is Blocked

Validations

• Ensure (manufacturer, item_code) pair is unique.
• Block adding Manufacturer Items if Manufacturer is marked as blocked.
• Auto-fill part_number with item_code if left blank.