1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295
|
/*
Copyright (©) 2003-2025 Teus Benschop.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#pragma once
#include <config/libraries.h>
#include <filter/passage.h>
class Webserver_Request;
struct Database_Notes_Text
{
std::string raw {};
std::string localized {};
};
class Database_Notes
{
public:
Database_Notes (Webserver_Request& webserver_request);
private:
Webserver_Request& m_webserver_request;
public:
void create ();
private:
std::string database_path ();
std::string checksums_database_path ();
std::string main_folder_path ();
std::string note_file (int identifier);
public:
bool healthy ();
bool checksums_healthy ();
bool checkup ();
bool checkup_checksums ();
void trim ();
void trim_server ();
void optimize ();
void sync ();
public:
bool identifier_exists (int identifier);
void set_identifier (int identifier, int new_identifier);
public:
std::vector <int> get_identifiers ();
struct NewNote {
// The notes's Bible.
const std::string bible{};
// The note's passage.
const int book{0};
const int chapter{0};
const int verse{0};
// The note's summary.
const std::string summary{};
// The note's contents.
const std::string contents{};
// Import contents as it is.
const bool raw {false};
};
int store_new_note (const NewNote& new_note);
private:
int get_new_unique_identifier ();
public:
enum class PassageSelector : uint8_t {
current_verse = 0,
current_chapter = 1,
current_book = 2,
any_passage = 3
};
enum class EditSelector : uint8_t {
at_any_time = 0,
during_last_30_days = 1,
during_last_7_days = 2,
since_yesterday = 3,
today = 4,
};
enum class NonEditSelector : uint8_t {
any_time = 0,
a_day = 1,
two_days = 2,
a_week = 3,
a_month = 4,
a_year = 5,
};
enum class SeveritySelector : int8_t {
any = -1,
wish = 0,
minor = 1,
normal = 2,
important = 3,
major = 4,
critical = 5,
};
struct Selector {
// Container of Bible names that is going to be searched.
// Can contains all Bibles the user has read access to.
// Or can contain one Bible to be searched.
// If it contains no Bibles, no constraints will be applied.
std::vector<std::string> bibles{};
// Four related selectors that can limit the selection.
// By default there's no constraint set for the passage.
int book{};
int chapter{};
int verse{};
PassageSelector passage_selector{PassageSelector::any_passage};
// Optionally constrains selection based on modification time.
// By default there's no constraint on modification time.
EditSelector edit_selector{EditSelector::at_any_time};
NonEditSelector non_edit_selector{NonEditSelector::any_time};
// Optionally constrains selection based on list of note statuses.
std::vector<std::string> status_selectors;
// Optionally constrains the selection based on a note being assigned to somebody.
std::string assignment_selector{};
// Optionally limits the selection based on a note's subscription.
bool subscription_selector{false};
// Optionally limits the selection, based on a note's severity.
SeveritySelector severity_selector{SeveritySelector::any};
// Optionally limits the selection to notes that contains certain text.
// If the "search_text" is empty, it is not considered.
std::string search_text{};
// If given, it indicates the starting limit for the selection.
std::optional<int> limit{};
};
std::vector<int> select_notes (const Selector& selector);
private:
std::string notes_select_identifier ();
std::string notes_optional_fulltext_search_relevance_statement (std::string search);
std::string notes_from_where_statement ();
std::string notes_optional_fulltext_search_statement (std::string search);
std::string notes_order_by_relevance_statement ();
public:
std::string get_summary (int identifier);
void set_summary (int identifier, const std::string& summary);
private:
std::string summary_key ();
public:
std::string get_contents (int identifier);
void set_contents (int identifier, const std::string& contents);
private:
std::string contents_key ();
std::string assemble_contents (int identifier, std::string contents);
void set_raw_contents (int identifier, const std::string& contents);
public:
void erase (int identifier);
public:
void add_comment (int identifier, const std::string& comment);
public:
void subscribe (int identifier);
void unsubscribe (int identifier);
void subscribe_user (int identifier, const std::string& user);
void unsubscribe_user (int identifier, const std::string& user);
bool is_subscribed (int identifier, const std::string& user);
std::vector <std::string> get_subscribers (int identifier);
void set_subscribers (int identifier, std::vector <std::string> subscribers);
private:
std::string subscriptions_key ();
std::string get_raw_subscriptions (int identifier);
void set_raw_subscriptions (int identifier, const std::string& subscriptions);
public:
void assign_user (int identifier, const std::string& user);
bool is_assigned (int identifier, const std::string& user);
void unassign_user (int identifier, const std::string& user);
std::vector <std::string> get_all_assignees (const std::vector <std::string>& bibles);
std::vector <std::string> get_assignees (int identifier);
void set_assignees (int identifier, std::vector <std::string> assignees);
private:
std::string assigned_key ();
std::vector <std::string> get_assignees_internal (std::string assignees);
void set_raw_assigned (int identifier, const std::string& assigned);
std::string get_raw_assigned (int identifier);
public:
std::string get_bible (int identifier);
void set_bible (int identifier, const std::string& bible);
std::vector <std::string> get_all_bibles ();
private:
std::string bible_key ();
public:
std::string encode_passage (int book, int chapter, int verse);
Passage decode_passage (std::string passage);
std::string decode_passage (int identifier);
std::vector <Passage> get_passages (int identifier);
void set_passages (int identifier, const std::vector <Passage>& passages, bool import = false);
void set_raw_passage (int identifier, const std::string& passage);
void index_raw_passage (int identifier, const std::string& passage);
private:
std::string passage_key ();
std::string get_raw_passage (int identifier);
public:
std::string get_raw_status (int identifier);
std::string get_status (int identifier);
void set_status (int identifier, const std::string& status, bool import = false);
std::vector <Database_Notes_Text> get_possible_statuses ();
private:
std::string status_key ();
public:
std::string get_severity (int identifier);
int get_raw_severity (int identifier);
void set_raw_severity (int identifier, int severity);
std::vector <Database_Notes_Text> get_possible_severities ();
private:
std::string severity_key ();
std::vector <std::string> standard_severities ();
public:
int get_modified (int identifier);
void set_modified (int identifier, int time);
private:
std::string modified_key ();
void note_modified_actions (int identifier);
public:
bool get_public (int identifier);
void set_public (int identifier, bool value);
private:
std::string public_key ();
public:
std::string get_search_field (int identifier);
void update_search_fields (int identifier);
std::vector <int> search_notes (std::string search, const std::vector <std::string> & bibles);
public:
void mark_for_deletion (int identifier);
void unmark_for_deletion (int identifier);
bool is_marked_for_deletion (int identifier);
private:
std::string expiry_key ();
void touch_marked_for_deletion ();
std::vector <int> get_due_for_deletion ();
public:
void set_checksum (int identifier, const std::string & checksum);
std::string get_checksum (int identifier);
void delete_checksum (int identifier);
void update_checksum (int identifier);
std::string get_multiple_checksum (const std::vector <int> & identifiers);
std::vector <int> get_notes_in_range_for_bibles (int lowId, int highId, std::vector <std::string> bibles, bool anybible);
public:
void set_availability (bool available);
bool available ();
private:
std::string availability_flag ();
public:
std::string get_bulk (std::vector <int> identifiers);
std::vector <std::string> set_bulk (std::string json);
private:
void update_database (int identifier);
void update_database_internal (int identifier, int modified, std::string assigned, std::string subscriptions, std::string bible, std::string passage, std::string status, int severity, std::string summary, std::string contents);
private:
friend void test_database_notes ();
friend void test_indexing_fixes_damaged_note ();
private:
std::string get_field (int identifier, const std::string& key);
void set_field (int identifier, std::string key, std::string value);
};
|