temporalio / temporalio/samples-java
[Sample Request] Payment workflow with idempotency, state machine, and compensation flow
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- Java
- Estrellas
- 258
- Forks
- 189
- Merge medio
- 6 d 4 h
- PR fusionados (30 d)
- 4
Descripción
Hi, I'd like to contribute a new sample demonstrating a production-grade payment workflow pattern.
What it would cover:
- 7-state payment state machine (INITIATED → VALIDATING → PROCESSING → COMPLETED / FAILED / CANCELLED / COMPENSATING)
- Idempotency key deduplication before any state mutation
- Exponential backoff with jitter on retries
- Compensation flow as a child workflow on failure
Why it's useful:
The existing HelloSaga and MoneyTransfer samples demonstrate SAGA and basic compensation, but none show the full combination of idempotency + state machine transitions + compensation in a single cohesive example. This pattern is extremely common in fintech/payment backends.
Happy to submit a PR if this is welcome. Let me know if there's a preferred package structure or naming convention I should follow.
Guía de contribución
No hay ninguna guía de contribución indexada para este repositorio
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Empieza leyendo los ejemplos existentes HelloSaga y MoneyTransfer para entender cómo se demuestran SAGA y la compensación. Define el ejemplo en torno a los siete estados solicitados, el manejo de la idempotencia, el backoff de reintentos y la compensación de child-workflow; estará terminado cuando un único workflow de pago cohesionado demuestre los cuatro comportamientos.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- java
- Área
- backend, distributed-systems
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Estado de actividad
- Estancado
- Claridad
- Bastante claro
- Aptitud para principiantes
- 35/100