70 lines
5.6 KiB
C
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
|