Skip to main content
Challenge

Build an Assisted Vernacular Trade License Prep and Appointment Scheduler

Assist micro-merchants in preparing municipal trade license submittals using regional voice transcripts and standard service appointment schemas. Generate validated document checklists and mock appointment booking payloads.

Workflow AutomationHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Assist micro-merchants in preparing municipal trade license submittals using regional voice transcripts and standard service appointment schemas. Generate validated document checklists and mock appointment booking payloads.

Field business facilitator aiding unorganized micro-retailers with municipal regulatory compliance and trade center verification.

Transcribe vernacular voice or dialect audio prompts describing merchant business categories into structured trade classifications.

Map regional business descriptions against municipal trade license document requirement matrices and extract key applicant metadata.

Inspect extracted application fields to generate a categorized submittal readiness checklist highlighting missing mandatory credentials.

Synthesize a mock service booking payload structured with Beckn appointment context headers and local language confirmation summaries.

Terminal CLI and local web console displaying dialect audio transcriptions, document completeness matrices, and structured appointment booking slips.

Download public municipal trade license category definitions and simulate voice interview transcripts across Hindi and Tamil with mock merchant records. Starter examples below are synthetic. They are not downloaded records.

Beckn protocol specifications Uses the Beckn protocol core packet structure with explicit context and message separation for appointment discovery and booking payloads.

mastra-ai, pydantic, fastapi. Mastra AI provides declarative workflows and structured step chaining suitable for orchestrating multi-stage multilingual extraction and schema assembly. Hosted or local LLM with strong multilingual Indian language reasoning capabilities and JSON schema adherence.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

Parses regional language trade declarations and maps them accurately into standardized municipal trade categories.

Generates an itemized document readiness scorecard flagging missing utility proofs or premise agreements.

Formats an outbound Beckn-compatible mock appointment registration payload with valid context and message fields.

Emits a translated vernacular confirmation summary corresponding to the selected applicant language code.

```json [ { "input": { "session_id": "TRD-8821", "language_code": "hi", "spoken_input": "Main Kanpur me stationery aur photocopy ki dukaan chalata hoon, 150 sq ft area hai, trade certificate chahiye", "merchant_profile": { "applicant_name": "Ramesh Sharma", "establishment_name": "Sharma Xerox & Book Stall", "premise_type": "leased", "area_sqft": 150 }, "documents_provided": [ "rent_agreement", "electricity_bill" ] }, "expected_output": { "trade_category": "Retail Trade - Commercial Paper & Stationery", "compliance_status": "ready_for_appointment", "required_documents": [ { "name": "rent_agreement", "status": "provided" }, { "name": "electricity_bill", "status": "provided" }, { "name": "fire_safety_noc", "status": "exempt" } ], "appointment_payload": { "context": { "domain": "nic:municipal_services", "action": "init", "version": "1.0.0", "bap_id": "mock-citizen-app.gov.in", "bpp_id": "mock-kanpur-nagar-nigam.gov.in" }, "message": { "appointment": { "category_id": "TRADE_LICENSE_VERIFICATION", "location_id": "NN_ZONE_3", "applicant": { "name": "Ramesh Sharma", "business": "Sharma Xerox & Book Stall" } } } }, "confirmation_summary_vernacular": "Sharma Xerox ke liye vyapar praman-patra satyapan slot taiyar hai. Sabhi zaroori dastavez uplabdh hain." } }, { "input": { "session_id": "TRD-8822", "language_code": "ta", "spoken_input": "Enaku Maduraiyil oru tea stall irukku, trade license eduka vendum", "merchant_profile": { "applicant_name": "K. Murugan", "establishment_name": "Murugan Tea Stall", "premise_type": "leased", "area_sqft": 80 }, "documents_provided": [] }, "expected_output": { "trade_category": "Food and Beverage - Small Eatery / Tea Stall", "compliance_status": "action_required", "required_documents": [ { "name": "rent_agreement_or_property_tax", "status": "missing" }, { "name": "fssai_basic_registration", "status": "missing" } ], "appointment_payload": null, "confirmation_summary_vernacular": "Murugan Tea Stall-kku trade license satyapanathuku vaadagai oppantham matrum FSSAI registration thevai. Slot book seiya mudiyathu." } } ] ```

Ensures no real Aadhaar numbers, tax credentials, or government API endpoints are contacted; strictly executes against simulated municipal sandboxes. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

Ensures no real Aadhaar numbers, tax credentials, or government API endpoints are contacted; strictly executes against simulated municipal sandboxes. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Parses regional language trade declarations and maps them accurately into standardized municipal trade categories. Generates an itemized document readiness scorecard flagging missing utility proofs or premise agreements. Formats an outbound Beckn-compatible mock appointment registration payload with valid context and message fields. Emits a translated vernacular confirmation summary corresponding to the selected applicant language code.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Transcribe vernacular voice or dialect audio prompts describing merchant business categories into structured trade classifications. Map regional business descriptions against municipal trade license document requirement matrices and extract key applicant metadata. Inspect extracted application fields to generate a categorized submittal readiness checklist highlighting missing mandatory credentials. Synthesize a mock service booking payload structured with Beckn appointment context headers and local language confirmation summaries.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Parses regional language trade declarations and maps them accurately into standardized municipal trade categories. Generates an itemized document readiness scorecard flagging missing utility proofs or premise agreements. Formats an outbound Beckn-compatible mock appointment registration payload with valid context and message fields. Emits a translated vernacular confirmation summary corresponding to the selected applicant language code.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Terminal CLI and local web console displaying dialect audio transcriptions, document completeness matrices, and structured appointment booking slips.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Ensures no real Aadhaar numbers, tax credentials, or government API endpoints are contacted; strictly executes against simulated municipal sandboxes.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Transcribe vernacular voice or dialect audio prompts describing merchant business categories into structured trade classifications.

  • Map regional business descriptions against municipal trade license document requirement matrices and extract key applicant metadata.

  • Inspect extracted application fields to generate a categorized submittal readiness checklist highlighting missing mandatory credentials.

  • Synthesize a mock service booking payload structured with Beckn appointment context headers and local language confirmation summaries.

Resources and assets

Reference links and supporting material

Dataset notes

Download public municipal trade license category definitions and simulate voice interview transcripts across Hindi and Tamil with mock merchant records. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

Mastra AI

TypeScript agent framework.

Evaluated output

No output checks are configured.

Evaluation checks
  • Transcribe vernacular voice or dialect audio prompts describing merchant business categories into structure...
  • Parses regional language trade declarations and maps them accurately into standardized municipal trade cate...
  • Terminal CLI and local web console displaying dialect audio transcriptions, document completeness matrices,...
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • Mastra AI · Optional
Orchestration
  • Mastra AI · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build an Assisted Vernacular Trade License Prep and Appointment Scheduler