Как исключить наложение изменений документа пользователями в базе данных

Для исключения наложения изменений (race condition) в БД можно использовать:

1. Оптимистичная блокировка - версионный контроль. Перед обновлением проверяем, что версия документа не изменилась:

@Entity
public class Document {
    @Version
    private int version;
    // другие поля
}

При конфликте будет выброшено OptimisticLockException.

2. Пессимистичная блокировка - явная блокировка записи на время транзакции:

Document doc = em.find(Document.class, id, LockModeType.PESSIMISTIC_WRITE);

Блокирует запись до конца транзакции.

3. CAS (Compare-And-Swap) операции:

UPDATE documents 
SET content = 'new', version = version + 1 
WHERE id = 1 AND version = 2

Проверя affected rows, можно определить успешность операции.