দরদেখা — বাংলাদেশের বাজারদর

দরদেখা（Dordekha）

孟加拉国政府农业市场价格——每日更新、单位已修正、可验证、原生支持 AI。

一个零预算、可自运行的微型 SaaS，数据来自农业部（农业营销局，DAM）的官方每日市场价格报告，并以 AI 助手可以直接获取和引用的方式发布。

---

包含内容

层级	内容
来源	moa-services.com/agri-service——农业部官方 JSON API。无需密钥、无需 cookie、无需 CSRF。64 个地区 · 447 种产品目录（其中 256 种有数据）· 零售 + 批发 · 历史数据每天增加 1 天
修正	单位标准化（上游的“昆塔尔”实际为 100 公斤）、如实保留缺失数据、标记过时值、修正并标记超出范围的平均值
发布	服务端渲染的孟加拉语 HTML · text/markdown · application/json · 每条数据都有规范永久链接 · JSON-LD Dataset
AI 接口	MCP 服务（无状态，规范版本 2026-07-28）——每条结果都包含 url，因此助手可以显示可点击的来源
运行	Cloudflare Workers + D1 + KV——完全使用免费套餐，无需用户介入

---

目录

src/
  index.ts      HTTP router: pages, API, MCP, robots, llms.txt, sitemap, openapi
  moa.ts        upstream client (keyless, retried, 64-district iteration)
  units.ts      unit normalisation — measured factors + plausibility repair
  normalize.ts  Bangla numerals, carry-forward detection, anomaly flags
  quality.ts    what may be published: clamping, range repair, is_midpoint
  db.ts         D1 access layer — every read falls back to the KV cache
  cache.ts      KV snapshot, aggregates, master data, history
  ingest.ts     self-chaining cron job (10 ms CPU budget on the free plan)
  resolve.ts    a name or a sentence → the right commodity or district
  bn.ts         Bangla normalisation (nukta, virama, aliases)
  render.ts     one set of facts → html / markdown / json
  docs.ts       one content model → html / markdown / json
  mcp.ts        MCP server: server/discover, tools/list, tools/call
  slug.ts       Bangla → ASCII transliteration
migrations/     D1 schema
test/           unit tests (75)
tools/          snapshot builder, verification harnesses, live probes
docs/           dataset, methodology, licence letter, audit prompts

---

运行

npm install
npm test                 # 25 unit tests
npx tsc --noEmit         # typecheck
npx wrangler d1 migrations apply dordekha --local
npx wrangler dev --local --port 8787 \
  --var "SITE_ORIGIN:http://localhost:8787" \
  --var "SOURCE_NAME:কৃষি মন্ত্রণালয় / কৃষি বিপণন অধিদপ্তর (DAM)" \
  --var "SOURCE_API:https://moa-services.com/agri-service"

然后：

POST /internal/master/refresh     → মাস্টার ডেটা
POST /internal/ingest/start       → ইনজেস্ট শুরু (নিজে নিজে চেইন করে)
GET  /health                      → "আজ ডেটা ঢুকেছে কি না"

---

API

GET /api/v1/latest?district=47          (জেলা আইডি বা নাম — নাম দিলেও চলে)
GET /api/v1/price?commodity=পেঁয়াজ&district=পাবনা
GET /api/v1/price?commodity=833&district=47&date=2026-10-19
GET /api/v1/search?q=পেঁয়াজ ঢাকা
GET /api/v1/answer?q=পেঁয়াজ ঢাকা        (উত্তর + উদ্ধৃতি, একটি অবজেক্টে)
GET /api/v1/series.csv?commodity=602&district=47
GET /api/v1/districts
GET /api/v1/commodities
GET /api/v1/units                        (ইউনিট কোডের লেজেন্ড)

所有响应都包含 price_date、unit_bn、is_midpoint，以及每行各自可引用的 url。OpenAPI 规范：/openapi.json

MCP

opencode mcp add dordekha --url https://dordekha.pages.dev/mcp

{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"get_market_price",
           "arguments":{"commodity":"পেঁয়াজ","district":"পাবনা"}}}

工具：get_market_price · compare_districts · get_price_trend · verify_claim

已发布到 MCP Registry——io.github.mdshipon4045-afk/dordekha（v1.0.0，状态为 active）：

{"mcpServers":{"dordekha":{"type":"http","url":"https://dordekha.pages.dev/mcp"}}}

搜索：https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.mdshipon4045-afk/dordekha

发布到 Registry 的说明：docs/PUBLISH-MCP.md

---

诚信原则

1. 每个数字都保留其来源、日期和单位换算系数。
2. 来源没有数据时，不会凭空生成数字。
3. 如果修正了单位，会明确说明。
4. 不进行任何估算或插值。
5. 来源中的第三个数字是“（最小值 + 最大值）/2”——它不是平均值，因此称为“中间值”，且每行都包含 is_midpoint。
6. 不会手动写入任何数字声明——页面渲染时会从数据中计算。

详情：docs/DATASET.md · 方法：/methodology 页面

---

📚 文档

文件	内容
PLAN.md	决策、计划、阶段、人工任务清单
docs/FAILURE-MODES.md	故障登记表 + 当前状态——如果从代码开始，请从这里入手
docs/MASTER-PROMPT.md	用于委托顶级 AI 负责整个项目的提示词
docs/DEEP-REVIEW-PROMPT.md	深入审查代码、业务和法律问题的提示词
docs/AUDIT-PROMPTS.md	4 个审计提示词（已于 10 月 21 日运行）
docs/DATASET.md	数据集范围与方法
docs/licence-letter-DAM.md	DAM/迪西姆许可函草稿
docs/OUTREACH-KIT.md	B2B 推广：潜在客户、电子邮件模板、Facebook 帖子
docs/PUBLISH-MCP.md	发布到 MCP Registry 的说明

---

验证

npx vitest run                                    # 75 unit tests
$env:BASE="https://dordekha.pages.dev"; node tools/e2e.mjs   # 60 live checks
node tools/verify-audit.mjs                       # 32 audit claims
node tools/peek.mjs                               # 12 render checks
node tools/product-test.mjs                       # question → citation → same number