Cycles

Cycles represent the progressive loan rounds a group passes through, where good repayment unlocks a larger limit next time. The record tracks cycle number, the loan band and the dates. Cycle progression is the core incentive mechanism of group lending and the basis for graduating members.

Workflow

Open Cycles under Operations.
Create a cycle and set its number and date range.
Define the loan band/ceiling for the cycle.
Link the cycle to the relevant groups.
Advance groups to the next cycle on successful completion.

Fields reference

Every field on this screen, drawn from the live data model.

Field	Type	Required	Description
Website Messages `website_message_ids`	List	—	Website communication history
Group `group_id`	Link → mfi.group.group	Yes	Group
Start Date `start_date`	Date	Yes	Start Date
My Activity Deadline `my_activity_date_deadline`	Date	—	My Activity Deadline
Has Message `has_message`	Yes/No	—	Has Message
Ratings `rating_ids`	List	—	Ratings
Name `name`	Text	—	Name
Cycle No `cycle_no`	Number	—	Cycle No
End Date `end_date`	Date	—	End Date
Target Amount `target_amount`	Money	—	Target Amount
State `state`	Choice: Forming, Disbursed, Repayment, Closed	—	State
Members in Cycle `cycle_member_ids`	List	—	Members in Cycle
Member Count `member_count`	Number	—	Member Count
Total Disbursed `total_disbursed`	Money	—	Total Disbursed
Cycle PAR % `par_pct`	Decimal	—	Cycle PAR %
Company `company_id`	Link → res.company	—	Company
Currency `currency_id`	Link → res.currency	—	Currency
Notes `notes`	Long text	—	Notes

Actions & buttons

Buttons available on this screen and what they do:

Disburse
Close Cycle

Status lifecycle

Records on this screen move through these statuses:

Forming → Disbursed → Repayment → Closed

Notes & rules

Model mfi.group.cycle; tracks the round-by-round lending progression.
Higher cycles unlock larger loan limits (graduation incentive).
Holds cycle number, loan band and period.
Drives member graduation and limit escalation rules.

Technical model: mfi.group.cycle · Record: Group Loan Cycle