Skip to content
singhaditya21Public

About

HRMS

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Filing-First HRMS

An AI-native HR and payroll system for Indian employers of 20–200 people, where the statutory filing — not the payslip — is the unit of delivery.

Status

Product definition stage. The repository holds the product requirements document; there is no application code yet, by design.

The PRD

PRD.md is the canonical document. Every version is committed and tagged (v0.1 … v1.0).

Part Sections
Why and for whom §01 Executive summary · §02 Evidence register · §03 Personas · §04 Problem & market · §05 Scope & phasing
The statutory core §06 Statutory compliance spine
What the product does §07–§11 Functional requirements (core HR, payroll & filing, attendance, talent, benefits)
How it is built §12–§13 AI layer & economics · §14 Data model · §15 Architecture · §16 Integrations · §17 NFRs
How it is sold and measured §18 Pricing & GTM · §19 Metrics
What could go wrong §20 Non-goals, validation plan & risk register
Reference §21 Competitive landscape · §22 Compliance operations · §23 Legal & regulatory

Claims carry confidence markers — [Verified], [Hypothesis], [Killed], [Reversed] — and evidence IDs registered in §02. Nothing in the PRD is legal advice; items that need counsel are logged in §23.

How the PRD is built

PRD.md is assembled from per-section sources in prd_build/: sections/*.md (one file per section), Mermaid diagrams in diagrams/*.mmd, the corrections ledger LEDGER.md, the underlying research in research/r1–r5, and assemble.py. All of it is committed except the validator's installed dependencies — restore those with cd prd_build/tools && pnpm install. Edit the sources, then rebuild:

python3 prd_build/assemble.py v1.0 2026-09-12
node prd_build/tools/validate_mmd.mjs prd_build/diagrams
python3 prd_build/tools/check_prd.py

The validator parses every diagram with Mermaid 11.12.0 and also lints for ; inside state and sequence labels, which Mermaid accepts silently but renders as a stray transition. The checker verifies that every § reference resolves, every cited evidence ID is registered, and no requirement ID is defined twice.

About

HRMS

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages