[feature][admin-v2] Applicant blacklist scan

[jasperjjhe]

Summary

This PR adds a client-side blacklist auto-scan flow to Evaluator. Applicants are matched against a global Firestore blacklist in real time, surfaced in a dedicated sidebar section, and disabled in the main applicant list without mutating applicant records.

Scope Implemented

• Added runtime blacklist matching by normalized email (toLowerCase().trim()).
• Added a new Blacklisted accordion section at the top of the applicant sidebar.
• Added disabled/greyed-out behavior for blacklisted applicants in the main list.
• Wired blacklist subscription into evaluator state so updates react to both applicant and blacklist changes.
• Added non-fatal error handling so blacklist read failures do not crash Evaluator.

Firestore Data Model

The implemented read path is:

• Hackathons/blacklist/entries
  • Hackthons/blacklist is a document path shape so we must add a sub-collection

Each entry document supports:

• email (required for matching)
• firstName
• lastName
• notes (optional)

Note: Since Firestore is schemaless, we cannot inherently enforce fixed columns or required fields. We could add Firestore security rules for this. It's usually done on app-side but since this is expected to be a manual thing within Firestore we can consider adding a security rule.

Behaviour Details

• Matching is exact after normalization and only uses email.
• No applicant documents are modified; blacklist state is derived at runtime.
• Blacklisted applicants:
  • appear in the Blacklisted sidebar section with count
  • are clickable there to focus the centre panel
  • remain visible but non-clickable in the main list
• Blacklist section defaults open when matches exist (including async load case).
• Blacklist accordion updates live if entries updated.
• Not sure what spec intended with displaying banned hackathons. Will follow up.
• Within entries the firstName and lastName are never used. Should this be intended?

Files Updated

• types.ts
• blacklist.ts
• blacklist-section.tsx
• applicant-entry.tsx
• applicant-list.tsx
• evaluator-provider.tsx
• accordion.tsx
• package.json
• pnpm-lock.yaml

Firestore Rules / Environment Changes

• Dev Firestore added document at Hackathons/blacklist then entries sub-collection; needs to be applied to Prod Firestore before rollout.
• Dev Firestore rules were updated to allow reads for:
  • /Hackathons/blacklist/entries/{entryId}
• This same rules update must be applied to Prod Firestore before rollout, or production Evaluator will fail to read blacklist entries with Missing or insufficient permissions.

Testing / Verification

• Confirmed blacklist entries load in real time after dev rules update.
• Confirmed matched applicants appear in Blacklisted section.
• Confirmed matched rows are disabled in main applicant list.
• Confirmed non-fatal behaviour when blacklist reads fail (warning logs, evaluator remains usable).

[jasperjjhe]

Checks seem to be failing benignly. Some naming normalization bug within the check itself.

[geoff-jiang]

It might be slightly confusing for others seeing just a greyed-out row. Could you add a 'blacklist' chip to these entries as well so its clear?

eg. next to Applicant X label

[geoff-jiang]

@jasperjjhe looks great overall - love the clean design 🐐. Could you try running the biome scripts locally again (lint, format) because I'm seeing a few unordered CSS class and import warnings.

To address your questions in the ticket:

1. Re: 'display banned hackathon' - the notion blacklist page also has a column for the hackathon that the incident occurred. No need to include it in the schema, apologies for the confusion.
2. Circumventing w diff email is not a problem we've run into (afaik). Might have to leave this one for the future, unless you also want to add a 'potential matches' section with exact first + last name matches. I think name matching is inherently difficult though due to nicknames, legal names, diff people w the same name etc.
3. Using the name from the applicant entry is fine.

Once this is merged, you can proceed with mirroring the dev firestore setup in prod. Please add the rule for admin-only reads and writes!

[github-actions]

Visit the preview URL for this PR (updated for commit 4a97ac5):

https://dev-nwplus-admin--pr114-29096700286-geppn7eo.web.app

_{(expires Mon, 20 Jul 2026 13:37:41 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: c290bf9e2fac0401389f751f415cce4267517b51}

[geoff-jiang]

@jasperjjhe thx for changing the branch - could you please add the small chip I requested in the above comment? It would be clearer for other users to know why they can't click on a blacklisted applicant in the normal list 🙏