Documentation

Read it before
you believe it

Every claim VoxShield makes in public is traceable to a document. This hub points at all of them — the ones published with this website, and the ones that live in the product repositories.

Two kinds of entry below. Links open documents published with this site. Entries shown as repository/path.md live in the Console or Mobile repositories and are not mirrored here — they are named so you can ask for them rather than being sent to a dead link.

Products

What each surface is, and what state it is in.

Mobile

Built

On-device Android detection, the four input paths, and the live-capture feasibility measurements.

How a call is checked

VoxshieldMobile/docs/ON_DEVICE_ARCHITECTURE.md, LIVE_CALL_AUDIO_FEASIBILITY.md

Console

Built

The detection core, the decision layer, the console views and the enterprise layer specification.

Console tour

Voxshield_Console/docs/ENTERPRISE_PLATFORM.md

SDK

Planned

No package and no document of its own yet. The wire contract it would wrap is documented.

Planned shape

Assistant

Built

Grounded retrieval, citation format, refusal behaviour and the corpus it indexes.

How it answers

Voxshield_Console/docs/claims/00-CONTEXT-PACK.md §10

Technical

Architecture, the detection pipeline, models and the decision layer.

TopicWhereCovers
Architecturetechnology.htmlOne process, one CUDA context, twelve stages.
Detection pipelinetechnology.html#pipelineIngest through audit append, stage by stage.
Modelstechnology.html#modelsSix components, licences, weights, devices.
Precondition gatetechnology.html#gateFour checks, six reason codes.
Language gatetechnology.html#language-gateWhich languages are admitted, and why.
Risk fusiontechnology.html#fusionWeights, bounds and the disagreement rule.
Verdict systemtechnology.html#verdictsFive verdicts, three-valued is_fake.
Frozen constantsVoxshield_Console/app/core/constants.pyEvery threshold the product is built on.
Technical requirementsVoxshield_Console/docs/TRD.mdThe specification the code is held to.

Security

Privacy posture, encryption, the audit chain and access control.

Privacy & data handling

Zero raw audio persisted, no transcription, encrypted voiceprints, retention windows and DPDP framing.

Read it

Audit chain

SHA-256 chaining, verification that names the first broken entry, and the three tested corruption paths.

Read it

Authentication & roles

Five roles, the permission matrix, session handling and what no API will ever return.

Read it

Offline architecture

Why there is exactly one outbound call in the codebase, and how that is tested rather than asserted.

Read it

Repository sources: Voxshield_Console/docs/RULES.md, docs/claims/07-engineering-security-privacy.md, this site's own backend note.

Evaluation

Benchmarks, datasets, limitations and how to reproduce them.

DocumentWhereCovers
Measurementsbenchmarks.htmlSpeed, capacity, cost and test coverage. No accuracy figure.
Why no accuracy numberbenchmarks.html#why-no-numberWhat a single percentage hides, and what we do instead.
What we do not claimbenchmarks.html#limitationsAccuracy, language coverage, replay, carrier and bank integration.
Claim disciplinebenchmarks.html#disciplineThe never-say / say-instead table this site is held to.
Detection test runsVoxshield_Console/benchmarks/results.mdKept in the repository with their datasets and caveats, not advertised on the site.
Dataset notesVoxshield_Console/docs/Which corpora were used, their licences, and how test sets were built.

Integration

The wire contract that everything else would be built on.

# One object, every endpoint, contract_version 1.0
{
  "contract_version": "1.0",
  "verdict":     "SAFE" | "SUSPICIOUS" | "HIGH_RISK" | "LOW_CONFIDENCE" | "ERROR",
  "risk":        0-100 | null,
  "risk_range":  [ low, high ],
  "is_fake":     true | false | null,     # null is not false
  "reason_code": "NO_VALIDATED_SIGNAL" | ... | null,
  "latency_ms":  308
}

REST & WebSocket

Built

14 REST endpoints and 3 WebSocket channels, documented in docs/API_CONTRACT.md.

Mobile → Console

Specified

Device tokens and recording upload are specified; metadata and a content hash are stored, never audio.

SDK

Planned

Not built. The contract above is the part that is already decided.

Project

The documents behind this website, published with it.

PRD — this website

Scope, audience, success criteria, and what is deliberately out of scope.

docs/PRD.md

TRD — this website

The locked stack: plain HTML, CSS and vanilla JS, static hosting, no build step.

docs/TRD.md

Frontend spec

Section rules, the status-badge rule, and the definition of done.

docs/FRONTEND.md

Why this site has no backend

A deliberate architecture decision, written down so nobody looks for a server folder.

docs/BACKEND_SCHEMA.md

SIH material

Problem statement framing, demo script and the judge-facing guide.

Voxshield_Console/docs/SIH_MASTER_GUIDE.md, DEMO_SCRIPT.md

Design system

The UI reference this site is built from: type, colour, status chips, components and motion.

Open the reference

Missing something?

Ask for the document by name

Repository documents are not mirrored here, but they exist and can be shared.