> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learnway.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Learning Paths & Roadmaps

> Structured career roadmaps, adaptive AI curriculum recommendations, and micro-skill progressions.

# Learning Paths & Roadmaps

Learning Paths organize courses into guided sequences designed to take a learner from novice to job-ready specialist in a particular discipline.

***

## Foundation vs Specialization Paths

LearnWay splits learning paths into two primary tiers:

| Tier                     | Characteristics                                                                        | Access Level                                |
| ------------------------ | -------------------------------------------------------------------------------------- | ------------------------------------------- |
| **Foundation Paths**     | Core competencies (e.g., *Digital Literacy*, *Financial Fundamentals*, *AI Literacy*). | **Free** for all registered learners.       |
| **Specialization Paths** | Deep-dive domains (e.g., *Full-Stack Solidity Developer*, *AI Prompt Engineer*).       | Requires **LearnWay Premium** subscription. |

***

## Dynamic Career Roadmap Generation

Learners can generate a custom learning roadmap tailored to their career aspirations:

```http theme={null}
POST /api/v2/learning-path/roadmap
Content-Type: application/json

{
  "userId": "550e8400-e29b-41d4-a716-446655440000",
  "careerGoal": "Smart Contract Auditor"
}
```

### Algorithmic Workflow

1. **Input Analysis**: The system parses the target `careerGoal` and user's past course completion history.
2. **Curriculum Synthesis**:
   * Always injects all Foundation Paths as prerequisites.
   * Matches keywords and competencies to active Specialization Paths.
   * Orders courses according to dependency graph (`prerequisites`).
3. **Roadmap Persistence**: Saves the roadmap into `user_career_roadmaps` table for live progress calculations.
4. **Response**: Delivers ordered milestones, total estimated hours, and access status for each node.