Skip to content

Bring the tutorials and the bilingual book up to date with the outbox, orchestration, webhooks and callbacks - #17

Merged
ancongui merged 19 commits into
mainfrom
docs/parity-books
Oct 13, 2026
Merged

ancongui merged 19 commits into
mainfrom
docs/parity-books

Conversation

@ancongui

Copy link
Copy Markdown
Contributor

Updates the tutorials, the site and both editions of larafly by example (English and Spanish) for everything W1, W2 and W4 shipped.

Book (EN + ES, byte-identical, provenance-checked code blocks)

  • New Chapter 8A, Webhooks and callbacks. Lumen accepts signed card top-ups and delivers signed partner callbacks.
  • New Chapter 9A, Sagas, TCC and durable workflows. The Lumen payout saga, with compensation in reverse, database checkpoints and the DLQ.
  • Chapter 7 (CQRS): caching queries with #[CachedQuery] and #[InvalidatesQuery].
  • Chapter 8 (EDA):
    • the portable database outbox and its claim strategies per server;
    • any number of consumers, and the relay;
    • eda-postgres as the LISTEN/NOTIFY optimization;
    • durable dead letters and replay;
    • Kafka and RabbitMQ messaging.
  • Chapter 12 (testing): the integration lanes (IntegrationDsn, composer test:integration, the compose file, the CI matrix, the SQL Server traps).
  • Scheduling: database and MySQL locks.
  • The glossary, Appendix A, book/README.md and both manifests are updated, and statements the program made false are fixed.

Tutorial (EN + ES)

  • Step 12 moves the greeting events onto the database outbox and delivers them with a consumer.
  • Step 13 adds a greeting-card order saga that compensates in reverse.

Both steps are proven as the reader's own App\ files under tests/Fixtures/Tutorial.

Samples

Every code listing is real code in samples/lumen, tested on every integration lane:

  • the database outbox;
  • a cached balance query;
  • webhook top-ups and partner callbacks;
  • the payout saga and its endpoint.

Verification

  • composer check: exit 0, 6535 passed.
  • bash scripts/build-docs.sh: exit 0. This covers the book tests, provenance in EN and ES, both PDF and EPUB editions, verify_pdf and mkdocs --strict.
  • Integration lanes: green.

Andres Contreras added 19 commits October 13, 2026 07:46
…NSATION_FAILED instead of the bank's refusal
…evicts it per wallet with #[InvalidatesQuery]
…any number of consumers, the relay, durable dead letters and Kafka/RabbitMQ messaging
…, durable workflows and the scheduler's lock, in both editions
…egrationDsn, the CI lanes and what SQL Server teaches
…what W1, W2 and W4 shipped, in both editions
…utbox and delivers them with a consumer, in both languages
…saga; What's Next becomes Step 14, in both languages
@ancongui
ancongui merged commit d5ff883 into main Oct 13, 2026
12 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.

1 participant