feat: 查标第 1 步——上传投标分册 → 检查 → 逐条处理 → 复查沿用

后端
- check 模块:检查预览、发起、进度、取消、记录;六个阶段(准备投标文件、响应匹配、规则、证据校验、
  状态沿用、汇总);问题列表、处理、撤销、批量处理(只限提示级)。
- 每条清单项的检查结论 check_item_result(C9,迁移 0005):「已响应」也带投标原文出处;
  没有校验通过的证据不能判已响应(C3)。级别从清单项算,不让模型定;说明不写整改建议。
- 响应匹配先只有第三层:内存 BM25 检索候选句 + check.match v1 提示词,检索不到不调模型,
  漏答记 missing_answer,模型临时错误只影响那一批。
- 计费:免费版不记流水;专业版 24 小时内复查免扣(记一行 0);expected_charge 不一致时拒绝不扣点;
  失败、取消退回;投标文件读不出文字按输入问题失败、不扣点。
- 投标分册:类型(volume_kind)和版本;电子投标平台加密格式在上传时拦下。
- 解析流水线前几个阶段拆到 document/pipeline/normalize.py,解析和检查共用。
- ops 模块:反馈接口;致命问题确认无误的说明自动进误报反馈(U4)。
- SK1:Valkey 客户端短超时、SSE 连接池上限。SK2:CI 加 Gotenberg、直接跑 init-roles.sh。

前端
- 上传投标文件并检查页、查标页(进度、覆盖范围、按级别筛选、逐条处理和行内说明、撤销、原文抽屉、
  已处理、本次已解决);项目头抽成公共组件,加「查标」标签页;工作台「下一步」覆盖查标阶段。

契约、文档:openapi.yaml 加 item-results、volume_kind、coverage 字段;data-model、api-design §10、
架构 §8 / §13(SK14)、AGENTS.md 同步。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
YANG JIANKUAN
2026-11-04 11:48:10 +08:00
parent 6ab42959df
commit e499de7486
56 changed files with 3735 additions and 183 deletions

View File

@@ -0,0 +1,55 @@
<script setup lang="ts">
/**
* 项目头(原型的 projHead):项目名、采购人等、投标截止、状态和就绪;下面是「读标 / 查标」标签页。
* 就绪只在「已检查」时显示(G7),只表示致命问题都已处理,不代表投标文件没有问题(READY_TIP)。
* 概览、报告页做到时在这里加标签页。
*/
import { computed } from "vue";
import { RouterLink } from "vue-router";
import { deadline, legalRegime, projectStatus, READY_TIP } from "@/lib/labels";
import type { ProjectDetail } from "@/lib/queries";
const props = defineProps<{ project?: ProjectDetail; tab: "checklist" | "check" }>();
const p = computed(() => props.project);
const meta = computed(() =>
p.value ? [p.value.purchaser, p.value.legal_regime !== "unknown" ? legalRegime(p.value.legal_regime) : "", p.value.procurement_method, p.value.code].filter(Boolean).join(" · ") : "",
);
const due = computed(() => deadline(p.value?.deadline_at));
const checkTo = computed(() =>
p.value?.latest_check_run_id
? { name: "results", params: { projectId: p.value.id, runId: p.value.latest_check_run_id } }
: { name: "bid-check", params: { projectId: p.value?.id ?? "" } },
);
</script>
<template>
<header class="ph">
<div class="ph-l1">
<div>
<h1 :title="p?.name">{{ p?.name ?? " " }}</h1>
<p class="ph-meta">{{ meta || "招标文件信息待解析" }}</p>
</div>
<dl v-if="p" class="facts">
<div>
<dt>投标截止</dt>
<dd>
<template v-if="due"><span class="fig m">{{ due.sub }}</span><span :class="due.cls || 'muted'">{{ due.main }}</span></template>
<span v-else class="muted">—</span>
</dd>
</div>
<div><dt>状态</dt><dd><span class="tag">{{ projectStatus(p.status) }}</span></dd></div>
<div v-if="p.readiness.ready !== null && p.readiness.ready !== undefined">
<dt>就绪</dt>
<dd>
<span v-if="p.readiness.ready" class="tip-below" :data-tip="READY_TIP" tabindex="0">致命问题已处理</span>
<span v-else class="sev fatal">致命<span class="fig">{{ p.readiness.open_fatal_count }}</span></span>
</dd>
</div>
</dl>
</div>
<nav class="tabs" aria-label="项目">
<RouterLink v-if="p" role="tab" :aria-selected="tab === 'checklist'" :to="{ name: 'checklist', params: { projectId: p.id } }">读标</RouterLink>
<RouterLink v-if="p" role="tab" :aria-selected="tab === 'check'" :to="checkTo">查标</RouterLink>
</nav>
</header>
</template>

View File

@@ -16,11 +16,14 @@ const due = computed(() => deadline(p.value.deadline_at));
const sub = computed(() => [p.value.purchaser, p.value.code].filter(Boolean).join(" · "));
const job = computed(() => p.value.active_job ?? null);
/** 项目的默认入口:解析中去进度页;还没上传招标文件去上传;其余去清单(骨架阶段唯一的项目内页面) */
/** 项目的默认入口:解析中去进度页;还没上传招标文件去上传;要检查去上传投标文件;检查过去查标;其余去清单 */
const home = computed<RouteLocationRaw>(() => {
const id = p.value.id;
if (job.value?.kind === "parse_job") return { name: "parse", params: { projectId: id, jobId: job.value.id } };
if (p.value.next_action === "upload_tender") return { name: "project-new", query: { project: id } };
if (p.value.next_action === "upload_bid" || p.value.next_action === "run_check") return { name: "bid-check", params: { projectId: id } };
if (p.value.latest_check_run_id && (p.value.next_action === "handle_fatal" || p.value.next_action === "export_report"))
return { name: "results", params: { projectId: id, runId: p.value.latest_check_run_id } };
return { name: "checklist", params: { projectId: id } };
});
/** 「下一步」:骨架阶段只有上传、解析进度、清单三个去处,其余动作先落到清单页 */

