DSH Bid Desk

Repository description: Local-first DSH workbench for evidence-backed pre-submission bid compliance self-checks.

DSH Bid Desk is a DSH plugin MVP for teams preparing a bid submission. It keeps tender-source evidence, requirement records, review decisions, and generated reports connected so a qualified human can investigate gaps before submission.

Status

This repository contains a runnable MVP vertical slice. It is not a complete release candidate: automated conflict detection, background worker/checkpoint recovery, persisted report snapshots, and the full disable/uninstall release gate remain incomplete. See the MVP acceptance audit for the evidence and open items.

What it does

• Imports local plain-text files, searchable PDFs, and DOCX files with explicit document roles.
• Preserves original bytes and their content hash, while storing evidence blocks with page, paragraph, line, or table-cell locators.
• Provides a requirement matrix, evidence index, deterministic candidate matching, and visible document conflicts.
• Records human review outcomes and waivers as separate, audited decisions.
• Produces a read-only HTML report containing same-origin links back to original evidence.
• Exposes a read-only bid_compliance_summary tool with project and count metadata only.

What it does not do

• It does not provide legal advice, certify compliance, guarantee bid acceptance, or make final pass/fail decisions.
• It does not submit bids, sign, seal, publish, or send external communications.
• It does not process scanned or image-only PDFs, perform OCR, or upload documents to an external provider by default.
• Candidate matches are ranking hints for human review, not compliance conclusions.

Quick start

Prerequisites: a compatible DSH web profile and a current Node.js/pnpm environment. The CI workflow uses Node.js 24.13.0 and pnpm 11.7.0.

git clone https://github.com/haoranwang0921/dsh-bid-desk.git
cd dsh-bid-desk/plugin
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm test
pnpm run build

To install the plugin from a local checkout, add plugin/ as a DSH bundle plugin, for example:

dsh plugin --profile web add link:<absolute-path-to-repository>/plugin

Then mount the dsh-bid-compliance entry defined in plugin/cordis.patch.yml using your DSH profile configuration.

Repository layout

Path	Purpose
plugin/	DSH bundle plugin, host routes, persistence, parsers, client UI, and smoke tests.
docs/MVP_ARCHITECTURE_AND_EXECUTION.md	Product boundaries, architecture, execution plan, and deferred work.
docs/MVP-ACCEPTANCE-AUDIT.md	Evidence-backed status of the MVP acceptance script.
docs/ADR-0003-document-scope-no-OCR.md	Decision to reject scanned PDFs rather than silently degrade evidence quality.
.github/workflows/ci.yml	CI for locked installation, type-checking, tests, and builds.

Development checks

The repository CI runs for pushes and pull requests targeting main. It installs from the committed lockfile, type-checks the plugin, runs its smoke suites, and builds the package.

cd plugin
pnpm run typecheck
pnpm test
pnpm run build

License

The plugin package metadata declares the MIT license. A repository-level license file has not yet been added.

---

DSH 投标合规工作台

仓库简介： 面向投标提交前合规自查的、本地优先且以证据为依据的 DSH 工作台。

DSH 投标合规工作台是一个 DSH 插件 MVP，服务于投标文件编制过程。它将招标来源证据、要求记录、人工复核决定和生成报告关联起来，帮助具备相应资质或经验的人员在提交前核查缺口。

当前状态

本仓库提供的是可运行的 MVP 垂直切片，而非完整发布候选版本。自动冲突检测、后台 worker/checkpoint 恢复、持久化报告快照，以及完整的禁用/卸载发布门仍未完成。证据和待办项见 MVP 验收审计。

已实现能力

• 导入本地纯文本、含文本层的 PDF 与 DOCX，并明确区分文档角色。
• 保存原始字节及其内容哈希，并按页、段落、行或表格单元格保存证据定位。
• 提供要求矩阵、证据索引、确定性候选匹配和可见的文档冲突。
• 将人工复核结果和豁免作为独立、可审计的决定保存。
• 生成只读 HTML 报告，并通过同源链接回到原始证据。
• 提供只读的 bid_compliance_summary Agent 工具，只返回项目和计数元数据。

明确不做的事

• 不提供法律意见、不认证合规性、不保证中标，也不代表用户作出最终通过/不通过决定。
• 不自动提交投标、签字、盖章、发布或发送外部通信。
• 默认不处理扫描件或纯图片 PDF、不进行 OCR，也不向外部服务商上传文档。
• 候选匹配只是供人工复核的排序提示，不是合规结论。

快速开始

前提：可兼容的 DSH Web Profile，以及可用的 Node.js/pnpm 环境。CI 使用 Node.js 24.13.0 与 pnpm 11.7.0。

git clone https://github.com/haoranwang0921/dsh-bid-desk.git
cd dsh-bid-desk/plugin
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm test
pnpm run build

从本地检出目录安装时，可将 plugin/ 添加为 DSH bundle plugin，例如：

dsh plugin --profile web add link:<仓库绝对路径>/plugin

随后按 DSH Profile 配置方式挂载 plugin/cordis.patch.yml 中定义的 dsh-bid-compliance 条目。

仓库结构

路径	用途
plugin/	DSH bundle 插件、Host 路由、持久化、解析器、客户端 UI 与冒烟测试。
docs/MVP_ARCHITECTURE_AND_EXECUTION.md	产品边界、架构、执行方案和延期事项。
docs/MVP-ACCEPTANCE-AUDIT.md	以证据为依据的 MVP 验收状态。
docs/ADR-0003-document-scope-no-OCR.md	明确拒绝扫描版 PDF，避免静默降低证据质量的决策。
.github/workflows/ci.yml	执行锁定安装、类型检查、测试和构建的 CI。

开发验证

仓库 CI 会在向 main 推送代码或创建面向 main 的 Pull Request 时执行：依据已提交锁文件安装依赖、完成类型检查、运行插件冒烟测试并构建软件包。

cd plugin
pnpm run typecheck
pnpm test
pnpm run build

许可证

插件 package.json 声明为 MIT 许可证；仓库根目录尚未添加独立的许可证文件。