Skip to content

Fix/stage consistency validation#195

Merged
Nitya-003 merged 2 commits intoNitya-003:mainfrom
navin-oss:fix/stage-consistency-validation
Mar 8, 2026
Merged

Fix/stage consistency validation#195
Nitya-003 merged 2 commits intoNitya-003:mainfrom
navin-oss:fix/stage-consistency-validation

Conversation

@navin-oss
Copy link
Contributor

centralize stage mapping and add validation to prevent blockchain sync failures

  • Add comprehensive documentation in STAGE_CONSISTENCY_GUIDE.md

    • Explains critical importance of stage consistency across layers
    • Documents the 4-stage supply chain model (farmer, mandi, transport, retailer)
    • Provides step-by-step guide for making stage changes safely
    • Lists common mistakes and troubleshooting steps
  • Enhance backend/constants/stages.js with:

    • STAGE_TO_NUMBER mapping for blockchain contract compatibility
    • getStageNumber() function for safe string-to-enum conversion
    • validateStageMapping() function to verify consistency on startup
    • Detailed JSDoc comments explaining critical dependencies
  • Update blockchainWorker.js to use centralized stage mapping:

    • Import getStageNumber() from constants/stages.js
    • Replace hardcoded stageMap with centralized function
    • Eliminates duplication and prevents drift between layers
  • Add automatic validation in server.js:

    • Run validateStageMapping() on application startup
    • Exit immediately with clear error if mismatch detected
    • Prevents blockchain sync failures due to configuration errors

This ensures that any future changes to stages will be caught at startup
before they can cause blockchain synchronization issues or data corruption.

… missing batch controller functions

- Fix nonce validation in walletLogin and walletRegister to prevent replay attacks
  * Always require stored nonce instead of falling back to constant string
  * Return 401 error if no nonce exists for the address
- Add missing controller functions to batchController.js:
  * createBatch - handles batch creation with transaction support
  * getBatch - retrieves single batch by ID
  * getAllBatches - alias for getBatches (consistency)
  * updateBatch - handles batch updates with stage transitions
  * recallBatch - admin-only batch recall functionality
- These functions prevent future import errors if routes are extracted from server.js
…in sync failures

- Add comprehensive documentation in STAGE_CONSISTENCY_GUIDE.md
  * Explains critical importance of stage consistency across layers
  * Documents the 4-stage supply chain model (farmer, mandi, transport, retailer)
  * Provides step-by-step guide for making stage changes safely
  * Lists common mistakes and troubleshooting steps

- Enhance backend/constants/stages.js with:
  * STAGE_TO_NUMBER mapping for blockchain contract compatibility
  * getStageNumber() function for safe string-to-enum conversion
  * validateStageMapping() function to verify consistency on startup
  * Detailed JSDoc comments explaining critical dependencies

- Update blockchainWorker.js to use centralized stage mapping:
  * Import getStageNumber() from constants/stages.js
  * Replace hardcoded stageMap with centralized function
  * Eliminates duplication and prevents drift between layers

- Add automatic validation in server.js:
  * Run validateStageMapping() on application startup
  * Exit immediately with clear error if mismatch detected
  * Prevents blockchain sync failures due to configuration errors

This ensures that any future changes to stages will be caught at startup
before they can cause blockchain synchronization issues or data corruption.
@netlify
Copy link

netlify bot commented Mar 8, 2026

Deploy Preview for roaring-ganache-c7465f failed. Why did it fail? →

Name Link
🔨 Latest commit 7ee8a7f
🔍 Latest deploy log https://app.netlify.com/projects/roaring-ganache-c7465f/deploys/69ad7373059760000826054c

@Nitya-003 Nitya-003 merged commit 7ee8a7f into Nitya-003:main Mar 8, 2026
0 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants