data.json

{
  "roadmap": [
    {
      "id": "step-1",
      "stepNumber": 1,
      "title": "Environment & CLI Setup",
      "summary": "Configure terminal shell, package managers, and core development runtimes.",
      "objective": "Establish a reproducible development workstation with standardized CLI tools, shell configurations, and runtime dependencies to eliminate 'works on my machine' errors.",
      "resources": [
        { "name": "POSIX Shell Configuration Standard", "url": "https://ou1ts.netlify.app/" },
        { "name": "Node.js & Python Version Managers Guide", "url": "#setup-guides" },
        { "name": "Terminal Customization Script", "url": "#vault-resources" }
      ]
    },
    {
      "id": "step-2",
      "stepNumber": 2,
      "title": "Git & Version Control Mastery",
      "summary": "Initialize SSH keys, configure identity, learn branch strategies, and sign commits.",
      "objective": "Master team collaboration workflows, clean commit messaging, rebase practices, and GPG authentication for security compliance.",
      "resources": [
        { "name": "SSH Key Generation & GitHub Auth", "url": "#setup-guides" },
        { "name": "UITS Git Branching Convention", "url": "https://ou1ts.netlify.app/" },
        { "name": "Interactive Rebase Cheatsheet", "url": "#vault-resources" }
      ]
    },
    {
      "id": "step-3",
      "stepNumber": 3,
      "title": "Project Scaffold & Tooling",
      "summary": "Set up linters, code formatters, build systems, and pre-commit automation.",
      "objective": "Automate code style enforcement, type checking, and local continuous integration hooks before pushing to remote repositories.",
      "resources": [
        { "name": "ESLint & Prettier Zero-Config Setup", "url": "#setup-guides" },
        { "name": "Husky Pre-commit Hook Template", "url": "#vault-resources" },
        { "name": "UITS Starter Templates", "url": "#vault-resources" }
      ]
    },
    {
      "id": "step-4",
      "stepNumber": 4,
      "title": "Peer Code Review & Open Source",
      "summary": "Submit pull requests, perform code audits, write documentation, and contribute.",
      "objective": "Participate in structured peer reviews, maintain standard issue templates, and publish reusable code to community repositories.",
      "resources": [
        { "name": "Code Review Checklist & Guidelines", "url": "#setup-guides" },
        { "name": "Pull Request Template Generator", "url": "#vault-resources" },
        { "name": "UITS Community Portal", "url": "https://ou1ts.netlify.app/" }
      ]
    }
  ],
  "guides": [
    {
      "id": "guide-cli-env",
      "title": "Universal Terminal & Shell Environment",
      "category": "CLI",
      "difficulty": "Beginner",
      "prerequisites": "Administrator access on Windows (WSL2), macOS, or Linux.",
      "steps": "Step 1: Install Zsh or Bash latest release.\nStep 2: Configure environment path variables in .zshrc or .bashrc.\nStep 3: Verify installation by running 'uname -a' and checking your shell version.\nStep 4: Clone community dotfiles configuration for standardized aliases."
    },
    {
      "id": "guide-git-ssh",
      "title": "Git Authentication & SSH Configuration",
      "category": "Git",
      "difficulty": "Beginner",
      "prerequisites": "Git installed on host OS; GitHub or GitLab account.",
      "steps": "Step 1: Generate ED25519 SSH keypair using 'ssh-keygen -t ed25519 -C student_id@uits'.\nStep 2: Start ssh-agent and add key via 'ssh-add ~/.ssh/id_ed25519'.\nStep 3: Copy public key to version control provider.\nStep 4: Test connection with 'ssh -T git@github.com'."
    },
    {
      "id": "guide-node-nvm",
      "title": "Node.js Runtime Management with NVM",
      "category": "OS & Tools",
      "difficulty": "Intermediate",
      "prerequisites": "Terminal access and curl/wget installed.",
      "steps": "Step 1: Run the NVM installation script.\nStep 2: Export NVM_DIR environment variables in your shell config.\nStep 3: Run 'nvm install --lts' to fetch current Long Term Support node binary.\nStep 4: Set default node version with 'nvm alias default lts/*'."
    },
    {
      "id": "guide-docker-dev",
      "title": "Isolated Dev Containers & Docker Engine",
      "category": "Scaffold",
      "difficulty": "Advanced",
      "prerequisites": "Virtualization enabled in BIOS; 8GB RAM minimum.",
      "steps": "Step 1: Install Docker Engine or Docker Desktop.\nStep 2: Configure non-root user group execution via 'sudo usermod -aG docker $USER'.\nStep 3: Create devcontainer.json configuration in target project root.\nStep 4: Validate container build with 'docker compose up -d'."
    },
    {
      "id": "guide-python-venv",
      "title": "Python Virtual Environments & Poetry",
      "category": "OS & Tools",
      "difficulty": "Intermediate",
      "prerequisites": "Python 3.10 or higher installed.",
      "steps": "Step 1: Install Poetry dependency manager via official installer script.\nStep 2: Initialize project using 'poetry init' inside working directory.\nStep 3: Configure in-project virtualenvs with 'poetry config virtualenvs.in-project true'.\nStep 4: Spawn active shell using 'poetry shell'."
    },
    {
      "id": "guide-vite-vanilla",
      "title": "Zero-Config Frontend Project Scaffold",
      "category": "Scaffold",
      "difficulty": "Beginner",
      "prerequisites": "Node.js 18+ and npm installed.",
      "steps": "Step 1: Execute 'npm create vite@latest build-app -- --template vanilla'.\nStep 2: Navigate into directory and run 'npm install'.\nStep 3: Configure strict lint rules in .eslintrc.json.\nStep 4: Launch local hot-reload dev server with 'npm run dev'."
    }
  ],
  "resources": [
    {
      "id": "res-script-bootstrap",
      "title": "Dev Workstation Auto-Bootstrap Script",
      "category": "Scripts",
      "description": "Automated shell script that sets up Git, Node.js, Python, and base tools on clean installations.",
      "tags": ["CLI", "Bash", "Automation"],
      "author": "UITS Maintainers",
      "url": "https://ou1ts.netlify.app/"
    },
    {
      "id": "res-template-vanilla-spa",
      "title": "Vanilla JS SPA Production Starter",
      "category": "Templates",
      "description": "Clean modular Single Page Application skeleton featuring hash routing, theme switching, and state containers.",
      "tags": ["Vanilla JS", "HTML5", "CSS3"],
      "author": "Dev Lab Core",
      "url": "https://ou1ts.netlify.app/"
    },
    {
      "id": "res-doc-git-rules",
      "title": "Git Commit & Branch Standard Guidelines",
      "category": "Docs",
      "description": "Document detailing semantic commit conventions, issue referencing, and pull request review protocol.",
      "tags": ["Git", "Standards", "Workflow"],
      "author": "UITS Quality Team",
      "url": "https://ou1ts.netlify.app/"
    },
    {
      "id": "res-tool-linter-config",
      "title": "Unified Code Formatter & Linter Configs",
      "category": "Tools",
      "description": "Pre-configured rulesets for ESLint, Prettier, Stylelint, and Markdownlint ready to paste into projects.",
      "tags": ["Tooling", "Linting", "Format"],
      "author": "Dev Lab Core",
      "url": "https://ou1ts.netlify.app/"
    },
    {
      "id": "res-script-git-clean",
      "title": "Local Git Repository Housekeeping Script",
      "category": "Scripts",
      "description": "CLI utility to prune merged local branches, purge dangling commits, and clear build cache.",
      "tags": ["Git", "Utility", "CLI"],
      "author": "Maintainer Team",
      "url": "https://ou1ts.netlify.app/"
    },
    {
      "id": "res-template-rest-api",
      "title": "Lightweight Node REST API Blueprint",
      "category": "Templates",
      "description": "Framework-free Node.js HTTP server boilerplate with structured routing and JSON validation.",
      "tags": ["Node.js", "Backend", "REST"],
      "author": "UITS Dev Group",
      "url": "https://ou1ts.netlify.app/"
    }
  ],
  "leaderboard": [
    {
      "id": "1",
      "name": "Tanvir Hossain",
      "username": "tanvir-dev",
      "score": 1420,
      "streakDays": 45,
      "role": "Full Stack Engineer",
      "techStack": ["React", "Node.js", "PostgreSQL", "TypeScript"],
      "githubUrl": "https://github.com/tanvir-dev"
    },
    {
      "id": "2",
      "name": "Nusrat Jahan",
      "username": "nusrat-codes",
      "score": 1280,
      "streakDays": 38,
      "role": "Frontend Developer",
      "techStack": ["Vue.js", "JavaScript", "TailwindCSS", "REST API"],
      "githubUrl": "https://github.com/nusrat-codes"
    },
    {
      "id": "3",
      "name": "Abrar Fahim",
      "username": "abrar-systems",
      "score": 1150,
      "streakDays": 30,
      "role": "Backend Engineer",
      "techStack": ["Go", "Docker", "Redis", "gRPC"],
      "githubUrl": "https://github.com/abrar-systems"
    },
    {
      "id": "4",
      "name": "Sadia Islam",
      "username": "sadia-ui",
      "score": 995,
      "streakDays": 24,
      "role": "UI/UX & Frontend",
      "techStack": ["CSS3", "JavaScript", "Figma", "HTML5"],
      "githubUrl": "https://github.com/sadia-ui"
    },
    {
      "id": "5",
      "name": "Mahmudul Hasan",
      "username": "mahmud-dev",
      "score": 870,
      "streakDays": 19,
      "role": "Software Engineer",
      "techStack": ["Python", "Django", "PostgreSQL", "Docker"],
      "githubUrl": "https://github.com/mahmud-dev"
    },
    {
      "id": "6",
      "name": "Fariha Chowdhury",
      "username": "fariha-tech",
      "score": 760,
      "streakDays": 14,
      "role": "DevOps & Cloud",
      "techStack": ["Linux", "Bash", "AWS", "Terraform"],
      "githubUrl": "https://github.com/fariha-tech"
    }
  ]
}