Talent Community

Overview

Summary

Talent Community is a shared repository of candidate resumes available to all recruiters on Knoot, distinct from My Talent Pool (each company's private repository). Recruiters can search this pool via AI-powered natural language queries or structured advanced filters, review candidates through a preview card, and unlock full contact details and resumes using Points.

Scope

• Browsing and searching the shared candidate pool.
• Two search modes: AI Search (natural language) and Advanced Search (structured filters, including Screening).
• Viewing candidate detail pages and unlocking full profiles via Points.
• Does not cover point top-up/purchase flows, subscription/plan management, or the Screening scoring algorithm itself (see related Screening spec).

Target Users HR / recruiters with an available Points balance. Candidates do not have access to this feature.

:::note Screenshot placeholder Placeholder: Talent Community landing page :::

---

Key Benefits

• Proactive sourcing — recruiters can actively search for candidates instead of passively waiting for applications after posting a job.
• Faster candidate discovery — AI Search lets recruiters query in natural language instead of manually stepping through multiple filters.
• Reduced screening time — AI auto-generates an "About Candidate" summary (strengths, watch-outs, best-fit roles), cutting down the time spent reading raw resumes.
• Pay-per-unlock pricing — recruiters spend Points only on the candidates they actually want to view, rather than paying for a flat subscription to the entire database.

---

Step-by-Step Guide

A. Browse & Basic Search

1. Navigate to Radar → Talent Community.
2. Landing state: a "Recent Resumes on Knoot" carousel (newest candidate cards across the system) plus an empty search field.
3. Select a search mode:
   • AI Search — free-text input. When the field is empty, the system shows "Recent Searches" (past queries with result counts).
   • Advanced Search — opens the structured filter flow (see Section B).
4. Submit the search — the system returns a list of resume cards matching the query.
5. Click Details on any card to open the candidate detail page.

:::note Screenshot placeholder Placeholder: search bar with AI Search / Advanced Search toggle :::

B. Advanced Search / Screening (gated flow)

1. Select a Candidate Source: "From My Talent Pool" and/or "From Talent Community" — at least one must be enabled.
2. If running Screening, the system requires a minimum of 15 selected resumes before it can proceed.
3. Set the years of experience range using a dual-handle slider (0–20 years).
4. Select a Job Description to match against. If no JD has been published yet, the system blocks the action and redirects the user to Job Management to create one.

:::note Screenshot placeholder Placeholder: Advanced Search filter panel :::

C. Candidate Detail & Unlock

1. The detail page has three tabs: Basic Information / Details / Feedback.
2. Basic Information is publicly visible: name, job title, country, and an AI-generated "About Candidate" summary (strengths, limitations, best-fit roles).
3. Contact information and the original resume are blurred, with an "Unlock Now" call-to-action.
4. Clicking Unlock opens a confirmation modal — "Get this talent now" — showing the price in Points (e.g. 155 points) with a non-refundable warning.
5. Confirming the action deducts Points and unlocks full contact details and the original resume, along with a Download Knoot Overview button.

:::note Screenshot placeholder Placeholder: candidate detail page with blurred contact info :::

---

Components

#	Name	Description	Note	Data Type
1	Search field ("Find Talent…")	Free-text input for AI Search	Static placeholder text	String
2	AI Search (button)	Activates natural-language search mode	Shows a loading icon while processing	Enum toggle
3	Advanced Search (button)	Opens the structured filter flow		Enum toggle
4	Resume/Candidate Card	Thumbnail, name, job title, last-updated date, AI-generated highlights (bullets), Points price, "Details" button		Object
5	Pagination dots	Navigation for the "Recent Resumes" carousel		UI control
6	Recent Searches (list)	Past queries with result counts	Sample data currently shows 0 results across all entries — needs a data check	List<String, Int>
7	Candidate Source toggle	Enables/disables source: My Talent Pool / Talent Community	At least one must be enabled	Boolean × 2
8	Years of experience slider	Dual-handle range filter, 0–20 years		Range<Int, Int>
9	Select Job (search field)	Autocomplete to find a Job Description to match against		String
10	"+ New Job Description" (button)	Shortcut to create a JD when none are eligible	Redirects to Job Management	Action
11	Tabs: Basic Information / Details / Feedback	Navigation within the candidate detail page		Enum
12	"About Candidate"	AI-generated summary: strengths, limitations, best-fit roles	Hallucination risk — needs a review/moderation policy	Text (AI-generated)
13	Unlock Now CTA (blur overlay)	Masks contact info/original resume, prompts unlock		Component
14	Modal "Get this talent now"	Confirms purchase via Points, includes non-refundable warning	Cancel / Confirm	Modal
15	Download Knoot Overview (button)	Exports a candidate summary (output format TBD — PDF?)	Format needs confirmation	Action
16	Points balance indicator	Not present in current mockups — user needs to see their Points balance before clicking Unlock		Int

---

Edge Cases & Open Questions

P0 = blocks release · P1 = should resolve before release · P2 = can resolve post-launch

Search & Discovery

• P0 — Clicking AI Search / Advanced Search with an empty field: should this be blocked (disabled button), or should it run an empty search and return the full pool?
• P0 — Duplicate candidates across "My Talent Pool" and "Talent Community" (same person, two sources): how should dedup work — one card shown, or two?
• P1 — Logically contradictory queries (e.g. "20 years of experience, fresher"): what does AI Search return? Is there validation, or does it run unvalidated?
• P1 — A recruiter has already unlocked a candidate and searches again: does the card show an "already unlocked" state (free to view again), or does it charge Points a second time?

Points & Payments

• P0 — Insufficient Points when clicking Unlock: where does this get blocked, and is there a top-up flow available directly in the modal, or must the user exit first?
• P0 — Two recruiters from the same company, different accounts, both unlock the same candidate: is this billed per user or per company/workspace? If per user, this is a pricing design flaw (double-charging for the same data) and needs to be resolved before development.
• P1 — Do Points expire or roll over at the end of a subscription cycle?
• P1 — Mid-cycle plan downgrade: do previously purchased Points and unlocked candidates get locked again?

Screening / Advanced Search

• P0 — A Job Description used for screening is edited or deleted while the job is running: does the job use a cached snapshot, or does it fail?
• P1 — Both sources selected simultaneously (My Talent Pool + Talent Community): how are results merged and ranked? Which source takes priority?
• P1 — Screening jobs run asynchronously, but no progress/loading state currently appears in the mockups. Does this take seconds or minutes? If minutes, the spec is missing a status screen (queued / processing / done).

Data & Privacy (legal risk — should be resolved early)

• P0 — A candidate requests removal of their resume from Talent Community (per data protection regulations): do recruiters who already unlocked that profile lose access retroactively? If access cannot be revoked, the "non-refundable" policy conflicts with the candidate's right to data deletion.
• P1 — A resume's "last updated" date is very old (>1–2 years): is it flagged/deprioritized, or sold as if it were current?

Multi-Tenant / Permissions

• P1 — An admin revokes a recruiter's access while that recruiter has a candidate detail page open: is the session killed immediately, or does it persist until it naturally expires?
• P2 — Can recruiters within the same company see a colleague's search history / list of unlocked candidates (to avoid duplicate purchases — directly related to the P0 Points question above)?

---

Change Log

Version	Update Date	Details
v1.0	06/11/2025	Initial draft — no prior version history available. Team to backfill real changelog or start tracking from this version onward.