Files
utun2/src/chat/chat_feedback.h
T

70 lines
5.6 KiB
C

/* Подписанные состояния реакций и ответов, отдельная таблица feedback_<channel>.
* Каждый (message_id, node_id, kind) хранит последнее полное состояние с ver.
* Пустое data — сохраняемая отмена. Неактивные/ожидающие авторы сохраняются в БД,
* но не входят в Merkle, выдачу и результаты. Допуск проверяет member_sync;
* интерпретацию ответа относительно опроса выполняет вызывающий модуль.
* Все операции — в uasync-потоке. init вызывается после member_sync_init;
* общий Merkle-движок освобождается member_sync_destroy.
* apply/set/приём страницы/init владеют своей BEGIN IMMEDIATE/COMMIT; внешняя транзакция запрещена.
* Запись и Merkle-индекс фиксируются вместе, уведомление — после commit. Неудачный rollback
* с открытой транзакцией запрашивает stop ядра; владелец закрывает БД вне callback. */
#ifndef CHAT_FEEDBACK_H
#define CHAT_FEEDBACK_H
#include <stdint.h>
#include <stddef.h>
struct UTUN_INSTANCE;
#ifdef __cplusplus
extern "C" {
#endif
#define CHAT_FEEDBACK_REACTION 1
#define CHAT_FEEDBACK_ANSWER 2
#define CHAT_FEEDBACK_DATA_MAX 2048
#define CHAT_MESSAGE_ID_SIZE 32
struct chat_feedback_record {
uint8_t message_id[CHAT_MESSAGE_ID_SIZE]; /* Неизменяемый ID исходного сообщения. */
uint64_t node_id; /* Автор этого состояния,1..INT64_MAX. */
uint64_t ver; /* 1..INT64_MAX; отдельная версия для каждого kind */
uint8_t kind; /* REACTION либо ANSWER. */
uint16_t data_len; /* Длина полного состояния,0 отменяет. */
uint8_t data[CHAT_FEEDBACK_DATA_MAX]; /* Канонические байты codec из chat_poll.h. */
uint8_t signature[64]; /* Ed25519 автора над domain/каналом/полями/data. */
};
/* Постоянный ID: канал, время создания, автор и случайный nonce[16]; 0/-1. Числа — BE64. */
int chat_message_id(uint64_t channel_id, uint64_t timestamp, uint64_t author, const uint8_t nonce[16], uint8_t id[32]);
/* Регистрирует FEEDBACK и восстанавливает индекс допущенных записей; 0/-1.
* Исключение или отсутствие зависимости автора не блокирует запуск и не удаляет историю. */
int chat_feedback_init(struct UTUN_INSTANCE* inst);
/* После изменения участника/его доверенного ключа пересчитать feedback автора и его
* зависимых приглашённых во всех каналах. Вызывается внутри транзакции MEMBERS;
* до регистрации FEEDBACK — no-op. 0/-1, ошибка требует rollback внешней транзакции. */
int chat_feedback_member_update(struct UTUN_INSTANCE* inst, uint64_t node_id);
/* После внешнего commit разбудить сессии и обновить затронутые результаты.
* Обработчики событий вызываются без живого SQLite cursor; до регистрации — no-op. */
void chat_feedback_member_committed(struct UTUN_INSTANCE* inst, uint64_t node_id);
/* Подготовить таблицу канала; 0/-1. Не создаёт членство или сетевую группу. */
int chat_feedback_ensure_channel(struct UTUN_INSTANCE* inst, const char* channel);
/* Прочитать сохранённое состояние, включая неактивное:1 найдено,0 отсутствует,-1 ошибка.
* out меняется только при успехе1;ошибка bind/step/finalize не считается отсутствием. */
int chat_feedback_get(struct UTUN_INSTANCE* inst, const char* channel, const uint8_t message_id[32],
uint64_t node_id, uint8_t kind, struct chat_feedback_record* out);
/* Проверить и применить подписанную запись: 1 изменилось, 0 повтор/старая/автор недоступен, -1 ошибка.
* Одинаковый ver разрешается сравнением data; подпись проверяется до сравнения. */
int chat_feedback_apply(struct UTUN_INSTANCE* inst, const char* channel, const struct chat_feedback_record* record);
/* Подписать локальное полное состояние с ver+1; NULL/0 отменяет.1/0/-1 как apply.
* Допуск/прежняя версия/подпись/запись выполняются под собственной блокировкой,включая no-op.
* out_ver необязателен,меняется только после commit. Канонический формат проверяет codec,
* семантику ответа относительно опроса проверяет вызывающий до этого вызова. */
int chat_feedback_set(struct UTUN_INSTANCE* inst, const char* channel, const uint8_t message_id[32],
uint8_t kind, const uint8_t* data, size_t len, uint64_t* out_ver);
#ifdef __cplusplus
}
#endif
#endif