How prathmesh2028/novexa_blockchain works
KavachTrust supports defense-asset traceability from registration and evidence capture through inspections, lifecycle management, certification, and tamper-evident verification. Users work through a role-specific React application backed by a NestJS API; PostgreSQL stores application state, MinIO holds evidence files, and an outbox worker publishes blockchain events. The graph preserves the documented supply-chain, dashboard, notification, wallet, and audit capabilities. Several subsystem links are based on the README because their implementation files were not sampled.
Main entry points: app.module.ts NestJS API · routes.tsx Role-based routes · auth.service.ts Authentication · App.tsx React application
Components 30
Web application
- React application
frontend/f1/App.tsx - Role-based routes
frontend/f1/routes.tsx - Asset workflows
frontend/f1/pages/lifecycle/LifecyclePage.tsx - Certification views
frontend/f1/pages/certifications/CertificationsPage.tsx - Evidence views
frontend/f1/pages/evidence/EvidencePage.tsx - Dashboard
frontend/f1/pages/dashboard/DashboardPage.tsx - User administration
frontend/f1/pages/users/UsersPage.tsx
Identity and access
- Authentication
backend/src/identity/auth/auth.service.ts - JWT guard
backend/src/identity/auth/guards/jwt-auth.guard.ts - Casbin authorization
backend/src/identity/auth/guards/casbin.guard.ts - Policy service
backend/src/core/casbin/casbin.service.ts
Asset operations
- Asset lifecycle
backend/src/asset-management/lifecycle/lifecycle.service.ts - Inspections
backend/src/asset-management/inspections/inspections.service.ts - Technical records
backend/src/asset-management/technical-records/technical-records.service.ts - Supply chain
backend/src/supply-chain/supply-chain.service.ts
Trust and verification
- Evidence integrity
backend/src/asset-management/evidence/evidence.service.ts - Object storage
backend/src/asset-management/evidence/minio.service.ts - Audit and hash chain
backend/src/asset-management/audit/audit.service.ts - Certifications
backend/src/certification/certifications/certifications.service.ts - Verification
backend/src/verification/verification.service.ts - Blockchain adapter
backend/src/trust/blockchain/blockchain.service.ts - SBT contract interface
contracts/typechain-types/contracts/KavachTrustSBT.ts - Transactional outbox
backend/src/trust/outbox/outbox.service.ts - Outbox worker
backend/src/trust/outbox/worker.service.ts
Platform services
- NestJS API
backend/src/app.module.ts - PostgreSQL
backend/src/core/database/prisma.service.ts - Search
backend/src/search/search.service.ts - Notifications
backend/src/notifications/notifications.service.ts
Other components
- Platform users
- EVM network
Connections 31
- Platform users → React application: uses
README.md - React application → Role-based routes: renders
frontend/f1/App.tsx - Role-based routes → Asset workflows: routes to
frontend/f1/routes.tsx - Role-based routes → Certification views: routes to
frontend/f1/routes.tsx - Role-based routes → Evidence views: routes to
frontend/f1/routes.tsx - Role-based routes → Dashboard: routes to
frontend/f1/routes.tsx - Role-based routes → User administration: routes to
frontend/f1/routes.tsx - React application → NestJS API: consumes API
README.md - NestJS API → Authentication: provides authentication
- JWT guard → Authentication: validates token
backend/src/identity/auth/guards/jwt-auth.guard.ts - Casbin authorization → Policy service: checks permission
backend/src/identity/auth/guards/casbin.guard.ts - Authentication → PostgreSQL: reads and writes users
backend/src/identity/auth/auth.service.ts - Authentication → PostgreSQL: uses configuration
backend/src/identity/auth/auth.service.ts - NestJS API → Asset lifecycle: exposes workflow
- NestJS API → Inspections: exposes workflow
- NestJS API → Technical records: exposes workflow
- NestJS API → Supply chain: routes requests
- NestJS API → Evidence integrity: routes requests
- Evidence integrity → Object storage: stores files
README.md - NestJS API → Certifications: routes requests
- NestJS API → Verification: routes requests
- NestJS API → Blockchain adapter: routes requests
- NestJS API → PostgreSQL: persists domain state
README.md - NestJS API → Transactional outbox: writes events
README.md - Outbox worker → Transactional outbox: publishes pending events
README.md - Outbox worker → EVM network: publishes events
README.md - Blockchain adapter → EVM network: uses EVM
README.md - Certifications → SBT contract interface: exposes proof flow
- NestJS API → Audit and hash chain: provides audit capability
- NestJS API → Search: provides search
- NestJS API → Notifications: provides notifications