rikrdo/mercadodevida
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ad040ae3a91d7cd29b46472c26660d8975ce0b20
mercadodevida/work/artifacts/F-027/documenter.md
chattie d595b4871f feat(ADM-018): completed feature
2026-08-17 22:23:10 +02:00

963 B
Raw Blame History

Documenter — F-027 Caching layer with explicit contracts

Summary

Cache module exposes a read-through wrapper, registered contracts and metrics. PostgreSQL remains the source of truth; the cache is best-effort and degrades to the loader when the adapter is unavailable.

Public API notes

Route Access Result
GET /cache/contracts admin Returns registered contracts (key, TTL, source, invalidation)
GET /cache/metrics authenticated Returns hits/misses/invalidations/hitRatio

Contracts (v1)

  • product:{slug} 300s invalidated by ProductUpdated
  • category:{slug} 300s invalidated by CategoryUpdated
  • nav:tree 600s invalidated by NavigationInvalidated
  • search:popular 60s invalidated by SearchInvalidated

Evidence

  • work/artifacts/F-027/architect.md
  • work/artifacts/F-027/implementer.md
  • work/artifacts/F-027/reviewer.json
  • work/artifacts/F-027/security.json
  • work/artifacts/F-027/qa.json