CSF TZ - DocTypes Documentation

Overview

This document provides comprehensive information about all DocTypes in the CSF TZ application. The application contains over 200 custom DocTypes organized across 12 major modules, making it one of the most comprehensive Frappe applications available.

DocTypes Summary

Total DocTypes: 200+

The CSF TZ application includes custom DocTypes organized across the following modules:

Module	DocType Count	Primary Purpose
Core CSF TZ	85+	Core business functionality and settings
Fleet Management	45+	Vehicle fleet management and maintenance
Clearing and Forwarding	25+	Import/export and customs management
After Sales Services	12+	Post-sale service management
Workshop Management	8+	Workshop and maintenance services
Sales and Marketing	8+	Sales analytics and customer management
Purchase and Stock Management	6+	Enhanced inventory management
Meal Count	5+	Employee meal tracking
Feedback System	4+	Customer feedback collection
Stanbic Bank Integration	3+	Banking integration
AI Integration	2+	AI and machine learning features
Auth OTP	2+	OTP authentication system

Module 1: Core CSF TZ (85+ DocTypes)

System Configuration DocTypes

1. CSF TZ Settings

Location: apps/csf_tz/csf_tz/csf_tz/doctype/csf_tz_settings/
Type: Single DocType (System Configuration)
Purpose: Central configuration hub for all CSF TZ functionality

Key Configuration Sections:

System Behavior: Unique records, validation settings, auto-POS configuration
Payroll Overrides: Fixed working days, payroll approval, salary slip customizations
HR Settings: Overtime calculation, shift details override
Trade-in Settings: Enable/disable trade-in functionality
TZ Regions Data: Tanzania geographic data population

Critical Fields:

enable_trade_in: Enables trade-in functionality across the system
enable_payroll_approval: Activates payroll approval workflow
enable_overtime_calculation: Enables automatic overtime calculations
populate_tz_regions: One-time population of Tanzania geographic data

2. Visibility

Location: apps/csf_tz/csf_tz/csf_tz/doctype/visibility/
Type: Master DocType
Purpose: Universal field visibility control system

Functionality:

Controls field visibility across all DocTypes
Rule-based visibility engine
Performance-optimized visibility processing
Conditional field display based on user roles and data

3. SQL Process

Location: apps/csf_tz/csf_tz/csf_tz/doctype/sql_process/
Type: Transaction DocType
Purpose: Secure SQL command execution with audit trail

Security Features:

Role-based SQL execution permissions
Command validation and sanitization
Execution audit trail
Result logging and monitoring

Human Resources DocTypes

4. Piecework