View File

@@ -7,7 +7,7 @@ import { subscribeEvents, type BdEvent } from "@bid-doctor/api-client";
import type { QueryClient } from "@tanstack/vue-query";
import { apiOptions } from "./api";
import { qk } from "./keys";
import { TERMINAL_JOB, type ParseJob, type ProjectListItem } from "./queries";
import { TERMINAL_JOB, type CheckRun, type ParseJob, type ProjectListItem } from "./queries";
type ProjectPage = { items: ProjectListItem[]; next_cursor: string | null };
@@ -47,6 +47,25 @@ function onEvent(qc: QueryClient, e: BdEvent) {
}
return;
}
if ((e.type === "job.progress" || e.type === "job.finished") && job && jobId && job.kind === "check_run") {
qc.setQueryData<CheckRun>(qk.checkRun(jobId), (old) =>
!old || TERMINAL_JOB.has(old.status) || (job.progress ?? 0) < old.progress
? old
: { ...old, status: job.status ?? old.status, stage: (job.stage as CheckRun["stage"]) ?? old.stage, progress: job.progress ?? old.progress },
);
if (e.type === "job.finished") {
void qc.invalidateQueries({ queryKey: qk.checkRun(jobId) });
void qc.invalidateQueries({ queryKey: qk.findings(jobId) });
void qc.invalidateQueries({ queryKey: qk.projects });
void qc.invalidateQueries({ queryKey: qk.quota });
if (e.project_id) {
void qc.invalidateQueries({ queryKey: qk.project(e.project_id) });
void qc.invalidateQueries({ queryKey: qk.checkPreview(e.project_id) });
void qc.invalidateQueries({ queryKey: qk.checkRuns(e.project_id) });
}
}
return;
}
switch (e.type) {
case "quota.changed":
void qc.invalidateQueries({ queryKey: qk.quota });

View File

@@ -9,4 +9,10 @@ export const qk = {
parseJob: (id: string) => ["parse-job", id] as const,
checklist: (projectId: string) => ["checklist", projectId] as const,
checklistItems: (projectId: string) => ["checklist-items", projectId] as const,
projectDocuments: (projectId: string) => ["project-documents", projectId] as const,
checkPreview: (projectId: string) => ["check-preview", projectId] as const,
checkRuns: (projectId: string) => ["check-runs", projectId] as const,
checkRun: (id: string) => ["check-run", id] as const,
findings: (runId: string) => ["findings", runId] as const,
itemResults: (runId: string) => ["item-results", runId] as const,
};

View File

@@ -155,6 +155,36 @@ export const PARSE_STEPS: readonly { label: string; stages: readonly string[] }[
export const parseStepIndex = (stage: string | null | undefined) =>
stage ? PARSE_STEPS.findIndex((s) => s.stages.includes(stage)) : -1;
/** 检查阶段:服务端的 6 个 stage 合成界面上的 4 步 */
export const CHECK_STEPS: readonly { label: string; stages: readonly string[] }[] = [
{ label: "读取投标文件", stages: ["prepare_bid"] },
{ label: "逐条找响应", stages: ["match"] },
{ label: "核对出处", stages: ["rules", "verify"] },
{ label: "沿用处理状态、汇总", stages: ["carry_over", "summarize"] },
];
export const checkStepIndex = (stage: string | null | undefined) =>
stage ? CHECK_STEPS.findIndex((s) => s.stages.includes(stage)) : -1;
export const VOLUME_KIND: Dict<Schemas["VolumeKind"]> = {
whole: "整本",
qualification: "资格证明",
commercial: "商务",
technical: "技术",
price: "报价",
other: "其他",
};
export const VOLUME_KINDS = Object.keys(VOLUME_KIND) as Schemas["VolumeKind"][];
/** 级别(§7.5):样式类沿用设计规范的 fatal / major / hint */
export const SEVERITY: Dict<Schemas["Severity"]> = { fatal: "致命", important: "重要", hint: "提示" };
export const SEVERITY_CLASS: Dict<Schemas["Severity"]> = { fatal: "fatal", important: "major", hint: "hint" };
export const FINDING_ACTION: Dict<Schemas["FindingStatus"]> = {
pending: "待处理",
confirmed_ok: "确认无误",
modified: "已修改",
ignored: "已忽略",
};
export const READY_TIP = "只表示致命问题都已处理,不代表投标文件没有问题。";
/* ---------- 时间 ---------- */

View File

@@ -21,6 +21,10 @@ export type ChecklistItem = Schemas["ChecklistItem"] & Required<Pick<Schemas["Ch
export type Citation = Schemas["Citation"];
export type MarkingRule = Schemas["MarkingRule"];
export type SessionInfo = Schemas["SessionInfo"];
export type CheckPreview = Schemas["CheckPreview"];
export type CheckRun = Schemas["CheckRun"];
export type Finding = Schemas["Finding"];
export type CheckItemResult = Schemas["CheckItemResult"];
export const fetchMe = () => unwrap(api.GET("/me"));
@@ -90,3 +94,41 @@ export function useChecklistItems(projectId: MaybeRefOrGetter<string>) {
}>,
});
}
export function useProjectDocuments(projectId: MaybeRefOrGetter<string>) {
return useQuery({
queryKey: computed(() => qk.projectDocuments(toValue(projectId))),
queryFn: () => unwrap(api.GET("/projects/{project_id}/documents", { params: { path: { project_id: toValue(projectId) } } })),
});
}
export function useCheckPreview(projectId: MaybeRefOrGetter<string>) {
return useQuery({
queryKey: computed(() => qk.checkPreview(toValue(projectId))),
queryFn: () => unwrap(api.GET("/projects/{project_id}/check-preview", { params: { path: { project_id: toValue(projectId) } } })),
});
}
export function useCheckRuns(projectId: MaybeRefOrGetter<string>) {
return useQuery({
queryKey: computed(() => qk.checkRuns(toValue(projectId))),
queryFn: () => unwrap(api.GET("/projects/{project_id}/check-runs", { params: { path: { project_id: toValue(projectId) } } })),
});
}
/** 检查进度:和解析一样,事件流推送为主、每 5 秒轮询兜底,结束后停止轮询。 */
export function useCheckRun(id: MaybeRefOrGetter<string>) {
return useQuery({
queryKey: computed(() => qk.checkRun(toValue(id))),
queryFn: () => unwrap(api.GET("/check-runs/{run_id}", { params: { path: { run_id: toValue(id) } } })),
refetchInterval: (query) => (query.state.data && TERMINAL_JOB.has(query.state.data.status) ? false : 5000),
});
}
export function useFindings(runId: MaybeRefOrGetter<string>, enabled: MaybeRefOrGetter<boolean>) {
return useQuery({
queryKey: computed(() => qk.findings(toValue(runId))),
queryFn: () => unwrap(api.GET("/check-runs/{run_id}/findings", { params: { path: { run_id: toValue(runId) } } })),
enabled: computed(() => toValue(enabled)),
});
}

