Prompt
How do I set up a mortgage origination platform for tracking underwriting and stipulation workflows?
Latest observation
To set up a mortgage origination platform for tracking underwriting and stipulation workflows, design it around a clear loan lifecycle, role-based task management, document/stip tracking, and auditability.
1) Define the workflow stages
Model the full loan path as stages, for example:
- Lead / Application
- Loan setup / intake
- Processing
- Underwriting
- Conditions / stipulations
- Clear to close
- Closing
- Funding / post-closing
- Purchase / final disposition
For underwriting and stipulations specifically, you’ll want states like:
- Submitted to underwriting
- In review
- Condition(s) issued
- Borrower/processor responded
- Re-submitted
- Approved with conditions
- Final approval
- Suspended / withdrawn / denied
2) Build the core data model
At minimum, you need these entities:
- Loan
- loan number, borrower(s), property, product, status, dates
- Borrower / Co-borrower
- contact info, demographics as needed, consent fields
- Application / 1003
- income, assets, liabilities, declarations, occupancy, etc.
- Documents
- uploaded files, type, version, source, received date
- Underwriting Review
- underwriter assigned, decision, decision date, notes
- Condition / Stipulation
- condition text, category, owner, due date, status, priority
- Task
- actionable item tied to a loan or condition
- User / Role
- LO, processor, underwriter, closing, admin, auditor
- Activity Log
- who changed what, when, and why
3) Use a condition/stipulation engine
Conditions are the heart of the workflow. Each stip should have:
- Condition ID
- Linked loan
- Category
- income, assets, credit, property, title, compliance, final docs, etc.
- Condition text
- e.g., “Provide 30 days of bank statements”
- Owner
- borrower, LO, processor, underwriter, title, employer, etc.
- Status
- open, in progress, satisfied, waived, reissued, expired
- Priority
- Due date
- Satisfaction evidence
- uploaded document or note
- Reviewed by underwriter
- yes/no, date
- Reopen history
- Audit trail
A good practice is to let underwriters generate conditions from templates, but allow manual edits and custom conditions.
4) Create role-based work queues
Each user should see only the items relevant to them.
Examples:
- Underwriter queue
- loans waiting review, conditions pending re-review, escalations
- Processor queue
- items needed to clear conditions
- LO queue
- borrower follow-up, missing docs, exceptions
- Manager queue
- overdue cases, pipeline aging, SLA breaches
Include filters by:
- status
- assigned user
- due date
- product/type
- branch/team
- aging
5) Document management and version control
Underwriting workflows depend heavily on documents.
Capabilities should include:
- secure upload and storage
- document classification
- OCR/search if possible
- version history
- “received” vs “reviewed” vs “accepted”
- document-to-condition mapping
- expiration tracking for time-sensitive docs
Example:
- Bank statements satisfy an “assets” condition
- Paystubs satisfy an “income” condition
- Updated hazard insurance satisfies a “property” condition
6) Build status transitions and approvals
Define strict transitions so the workflow is controlled.
Example:
- Condition issued → Awaiting response
- Docs received → Processor review
- Processor clears → Underwriter re-review
- Underwriter approves → Condition satisfied
- All conditions satisfied → Clear to close
You may want:
- approval rules
- exception handling
- escalation paths
- re-open capability if new information arrives
7) Notifications and SLA monitoring
Automate reminders and alerts for:
- new underwriting assignment
- conditions issued
- documents uploaded
- due dates approaching
- conditions overdue
- loans stalled in underwriting
- re-submission ready for review
Track SLA metrics such as:
- time from submission to first review
- condition clearance time
- average number of condition cycles
- aged files by stage
8) Add compliance and audit controls
Mortgage platforms need strong auditability.
Include:
- immutable activity history
- document access logs
- change reason codes
- role-based permissions
- electronic signature support if needed
- retention policies
- secure PII handling
- encryption in transit and at rest
If you’re operating in regulated markets, make sure the system supports relevant compliance requirements for mortgage lending, privacy, and recordkeeping.
9) Design the UI around the workflow
Helpful screens:
- Pipeline dashboard
- Loan detail page
- Underwriting review panel
- Condition tracker
- Document center
- Task list / inbox
- Timeline view
- Exception/approval screen
A strong loan detail page usually has:
- header with status and assigned users
- checklist of outstanding conditions
- document tabs
- notes/comments
- timeline of events
- decision history
10) Reporting and analytics
Important reports include:
- loans by stage
- average underwriting turnaround
- condition aging
- bottlenecks by team/user
- approval/denial rates
- document deficiency trends
- re-submission frequency
These metrics help you identify where files get stuck.
11) Integration points
You’ll likely want integrations with:
- LOS/CRM systems
- credit bureaus
- income/asset verification tools
- e-signature services
- document storage
- email/SMS notification systems
- title/closing providers
- identity verification/KYC tools
12) Recommended implementation approach
If you’re building from scratch:
MVP
Start with:
- loan record
- user roles
- underwriting statuses
- condition creation/assignment
- document upload
- task inbox
- comments and audit log
Phase 2
Add:
- automated routing
- condition templates
- SLA alerts
- reporting dashboards
- external integrations
Phase 3
Add:
- rules engine
- AI-assisted document classification
- exception detection
- advanced analytics
13) Suggested architecture
A practical backend structure:
- Frontend
- loan dashboard, work queues, document review
- API layer
- loans, tasks, conditions, docs, users
- Workflow engine
- status transitions, approvals, automation
- Document service
- storage, metadata, OCR
- Notification service
- email/SMS/in-app alerts
- Audit/log service
- Reporting warehouse
14) Key design principles
- keep every condition tied to a loan and a responsible owner
- make status changes explicit and auditable
- avoid free-form notes as the only source of truth
- support re-review after condition satisfaction
- minimize manual handoffs with automation
- make aging and bottlenecks visible
If you want, I can also provide:
- a sample database schema,
- a workflow state diagram, or
- a MVP feature checklist for building this platform.