How ahmedrumi/parikkhachain works
ParikkhaChain is a blockchain-backed examination and result-verification application. In the main user workflow, role-selected users use the portal to manage exams, submit and review marks, handle scrutiny or student rescrutiny, and inspect results; contract calls and events run through the browser’s chain adapter to the local Ganache network. Separate Python workflow tooling automates a demo lifecycle and applies grading rules. The tree documents additional audit, hash-registry and ZKP contracts, but their detailed runtime links are not established by the excerpts; arrows are limited to evidenced relationships.
Main entry points: contracts.js Contract adapter · App.jsx Role portal · useChain.js Account and role state · admin Admin controls
Components 23
Role Portal
- Role portal
frontend/src/App.jsx - Account and role state
frontend/src/hooks/useChain.js - Admin controls
frontend/src/components/pages/admin - Examiner workflow
frontend/src/components/pages/ExaminerPage.jsx - Scrutiny workflow
frontend/src/components/pages/ScrutinizerPage.jsx - Student results
frontend/src/components/pages/StudentPage.jsx - Event feed
frontend/src/components/EventFeed.jsx - Transaction forms
frontend/src/components/ui.jsx
Chain Access
- Contract adapter
frontend/src/chain/contracts.js - RPC provider
frontend/src/chain/provider.js
Exam Lifecycle
- Role access
contracts/RBAC.sol - Exam lifecycle
contracts/ExamLifecycle.sol - Result audit
contracts/ResultAudit.sol - Script hash registry
contracts/Hashregistry.sol - Rescrutiny
contracts/Rescrutiny.sol - ZKP contract
contracts/zkp.sol
Python Tools
- Lifecycle automation
scripts/workflow.py - Web3 interface
scripts/blockchain_interface.py - Grading rules
scripts/grading_rules.py - Transcript PDF
scripts/generate_transcript_pdf.py - Contract configuration
scripts/contract_config.py
Other components
- Exam participants
- Ganache chain
Connections 30
- Exam participants → Role portal: uses
frontend/src/App.jsx - Role portal → Account and role state: loads state
frontend/src/App.jsx - Role portal → Admin controls: routes admin
frontend/src/App.jsx - Role portal → Examiner workflow: routes examiner
frontend/src/App.jsx - Role portal → Scrutiny workflow: routes scrutinizer
frontend/src/App.jsx - Role portal → Student results: routes student
frontend/src/App.jsx - Role portal → Event feed: renders
frontend/src/App.jsx - Account and role state → RPC provider: gets accounts
frontend/src/hooks/useChain.js - Account and role state → Contract adapter: reads role
frontend/src/hooks/useChain.js - Admin controls → Contract adapter: reads and writes
frontend/src/components/pages/admin/ExamsTab.jsx - Examiner workflow → Contract adapter: reads and writes
frontend/src/components/pages/ExaminerPage.jsx - Scrutiny workflow → Contract adapter: reads and writes
frontend/src/components/pages/ScrutinizerPage.jsx - Student results → Contract adapter: reads and writes
frontend/src/components/pages/StudentPage.jsx - Admin controls → Transaction forms: uses forms
frontend/src/components/pages/admin/ExamsTab.jsx - Scrutiny workflow → Transaction forms: uses forms
frontend/src/components/pages/ScrutinizerPage.jsx - Student results → Transaction forms: sends transactions
frontend/src/components/pages/StudentPage.jsx - Event feed → Contract adapter: reads events
frontend/src/components/EventFeed.jsx - Contract adapter → RPC provider: gets provider
frontend/src/chain/contracts.js - RPC provider → Ganache chain: JSON-RPC
frontend/src/chain/provider.js - Contract adapter → Role access: binds ABI
frontend/src/chain/contracts.js - Contract adapter → Exam lifecycle: binds ABI
frontend/src/chain/contracts.js - Contract adapter → Result audit: binds ABI
frontend/src/chain/contracts.js - Contract adapter → Script hash registry: binds ABI
frontend/src/chain/contracts.js - Contract adapter → Rescrutiny: binds ABI
frontend/src/chain/contracts.js - Lifecycle automation → Web3 interface: runs lifecycle
scripts/workflow.py - Web3 interface → Contract configuration: loads settings
scripts/blockchain_interface.py - Lifecycle automation → Grading rules: applies grading
scripts/workflow.py - Web3 interface → Ganache chain: Web3 transactions
- Transcript PDF → Grading rules: uses rules
scripts/generate_transcript_pdf.py - ZKP contract → Ganache chain: deployed contract