job-pro 0.7.0 → 0.7.2

package/dist/vivo.js

@@ -1,70 +1,320 @@
-// vivo — stub adapter for `job-pro`.
-//
-// STATUS: stub-only. vivo's careers portal at hr.vivo.com is a Vite SPA
-// hosted on the company's internal BPM platform (it-static.vivo.xyz). The
-// job-list endpoints under /wt/vivo/web/* exist but reject every unauthenticated
-// POST with HTTP 405 (Method Not Allowed at the nginx layer), and GETs return
-// the SPA shell instead of JSON. The platform requires browser-issued
-// vmonitor / vui-tracking tokens to be added by the bundle before the API
-// gateway will route the request.
+// vivo careers adapter for `job-pro`.
 //
 // ============================================================
-// RECONNAISSANCE RESULTS (probed 2026-05):
+// API DISCOVERY (probed 2026-05-15)
+//
+// hr.vivo.com is vivo's *internal* BPM portal SPA and serves an all-paths-match
+// catchall that returns its own HTML for every URL. The actual public careers
+// site is a Beisen (北森) recruitment-portal tenant hosted at
+// https://vivo.zhiye.com/ (tenant id 612022).
+//
+// The Beisen 2022 portal exposes a single paginated POST endpoint that backs
+// every job-listing widget (社招 / 校招 / 全部职位 / 实习生):
+//
+//   POST /api/Jobad/GetJobAdPageList
 //
-//   https://hr.vivo.com/                       — Vite SPA, /assets/index.*.js
-//   POST https://hr.vivo.com/wt/vivo/web/queryJobsList — HTTP 405 (nginx)
-//   POST https://hr.vivo.com/wt/vivo/web/list         — HTTP 405 (nginx)
-//   GET  https://hr.vivo.com/wt/vivo/web/index?type=1 — returns SPA HTML
+// The endpoint is anonymous; the only required headers are a real browser
+// User-Agent, Content-Type=application/json, and a vivo.zhiye.com Referer.
+// `Category` filters by recruit type:
 //
-//   The page initializer pulls vmonitor.min.js and vui-tracking/index.js
-//   from it-static.vivo.xyz before any API call is made; these libraries
-//   are expected to inject runtime headers (suspected MD5-signed timestamp
-//   + UID) that the gateway validates.
+//   "1"  全部 / unspecified (default in widget config)
+//   "4"  员工社招  (social hire)
+//   "5"  员工校招  (campus hire)
+//   "2"  校园招聘 (templated campus)
+//   "3"  实习生
 //
-//   Feishu ATSX:
-//     vivo.jobs.feishu.cn — HTTP 400 (no portal configured)
+// Each position record exposes `Category` (Chinese label) and `CategoryId`.
 //
-//   Moka:
-//     app.mokahr.com/social-recruitment/vivo — 302 (slug not provisioned)
+// Endpoint inventory (anonymous POST, content-type application/json):
+//   POST /api/Jobad/GetJobAdPageList            → paginated job list
+//   POST /api/Jobad/GetJobAdSearchConditions    → filter taxonomy
+//   GET  /api/Jobad/GetSpecialJobAdList         → hot/special jobs
+//   GET  /api/Jobad/SearchAreasTreeConditions   → city tree
+//   GET  /api/Common/GetPortalAIRobot           → portal config
 //
-// Conclusion: no unauthenticated public job-list API is available. Visit
-// https://hr.vivo.com/ for the official portal.
+// ============================================================
 import { extractResumeSignals, scoreOverlap, checkResume } from "./tencent.js";
 export { checkResume };