View File

@@ -0,0 +1,295 @@
<script setup lang="ts">
/**
* 上传投标文件并检查(原型 bid-check.html,FR-M3-01、02)。
* - 按分册上传;同一分册重新上传是新版本,检查默认用每个分册的最新版本;
* - 「检查范围」如实写会查什么、不查什么,报告首页照此写明(红线 3);
* - 扣点说明写在按钮旁边(红线 9),来自 check-preview;发起时带 expected_charge,和服务端算的不一致时不扣点(API4)。
*/
import { ApiError, unwrap, uploadFile, type Schemas } from "@bid-doctor/api-client";
import { Info, Upload } from "@lucide/vue";
import { useQueryClient } from "@tanstack/vue-query";
import { computed, ref } from "vue";
import { RouterLink, useRouter } from "vue-router";
import ProjectHead from "@/components/ProjectHead.vue";
import { api, apiOptions, errorTitle, isApiError } from "@/lib/api";
import { useCrumbs } from "@/lib/crumbs";
import { qk } from "@/lib/keys";
import { fmtDateTime, fmtSize, VOLUME_KIND, VOLUME_KINDS } from "@/lib/labels";
import { useCheckPreview, useProject, useQuotaAccount, type DocumentInfo } from "@/lib/queries";
import { platform } from "@/platform";
const props = defineProps<{ projectId: string }>();
const ACCEPT = [".pdf", ".docx", ".doc", ".wps"];
const router = useRouter();
const qc = useQueryClient();
const project = useProject(() => props.projectId);
const previewQ = useCheckPreview(() => props.projectId);
const parse = useQuotaAccount("parse");
const p = computed(() => project.data.value);
const pv = computed(() => previewQ.data.value);
useCrumbs(() => [{ label: "工作台", to: { name: "workbench" } }, { label: p.value?.name ?? "项目" }, { label: "上传投标文件并检查" }]);
const vols = computed<DocumentInfo[]>(() => pv.value?.bid_documents ?? []);
/* ---------- 上传 ---------- */
const kind = ref<Schemas["VolumeKind"]>("whole");
const volName = ref("");
const replacing = ref<DocumentInfo | null>(null);
const uploading = ref<{ name: string; ratio: number } | null>(null);
const upErr = ref("");
const over = ref(false);
async function upload(file: File) {
upErr.value = "";
uploading.value = { name: file.name, ratio: 0 };
try {
const done = await uploadFile(api, apiOptions, file, "project_document", (ratio) => {
uploading.value = { name: file.name, ratio };
});
const target = replacing.value;
await unwrap(
api.POST("/projects/{project_id}/documents", {
params: { path: { project_id: props.projectId } },
body: target
? { upload_id: done.id, role: "bid_volume", replaces_document_id: target.id }
: { upload_id: done.id, role: "bid_volume", volume_kind: kind.value, ...(volName.value.trim() ? { volume_name: volName.value.trim() } : {}) },
}),
);
volName.value = "";
replacing.value = null;
await qc.invalidateQueries({ queryKey: qk.checkPreview(props.projectId) });
void qc.invalidateQueries({ queryKey: qk.projects });
} catch (e) {
// 格式不支持、加密、电子投标平台加密格式:在上传完成时就拦下,不扣点
const detail = e instanceof ApiError && e.problem.detail ? `(${e.problem.detail})` : "";
upErr.value = `${file.name}:${errorTitle(e)}${detail}`;
} finally {
uploading.value = null;
}
}
async function pick(target: DocumentInfo | null = null) {
if (uploading.value) return;
replacing.value = target;
const f = await platform.pickFile({ accept: ACCEPT });
if (f) void upload(f);
else replacing.value = null;
}
function onDrop(e: DragEvent) {
over.value = false;
const f = e.dataTransfer?.files[0];
if (f && !uploading.value) void upload(f);
}
/* ---------- 发起检查 ---------- */
const busy = ref(false);
const startErr = ref("");
const blockerText: Record<string, string> = {
no_parsed_tender: "还没有解析成功的招标文件",
checklist_empty: "正式清单还没有条目",
no_bid_documents: "先上传投标文件",
job_already_running: "这个项目正在检查",
quota_exhausted: "解析额度已用完",
project_read_only: "项目已递交或已归档",
};
const blockers = computed(() => (pv.value?.blockers ?? []).map((b) => blockerText[b] ?? b));
async function start() {
if (!pv.value?.can_start) return;
busy.value = true;
startErr.value = "";
try {
const run = await unwrap(
api.POST("/projects/{project_id}/check-runs", {
params: { path: { project_id: props.projectId } },
body: { document_ids: vols.value.map((d) => d.id), expected_charge: pv.value.charge },
}),
);
void qc.invalidateQueries({ queryKey: qk.quota });
void qc.invalidateQueries({ queryKey: qk.projects });
await router.push({ name: "results", params: { projectId: props.projectId, runId: run.id } });
} catch (e) {
const running = isApiError(e, "job_already_running") ? e.problem.job_id : undefined;
if (typeof running === "string") {
await router.push({ name: "results", params: { projectId: props.projectId, runId: running } });
return;
}
if (isApiError(e, "billing_changed")) {
startErr.value = "扣点情况有变化(例如 24 小时免扣窗口刚好过了),已刷新说明,确认后再点一次。本次没有扣点。";
void qc.invalidateQueries({ queryKey: qk.checkPreview(props.projectId) });
} else {
startErr.value = `${errorTitle(e)}。本次没有扣点。`;
}
} finally {
busy.value = false;
}
}
</script>
<template>
<ProjectHead :project="p" tab="check" />
<div class="content narrow">
<div class="page-title">
<div>
<h1>上传投标文件并检查</h1>
<p>只读加密前的 Word / PDF 稿。每次上传都是新版本,检查结果对应到具体版本。</p>
</div>
</div>
<div v-if="pv && !pv.checklist_confirmed" class="alert" role="note">
<Info class="ic lg" :stroke-width="1.5" />
<p>清单还没确认(或确认后又改过)。这次检查以当前清单为准<template v-if="pv.pending_item_count">;待确认区的 <span class="fig">{{ pv.pending_item_count }}</span> 条不参与检查</template>。</p>
<RouterLink class="btn sm" :to="{ name: 'checklist', params: { projectId } }">去确认清单</RouterLink>
</div>
<form class="card flush" novalidate aria-labelledby="h-form" @submit.prevent="start">
<div class="card-h"><h2 id="h-form">投标文件分册</h2></div>
<div class="card-b form-b">
<div v-for="v in vols" :key="v.id" class="file-row">
<span class="ext">{{ v.detected_format.toUpperCase() }}</span>
<div>
<span class="name"><b>{{ v.label }}</b></span>
<span class="meta">{{ v.original_filename }}<template v-if="v.page_count"> · <span class="fig xs">{{ v.page_count }}</span> 页</template> · {{ fmtSize(v.size_bytes) }} · {{ fmtDateTime(v.created_at) }}</span>
</div>
<span class="acts"><button type="button" class="btn sm" :disabled="!!uploading" @click="pick(v)">上传新版本</button></span>
</div>
<div class="new-vol">
<div class="field">
<label for="vk">分册类型</label>
<select id="vk" v-model="kind" class="input" :disabled="!!uploading">
<option v-for="k in VOLUME_KINDS" :key="k" :value="k">{{ VOLUME_KIND[k] }}</option>
</select>
</div>
<div class="field">
<label for="vn">分册名称 <small>(选填)</small></label>
<input id="vn" v-model="volName" class="input" maxlength="40" placeholder="例如:技术册" autocomplete="off" :disabled="!!uploading" />
</div>
</div>
<div
class="drop"
:class="{ 'is-over': over }"
tabindex="0"
role="button"
aria-describedby="drop-sub"
@click="pick()"
@keydown.enter.prevent="pick()"
@keydown.space.prevent="pick()"
@dragenter.prevent="over = true"
@dragover.prevent="over = true"
@dragleave.prevent="over = false"
@drop.prevent="onDrop"
>
<Upload class="ic lg" :stroke-width="1.5" />
<b>{{ uploading ? `正在上传 ${uploading.name}(${Math.round(uploading.ratio * 100)}%)` : "拖入或点击上传分册" }}</b>
<span id="drop-sub">Word / PDF;电子投标客户端加密后的文件读不了,请上传加密前的稿子</span>
</div>
<p v-if="upErr" class="hint-warn" role="alert"><span class="ico w" aria-hidden="true">!</span><span>{{ upErr }}</span></p>
<fieldset class="form-sec scope">
<legend>检查范围<small>报告首页会照此写明</small></legend>
<div>
<h3>会查</h3>
<ul>
<li>正式清单每一条在投标文件里有没有响应:未找到响应、负偏离未说明、疑似不满足</li>
<li>每条结论都带投标文件的原文出处;出处核对不上的,不算「已响应」</li>
</ul>
</div>
<div class="no">
<h3>这一版还不查</h3>
<ul>
<li>报价形式(三层限价、合计、大小写)、形式要件、资质有效期:规则检查还没有上线</li>
<li>签章真伪(以后也只看有无,不鉴定真伪)</li>
<li>份数、密封、CA 加密、递交方式(文件里看不出来)</li>
<li>报价是否合理、该报多少,评分高低</li>
</ul>
</div>
</fieldset>
<div v-if="startErr" class="alert warn" role="alert"><span class="ico w" aria-hidden="true">!</span><p>{{ startErr }}</p></div>
</div>
<div class="card-f">
<span v-if="pv" class="cost">
<template v-if="pv.billing === 'charged'">扣 <span class="fig">1</span> 次解析额度;检查失败、中断或取消不扣点<template v-if="parse"> · 剩 <span class="fig">{{ parse.balance }}</span> 次</template></template>
<template v-else-if="pv.billing === 'waived_recheck'">24 小时内复查,不扣额度<template v-if="pv.waive_until">(到 {{ fmtDateTime(pv.waive_until) }},复查不延长窗口)</template></template>
<template v-else>免费版:这个项目内检查不限次数</template>
<template v-if="blockers.length"> · <span class="hint-warn inline">{{ blockers.join(";") }}</span></template>
</span>
<RouterLink class="btn" :to="{ name: 'checklist', params: { projectId } }">取消</RouterLink>
<button type="submit" class="btn primary swap" :class="{ 'is-loading': busy }" :aria-busy="busy" :disabled="busy || !pv?.can_start">
<span class="idle">开始检查</span><span class="busy">正在提交…</span>
</button>
</div>
</form>
</div>
</template>
<style scoped>
.alert {
margin-bottom: var(--sp-4);
}
.card-b.form-b {
display: flex;
flex-direction: column;
gap: var(--sp-4);
padding-top: var(--sp-5);
padding-bottom: var(--sp-6);
}
.file-row .name {
display: flex;
align-items: center;
gap: var(--sp-2);
}
.file-row .meta {
display: block;
font-size: var(--fs-caption);
line-height: var(--lh-caption);
color: var(--text-secondary);
}
.new-vol {
display: grid;
grid-template-columns: 160px minmax(0, 1fr);
gap: var(--sp-4);
}
.new-vol .field {
max-width: none;
}
.scope {
display: grid;
grid-template-columns: 1fr 1fr;
gap: var(--sp-6);
border: 0;
margin: var(--sp-2) 0 0;
padding: 0;
}
.scope legend {
grid-column: 1 / -1;
font-weight: var(--fw-bold);
margin-bottom: var(--sp-2);
}
.scope legend small {
margin-left: var(--sp-2);
font-weight: var(--fw-regular);
color: var(--text-secondary);
}
.scope h3 {
margin: 0 0 var(--sp-1);
font-size: var(--fs-body);
}
.scope ul {
margin: 0;
padding-left: 1.2em;
}
.scope .no {
color: var(--text-secondary);
}
.card-f .cost {
margin-right: auto;
white-space: normal;
}
.hint-warn.inline {
display: inline;
}
</style>

