Skip to content

Latest commit

 

History

History
93 lines (66 loc) · 4.5 KB

File metadata and controls

93 lines (66 loc) · 4.5 KB

Terrier App User Guide

Welcome to the guide for the Terrier hackathon platform. This document traces the features and workflows available to different users of the app.


1. 🛠 For Hackers (Participants)

As a hacker, the app is your central hub for the entire event.

Registration & Dashboard

  • Apply: Upon logging in, navigate to the Dashboard or Apply page to complete your application. You can save your progress and return later.
  • Status Status: Your dashboard will show your current status (e.g., Pending, Accepted, Waitlisted).
  • Confirmation: Once accepted, you must confirm your attendance to secure your spot.

Team Formation

  • Create a Team: Go to the Team tab to create a new team. You'll get a unique join code.
  • Join a Team: If your teammates have already created a team, ask for their join code and enter it on the Team page.
  • Manage Members: You can view your teammates. Note that for many events, you must be in a team to submit a project.

Schedule

  • Timeline: The Schedule page shows all events, workshops, and deadlines.
  • Details: Click on any event to see location (e.g., room numbers) and descriptions.
  • Filtering: You can filter events by type (e.g., Food, Workshops, Talks).

Project Submission

  • Devpost/GitHub: When hacking is complete, go to the Submission page.
  • Details: You will likely need to provide your project name, a description, and links to your code (GitHub) and demo (video/Devpost).
  • Deadline: Ensure you submit before the hacking deadline shown on the dashboard!

2. ⚖️ For Judges

Your role is to evaluate projects based on specific criteria.

Dashboard & Assignments

  • Assignments: On the Judge Dashboard, you will see a list of projects or tables assigned to you.
  • Status: You can see which projects you have already scored and which are pending.

Judging a Project

  1. Find the Team: Use the table number or location provided in your assignment.
  2. Listen to Pitch: Watch the demo and ask questions.
  3. Open Evaluation: Click on the project in your dashboard to open the judging form.

Scoring

  • Rubric: You will rate the project on various criteria (e.g., Technical Difficulty, Creativity, Polish).
  • Scale: Use the sliders or input fields to assign points.
  • Submit: Once submitted, you can move to the next assignment. You can edit scores until the judging period closes.

3. 📋 For Organizers

Organizers manage the flow of the event on the ground.

Check-in & Scanning

  • QR Scanning: Use the Scan feature to scan participant QR codes at the registration desk.
  • Status Check: Scanning a code instantly pulls up the participant's profile, showing if they are accepted and confirmed.
  • Check-in Action: One tap determines if they are "Checked In" and ready to receive swag/badges.

Schedule Management

  • Edit Events: You have permission to edit the schedule in real-time.
  • Updates: If a room changes or a workshop is delayed, update the event details. These changes push to all users immediately.
  • Create Events: You can add ad-hoc events (e.g., "Midnight Pizza") as needed.

People & Prizes

  • Participant List: Access the People directory to find specific hackers, check their table assignments, or contact info.
  • Prize Tracks: Configure specific prize categories (e.g., "Best UI", "Best Hardware") that hackers can opt-in to.

4. ⚙️ For Admins

Admins have full control over the hackathon instance configuration.

Hackathon Configuration

  • Settings: Configure global variables like the Hackathon Name, Slug (URL), Dates, and Branding (logos, colors).
  • Features: Toggle specific features on/off (e.g., if "Teams" or "Judging" are not needed yet).

Application Management (Admissions)

  • Review: The Applicants page allows you to review incoming applications.
  • Decisions: Bulk or individually mark users as Accepted, Waitlisted, or Rejected.
  • Stats: View acceptance rates and demographics.

Role Management

  • Permissions: You can promote users to Organizers or Judges.
  • Access Control: Ensure only the right people have access to sensitive organizer tools.

Judging Setup

  • Configuration: Before judging starts, use Judging Admin to set up the algorithm (e.g., how many judges see each project).
  • Table Assignment: Assign table numbers to teams automatically or manually.
  • Export: Export results and winner data after the event.