How adityaaa89/manak works
Manak Compliance is a BIS compliance guidance application: users explore standards and certification, assess factory readiness, find labs, verify products, and ask evidence-grounded questions. The clearest sampled end-to-end flow is the Evidence Assistant: a query enters the chat route, is augmented and language-processed, retrieved against document chunks and structured mappings, then answered and returned with citations and compliance metadata. Other product capabilities are represented by their route and page modules; their internal wiring was not sampled, so those links are limited to explicit application routing and API boundaries.
Main entry points: main.py FastAPI application · App.tsx Web router · rag.py Chat query route · retrieval_service.py Hybrid retrieval
Components 34
Web experience
- Web router
src/App.tsx - API client
src/services/api.ts - Standards discovery
src/pages/StandardsDiscovery.tsx - Evidence assistant
src/pages/EvidenceAssistant.tsx - Certification journey
src/pages/CertificationJourney.tsx - Compliance blueprint
src/pages/ComplianceBlueprint.tsx - Compliance analysis
src/pages/ComplianceAnalysis.tsx - Factory readiness
src/pages/FactoryReadiness.tsx - Laboratory finder
src/pages/LaboratoryFinder.tsx - Snap verify
src/pages/SnapVerify.tsx
API routes
- FastAPI application
backend/app/main.py - Chat query route
backend/app/routes/rag.py - Standards routes
backend/app/routes/standards.py - Product routes
backend/app/routes/products.py - QCO routes
backend/app/routes/qco.py - Testing routes
backend/app/routes/testing.py - Readiness routes
backend/app/routes/readiness.py - Laboratory routes
backend/app/routes/labs.py - Blueprint routes
backend/app/routes/blueprint.py - Document routes
backend/app/routes/documents.py - Verification routes
backend/app/routes/verification.py
Evidence assistant
- Hybrid retrieval
backend/app/services/retrieval_service.py - Query intent
backend/app/services/query_intent_service.py - Structured evidence
backend/app/services/structured_retrieval_service.py - Embedding service
backend/app/services/embedding_service.py - Answer generation
backend/app/services/llm_service.py - Language handling
backend/app/services/language_service.py - Conversation memory
backend/app/services/conversation_memory.py - Answer explanation
backend/app/services/explanation_service.py
Compliance services
- Readiness assessment
backend/app/services/readiness_engine.py - Testing requirements
backend/app/services/testing_engine.py - Lab ranking
backend/app/services/lab_ranker.py
Data and documents
- Application database
backend/app/database/database.py
Other components
- Compliance user
Connections 34
- Compliance user → Web router: uses
- Web router → Standards discovery: routes
- Web router → Evidence assistant: routes
- Web router → Certification journey: routes
- Web router → Compliance blueprint: routes
- Web router → Compliance analysis: routes
- Web router → Factory readiness: routes
- Web router → Laboratory finder: routes
- Web router → Snap verify: routes
- Evidence assistant → API client: requests
- API client → FastAPI application: calls API
- FastAPI application → Chat query route: registers
- FastAPI application → Standards routes: registers
- FastAPI application → Product routes: registers
- FastAPI application → QCO routes: registers
- FastAPI application → Testing routes: registers
- FastAPI application → Readiness routes: registers
- FastAPI application → Laboratory routes: registers
- FastAPI application → Blueprint routes: registers
- FastAPI application → Document routes: registers
- FastAPI application → Verification routes: registers
- Chat query route → Language handling: detects and translates
- Chat query route → Conversation memory: augments query
- Chat query route → Hybrid retrieval: searches evidence
- Hybrid retrieval → Query intent: detects intent
- Hybrid retrieval → Structured evidence: gets mappings
- Hybrid retrieval → Embedding service: embeds query
- Hybrid retrieval → Application database: queries chunks
- Structured evidence → Testing requirements: gets requirements
- Structured evidence → Lab ranking: ranks labs
- Chat query route → Answer generation: generates answer
- Chat query route → Answer explanation: builds explanation
- Readiness routes → Readiness assessment: assesses readiness
- Readiness assessment → Application database: reads and saves