View File

@@ -18,11 +18,12 @@ import ConfirmDialog from "@/components/ConfirmDialog.vue";
import HistoryDialog from "@/components/HistoryDialog.vue";
import ItemDialog from "@/components/ItemDialog.vue";
import PdfViewer, { type ViewerTarget } from "@/components/PdfViewer.vue";
import ProjectHead from "@/components/ProjectHead.vue";
import { api, errorTitle } from "@/lib/api";
import { useChecklistOps, useDeletedItems, type ItemFields } from "@/lib/checklistOps";
import { groupCitations, type CitationGroup } from "@/lib/citations";
import { useCrumbs } from "@/lib/crumbs";
import { category, CATEGORY_ORDER, deadline, fmtDateTime, legalRegime, MARKER, projectStatus } from "@/lib/labels";
import { category, CATEGORY_ORDER, fmtDateTime, MARKER, projectStatus } from "@/lib/labels";
import { useChecklist, useChecklistItems, useProject, type ChecklistItem, type Citation, type MarkingRule } from "@/lib/queries";
import { toast } from "@/lib/toast";
@@ -42,10 +43,6 @@ const cl = computed(() => checklist.data.value);
const readOnly = computed(() => p.value?.status === "submitted" || p.value?.status === "archived");
useCrumbs(() => [{ label: "工作台", to: { name: "workbench" } }, { label: p.value?.name ?? "项目" }, { label: "读标" }]);
const meta = computed(() =>
p.value ? [p.value.purchaser, p.value.legal_regime !== "unknown" ? legalRegime(p.value.legal_regime) : "", p.value.procurement_method, p.value.code].filter(Boolean).join(" · ") : "",
);
const due = computed(() => deadline(p.value?.deadline_at));
/* ---------- 分组与筛选 ---------- */
const all = computed(() => (itemsQ.data.value?.items ?? []).filter((i) => !i.deleted_at));
@@ -246,26 +243,7 @@ onBeforeUnmount(() => window.removeEventListener("keydown", onKey));
<template>
<div class="reading">
<header class="ph">
<div class="ph-l1">
<div>
<h1 :title="p?.name">{{ p?.name ?? " " }}</h1>
<p class="ph-meta">{{ meta || "招标文件信息待解析" }}</p>
</div>
<dl v-if="p" class="facts">
<div>
<dt>投标截止</dt>
<dd>
<template v-if="due"><span class="fig m">{{ due.sub }}</span><span :class="due.cls || 'muted'">{{ due.main }}</span></template>
<span v-else class="muted">—</span>
</dd>
</div>
<div><dt>状态</dt><dd><span class="tag">{{ projectStatus(p.status) }}</span></dd></div>
</dl>
</div>
<!-- 骨架阶段只有「读标」一页;概览、查标、报告做到时在这里加标签页 -->
<nav class="tabs" aria-label="项目"><a role="tab" aria-selected="true" aria-current="page">读标</a></nav>
</header>
<ProjectHead :project="p" tab="checklist" />
<div class="content">
<div class="cl-bar">

