Add creator docs, indexer latency logs, health timing test, and URL n…

[testersweb0-bug]

Summary

Implements four related backend improvements:

• Add docs for creator data model field definitions and constraints #357 — Adds a canonical creator data model reference doc consolidating field types, constraints, and required/optional rules from Prisma, Zod schemas, and API contracts.
• Add structured log for indexer event processing latency #354 — Adds structured info-level logging for indexer chain event processing latency, including event type, event ID, and elapsed milliseconds.
• Add integration test for health endpoint response time #356 — Adds an isolated integration test asserting the liveness health endpoint responds within a named millisecond budget.
• Add helper for normalizing creator social handle URLs before storage #355 — Adds a social link URL normalization helper applied before creator profile storage (trailing slash removal, host lowercasing, tracking query param stripping).

Changes

Documentation (#357)

• New docs/architecture/creator-data-model.md with field-level reference for persisted fields, API-only fields, write/read schemas, and known cross-layer divergences
• Cross-links added in README.md, CONTRIBUTING.md, and docs/architecture/domain-boundaries.md

Indexer latency logging (#354)

• New processIndexerChainEvent / processIndexerChainEvents utilities in src/utils/indexer-event-processor.utils.ts
• Emits one structured log per processed event: type, eventType, eventId, txHash, eventIndex, ledger, elapsedMs
• Updated docs/indexer/EVENT_PROCESSING.md with usage example and log field table

Health response time test (#356)

• New HEALTH_LIVENESS_MAX_LATENCY_MS constant in src/constants/health.constants.ts
• New isolated integration test in src/modules/health/health.response-time.integration.test.ts

Social URL normalization (#355)

• New normalizeSocialLinkUrl in src/modules/creator/creator-social-link-url.utils.ts
• Wired into UpsertCreatorProfileBodySchema (Zod transform) and upsertCreatorProfile (pre-storage normalization)

Test plan

• pnpm exec jest src/utils/indexer-event-processor.utils.test.ts
• pnpm exec jest src/modules/health/health.response-time.integration.test.ts
• pnpm exec jest src/modules/creator/creator-social-link-url.utils.test.ts
• pnpm build
• Review docs/architecture/creator-data-model.md for accuracy against live schemas

Closes #354
Closes #355
Closes #356
Closes #357

[drips-wave]

@testersweb0-bug 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