How harip-git/spendgate_hari works
SpendGate is a Frappe app for managing employee expense claims against departmental budgets. Staff enter claims and expense lines; the claim controller validates them against budget limits, while authorized department heads and finance managers can approve, reject, or reassign claims. The app also exposes claim and budget APIs, sends submission notifications and optional webhooks, records audit events, and checks budget thresholds daily. The README gives only a brief product description; report and voucher capabilities are represented from the repository tree, whose implementation was not sampled.
Main entry points: expense_claim.py Claim controller · expense_claim.js Claim form · tasks.py Daily threshold check · api.py Webhook delivery
Components 20
Claims and approvals
- Claim form
spendgate/spendgate/doctype/expense_claim/expense_claim.js - Claim controller
spendgate/spendgate/doctype/expense_claim/expense_claim.py - Expense lines
spendgate/spendgate/doctype/expense_line/expense_line.py - Approval actions
spendgate/spendgate/doctype/expense_claim/expense_claim.py - Claim voucher
spendgate/spendgate/print_format/expense_claim_voucher - Pending approvals
spendgate/spendgate/report/pending_approvals
Budgets and setup
- Budget rules
spendgate/spendgate/doctype/budget/budget.py - Departments
spendgate/spendgate/doctype/department - Expense categories
spendgate/spendgate/doctype/expense_category/expense_category.py - App settings
spendgate/spendgate/doctype/spendgate_settings/spendgate_settings.py
Access and APIs
- Expense APIs
spendgate/api.py - Claim permissions
spendgate/permission.py
Alerts and audit
- Audit logging
spendgate/audit.py - Daily threshold check
spendgate/tasks.py - Claim notifications
spendgate/notifications.py - Webhook delivery
spendgate/api.py
Other components
- SpendGate user
- Frappe document store
- Email service
- Configured webhook
Connections 24
- SpendGate user → Claim form: enters claim
spendgate/spendgate/doctype/expense_claim/expense_claim.js - Claim form → Claim controller: calls claim methods
spendgate/spendgate/doctype/expense_claim/expense_claim.js - Claim form → Approval actions: calls decisions
spendgate/spendgate/doctype/expense_claim/expense_claim.js - Claim form → Claim controller: requests remaining budget
spendgate/spendgate/doctype/expense_claim/expense_claim.js - Claim controller → Frappe document store: reads and writes
spendgate/spendgate/doctype/expense_claim/expense_claim.py - Claim controller → Budget rules: loads linked budget
spendgate/spendgate/doctype/expense_claim/expense_claim.py - Claim controller → Claim notifications: queues notice
spendgate/spendgate/doctype/expense_claim/expense_claim.py - Claim controller → Webhook delivery: queues webhook
spendgate/spendgate/doctype/expense_claim/expense_claim.py - Approval actions → Frappe document store: updates claim status
spendgate/spendgate/doctype/expense_claim/expense_claim.py - SpendGate user → Expense APIs: requests API
spendgate/api.py - Expense APIs → Frappe document store: reads and shares
spendgate/api.py - SpendGate user → Claim permissions: claim list access
- Claim permissions → Frappe document store: filters claims
spendgate/permission.py - Daily threshold check → Frappe document store: reads budgets and logs
spendgate/tasks.py - Daily threshold check → App settings: reads alert threshold
spendgate/tasks.py - Daily threshold check → Email service: sends budget alert
spendgate/tasks.py - Daily threshold check → Frappe document store: writes alert and audit logs
spendgate/tasks.py - Webhook delivery → App settings: reads webhook URL
spendgate/api.py - Webhook delivery → Frappe document store: loads submitted claim
spendgate/api.py - Webhook delivery → Configured webhook: posts claim event
spendgate/api.py - Audit logging → Frappe document store: records changes
- Frappe document store → Expense lines: stores line records
- Claim notifications → Email service: sends claim notice
- Claim form → Expense lines: edits claim lines