View File

@@ -0,0 +1,448 @@
<script setup lang="ts">
/**
* 查标(原型 results.html,FR-M3-03、07、08)。第 1 步的最小版本:
* - 检查进行中显示进度和取消;失败时写明原因和是否退回额度;
* - 顶部是检查覆盖范围:查了什么、没查什么(m3-plan §2.5,红线 3);
* - 问题按级别筛选,逐条处理:确认无误 / 已修改 / 忽略并注明原因;致命问题确认无误也要写说明(U4),
* 说明框在行内展开;处理后显示署名,可以撤销(U 键在第 6 步);
* - 每个问题带招标原文和投标原文两侧出处,「未找到」写明找过哪些分册;点出处在右侧抽屉里看原文;
* - 只有最近一次检查的问题可以处理,历史批次只读。
* TODO(第 6 步):键盘操作、批量处理「提示」、判断有误反馈、需人工核对、导出报告。
*/
import { unwrap } from "@bid-doctor/api-client";
import { ChevronDown, ChevronRight, X } from "@lucide/vue";
import { useQueryClient } from "@tanstack/vue-query";
import { computed, ref } from "vue";
import { RouterLink } from "vue-router";
import CitationBlock from "@/components/CitationBlock.vue";
import PdfViewer, { type ViewerTarget } from "@/components/PdfViewer.vue";
import ProjectHead from "@/components/ProjectHead.vue";
import { api, errorTitle, isApiError } from "@/lib/api";
import { useCrumbs } from "@/lib/crumbs";
import { qk } from "@/lib/keys";
import { CHECK_STEPS, checkStepIndex, FINDING_ACTION, fmtDateTime, SEVERITY, SEVERITY_CLASS } from "@/lib/labels";
import { TERMINAL_JOB, useCheckRun, useFindings, useProject, type Citation, type Finding } from "@/lib/queries";
import { toast } from "@/lib/toast";
const props = defineProps<{ projectId: string; runId: string }>();
const qc = useQueryClient();
const project = useProject(() => props.projectId);
const runQ = useCheckRun(() => props.runId);
const run = computed(() => runQ.data.value);
const done = computed(() => run.value?.status === "succeeded");
const findingsQ = useFindings(() => props.runId, done);
const p = computed(() => project.data.value);
useCrumbs(() => [{ label: "工作台", to: { name: "workbench" } }, { label: p.value?.name ?? "项目" }, { label: "查标" }]);
const readOnly = computed(() => !run.value?.is_latest || p.value?.status === "submitted" || p.value?.status === "archived");
const step = computed(() => checkStepIndex(run.value?.stage));
/* ---------- 进行中 ---------- */
const cancelling = ref(false);
async function cancel() {
cancelling.value = true;
try {
await unwrap(api.POST("/check-runs/{run_id}/cancel", { params: { path: { run_id: props.runId } } }));
void qc.invalidateQueries({ queryKey: qk.checkRun(props.runId) });
} catch (e) {
toast(errorTitle(e), { ok: false });
} finally {
cancelling.value = false;
}
}
/* ---------- 问题 ---------- */
type Sev = "" | Finding["severity"];
const sev = ref<Sev>("");
const all = computed(() => findingsQ.data.value?.items ?? []);
const live = computed(() => all.value.filter((f) => f.presence !== "resolved"));
const todo = computed(() => live.value.filter((f) => f.status === "pending" && (!sev.value || f.severity === sev.value)));
const handled = computed(() => live.value.filter((f) => f.status !== "pending" && (!sev.value || f.severity === sev.value)));
const resolved = computed(() => all.value.filter((f) => f.presence === "resolved"));
const count = (s: Sev) => live.value.filter((f) => f.status === "pending" && (!s || f.severity === s)).length;
const showHandled = ref(false);
const showResolved = ref(false);
/** 行内说明框(U4):忽略、致命问题的确认无误必须写说明 */
const noteFor = ref<{ id: string; status: "confirmed_ok" | "ignored" } | null>(null);
const note = ref("");
const noteErr = ref("");
const busyId = ref<string | null>(null);
const needsNote = (f: Finding, status: string) => status === "ignored" || (status === "confirmed_ok" && f.severity === "fatal");
function act(f: Finding, status: "confirmed_ok" | "modified" | "ignored") {
if (needsNote(f, status)) {
noteFor.value = { id: f.id, status: status as "confirmed_ok" | "ignored" };
note.value = "";
noteErr.value = "";
return;
}
void resolve(f, status);
}
async function resolve(f: Finding, status: "confirmed_ok" | "modified" | "ignored", text?: string) {
if (text !== undefined && text.trim().length < 5) {
noteErr.value = status === "ignored" ? "至少写 5 个字,说明为什么不处理" : "请写一句说明,至少 5 个字";
return;
}
busyId.value = f.id;
try {
await unwrap(
api.POST("/findings/{finding_id}/resolve", { params: { path: { finding_id: f.id } }, body: { status, ...(text ? { note: text.trim() } : {}) } }),
);
noteFor.value = null;
toast(`已标记为「${FINDING_ACTION[status]}」`, { undo: () => void reopen(f) });
refresh();
} catch (e) {
if (isApiError(e, "note_required")) noteErr.value = "请填写说明";
else toast(errorTitle(e), { ok: false });
} finally {
busyId.value = null;
}
}
async function reopen(f: Finding) {
try {
await unwrap(api.POST("/findings/{finding_id}/reopen", { params: { path: { finding_id: f.id } } }));
refresh();
} catch (e) {
toast(errorTitle(e), { ok: false });
}
}
function refresh() {
void qc.invalidateQueries({ queryKey: qk.findings(props.runId) });
void qc.invalidateQueries({ queryKey: qk.project(props.projectId) });
void qc.invalidateQueries({ queryKey: qk.projects });
}
/* ---------- 原文抽屉 ---------- */
const viewer = ref<{ doc: { id: string; label: string }; target: ViewerTarget & { id: string } } | null>(null);
function openCitation(c: Citation) {
viewer.value = {
doc: { id: c.document_id, label: c.document_label ?? "" },
target: { id: c.id, page: c.page_no, quads: c.quads, sha: c.normalized_sha256 },
};
}
const metaLine = computed(() => {
const r = run.value;
if (!r) return "";
const files = (r.documents ?? []).map((d) => d.label).join("、");
return [`第 ${r.run_no} 次检查`, fmtDateTime(r.created_at), files, `清单 v${r.checklist_version_no}(${r.checklist_confirmed ? "已确认" : "未确认"})`]
.filter(Boolean)
.join(" · ");
});
const errorText = computed(() => {
const e = run.value?.error;
if (!e) return "";
return `${e.message}。${e.refunded ? "已扣的额度已退回。" : "这次检查没有扣点。"}`;
});
</script>
<template>
<ProjectHead :project="p" tab="check" />
<div class="content">
<!-- 进行中 -->
<section v-if="run && !TERMINAL_JOB.has(run.status)" class="card running" aria-live="polite">
<h2>正在检查<span class="fig">{{ run.progress }}</span>%</h2>
<div class="bar" role="progressbar" :aria-valuenow="run.progress" aria-valuemin="0" aria-valuemax="100" aria-label="检查进度"><i :style="{ width: `${run.progress}%` }"></i></div>
<ol class="steps">
<li v-for="(s, i) in CHECK_STEPS" :key="s.label" :class="{ done: i < step, cur: i === step }">{{ s.label }}</li>
</ol>
<div class="acts">
<span class="cap muted">可以离开这个页面,检查完成后会通知你。</span>
<button type="button" class="btn sm text" :disabled="cancelling || run.cancel_requested" @click="cancel">{{ run.cancel_requested ? "正在取消…" : "取消检查" }}</button>
</div>
</section>
<!-- 失败 / 取消 -->
<div v-else-if="run && run.status !== 'succeeded'" class="alert warn" role="alert">
<span class="ico w" aria-hidden="true">!</span>
<p>{{ run.status === "cancelled" ? "检查已取消,额度已退回。" : `检查没有完成:${errorText}` }}</p>
<RouterLink class="btn sm" :to="{ name: 'bid-check', params: { projectId } }">重新检查</RouterLink>
</div>
<template v-else-if="run">
<div class="rbar">
<div>
<h2>检查结果</h2>
<p class="meta" :title="metaLine">{{ metaLine }}</p>
</div>
<div class="actions">
<RouterLink class="btn" :to="{ name: 'bid-check', params: { projectId } }">重新检查</RouterLink>
</div>
</div>
<div v-if="!run.is_latest" class="alert warn" role="note"><span class="ico w" aria-hidden="true">!</span><p>这是历史检查,只能查看。</p></div>
<section v-if="run.coverage" class="card coverage" aria-labelledby="h-cov">
<h2 id="h-cov" class="vh">检查覆盖范围</h2>
<div>
<h3>查了</h3>
<ul><li v-for="t in run.coverage.checked ?? []" :key="t">{{ t }}</li></ul>
</div>
<div class="no">
<h3>没查</h3>
<ul><li v-for="t in run.coverage.not_checked ?? []" :key="t">{{ t }}</li></ul>
</div>
</section>
<section class="card flush results" aria-label="检查结果">
<div class="card-h">
<div class="seg" role="group" aria-label="按级别筛选">
<button type="button" :aria-pressed="sev === ''" @click="sev = ''">全部 <span class="fig">{{ count("") }}</span></button>
<button v-for="s in (['fatal', 'important', 'hint'] as const)" :key="s" type="button" :aria-pressed="sev === s" @click="sev = s">
<span class="sev" :class="SEVERITY_CLASS[s]">{{ SEVERITY[s] }}<span class="fig">{{ count(s) }}</span></span>
</button>
</div>
</div>
<div v-if="findingsQ.isPending.value" class="lst-pad"><span class="skel t"></span><span class="skel"></span></div>
<template v-else>
<article v-for="f in [...todo, ...(showHandled ? handled : [])]" :key="f.id" class="finding">
<div>
<div class="f-head">
<span class="sev" :class="SEVERITY_CLASS[f.severity]">{{ SEVERITY[f.severity] }}</span>
<span class="f-title">{{ f.title }}</span>
<span v-if="f.presence === 'carried'" class="flag">沿用<template v-if="f.carried_status === 'modified'">:上次已修改,这次仍查出</template></span>
</div>
<p class="f-text">{{ f.explanation }}</p>
<div v-if="f.status !== 'pending'" class="sign" :class="{ ign: f.status === 'ignored' }">
<span aria-hidden="true">{{ f.status === "ignored" ? "–" : "✓" }}</span><b>{{ f.resolved_by?.name }}</b>
<span v-if="f.resolved_at" class="fig">{{ fmtDateTime(f.resolved_at) }}</span><span>{{ FINDING_ACTION[f.status] }}</span>
<button v-if="!readOnly" type="button" class="undo" @click="reopen(f)">撤销</button>
</div>
<p v-if="f.status !== 'pending' && f.resolution_note" class="sign-note">{{ f.status === "ignored" ? "原因" : "说明" }}:{{ f.resolution_note }}</p>
<div v-else-if="noteFor?.id === f.id" class="u4">
<div class="field" :class="{ err: noteErr }">
<label :for="`u4-${f.id}`">{{ noteFor.status === "confirmed_ok" ? "确认无误的说明" : "忽略原因" }} <small>(必填,至少 5 个字)</small></label>
<textarea :id="`u4-${f.id}`" v-model="note" class="input" maxlength="200" :aria-invalid="!!noteErr" @keydown.ctrl.enter="resolve(f, noteFor.status, note)" @keydown.esc="noteFor = null"></textarea>
<span class="msg"><template v-if="noteErr"><span class="ico w" aria-hidden="true">!</span>{{ noteErr }}</template><template v-else>{{ noteFor.status === "confirmed_ok" ? "说明会同时作为误报反馈提交" : "「已忽略」在报告里单独列出" }}</template></span>
</div>
<div class="row">
<button type="button" class="btn sm" :disabled="busyId === f.id" @click="resolve(f, noteFor.status, note)">{{ noteFor.status === "confirmed_ok" ? "确认无误" : "忽略这一项" }}</button>
<button type="button" class="btn sm text" @click="noteFor = null">取消</button>
</div>
</div>
<div v-else-if="!readOnly" class="f-actions">
<button type="button" class="btn sm" :disabled="busyId === f.id" @click="act(f, 'confirmed_ok')">确认无误</button>
<button type="button" class="btn sm" :disabled="busyId === f.id" @click="act(f, 'modified')">已修改</button>
<button type="button" class="btn sm" :disabled="busyId === f.id" @click="act(f, 'ignored')">忽略并注明原因</button>
</div>
</div>
<aside>
<CitationBlock v-for="c in f.tender_citations" :key="c.id" :citation="c" :active="viewer?.target.id === c.id" @open="openCitation(c)" />
<CitationBlock v-for="c in f.bid_citations" :key="c.id" :citation="c" :active="viewer?.target.id === c.id" @open="openCitation(c)" />
<div v-if="f.type === 'unresponded' && f.search_scope" class="cite missing">
<span class="cite-src">投标文件 · 未找到</span>
<p>找过:{{ (f.search_scope.documents ?? []).join("、") || "全部分册" }}</p>
</div>
</aside>
</article>
<div v-if="!todo.length" class="empty sm">
<b>{{ live.length ? (sev ? "这个级别的问题都已处理" : "全部问题都已处理") : "没有发现问题" }}</b>
<p>{{ live.length ? "已处理的在下方,可以撤销。" : "只表示本次检查的范围内没有发现问题,不代表投标文件没有问题。没查的内容见上方「没查」。" }}</p>
</div>
<button v-if="handled.length" type="button" class="group-h" :aria-expanded="showHandled" @click="showHandled = !showHandled">
<component :is="showHandled ? ChevronDown : ChevronRight" class="ic" :stroke-width="1.5" />已处理(<span class="fig">{{ handled.length }}</span>)
</button>
<button v-if="resolved.length" type="button" class="group-h" :aria-expanded="showResolved" @click="showResolved = !showResolved">
<component :is="showResolved ? ChevronDown : ChevronRight" class="ic" :stroke-width="1.5" />本次已解决(<span class="fig">{{ resolved.length }}</span>)<span class="sub">上次有、这次没再发现,已自动关闭</span>
</button>
<template v-if="showResolved">
<div v-for="f in resolved" :key="f.id" class="resolved">
<span class="sev" :class="SEVERITY_CLASS[f.severity]">{{ SEVERITY[f.severity] }}</span><s>{{ f.title }}</s>
<span v-if="f.carried_status && f.carried_status !== 'pending'" class="cap">上次:{{ FINDING_ACTION[f.carried_status] }}</span>
</div>
</template>
</template>
</section>
</template>
<div v-else-if="runQ.error.value" class="alert warn" role="alert"><span class="ico w" aria-hidden="true">!</span><p>{{ errorTitle(runQ.error.value) }}</p></div>
</div>
<aside v-if="viewer" class="drawer" aria-label="原文">
<button type="button" class="icon-btn sm close" aria-label="关闭原文" @click="viewer = null"><X class="ic" :stroke-width="1.5" /></button>
<PdfViewer :document-id="viewer.doc.id" :document-label="viewer.doc.label" :target="viewer.target" />
</aside>
</template>
<style scoped>
.running h2 {
display: flex;
gap: var(--sp-2);
align-items: baseline;
margin: 0 0 var(--sp-3);
font: var(--fw-bold) var(--fs-title) / var(--lh-title) var(--font-sans);
}
.running .bar {
height: 6px;
border-radius: 3px;
background: var(--c-n100);
overflow: hidden;
}
.running .bar i {
display: block;
height: 100%;
background: var(--ai);
transition: width var(--dur-base) var(--ease);
}
.steps {
display: flex;
gap: var(--sp-6);
margin: var(--sp-4) 0 0;
padding: 0;
list-style: none;
color: var(--text-secondary);
}
.steps .done {
color: var(--text-primary);
}
.steps .cur {
color: var(--text-primary);
font-weight: var(--fw-bold);
}
.running .acts {
display: flex;
align-items: center;
justify-content: space-between;
margin-top: var(--sp-4);
}
.rbar {
display: flex;
align-items: flex-end;
gap: var(--sp-4);
margin-bottom: var(--sp-4);
}
.rbar h2 {
margin: 0;
font: var(--fw-bold) var(--fs-title) / var(--lh-title) var(--font-sans);
}
.rbar .meta {
margin: 2px 0 0;
color: var(--text-secondary);
font-size: var(--fs-caption);
}
.rbar .actions {
margin-left: auto;
}
.coverage {
display: grid;
grid-template-columns: 1fr 1fr;
gap: var(--sp-6);
margin-bottom: var(--sp-4);
}
.coverage h3 {
margin: 0 0 var(--sp-1);
font-size: var(--fs-body);
}
.coverage ul {
margin: 0;
padding-left: 1.2em;
}
.coverage .no {
color: var(--text-secondary);
}
.results .card-h {
display: flex;
align-items: center;
}
.seg {
display: flex;
gap: var(--sp-2);
}
.seg button {
display: inline-flex;
align-items: center;
gap: var(--sp-1);
padding: 2px var(--sp-2);
border-radius: var(--radius-ctl);
color: var(--text-secondary);
}
.seg button[aria-pressed="true"] {
background: var(--c-n100);
color: var(--text-primary);
}
.sign.ign {
color: var(--text-secondary);
}
.sign .undo {
border: 0;
background: none;
padding: 0;
cursor: pointer;
text-decoration: underline;
}
.sign-note {
margin: var(--sp-1) 0 0;
color: var(--text-secondary);
font-size: var(--fs-caption);
}
.u4 {
margin-top: var(--sp-3);
}
.u4 .field {
max-width: none;
}
.u4 textarea {
min-height: 64px;
}
.u4 .row {
display: flex;
gap: var(--sp-2);
margin-top: var(--sp-2);
}
.cite.missing p {
margin: 0;
color: var(--text-secondary);
}
.group-h {
display: flex;
align-items: center;
gap: var(--sp-1);
width: 100%;
padding: var(--sp-3) var(--card-x);
border-top: var(--line) solid var(--border-subtle);
color: var(--text-secondary);
text-align: left;
}
.group-h .sub {
margin-left: var(--sp-2);
font-size: var(--fs-caption);
}
.resolved {
display: flex;
align-items: center;
gap: var(--sp-2);
padding: var(--sp-2) var(--card-x);
color: var(--text-secondary);
}
.drawer {
position: fixed;
top: 0;
right: 0;
bottom: 0;
z-index: 40;
display: flex;
width: min(640px, 50vw);
background: var(--bg-surface);
box-shadow: var(--shadow-overlay);
}
.drawer > :deep(*:last-child) {
flex: 1;
min-width: 0;
}
/* 关闭按钮挂在抽屉左边缘外侧,不挡查看器自己的翻页按钮 */
.drawer .close {
position: absolute;
top: var(--sp-3);
left: calc(-1 * var(--sp-8));
background: var(--bg-surface);
box-shadow: var(--shadow-overlay);
}
</style>

View File

@@ -36,6 +36,18 @@ export const router = createRouter({
component: () => import("@/pages/ChecklistPage.vue"),
props: true,
},
{
path: "projects/:projectId/check",
name: "bid-check",
component: () => import("@/pages/BidCheckPage.vue"),
props: true,
},
{
path: "projects/:projectId/results/:runId",
name: "results",
component: () => import("@/pages/ResultsPage.vue"),
props: true,
},
],
},
{ path: "/:pathMatch(.*)*", redirect: "/" },