feat: resolve issues #975, #981, #985, #992

[Joel234-png]

#975 [Frontend] Audit app directory routes

• Add ExperimentalBanner component for work-in-progress routes
• Add loading.tsx skeleton states to 10 async routes (blog, forum, bridge-tracker, network-streamer, mempool-auction, merkle-tree, chain-reorg, yield-calculator, webrtc, microfrontends)
• Mark webrtc and microfrontends pages with ExperimentalBanner
• Add frontend/ROUTES.md documenting all 50+ routes with status, purpose, and loading-state coverage

#981 [Observability] Distributed trace-id propagation

• Replace executionAsyncId-based correlation with AsyncLocalStorage (traceContext) for true async propagation across Promises, timers, and I/O callbacks
• requestLogger wraps every request in traceContext.run() so all downstream code (Prisma, Redis, BullMQ) inherits the traceId
• Every response gets X-Request-ID and X-Correlation-ID headers
• BullMQ webhook jobs carry traceId in job data; worker runs inside traceContext.run() for correlated job logs
• Backward-compat shims kept for existing setCorrelationId callers

#985 [Reliability] Idempotency keys for critical endpoints

• New idempotency middleware (Redis-backed, 24 h TTL, SET NX EX lock)
• Concurrent duplicate requests receive 409; replays get cached response with X-Idempotency-Replay: true header
• Applied to: POST /certificates, POST /subscriptions/plans, POST /subscriptions/subscribe, POST /enrollments, POST /webhooks/ingest, POST /webhooks/dispatch, POST /webhooks/subscriptions

#992 [Data] Soroban gradual storage migration pattern

• New contracts/src/storage_migration.rs implementing:
  • StorageVersion field in instance storage
  • Lazy migration: V1 records upgraded to V2 transparently on read
  • Eager migration: admin migrate_batch(keys) for time-sensitive changes
  • pause() / unpause() to prevent writes during batch migration
  • Migration registry (Migrated key per record)
  • Full test suite covering all paths
• Registered module in contracts/src/lib.rs
  Closes [Frontend] Audit 30+ app directory routes for completeness and remove stubs #975
  Closes [Observability-Advanced] Implement distributed trace-id propagation across backend services #981
  Closes [Reliability-Advanced] Implement idempotency keys for payment and certificate issuance endpoints #985
  Closes [Data-Advanced] Implement gradual storage migration pattern for Soroban contract upgrades #992

chore: update .gitignore

• Exclude test snapshots, playwright output, all log files, .db files, PID files, benchmarks/results, contracts/check_output

[vercel]

@Joel234-png is attempting to deploy a commit to the Ayomide Adeniran's projects Team on Vercel.

A member of the Team first needs to authorize it.

[drips-wave]

@Joel234-png Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits