route redesign + tests

lib/ll_queue.h

@@ -228,11 +228,29 @@ int queue_data_put(struct ll_queue* q, struct ll_entry* entry);
  */
 int queue_data_put_first(struct ll_queue* q, struct ll_entry* entry);
 
+/**
+ * @brief Добавляет элемент в конец очереди с явным указанием смещения индекса для hash.
+ * @param q очередь
+ * @param entry элемент
+ * @param index_offset смещение индекса (node_id) в data[]
+ * @param index_size размер индекса (8 для uint64_t node_id)
+ * @return 0 — успех, -1 — ошибка
+ */
 int queue_data_put_with_index(struct ll_queue* q, struct ll_entry* entry,
-                              uint16_t index_offset, uint16_t index_size);
+                               uint16_t index_offset, uint16_t index_size);
+
+/**
+ * @brief Добавляет элемент в начало очереди с явным указанием смещения индекса для hash.
+ * @param q очередь
+ * @param entry элемент
+ * @param index_offset смещение индекса в data[]
+ * @param index_size размер индекса
+ * @return 0 — успех, -1 — ошибка
+ */
 int queue_data_put_first_with_index(struct ll_queue* q, struct ll_entry* entry,
                                     uint16_t index_offset, uint16_t index_size);
 
+
 /**
  * @brief Извлекает элемент из начала очереди.
  * @param q очередь