{
  "tool": "phd.phd_milestones",
  "name": "Milestone plan — the research calendar (CDU-GEN-PHD-1000)",
  "answers": "The milestone dates of a doctorate from a start year and a duration, with the credit-to-hours arithmetic.",
  "degree": {
    "id": "competency:phd",
    "code": "CDU-GEN-PHD-1000",
    "name": "PhD — Doctor of Philosophy (NQF 10)",
    "version": "1.0.0"
  },
  "reference": "Doctoral milestone arithmetic; one credit = ten notional hours (the framework lookup)",
  "endpoint": "/faculty/phd/phd_milestones",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "startYear",
      "durationYears",
      "totalCredits"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "startYear": {
        "type": "number",
        "description": "start year (whole)",
        "minimum": 2026,
        "maximum": 2100
      },
      "durationYears": {
        "type": "number",
        "description": "planned duration (whole years, 2–8)",
        "minimum": 2,
        "maximum": 8
      },
      "totalCredits": {
        "type": "number",
        "description": "credit size (whole, ≥ 120)",
        "minimum": 120,
        "maximum": 720
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "proposalYear",
      "midpointYear",
      "submissionYear",
      "notionalHours",
      "hoursPerYear"
    ],
    "properties": {
      "proposalYear": {
        "type": "number",
        "description": "proposal defended"
      },
      "midpointYear": {
        "type": "number",
        "description": "midpoint review"
      },
      "submissionYear": {
        "type": "number",
        "description": "thesis submitted"
      },
      "notionalHours": {
        "type": "number",
        "description": "credits × 10"
      },
      "hoursPerYear": {
        "type": "number",
        "description": "notional hours per planned year (1 d.p.)"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "startYear": 2027,
    "durationYears": 4,
    "totalCredits": 360
  }
}