How hanii-tech/automated-payslip-generation-system works
This is a batch payslip-generation application: an operator starts a run, employee records are loaded and validated, payroll amounts are calculated, PDFs are created, emails are optionally sent, and outcomes are written to a manifest. The graph follows the documented workflow and sampled calls; the README also describes Excel input, although only a CSV sample appears in the tree.
Main entry points: main.py Pipeline orchestration · utils.py Data loading & validation · email_sender.py Email delivery · run.py Command entry
Components 13
Run orchestration
- Command entry
run.py - Pipeline orchestration
src/main.py
Payroll processing
- Employee CSV
data/employees.csv - Data loading & validation
src/utils.py - Net pay calculation
src/utils.py
Payslip delivery
- Payslip PDF generation
src/pdf_generator.py - Email delivery
src/email_sender.py
Run artifacts
- Processed payroll CSV
- Payslip PDFs
- Run manifest CSV
Other components
- Payroll operator
- SMTP provider
- Employee recipient
Connections 14
- Payroll operator → Command entry: starts run
- Command entry → Pipeline orchestration: calls
- Pipeline orchestration → Data loading & validation: loads and validates
- Data loading & validation → Employee CSV: reads
- Pipeline orchestration → Net pay calculation: calculates pay
- Pipeline orchestration → Data loading & validation: saves processed data
- Data loading & validation → Processed payroll CSV: writes
- Pipeline orchestration → Payslip PDF generation: generates payslips
- Payslip PDF generation → Payslip PDFs: writes PDFs
- Pipeline orchestration → Email delivery: requests delivery
- Email delivery → SMTP provider: sends attachment
- SMTP provider → Employee recipient: delivers email
- Email delivery → Payslip PDFs: reads attachment
- Pipeline orchestration → Run manifest CSV: writes outcomes