Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Daniel-Stojanovski/finkiopendesk/llms.txt

Use this file to discover all available pages before exploring further.

The Career Guide connects FCSE academic subjects to real-world industry professions. Each profession lists the subjects most relevant to that career, organized into a visual roadmap that shows recommended course progression by academic level and semester. The community can vote on individual subjects to signal how important they are for a given profession, making the guide a living, student-driven resource.

​
Browsing professions

The career guide opens with a grid of all professions. You can search by name or filter by academic program using the pill buttons at the top of the page. Supported academic programs: SIIS SEIS IMB PIT IE KI KN SSP Selecting a program pill filters the profession list to only those linked to that program. Selecting “None” clears the filter and shows all professions. API endpoint: 
GET /api/professions?query={searchQuery}

​
Career guide workflow

1

Browse professions

Open the Careers page. All professions load automatically. Type in the search bar to filter by profession name or alternative name, or click a program pill to filter by academic program.
2

Select a profession

Click any profession card to open its detail view. The header shows the profession name and description. Two tabs are available: Roadmap and Voting.
3

View the subject roadmap

The Roadmap tab displays a visual diagram of recommended subjects, organized into columns by academic level (L1, L2, L3) and semester (Winter/Summer). Use the program filter pills to show only subjects for a specific program. Mandatory subjects appear before elective ones within each column.
4

Switch to voting

Click the Voting tab to see all subjects associated with the profession with their current community vote counts. Each subject card shows the total votes it has received and whether you have already voted for it.
5

Vote on subjects

Click the vote button on any subject card to cast or withdraw your vote. Voting again on a subject you already voted for removes your vote (toggle behavior). Votes are scoped to the profession-subject combination — the same subject in a different profession has independent vote counts.

​
Roadmap diagram

The roadmap groups subjects into six columns derived from two axes:
LevelSeasonColumn ID
L1 (foundational)WinterL1-W
L1 (foundational)SummerL1-S
L2 (intermediate)WinterL2-W
L2 (intermediate)SummerL2-S
L3 (advanced)WinterL3-W
L3 (advanced)SummerL3-S
A subject’s level and season come from its tags. Within a column, mandatory subjects are sorted before elective ones. Nodes in the diagram carry dependency edges — subjects with prerequisites show connections to those prerequisite nodes. API endpoint: 
GET /api/program-subjects/pid/{professionId}
The response is filtered to MANDATORY and ELECTIVE types, and further filtered by the active program pill selection.

​
Voting

Each authenticated user can cast one vote per subject within a profession context. The vote is stored as a (professionId, subjectId, userId) combination, so the same subject appearing across multiple professions has independent vote tallies.Casting a vote when one already exists for that combination removes the vote — there is no separate “unvote” action. This toggle behavior is consistent with the favorites system.Reading votes:
GET /api/votes/pid/{professionId}
Returns an array of { subjectId, voteCount } for all subjects in the profession.Reading your own votes:
GET /api/votes/pid/{professionId}/{userId}
Returns an array of { subjectId, vote } for the authenticated user only.Casting or withdrawing a vote:
POST /api/subjects/vote
Content-Type: application/json

{
  "subjectId": "{subjectId}",
  "professionId": "{professionId}"
}
A 204 No Content response means the vote was withdrawn. A 200 OK response returns the new vote record.
You must be logged in to vote. The backend extracts the user ID from the JWT token attached to the request. Unauthenticated requests to the vote endpoint will be rejected.
A profession can be linked to multiple academic programs. The roadmap program filter pills are populated dynamically from profession.programs. Selecting a program restricts the diagram to subjects that belong to that program’s curriculum, letting you see a focused path relevant to your degree.

​
Profession data shape

interface ProfessionDto {
  professionId: string;
  name: string;
  alternativeName: string | null;
  description: string | null;
  discussion: ProfessionDiscussionDto;
  recommendedSubjects?: SubjectDto[];
  programs?: ProgramDto[];
}
Each profession also has a dedicated community discussion thread accessible from the discussions view, separate from the career guide roadmap and voting interface.

Build docs developers (and LLMs) love

Get started for freeTalk to us