How payroll-engine/payrollengine works
Project Type and Purpose
• This is a CLI‐based payroll automation framework (the “Payroll Engine”), built on .NET and driven by script files (.pecmd), JSON definitions, and C# extensions.
• It provides a core executable (“engine”) that interprets .pecmd commands, validates against JSON Schemas, invokes embedded or user‐supplied C# scripts, and produces payroll results (reports, exports, logs).
File Structure Analysis
• Top‐level directories:
• Commands – PowerShell/CMD wrapper scripts for build, pack, publish, testing, schema generation, file‐type registration.
• Examples – Sample payroll scenarios (SimplePayroll, TimesheetPayroll, etc.), each containing:
– .pecmd scripts (setup/import/delete/build/test)
– JSON definitions (Payroll.json, parameters.json, etc.)
– Optional C# script files and .csproj/.sln for extension libraries
• Schemas – JSON Schema definitions driving validation (CaseTest, Exchange, ReportTest).
• Tests – Integration/test suites (each in its own folder) leveraging .pecmd scripts + test data (.json, .pt.json, .et.json) + C# test helpers.
• Setup – OS‐level registration (file associations, admin tasks).
• docs – Markdown docs, whitepapers, Swagger JSON.
• images, LICENSE, README.md.
Key Insights from README
• Core branding: “Payroll Engine – the payroll automation framework.”
• Directs users to an online Wiki for deeper architecture and usage details.