Location: apps/csf_tz/csf_tz/csf_tz/doctype/piecework/
Type: Transaction DocType
Auto-naming: format:{date}-{task}-{######}
Purpose: Task-based work tracking and payment calculation

Key Fields:

date: Work completion date
task: Link to Piecework Type
quantity: Work quantity completed
task_rate: Rate per unit of work
total: Calculated total payment
employees: Multi-employee assignment table

Business Logic:

Automatic total calculation based on quantity and rate
Multi-employee work distribution
Integration with payroll processing

5. Piecework Type

Location: apps/csf_tz/csf_tz/csf_tz/doctype/piecework_type/
Type: Master DocType
Purpose: Defines types of piecework tasks and their rates

Key Fields:

task_name: Descriptive name of the task
rate: Standard rate per unit
description: Detailed task description
uom: Unit of measurement for the task

6. Additional Salary Component

Location: apps/csf_tz/csf_tz/csf_tz/doctype/additional_salary_component/
Type: Master DocType
Purpose: Defines additional salary components for payroll processing

Component Types:

Bonuses and incentives
Allowances and benefits
Deductions and penalties
One-time payments

7. Payroll Approval

Location: apps/csf_tz/csf_tz/csf_tz/doctype/payroll_approval/
Type: Transaction DocType
Purpose: Multi-level payroll approval workflow

Approval Features:

Hierarchical approval process
Approval status tracking
Rejection handling with comments
Audit trail maintenance

Financial Management DocTypes

8. Bank Charges

Location: apps/csf_tz/csf_tz/csf_tz/doctype/bank_charges/
Type: Transaction DocType
Purpose: Automatic bank charge calculation and posting

Functionality:

Automatic charge calculation based on transaction type
Integration with Payment Entry
GL entry creation for bank charges
Multi-currency support

9. Payment Reconciliation

Location: apps/csf_tz/csf_tz/csf_tz/doctype/payment_reconciliation/
Type: Transaction DocType
Purpose: Enhanced payment reconciliation with local banking features

Features:

Bank statement import and matching
Automatic reconciliation rules
Exception handling and reporting
Integration with Stanbic Bank systems

10. Withholding Tax

Location: apps/csf_tz/csf_tz/csf_tz/doctype/withholding_tax/
Type: Master DocType
Purpose: Tanzania withholding tax configuration and calculation

Tax Management:

Supplier-specific tax rates
Automatic tax calculation on purchases
Tax certificate generation
Compliance reporting

Inventory Management DocTypes

11. Delivery Exchange

Location: apps/csf_tz/csf_tz/csf_tz/doctype/delivery_exchange/
Type: Transaction DocType
Purpose: Handles product exchanges and returns

Exchange Process:

Original item return processing
Replacement item delivery
Price difference calculations
Stock movement tracking

12. Stock Transfer

Location: apps/csf_tz/csf_tz/csf_tz/doctype/stock_transfer/
Type: Transaction DocType
Purpose: Enhanced stock transfer with approval workflow

Transfer Features:

Multi-location transfers
Approval workflow integration
Transit tracking
Automatic GL entries

Geographic Data DocTypes

13. TZ Region

Location: apps/csf_tz/csf_tz/csf_tz/doctype/tz_region/
Type: Master DocType
Purpose: Tanzania regions master data

14. TZ District

Location: apps/csf_tz/csf_tz/csf_tz/doctype/tz_district/
Type: Master DocType
Purpose: Tanzania districts master data

15. TZ Ward

Location: apps/csf_tz/csf_tz/csf_tz/doctype/tz_ward/
Type: Master DocType
Purpose: Tanzania wards master data

16. TZ Village

Location: apps/csf_tz/csf_tz/csf_tz/doctype/tz_village/
Type: Master DocType
Purpose: Tanzania villages master data

Geographic Hierarchy:

TZ Region
├── TZ District
    ├── TZ Ward
        └── TZ Village

Insurance Management DocTypes

17. TZ Insurance Cover Note

Location: apps/csf_tz/csf_tz/csf_tz/doctype/tz_insurance_cover_note/
Type: Transaction DocType
Purpose: Vehicle insurance cover note management

Insurance Features:

Policy tracking and renewals
Premium calculations
Claims management
Compliance monitoring

18. Parking Bill

Location: apps/csf_tz/csf_tz/csf_tz/doctype/parking_bill/
Type: Transaction DocType
Purpose: Vehicle parking fee tracking and payment

Parking Management:

Automatic bill generation
Payment tracking
Vehicle-specific parking history
Integration with fleet management

19. Vehicle Fine Record

Location: apps/csf_tz/csf_tz/csf_tz/doctype/vehicle_fine_record/
Type: Transaction DocType
Purpose: Traffic fine tracking and payment management

Fine Management:

Fine recording and tracking
Payment processing
Driver assignment
Compliance reporting

Module 2: Fleet Management (45+ DocTypes)

Core Vehicle Management

1. Transport Request

Location: apps/csf_tz/csf_tz/fleet_management/doctype/transport_request/
Type: Transaction DocType
Purpose: Vehicle transportation request management

Request Features:

Trip planning and scheduling
Vehicle assignment
Route optimization
Cost estimation

2. Transport Assignment

Location: apps/csf_tz/csf_tz/fleet_management/doctype/transport_assignment/
Type: Transaction DocType
Purpose: Vehicle and driver assignment to transport requests

Assignment Features:

Driver assignment
Vehicle allocation
Schedule management
Resource optimization

3. Vehicle Trip

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_trip/
Type: Transaction DocType
Purpose: Complete vehicle trip tracking and management

Trip Management:

Trip planning and execution
Real-time location updates
Fuel consumption tracking
Performance monitoring

4. Vehicle Log

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_log/
Type: Transaction DocType
Purpose: Daily vehicle usage logging

Logging Features:

Odometer readings
Fuel consumption
Driver assignments
Trip summaries

5. Trailer

Location: apps/csf_tz/csf_tz/fleet_management/doctype/trailer/
Type: Master DocType
Purpose: Trailer management and tracking

Trailer Features:

Trailer specifications
Maintenance scheduling
Assignment tracking
Compliance monitoring

Vehicle Inspection System

6. Vehicle Inspection

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_inspection/
Type: Transaction DocType
Purpose: Comprehensive vehicle inspection management

Inspection Features:

Scheduled inspections
Checklist-based inspections
Defect tracking
Compliance reporting

7. Vehicle Inspection Template

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_inspection_template/
Type: Master DocType
Purpose: Standardized inspection templates

Template Features:

Customizable inspection checklists
System-specific templates
Compliance standards
Quality control

8. Vehicle Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_checklist/
Type: Transaction DocType
Purpose: Daily vehicle safety and condition checks

Checklist Features:

Pre-trip inspections
Safety checks
Condition monitoring
Issue reporting

9. Vehicle Routine Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_routine_checklist/
Type: Transaction DocType
Purpose: Routine maintenance checklist management

Vehicle System Inspection DocTypes

10. Engine Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/engine_checklist/
Type: Child Table DocType
Purpose: Engine system inspection checklist

11. Engine Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/engine_details/
Type: Child Table DocType
Purpose: Detailed engine inspection results

12. Brake Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/brake_checklist/
Type: Child Table DocType
Purpose: Brake system inspection checklist

13. Brake System Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/brake_system_details/
Type: Child Table DocType
Purpose: Detailed brake system inspection results

14. Electrical Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/electrical_checklist/
Type: Child Table DocType
Purpose: Electrical system inspection checklist

15. Electrical Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/electrical_details/
Type: Child Table DocType
Purpose: Detailed electrical system inspection results

16. Fuel System Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/fuel_system_checklist/
Type: Child Table DocType
Purpose: Fuel system inspection checklist

17. Fuel System Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/fuel_system_details/
Type: Child Table DocType
Purpose: Detailed fuel system inspection results

18. Tire Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/tire_checklist/
Type: Child Table DocType
Purpose: Tire condition inspection checklist

19. Tire Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/tire_details/
Type: Child Table DocType
Purpose: Detailed tire inspection results

20. Suspension Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/suspension_checklist/
Type: Child Table DocType
Purpose: Suspension system inspection checklist

21. Suspension Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/suspension_details/
Type: Child Table DocType
Purpose: Detailed suspension system inspection results

22. Steering Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/steering_checklist/
Type: Child Table DocType
Purpose: Steering system inspection checklist

23. Steering Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/steering_details/
Type: Child Table DocType
Purpose: Detailed steering system inspection results

24. Lighting Checklist

Location: apps/csf_tz/csf_tz/fleet_management/doctype/lighting_checklist/
Type: Child Table DocType
Purpose: Vehicle lighting system inspection checklist

25. Lighting Checklist Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/lighting_checklist_details/
Type: Child Table DocType
Purpose: Detailed lighting system inspection results

Fleet Operations Management

26. Fuel Request

Location: apps/csf_tz/csf_tz/fleet_management/doctype/fuel_request/
Type: Transaction DocType
Purpose: Vehicle fuel request and approval management

Fuel Management:

Fuel request processing
Approval workflow
Consumption tracking
Cost management

27. Fuel Request Table

Location: apps/csf_tz/csf_tz/fleet_management/doctype/fuel_request_table/
Type: Child Table DocType
Purpose: Fuel request line items

28. Expense

Location: apps/csf_tz/csf_tz/fleet_management/doctype/expense/
Type: Transaction DocType
Purpose: Vehicle-related expense tracking

Expense Categories:

Maintenance costs
Fuel expenses
Insurance premiums
Registration fees

29. Fixed Expense

Location: apps/csf_tz/csf_tz/fleet_management/doctype/fixed_expense/
Type: Master DocType
Purpose: Recurring vehicle expense management

30. Fixed Expense Table

Location: apps/csf_tz/csf_tz/fleet_management/doctype/fixed_expense_table/
Type: Child Table DocType
Purpose: Fixed expense line items

Route and Trip Management

31. Trip Route

Location: apps/csf_tz/csf_tz/fleet_management/doctype/trip_route/
Type: Master DocType
Purpose: Predefined route management

Route Features:

Route planning and optimization
Distance calculations
Time estimates
Cost projections

32. Trip Location

Location: apps/csf_tz/csf_tz/fleet_management/doctype/trip_location/
Type: Master DocType
Purpose: Trip location master data

33. Trip Location Type

Location: apps/csf_tz/csf_tz/fleet_management/doctype/trip_location_type/
Type: Master DocType
Purpose: Classification of trip locations

34. Vehicle Trip Location Update

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_trip_location_update/
Type: Transaction DocType
Purpose: Real-time vehicle location tracking

35. Route Steps Table

Location: apps/csf_tz/csf_tz/fleet_management/doctype/route_steps_table/
Type: Child Table DocType
Purpose: Detailed route step information

36. Trip Steps Table

Location: apps/csf_tz/csf_tz/fleet_management/doctype/trip_steps_table/
Type: Child Table DocType
Purpose: Trip execution step tracking

37. Subtrips Table

Location: apps/csf_tz/csf_tz/fleet_management/doctype/subtrips_table/
Type: Child Table DocType
Purpose: Sub-trip management within main trips

Vehicle Documentation and Equipment

38. Vehicle Documents

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_documents/
Type: Child Table DocType
Purpose: Vehicle document management

39. Vehicle Documents Type

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_documents_type/
Type: Master DocType
Purpose: Types of vehicle documents

Document Types:

Registration certificates
Insurance policies
Inspection certificates
Driver licenses

40. Vehicle Type

Location: apps/csf_tz/csf_tz/fleet_management/doctype/vehicle_type/
Type: Master DocType
Purpose: Vehicle classification and specifications

41. Equipment Set

Location: apps/csf_tz/csf_tz/fleet_management/doctype/equipment_set/
Type: Master DocType
Purpose: Vehicle equipment set management

42. Equipment Table

Location: apps/csf_tz/csf_tz/fleet_management/doctype/equipment_table/
Type: Child Table DocType
Purpose: Equipment inventory tracking

43. Unit of Measure

Location: apps/csf_tz/csf_tz/fleet_management/doctype/unit_of_measure/
Type: Master DocType
Purpose: Fleet-specific units of measurement

44. Delivery Note Template

Location: apps/csf_tz/csf_tz/fleet_management/doctype/delivery_note_template/
Type: Master DocType
Purpose: Standardized delivery note templates

45. Assigned Transport Details

Location: apps/csf_tz/csf_tz/fleet_management/doctype/assigned_transport_details/
Type: Child Table DocType
Purpose: Transport assignment details

Module 3: Clearing and Forwarding (25+ DocTypes)

Import/Export Management

1. Container

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/container/
Type: Master DocType
Purpose: Container management for import/export operations

Container Features:

Container specifications
Tracking and monitoring
Status management
Cost allocation

2. Container Receipt

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/container_receipt/
Type: Transaction DocType
Purpose: Container receipt and processing

3. Clearing Agent

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/clearing_agent/
Type: Master DocType
Purpose: Clearing agent management

4. Clearing Job

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/clearing_job/
Type: Transaction DocType
Purpose: Complete clearing job management

Job Features:

Job planning and execution
Document management
Cost tracking
Timeline management

5. Clearing Job Item

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/clearing_job_item/
Type: Child Table DocType
Purpose: Items within clearing jobs

6. Clearing Job Container

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/clearing_job_container/
Type: Child Table DocType
Purpose: Containers within clearing jobs

Customs and Documentation

7. Border

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/border/
Type: Master DocType
Purpose: Border crossing point management

8. Border Processing

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/border_processing/
Type: Transaction DocType
Purpose: Border processing and customs clearance

9. Bond

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/bond/
Type: Master DocType
Purpose: Customs bond management

10. Bond Processing

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/bond_processing/
Type: Transaction DocType
Purpose: Bond processing and management

11. Manifest

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/manifest/
Type: Transaction DocType
Purpose: Cargo manifest management

12. Manifest Item

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/manifest_item/
Type: Child Table DocType
Purpose: Items within cargo manifests

Shipping and Logistics

13. Shipping Line

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/shipping_line/
Type: Master DocType
Purpose: Shipping line management

14. Port

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/port/
Type: Master DocType
Purpose: Port and terminal management

15. Warehouse Receipt

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/warehouse_receipt/
Type: Transaction DocType
Purpose: Warehouse receipt processing

16. Warehouse Receipt Item

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/warehouse_receipt_item/
Type: Child Table DocType
Purpose: Items within warehouse receipts

Financial and Billing

17. Clearing Charges

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/clearing_charges/
Type: Master DocType
Purpose: Clearing service charges management

18. Clearing Invoice

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/clearing_invoice/
Type: Transaction DocType
Purpose: Clearing service invoicing

19. Clearing Invoice Item

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/clearing_invoice_item/
Type: Child Table DocType
Purpose: Invoice line items

20. Exchange Rate

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/exchange_rate/
Type: Master DocType
Purpose: Currency exchange rate management

Documentation and Compliance

21. Import Declaration

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/import_declaration/
Type: Transaction DocType
Purpose: Import declaration processing

22. Export Declaration

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/export_declaration/
Type: Transaction DocType
Purpose: Export declaration processing

23. Bill of Lading

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/bill_of_lading/
Type: Transaction DocType
Purpose: Bill of lading management

24. Commercial Invoice

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/commercial_invoice/
Type: Transaction DocType
Purpose: Commercial invoice processing

25. Packing List

Location: apps/csf_tz/csf_tz/clearing_and_forwarding/doctype/packing_list/
Type: Transaction DocType
Purpose: Cargo packing list management

Module 4: After Sales Services (12+ DocTypes)

Service Management

1. Machine Strip Request

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/machine_strip_request/
Type: Transaction DocType
Purpose: Equipment maintenance and stripping requests

2. Pre Delivery Inspection

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/pre_delivery_inspection/
Type: Transaction DocType
Purpose: Quality control before delivery

3. Maintenance Schedule

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/maintenance_schedule/
Type: Master DocType
Purpose: Preventive maintenance scheduling

4. Service Request

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/service_request/
Type: Transaction DocType
Purpose: Customer service request management

5. Service Type

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/service_type/
Type: Master DocType
Purpose: Classification of service types

6. Warranty Claim

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/warranty_claim/
Type: Transaction DocType
Purpose: Product warranty claim processing

7. Requested Payments

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/requested_payments/
Type: Transaction DocType
Purpose: Service payment request management

8. Service Report

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/service_report/
Type: Transaction DocType
Purpose: Service completion reporting

9. Spare Parts Request

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/spare_parts_request/
Type: Transaction DocType
Purpose: Spare parts ordering and management

10. Customer Feedback

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/customer_feedback/
Type: Transaction DocType
Purpose: Post-service customer feedback collection

11. Service Agreement

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/service_agreement/
Type: Master DocType
Purpose: Service contract management

12. Technician Assignment

Location: apps/csf_tz/csf_tz/after_sales_services/doctype/technician_assignment/
Type: Transaction DocType
Purpose: Technician assignment to service requests

Module 5: Workshop Management (8+ DocTypes)

Workshop Operations

1. Workshop Service

Location: apps/csf_tz/csf_tz/workshop/doctype/workshop_service/
Type: Transaction DocType
Purpose: Workshop service management

2. Workshop Service Type

Location: apps/csf_tz/csf_tz/workshop/doctype/workshop_service_type/
Type: Master DocType
Purpose: Workshop service classification

3. Workshop Item

Location: apps/csf_tz/csf_tz/workshop/doctype/workshop_item/
Type: Master DocType
Purpose: Workshop inventory management

4. Workshop Request

Location: apps/csf_tz/csf_tz/workshop/doctype/workshop_request/
Type: Transaction DocType
Purpose: Workshop service request processing

5. Workshop Equipment

Location: apps/csf_tz/csf_tz/workshop/doctype/workshop_equipment/
Type: Master DocType
Purpose: Workshop equipment management

6. Workshop Schedule

Location: apps/csf_tz/csf_tz/workshop/doctype/workshop_schedule/
Type: Transaction DocType
Purpose: Workshop scheduling and planning

7. Workshop Invoice

Location: apps/csf_tz/csf_tz/workshop/doctype/workshop_invoice/
Type: Transaction DocType
Purpose: Workshop service billing

8. Workshop Report

Location: apps/csf_tz/csf_tz/workshop/doctype/workshop_report/
Type: Transaction DocType
Purpose: Workshop service reporting

Module 6: Sales and Marketing (8+ DocTypes)

Customer Management

1. Customer Communication

Location: apps/csf_tz/csf_tz/sales_and_marketing/doctype/customer_communication/
Type: Transaction DocType
Purpose: Customer communication tracking

2. Customer Alert

Location: apps/csf_tz/csf_tz/sales_and_marketing/doctype/customer_alert/
Type: Transaction DocType
Purpose: Customer alert and notification management

3. Past Sales Analysis

Location: apps/csf_tz/csf_tz/sales_and_marketing/doctype/past_sales_analysis/
Type: Report DocType
Purpose: Historical sales data analysis

4. Sales Target

Location: apps/csf_tz/csf_tz/sales_and_marketing/doctype/sales_target/
Type: Master DocType
Purpose: Sales target setting and tracking

5. Customer Payment Plan

Location: apps/csf_tz/csf_tz/sales_and_marketing/doctype/customer_payment_plan/
Type: Master DocType
Purpose: Customer payment schedule management

6. Marketing Campaign

Location: apps/csf_tz/csf_tz/sales_and_marketing/doctype/marketing_campaign/
Type: Master DocType
Purpose: Marketing campaign management

7. Lead Source

Location: apps/csf_tz/csf_tz/sales_and_marketing/doctype/lead_source/
Type: Master DocType
Purpose: Lead source tracking and analysis

8. Customer Segment

Location: apps/csf_tz/csf_tz/sales_and_marketing/doctype/customer_segment/
Type: Master DocType
Purpose: Customer segmentation and classification

Module 7: Purchase and Stock Management (6+ DocTypes)

Enhanced Inventory Management

1. Bin Management

Location: apps/csf_tz/csf_tz/purchase_and_stock_management/doctype/bin_management/
Type: Master DocType
Purpose: Warehouse bin organization and management

2. Purchase Order Tracking

Location: apps/csf_tz/csf_tz/purchase_and_stock_management/doctype/purchase_order_tracking/
Type: Transaction DocType
Purpose: Enhanced purchase order monitoring

3. Stock Movement Analysis

Location: apps/csf_tz/csf_tz/purchase_and_stock_management/doctype/stock_movement_analysis/
Type: Report DocType
Purpose: Stock movement analytics and reporting

4. Supplier Performance

Location: apps/csf_tz/csf_tz/purchase_and_stock_management/doctype/supplier_performance/
Type: Report DocType
Purpose: Supplier performance evaluation

5. Item Reorder Level

Location: apps/csf_tz/csf_tz/purchase_and_stock_management/doctype/item_reorder_level/
Type: Master DocType
Purpose: Automated reorder level management

6. Stock Reconciliation Template

Location: apps/csf_tz/csf_tz/purchase_and_stock_management/doctype/stock_reconciliation_template/
Type: Master DocType
Purpose: Standardized stock reconciliation templates

Module 8: Meal Count (5+ DocTypes)

Employee Meal Management

1. Biometric Device

Location: apps/csf_tz/csf_tz/meal_count/doctype/biometric_device/
Type: Master DocType
Purpose: Biometric device configuration and management

2. Meal Type

Location: apps/csf_tz/csf_tz/meal_count/doctype/meal_type/
Type: Master DocType
Purpose: Meal category and type management

3. Employee Meal Record

Location: apps/csf_tz/csf_tz/meal_count/doctype/employee_meal_record/
Type: Transaction DocType
Purpose: Employee meal consumption tracking

4. Meal Count Settings

Location: apps/csf_tz/csf_tz/meal_count/doctype/meal_count_settings/
Type: Single DocType
Purpose: Meal counting system configuration

5. Meal Report

Location: apps/csf_tz/csf_tz/meal_count/doctype/meal_report/
Type: Report DocType
Purpose: Meal consumption reporting and analytics

Module 9: Feedback System (4+ DocTypes)

Customer Feedback Management

1. Feedback Form

Location: apps/csf_tz/csf_tz/feedback/doctype/feedback_form/
Type: Master DocType
Purpose: Customizable feedback form creation

2. Feedback Template

Location: apps/csf_tz/csf_tz/feedback/doctype/feedback_template/
Type: Master DocType
Purpose: Standardized feedback templates

3. Feedback Response

Location: apps/csf_tz/csf_tz/feedback/doctype/feedback_response/
Type: Transaction DocType
Purpose: Customer feedback response collection

4. Feedback Analysis

Location: apps/csf_tz/csf_tz/feedback/doctype/feedback_analysis/
Type: Report DocType
Purpose: Feedback data analysis and reporting

Module 10: Stanbic Bank Integration (3+ DocTypes)

Banking Integration

1. Stanbic Payment

Location: apps/csf_tz/csf_tz/stanbic/doctype/stanbic_payment/
Type: Transaction DocType
Purpose: Stanbic Bank payment processing

2. Stanbic Settings

Location: apps/csf_tz/csf_tz/stanbic/doctype/stanbic_settings/
Type: Single DocType
Purpose: Stanbic Bank integration configuration

3. Stanbic Transaction Log

Location: apps/csf_tz/csf_tz/stanbic/doctype/stanbic_transaction_log/
Type: Transaction DocType
Purpose: Banking transaction audit trail

Module 11: AI Integration (2+ DocTypes)

Artificial Intelligence Features

1. LLM Settings

Location: apps/csf_tz/csf_tz/ai_integration/doctype/llm_settings/
Type: Single DocType
Purpose: Large Language Model configuration

2. OpenAI Query Log

Location: apps/csf_tz/csf_tz/ai_integration/doctype/openai_query_log/
Type: Transaction DocType
Purpose: AI query tracking and logging

Module 12: Auth OTP (2+ DocTypes)

Authentication System

1. AuthOTP Settings

Location: apps/csf_tz/csf_tz/authotp/doctype/authotp_settings/
Type: Single DocType
Purpose: OTP authentication configuration

2. OTP Register

Location: apps/csf_tz/csf_tz/authotp/doctype/otp_register/
Type: Transaction DocType
Purpose: OTP generation and validation tracking

DocType Relationships and Dependencies

Master-Transaction Relationships

Geographic Hierarchy

TZ Region (Master)
├── TZ District (Master)
    ├── TZ Ward (Master)
        └── TZ Village (Master)

Fleet Management Hierarchy

Vehicle Type (Master)
├── Transport Request (Transaction)
    ├── Transport Assignment (Transaction)
        └── Vehicle Trip (Transaction)
            └── Vehicle Log (Transaction)

Clearing and Forwarding Workflow

Clearing Job (Transaction)
├── Clearing Job Container (Child Table)
├── Clearing Job Item (Child Table)
└── Clearing Invoice (Transaction)
    └── Clearing Invoice Item (Child Table)

Service Management Flow

Service Request (Transaction)
├── Technician Assignment (Transaction)
├── Service Report (Transaction)
└── Customer Feedback (Transaction)

Key Integration Points

HR and Payroll Integration

Piecework → Additional Salary Component → Payroll Processing
Employee Meal Record → Payroll Deductions
Overtime Calculation → Salary Slip Generation

Financial Integration

Bank Charges → Payment Entry → GL Entries
Withholding Tax → Purchase Invoice → Tax Compliance
Clearing Charges → Clearing Invoice → Customer Billing

Inventory Integration

Stock Transfer → Stock Entry → GL Entries
Delivery Exchange → Sales Return → Stock Adjustment
Trade-in Processing → Asset Management → Depreciation

DocType Categories Summary

By Functionality

Master Data DocTypes (80+)

Geographic data (Regions, Districts, Wards, Villages)
Vehicle and equipment specifications
Service types and categories
Customer and supplier classifications
Product and inventory masters

Transaction DocTypes (100+)

Sales and purchase transactions
HR and payroll transactions
Fleet management operations
Service requests and maintenance
Financial transactions and payments

Configuration DocTypes (20+)

System settings and preferences
Integration configurations
Workflow settings
User access controls

Reporting DocTypes (15+)

Financial reports and analytics
Operational reports
Compliance reports
Performance dashboards

By Business Process

Core Business Operations (120+)

Sales and customer management
Purchase and supplier management
Inventory and warehouse management
Financial management and accounting

Specialized Operations (80+)

Fleet management and logistics
Clearing and forwarding
Workshop and maintenance services
After-sales service management

Support Functions (20+)

Human resources and payroll
System administration
Security and authentication
Reporting and analytics

Technical Implementation

DocType Design Patterns

Naming Conventions

Auto-naming: Format-based naming for transactions
Prompt Naming: User-defined names for masters
Field-based Naming: Using specific field values

Field Types Usage

Link Fields: Extensive use for relationships
Child Tables: Complex data structures
Calculated Fields: Business logic implementation
Conditional Fields: Dynamic form behavior

Permissions and Security

Role-based Access: Granular permission control
Document-level Security: Row-level security implementation
Field-level Permissions: Sensitive data protection
Workflow Integration: Approval-based processing

Performance Considerations

Database Optimization

Indexed Fields: Optimized query performance
Selective Loading: Reduced memory usage
Caching Strategies: Improved response times
Archive Policies: Data lifecycle management

User Experience

Form Optimization: Streamlined data entry
List View Customization: Efficient data browsing
Search Enhancement: Quick data location
Mobile Responsiveness: Cross-device compatibility

Maintenance and Development

DocType Lifecycle Management

Development Process

Requirements Analysis: Business need identification
Design Phase: DocType structure planning
Implementation: Field and logic development
Testing: Functionality validation
Deployment: Production release
Maintenance: Ongoing support and updates

Version Control

Schema Changes: Tracked through patches
Data Migration: Automated upgrade scripts
Backward Compatibility: Legacy system support
Documentation Updates: Synchronized with changes

Best Practices

DocType Design

Single Responsibility: Each DocType serves one purpose
Normalized Structure: Avoid data duplication
Extensible Design: Future enhancement capability
Performance Optimization: Efficient data access

Business Logic Implementation

Server-side Validation: Data integrity enforcement
Client-side Enhancement: User experience improvement
Workflow Integration: Process automation
Audit Trail: Change tracking and compliance

Conclusion

The CSF TZ application represents one of the most comprehensive DocType implementations in the Frappe ecosystem, with over 200 custom DocTypes spanning 12 major business modules. This extensive collection addresses virtually every aspect of business operations in Tanzania, from basic accounting and HR to specialized functions like fleet management, clearing and forwarding, and workshop operations.

The modular design ensures scalability and maintainability while providing businesses with the flexibility to implement only the modules they need. The deep integration between modules creates a cohesive business management system that can handle complex, multi-faceted operations while maintaining data integrity and business process compliance.

CFS TZ