# CHM ERP Context Document

## Project

CHM ERP (Celebrate Hope Ministries ERP)

A Laravel-based enterprise management system used by Celebrate Hope Ministries.

The system integrates program management, coffee operations, accounting, finance, HR and administrative workflows.


# Technology Stack

- Laravel 10
- PHP 8.x
- MySQL
- Blade Templates
- Bootstrap 5
- jQuery
- Vite
- Livewire
- Spatie Permission
- Laravel Excel
- DomPDF


# Main Business Areas


## CFDP (Child and Family Development Program)

Modules:

- Child Management
- Sponsor Management
- Letter Writing
- Education Tracking
- Health Records
- Coffee Growing


## Transformation

Modules:

- Farmer Management
- Special Projects
- CCV (Coffee Community Volunteers)
- Development Tracking


## Hope Health

Modules:

- Patients
- Medical Records
- Outreach Programs
- Staff Health


## Church

Modules:

- Churches
- Pastors
- Clusters
- Groups


## Hope Coffee

Modules:

- Farmers
- Green Bean Processing
- Nursery Beds
- Beverage Production
- Inventory
- Sales


## Accounting

Modules:

- Chart of Accounts
- Journal Entries
- Payment Vouchers
- Receipts
- General Ledger
- Trial Balance
- Balance Sheet
- Profit and Loss


## Administration

Modules:

- Human Resources
- Finance
- Support Services


# Important Rules

Before making changes:

1. Understand existing workflows.
2. Do not create duplicate functionality.
3. Check existing models and migrations.
4. Preserve accounting integrity.
5. Maintain Laravel standards.
6. Do not remove existing features.
7. Test changes locally before deployment.


# Development Environment

Local development only.

Production server must never be modified directly.

All changes go through:

Local → Git → Testing → Production