Feature: Career Paths

Relevant source files

The following files were used as context for generating this wiki page:

• src/lib/career-paths.ts
• src/pages/career-paths/[path]/data.json.ts
• src/content.config.ts
• src/pages/career-paths/[path]/data-index.json.ts
• src/components/astro/database/records-table/col-certification-path.tsx
• src/components/astro/database/reactive-datatable.tsx

The Career Paths feature provides a structured way to categorize and browse cybersecurity certifications based on specific job roles. It allows users to filter the comprehensive certification database to find resources relevant to a particular career trajectory, such as "Penetration Tester" or "Cloud Security Specialist". This is achieved through a combination of a static data model defining the career paths, integration with the content collection schema, and a set of dynamic API endpoints that serve filtered data to the frontend.

This system enhances user experience by providing curated views of the certification data, making it easier for individuals to navigate their cybersecurity journey.

Data Model and Definitions

Sources: src/lib/career-paths.ts

The core of the feature is defined in src/lib/career-paths.ts, which establishes the available career paths and their associated metadata.

Career Path List

A constant array CareerPathsList defines all valid career path names available in the application. This list is used for type safety and for validation within the content schema.

A special constant, CAREER_PATH_SPECIAL_HIDDEN, is included in the list. It is intended to be filtered out from user-facing displays and is used as a placeholder.

Sources: src/lib/career-paths.ts:15-27

Career Path Metadata

The CareerPathsData object maps each career path name from CareerPathsList to its corresponding metadata, which includes a description, an associated image, and an attribution link for the image.

The structure of the CareerPathData object is shown in the diagram below.

The following table details the available career paths and their descriptions as defined in the system.

Career Path Name	Description
Blue Team Specialist	Defends an organization’s networks and systems against cyberattacks. Specializes in incident response, digital forensics, and continuous monitoring.
Cloud Security Specialist	Responsible for designing and implementing security measures to protect cloud-based infrastructure and data.
Cybersecurity Manager	Leads and manages cybersecurity teams and strategies, overseeing the implementation of security policies, projects, and incident response.
Malware Developer	Develops and tests exploits to identify vulnerabilities in systems, software, or hardware.
OSINT Specialist	Specializes in gathering and analyzing publicly available information (Open-Source Intelligence) to identify potential threats.
Penetration Tester	Conducts authorized simulated cyberattacks to identify vulnerabilities in systems, networks, and applications.
Red Team Specialist	Performs offensive security testing, simulating advanced cyberattacks to identify and exploit vulnerabilities.
Risk Management Specialist	Identifies, assesses, and prioritizes potential security risks to an organization’s assets.
Security Operations Specialist	Manages the daily operations of an organization’s security infrastructure, often within a SOC.
Threat Hunter	Actively searches for hidden and advanced threats within an organization’s environment that may bypass traditional security measures.

Sources: src/lib/career-paths.ts:43-110

Content Schema Integration

Sources: src/content.config.ts

To associate certifications with career paths, the career_paths field is integrated into the certifications content collection schema using Astro's content collections API.

The schema, defined in src/content.config.ts, ensures that every certification's frontmatter contains a career_paths array. This array is strictly validated against the CareerPathsList enum, ensuring data integrity and preventing the use of undefined career paths.

The diagram below illustrates the relationship between a certification document and the career paths.

The schema definition for the career_paths field is as follows:

// src/content.config.ts:16
career_paths: z.array(z.enum(CareerPathsList)),

This Zod schema enforces that career_paths must be an array of strings, where each string is one of the values from the CareerPathsList.

API Endpoints

The Career Paths feature exposes two dynamic API endpoints for each path to provide filtered certification data and a search index to the frontend. These endpoints are generated by Astro at build time based on the defined career paths.

Static Path Generation

The getStaticPaths function generates the URL paths for each career path. It takes the CareerPathsList, filters out the hidden entry, converts each name to kebab-case (e.g., "Blue Team Specialist" becomes blue-team-specialist), and creates a static path for it.

Sources: src/pages/career-paths/[path]/data.json.ts:13-25

Data Endpoint: data.json

Sources: src/pages/career-paths/[path]/data.json.ts

This endpoint returns a JSON array of certification metadata belonging to a specific career path.

• Route: GET /career-paths/[path]/data.json
• Description: Fetches all certifications where the career_paths array in the content frontmatter includes the career path specified in the URL.
• Logic:
  1. A lookup table is created to map the kebab-cased URL path parameter back to its full name (e.g., blue-team-specialist -> "Blue Team Specialist").
  2. The getCertificationMetadata function is called with a filter predicate that checks if a certification's career_paths array includes the resolved career path name.
  3. The filtered list of certification metadata is returned as a JSON response.

The following sequence diagram illustrates the request flow for this endpoint.

Search Index Endpoint: data-index.json

Sources: src/pages/career-paths/[path]/data-index.json.ts

This endpoint provides a pre-computed Fuse.js search index for the certifications within a specific career path. This optimizes client-side search performance by avoiding the need to build the index on the fly.

• Route: GET /career-paths/[path]/data-index.json
• Description: Generates and returns a JSON representation of a Fuse.js index for a specific career path.
• Logic:
  1. It retrieves the filtered certification metadata for the given career path, similar to the data.json endpoint.
  2. It uses Fuse.createIndex to build a search index from this filtered data based on the global FuseConfig.
  3. The generated index is serialized to JSON and returned in the response.

Sources: src/pages/career-paths/[path]/data-index.json.ts:15-22

Frontend Rendering

The data provided by the Career Path API endpoints is consumed by frontend components to display filtered and searchable tables of certifications.

Reactive Datatable

The ReactiveDatatable component is responsible for fetching and displaying certification data. It can be configured to fetch from a specific career path by setting its base_url prop. For example, if base_url is set to /career-paths/penetration-tester, it will fetch data from /career-paths/penetration-tester/data.json and the search index from /career-paths/penetration-tester/data-index.json.

Sources: src/components/astro/database/reactive-datatable.tsx:23-26, src/components/astro/database/reactive-datatable.tsx:160-163

Career Path Column

The ColCertificationPath React component is used within the data table to render the list of career paths associated with each certification. It receives the career_paths array and displays each path as a list item.

// src/components/astro/database/records-table/col-certification-path.tsx:6-14
export const ColCertificationPath: FC<Pick<CertificationMetadata, "career_paths">> = ({ career_paths }) => {
    return (
        <div className="text-xs leading-5 text-gray-500">
            <ul>
                {
                    career_paths.map((path) => (
                        <li key={path}>{ path }</li> // key added for clarity
                    ))
                }
            </ul>
        </div>
    );
};

Sources: src/components/astro/database/records-table/col-certification-path.tsx

Summary

The Career Paths feature is a key navigational tool in the CyberPath application. It leverages Astro's static site generation and content collections to create a robust and performant system. By defining a clear data model for career roles, integrating it with the certification content schema, and serving filtered data through dedicated API endpoints, the feature allows users to efficiently discover certifications tailored to their professional goals. The use of pre-computed search indexes for each path further enhances the user experience by enabling fast, client-side searching within filtered datasets.