-const SOURCE = "hr.vivo.com";
-const STUB_MESSAGE = "vivo: hr.vivo.com /wt/vivo/web/* endpoints reject anonymous requests with HTTP 405 (nginx). " +
-    "API gateway requires browser-runtime tokens injected by vmonitor + vui-tracking bundles. " +
-    "No unauthenticated public API available. Visit https://hr.vivo.com/ for the portal.";
-export async function searchPositions(_opts = {}) {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, query: {}, positions: [] };
+const SOURCE = "vivo.zhiye.com";
+const API_ROOT = "https://vivo.zhiye.com";
+const SITE_ROOT = "https://vivo.zhiye.com/jobs";
+const DETAIL_PAGE = (id) => `https://vivo.zhiye.com/jobs?jobAdId=${encodeURIComponent(id)}`;
+const DEFAULT_HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
+    Accept: "application/json",
+    "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+    Referer: SITE_ROOT,
+    Origin: API_ROOT,
+    "x-requested-with": "xmlhttprequest",
+    langtype: "zh_CN",
+};
+async function post(path, body) {
+    let response;
+    try {
+        response = await fetch(`${API_ROOT}${path}`, {
+            method: "POST",
+            headers: { ...DEFAULT_HEADERS, "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: `network error: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!response.ok) {
+        return { ok: false, message: `HTTP ${response.status}: ${response.statusText}` };
+    }
+    let payload;
+    try {
+        payload = (await response.json());
+    }
+    catch (err) {
+        return { ok: false, message: `bad JSON: ${err instanceof Error ? err.message : err}` };
+    }
+    return {
+        ok: payload.Code === 200,
+        data: payload.Data,
+        count: payload.Count ?? payload.Total,
+        message: payload.Message || (payload.Code === 200 ? "ok" : "upstream error"),
+    };
 }
-export async function fetchAllPositions(_opts = {}) {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, total: 0, fetched: 0, positions: [] };
+async function get(path) {
+    let response;
+    try {
+        response = await fetch(`${API_ROOT}${path}`, { method: "GET", headers: DEFAULT_HEADERS });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: `network error: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!response.ok) {
+        return { ok: false, message: `HTTP ${response.status}: ${response.statusText}` };
+    }
+    let payload;
+    try {
+        payload = (await response.json());
+    }
+    catch (err) {
+        return { ok: false, message: `bad JSON: ${err instanceof Error ? err.message : err}` };
+    }
+    return {
+        ok: payload.Code === 200,
+        data: payload.Data,
+        message: payload.Message || (payload.Code === 200 ? "ok" : "upstream error"),
+    };
+}
+function summarize(item) {
+    const id = String(item.JobAdId ?? item.Id ?? "");
+    const cities = Array.isArray(item.LocNames) ? item.LocNames.join(", ") : "";
+    return {
+        post_id: id,
+        title: (item.JobAdName ?? "").trim(),
+        project: (item.Org ?? "").trim(),
+        recruit_label: (item.Category ?? "").trim(),
+        bgs: "",
+        work_cities: cities,
+        apply_url: id ? DETAIL_PAGE(id) : SITE_ROOT,
+    };
 }
+function categoryFromRecruitType(t) {
+    switch (t) {
+        case "social":
+            return ["4"];
+        case "campus":
+            return ["5"];
+        case "intern":
+            return ["3"];
+        case "all":
+        default:
+            return undefined;
+    }
+}
+// ---------- searchPositions ----------
+export async function searchPositions(opts = {}) {
+    const pageSize = Math.max(1, Math.min(50, opts.pageSize ?? 20));
+    const page = Math.max(1, opts.page ?? 1);
+    // Beisen pageIndex is zero-based.
+    const body = {
+        PageIndex: page - 1,
+        PageSize: pageSize,
+        KeyWords: (opts.keyword ?? "").trim().slice(0, 60),
+        SpecialType: 0,
+        PortalId: "",
+        DisplayFields: ["Category", "Kind", "LocId", "Org", "HeadCount", "PostDate", "Salary"],
+    };
+    const category = categoryFromRecruitType(opts.recruitType);
+    if (category)
+        body.Category = category;
+    const r = await post("/api/Jobad/GetJobAdPageList", body);
+    if (!r.ok) {
+        return {
+            ok: false,
+            source: SOURCE,
+            message: r.message,
+            query: body,
+            positions: [],
+        };
+    }
+    const rows = r.data ?? [];
+    return {
+        ok: true,
+        source: SOURCE,
+        query: body,
+        page,
+        page_size: pageSize,
+        total: r.count ?? rows.length,
+        positions: rows.map(summarize),
+    };
+}
+// ---------- fetchAllPositions ----------
+export async function fetchAllPositions(opts = {}) {
+    const pageSize = Math.max(1, Math.min(50, opts.pageSize ?? 30));
+    const maxPages = Math.max(1, opts.maxPages ?? 20);
+    const bucket = [];
+    let total;
+    for (let page = 1; page <= maxPages; page++) {
+        const r = await searchPositions({
+            keyword: opts.keyword,
+            page,
+            pageSize,
+            recruitType: opts.recruitType,
+        });
+        if (!r.ok) {
+            return {
+                ok: false,
+                source: SOURCE,
+                message: r.message,
+                total: 0,
+                fetched: bucket.length,
+                positions: bucket,
+            };
+        }
+        if (total === undefined)
+            total = r.total;
+        if (!r.positions.length)
+            break;
+        bucket.push(...r.positions);
+        if (total !== undefined && bucket.length >= total)
+            break;
+    }
+    return {
+        ok: true,
+        source: SOURCE,
+        total: total ?? bucket.length,
+        fetched: bucket.length,
+        positions: bucket,
+    };
+}
+// ---------- fetchPositionDetail ----------
+//
+// Beisen returns the full duty/require text directly on the list endpoint
+// when DisplayFields is omitted or includes those keys. We therefore call
+// GetJobAdPageList with the exact JobAdId to recover a single record.
 export async function fetchPositionDetail(postId) {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, post_id: postId };
+    const id = (postId ?? "").trim();
+    if (!id)
+        return { ok: false, source: SOURCE, message: "post_id is required", post_id: id };
+    const r = await post("/api/Jobad/GetJobAdPageList", {
+        PageIndex: 0,
+        PageSize: 1,
+        KeyWords: "",
+        SpecialType: 0,
+        PortalId: "",
+        JobAdIds: [Number(id) || id],
+        DisplayFields: [
+            "Category",
+            "Kind",
+            "LocId",
+            "Org",
+            "HeadCount",
+            "PostDate",
+            "Salary",
+            "DetailAddress",
+        ],
+    });
+    if (!r.ok || !r.data || !r.data.length) {
+        return { ok: false, source: SOURCE, message: r.message || "no detail returned", post_id: id };
+    }
+    const raw = r.data[0];
+    return {
+        ok: true,
+        source: SOURCE,
+        post_id: String(raw.JobAdId ?? id),
+        title: raw.JobAdName ?? "",
+        project: raw.Org ?? "",
+        recruit_label: raw.Category ?? "",
+        description: (raw.Duty ?? "").trim(),
+        requirements: (raw.Require ?? "").trim(),
+        work_cities: Array.isArray(raw.LocNames) ? raw.LocNames.join(", ") : "",
+        salary: raw.Salary ?? "",
+        kind: raw.Kind ?? "",
+        head_count: raw.HeadCount,
+        post_date: raw.PostDate ?? "",
+        apply_url: DETAIL_PAGE(String(raw.JobAdId ?? id)),
+    };
 }
+// ---------- fetchDictionaries ----------
 export async function fetchDictionaries() {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE };
+    const [conditions, areas] = await Promise.all([
+        post("/api/Jobad/GetJobAdSearchConditions", { Category: [] }),
+        get("/api/Jobad/SearchAreasTreeConditions"),
+    ]);
+    return {
+        ok: conditions.ok || areas.ok,
+        source: SOURCE,
+        api_host: API_ROOT,
+        verified_at: new Date().toISOString(),
+        search_conditions: conditions.data ?? null,
+        areas_tree: areas.data ?? null,
+        category_map: { "4": "员工社招", "5": "员工校招", "2": "校园招聘", "3": "实习生" },
+    };
 }
+// ---------- notices ----------
+const NO_NOTICES = "vivo careers (Beisen tenant 612022) does not expose a public notices endpoint.";
 export async function listNotices() {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notices: [] };
+    return { ok: false, source: SOURCE, message: NO_NOTICES, notices: [] };
 }
 export async function getNotice(noticeId) {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notice_id: noticeId };
+    return { ok: false, source: SOURCE, message: NO_NOTICES, notice_id: noticeId };
 }
 export async function findNoticesByQuestion(question, _opts = {}) {
-    return { ok: false, source: SOURCE, question, message: STUB_MESSAGE, matches: [] };
+    return { ok: false, source: SOURCE, question, message: NO_NOTICES, matches: [] };
 }
-export async function matchResume(text, _opts = {}) {
+// ---------- matchResume ----------
+export async function matchResume(text, opts = {}) {
     const { terms, cities } = extractResumeSignals(text ?? "");
+    const topN = Math.max(1, opts.topN ?? 5);
+    const candidates = Math.max(topN, opts.candidates ?? 200);
+    const all = await fetchAllPositions({ pageSize: 30, maxPages: Math.ceil(candidates / 30) });
+    if (!all.ok) {
+        return {
+            ok: false,
+            source: SOURCE,
+            message: all.message,
+            extracted_terms: terms,
+            city_preferences: cities,
+            matches: [],
+        };
+    }
+    const scored = [];
+    for (const p of all.positions) {
+        const haystack = `${p.title} ${p.project} ${p.bgs} ${p.work_cities}`;
+        const score = scoreOverlap(haystack, terms, cities).score;
+        if (score > 0)
+            scored.push({ score, position: p });
+    }
+    scored.sort((a, b) => b.score - a.score);
     return {
-        ok: false,
+        ok: true,
         source: SOURCE,
         extracted_terms: terms,
         city_preferences: cities,
-        matches: [],
-        message: STUB_MESSAGE,
+        candidate_pool: all.positions.length,
+        matches: scored.slice(0, topN).map((s) => s.position),
     };
 }
 export { extractResumeSignals, scoreOverlap };