+
+
+
-
- Calendink Provider 🚀🚀👑
+ESP32-S3 System Dashboard v{__APP_VERSION__}
+ + +
+ {#if status === "loading"}
+
+
+
+ Connecting...
+
+ {:else if status === "ok"}
+
+
+ Connected
+
+ {:else if status === "rebooting"}
+
+
+ Rebooting...
+
+ {:else}
+
+
+ Offline — {errorMsg}
+
+ {/if}
-
-
- - Partition Table -
- Flash: 16MB -
- {#if status === "loading"}
-
Loading memory layout...
- {:else}
- {#each otaStatus.partitions as part}
-
-
- >}
+ */
+export async function getUsers() {
+ const res = await fetch(`${API_BASE}/api/users`);
+ if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+ return res.json();
+}
+
+/**
+ * Create a new user.
+ * @param {string} name
+ * @returns {Promise<{id: number, name: string}>}
+ */
+export async function addUser(name) {
+ const res = await fetch(`${API_BASE}/api/users`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ name })
+ });
+ if (!res.ok) {
+ const errorText = await res.text();
+ throw new Error(`Failed (${res.status}): ${errorText || res.statusText}`);
+ }
+ return res.json();
+}
+
+/**
+ * Delete a user and all their tasks.
+ * @param {number} id
+ * @returns {Promise<{status: string}>}
+ */
+export async function removeUser(id) {
+ const res = await fetch(`${API_BASE}/api/users?id=${id}`, {
+ method: 'DELETE'
+ });
+ if (!res.ok) {
+ const errorText = await res.text();
+ throw new Error(`Failed (${res.status}): ${errorText || res.statusText}`);
+ }
+ return res.json();
+}
+
+// ─── Task Management ─────────────────────────────────────────────────────────
+
+/**
+ * Fetch tasks for a specific user.
+ * @param {number} userId
+ * @returns {Promise>}
+ */
+export async function getTasks(userId) {
+ const res = await fetch(`${API_BASE}/api/tasks?user_id=${userId}`);
+ if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+ return res.json();
+}
+
+/**
+ * Fetch top 3 upcoming tasks per user (for Dashboard).
+ * @returns {Promise<{users: Array<{id: number, name: string, tasks: Array}>}>}
+ */
+export async function getUpcomingTasks() {
+ const res = await fetch(`${API_BASE}/api/tasks/upcoming`);
+ if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+ return res.json();
+}
+
+/**
+ * Create a new task.
+ * @param {number} userId
+ * @param {string} title
+ * @param {number} dueDate Unix timestamp in seconds
+ * @returns {Promise<{id: number, user_id: number, title: string, due_date: number, completed: boolean}>}
+ */
+export async function addTask(userId, title, dueDate) {
+ const res = await fetch(`${API_BASE}/api/tasks`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ user_id: userId, title, due_date: dueDate })
+ });
+ if (!res.ok) {
+ const errorText = await res.text();
+ throw new Error(`Failed (${res.status}): ${errorText || res.statusText}`);
+ }
+ return res.json();
+}
+
+/**
+ * Update a task (partial update — only include fields you want to change).
+ * @param {number} id
+ * @param {Object} fields - { title?: string, due_date?: number, completed?: boolean }
+ * @returns {Promise<{status: string}>}
+ */
+export async function updateTask(id, fields) {
+ const res = await fetch(`${API_BASE}/api/tasks/update`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ id, ...fields })
+ });
+ if (!res.ok) {
+ const errorText = await res.text();
+ throw new Error(`Failed (${res.status}): ${errorText || res.statusText}`);
+ }
+ return res.json();
+}
+
+/**
+ * Delete a task.
+ * @param {number} id
+ * @returns {Promise<{status: string}>}
+ */
+export async function deleteTask(id) {
+ const res = await fetch(`${API_BASE}/api/tasks?id=${id}`, {
+ method: 'DELETE'
+ });
+ if (!res.ok) {
+ const errorText = await res.text();
+ throw new Error(`Failed (${res.status}): ${errorText || res.statusText}`);
+ }
+ return res.json();
+}
diff --git a/Provider/main/CMakeLists.txt b/Provider/main/CMakeLists.txt
index f7d65df..9b3debf 100644
--- a/Provider/main/CMakeLists.txt
+++ b/Provider/main/CMakeLists.txt
@@ -2,7 +2,7 @@ idf_component_register(SRCS "main.cpp"
# Needed as we use minimal build
PRIV_REQUIRES esp_http_server esp_eth
esp_wifi nvs_flash esp_netif vfs
- json app_update esp_timer
+ json app_update esp_timer esp_psram
INCLUDE_DIRS ".")
if(CONFIG_CALENDINK_DEPLOY_WEB_PAGES)
diff --git a/Provider/main/api/tasks/add.cpp b/Provider/main/api/tasks/add.cpp
new file mode 100644
index 0000000..105f8f3
--- /dev/null
+++ b/Provider/main/api/tasks/add.cpp
@@ -0,0 +1,76 @@
+// POST /api/tasks — Create a new task
+// Body: {"user_id":1, "title":"...", "due_date":1741369200}
+
+#include "cJSON.h"
+#include "esp_http_server.h"
+
+#include "todo.hpp"
+#include "types.hpp"
+
+internal esp_err_t api_tasks_post_handler(httpd_req_t *req)
+{
+ httpd_resp_set_type(req, "application/json");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
+
+ char buf[256];
+ int received = httpd_req_recv(req, buf, sizeof(buf) - 1);
+ if (received <= 0)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Empty body");
+ return ESP_FAIL;
+ }
+ buf[received] = '\0';
+
+ cJSON *body = cJSON_Parse(buf);
+ if (!body)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Invalid JSON");
+ return ESP_FAIL;
+ }
+
+ cJSON *user_id_item = cJSON_GetObjectItem(body, "user_id");
+ cJSON *title_item = cJSON_GetObjectItem(body, "title");
+ cJSON *due_date_item = cJSON_GetObjectItem(body, "due_date");
+
+ if (!cJSON_IsNumber(user_id_item) || !cJSON_IsString(title_item) ||
+ !cJSON_IsNumber(due_date_item))
+ {
+ cJSON_Delete(body);
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST,
+ "Missing user_id, title, or due_date");
+ return ESP_FAIL;
+ }
+
+ task_t *task =
+ add_task((uint8)user_id_item->valueint, title_item->valuestring,
+ (int64)due_date_item->valuedouble);
+ cJSON_Delete(body);
+
+ if (!task)
+ {
+ httpd_resp_send_err(req, HTTPD_500_INTERNAL_SERVER_ERROR,
+ "Task limit reached or invalid user");
+ return ESP_FAIL;
+ }
+
+ cJSON *resp = cJSON_CreateObject();
+ cJSON_AddNumberToObject(resp, "id", task->id);
+ cJSON_AddNumberToObject(resp, "user_id", task->user_id);
+ cJSON_AddStringToObject(resp, "title", task->title);
+ cJSON_AddNumberToObject(resp, "due_date", (double)task->due_date);
+ cJSON_AddBoolToObject(resp, "completed", task->completed);
+
+ const char *json = cJSON_PrintUnformatted(resp);
+ httpd_resp_sendstr(req, json);
+
+ free((void *)json);
+ cJSON_Delete(resp);
+
+ return ESP_OK;
+}
+
+internal const httpd_uri_t api_tasks_post_uri = {.uri = "/api/tasks",
+ .method = HTTP_POST,
+ .handler =
+ api_tasks_post_handler,
+ .user_ctx = NULL};
diff --git a/Provider/main/api/tasks/list.cpp b/Provider/main/api/tasks/list.cpp
new file mode 100644
index 0000000..8104981
--- /dev/null
+++ b/Provider/main/api/tasks/list.cpp
@@ -0,0 +1,62 @@
+// GET /api/tasks?user_id=N — List tasks for a specific user
+
+#include "cJSON.h"
+#include "esp_http_server.h"
+
+#include "todo.hpp"
+#include "types.hpp"
+
+internal esp_err_t api_tasks_get_handler(httpd_req_t *req)
+{
+ httpd_resp_set_type(req, "application/json");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
+
+ char query[64] = {};
+ if (httpd_req_get_url_query_str(req, query, sizeof(query)) != ESP_OK)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST,
+ "Missing query param 'user_id'");
+ return ESP_FAIL;
+ }
+
+ char user_id_str[8] = {};
+ if (httpd_query_key_value(query, "user_id", user_id_str,
+ sizeof(user_id_str)) != ESP_OK)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST,
+ "Missing query param 'user_id'");
+ return ESP_FAIL;
+ }
+
+ uint8 user_id = (uint8)atoi(user_id_str);
+
+ cJSON *arr = cJSON_CreateArray();
+
+ for (int i = 0; i < MAX_TASKS; i++)
+ {
+ if (g_Tasks[i].active && g_Tasks[i].user_id == user_id)
+ {
+ cJSON *obj = cJSON_CreateObject();
+ cJSON_AddNumberToObject(obj, "id", g_Tasks[i].id);
+ cJSON_AddNumberToObject(obj, "user_id", g_Tasks[i].user_id);
+ cJSON_AddStringToObject(obj, "title", g_Tasks[i].title);
+ cJSON_AddNumberToObject(obj, "due_date", (double)g_Tasks[i].due_date);
+ cJSON_AddBoolToObject(obj, "completed", g_Tasks[i].completed);
+ cJSON_AddItemToArray(arr, obj);
+ }
+ }
+
+ const char *json = cJSON_PrintUnformatted(arr);
+ httpd_resp_sendstr(req, json);
+
+ free((void *)json);
+ cJSON_Delete(arr);
+
+ return ESP_OK;
+}
+
+internal const httpd_uri_t api_tasks_get_uri = {.uri = "/api/tasks",
+ .method = HTTP_GET,
+ .handler =
+ api_tasks_get_handler,
+ .user_ctx = NULL};
diff --git a/Provider/main/api/tasks/remove.cpp b/Provider/main/api/tasks/remove.cpp
new file mode 100644
index 0000000..341eb56
--- /dev/null
+++ b/Provider/main/api/tasks/remove.cpp
@@ -0,0 +1,42 @@
+// DELETE /api/tasks?id=N — Delete a task
+
+#include "esp_http_server.h"
+
+#include "types.hpp"
+
+internal esp_err_t api_tasks_delete_handler(httpd_req_t *req)
+{
+ httpd_resp_set_type(req, "application/json");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
+
+ char query[32] = {};
+ if (httpd_req_get_url_query_str(req, query, sizeof(query)) != ESP_OK)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Missing query param 'id'");
+ return ESP_FAIL;
+ }
+
+ char id_str[8] = {};
+ if (httpd_query_key_value(query, "id", id_str, sizeof(id_str)) != ESP_OK)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Missing query param 'id'");
+ return ESP_FAIL;
+ }
+
+ uint16 id = (uint16)atoi(id_str);
+
+ if (!remove_task(id))
+ {
+ httpd_resp_send_err(req, HTTPD_404_NOT_FOUND, "Task not found");
+ return ESP_FAIL;
+ }
+
+ httpd_resp_sendstr(req, "{\"status\":\"ok\"}");
+ return ESP_OK;
+}
+
+internal const httpd_uri_t api_tasks_delete_uri = {.uri = "/api/tasks",
+ .method = HTTP_DELETE,
+ .handler =
+ api_tasks_delete_handler,
+ .user_ctx = NULL};
diff --git a/Provider/main/api/tasks/store.cpp b/Provider/main/api/tasks/store.cpp
new file mode 100644
index 0000000..edd6f06
--- /dev/null
+++ b/Provider/main/api/tasks/store.cpp
@@ -0,0 +1,111 @@
+// Task data store: CRUD helpers, sorting, and seed data
+
+#include "esp_timer.h"
+
+#include "api/tasks/store.hpp"
+#include "api/users/store.hpp"
+
+// Find a task by ID, returns nullptr if not found
+internal task_t *find_task(uint16 id)
+{
+ for (int i = 0; i < MAX_TASKS; i++)
+ {
+ if (g_Tasks[i].active && g_Tasks[i].id == id)
+ {
+ return &g_Tasks[i];
+ }
+ }
+ return nullptr;
+}
+
+// Add a task, returns pointer to new task or nullptr if full
+internal task_t *add_task(uint8 user_id, const char *title, int64 due_date)
+{
+ // Verify user exists
+ if (find_user(user_id) == nullptr)
+ {
+ return nullptr;
+ }
+
+ for (int i = 0; i < MAX_TASKS; i++)
+ {
+ if (!g_Tasks[i].active)
+ {
+ g_Tasks[i].id = g_NextTaskId++;
+ g_Tasks[i].user_id = user_id;
+ strlcpy(g_Tasks[i].title, title, sizeof(g_Tasks[i].title));
+ g_Tasks[i].due_date = due_date;
+ g_Tasks[i].completed = false;
+ g_Tasks[i].active = true;
+ return &g_Tasks[i];
+ }
+ }
+ return nullptr;
+}
+
+// Remove a task by ID, returns true if found and removed
+internal bool remove_task(uint16 id)
+{
+ for (int i = 0; i < MAX_TASKS; i++)
+ {
+ if (g_Tasks[i].active && g_Tasks[i].id == id)
+ {
+ g_Tasks[i].active = false;
+ g_Tasks[i].id = 0;
+ return true;
+ }
+ }
+ return false;
+}
+
+// Remove all tasks belonging to a user
+internal void remove_tasks_for_user(uint8 user_id)
+{
+ for (int i = 0; i < MAX_TASKS; i++)
+ {
+ if (g_Tasks[i].active && g_Tasks[i].user_id == user_id)
+ {
+ g_Tasks[i].active = false;
+ g_Tasks[i].id = 0;
+ }
+ }
+}
+
+// Simple insertion sort for small arrays — sort task pointers by due_date
+// ascending
+internal void sort_tasks_by_due_date(task_t **arr, int count)
+{
+ for (int i = 1; i < count; i++)
+ {
+ task_t *key = arr[i];
+ int j = i - 1;
+ while (j >= 0 && arr[j]->due_date > key->due_date)
+ {
+ arr[j + 1] = arr[j];
+ j--;
+ }
+ arr[j + 1] = key;
+ }
+}
+
+// Populate dummy tasks on boot for development iteration.
+// Uses relative offsets from current time so due dates always make sense.
+internal void seed_tasks()
+{
+ int64 now = (int64)(esp_timer_get_time() / 1000000);
+
+ // Alice's tasks (user_id = 1)
+ add_task(1, "Buy groceries", now + 86400); // +1 day
+ add_task(1, "Review PR #42", now + 3600); // +1 hour
+ add_task(1, "Book dentist appointment", now + 172800); // +2 days
+ add_task(1, "Update resume", now + 604800); // +7 days
+
+ // Bob's tasks (user_id = 2)
+ add_task(2, "Fix login bug", now + 7200); // +2 hours
+ add_task(2, "Deploy staging", now + 43200); // +12 hours
+ add_task(2, "Write unit tests", now + 259200); // +3 days
+
+ // Charlie's tasks (user_id = 3)
+ add_task(3, "Water plants", now + 1800); // +30 min
+ add_task(3, "Call plumber", now + 86400); // +1 day
+}
diff --git a/Provider/main/api/tasks/store.hpp b/Provider/main/api/tasks/store.hpp
new file mode 100644
index 0000000..a900661
--- /dev/null
+++ b/Provider/main/api/tasks/store.hpp
@@ -0,0 +1,12 @@
+#pragma once
+
+#include "todo.hpp"
+#include "types.hpp"
+
+// Data store operations for tasks
+internal task_t *find_task(uint16 id);
+internal task_t *add_task(uint8 user_id, const char *title, int64 due_date);
+internal bool remove_task(uint16 id);
+internal void remove_tasks_for_user(uint8 user_id);
+internal void sort_tasks_by_due_date(task_t **arr, int count);
+internal void seed_tasks();
diff --git a/Provider/main/api/tasks/unity.cpp b/Provider/main/api/tasks/unity.cpp
new file mode 100644
index 0000000..6c44cfa
--- /dev/null
+++ b/Provider/main/api/tasks/unity.cpp
@@ -0,0 +1,8 @@
+// clang-format off
+#include "api/tasks/store.cpp"
+#include "api/tasks/add.cpp"
+#include "api/tasks/list.cpp"
+#include "api/tasks/remove.cpp"
+#include "api/tasks/upcoming.cpp"
+#include "api/tasks/update.cpp"
+// clang-format on
\ No newline at end of file
diff --git a/Provider/main/api/tasks/upcoming.cpp b/Provider/main/api/tasks/upcoming.cpp
new file mode 100644
index 0000000..4c4e74b
--- /dev/null
+++ b/Provider/main/api/tasks/upcoming.cpp
@@ -0,0 +1,72 @@
+// GET /api/tasks/upcoming — Top 3 upcoming tasks per user (for Dashboard)
+
+#include "cJSON.h"
+#include "esp_http_server.h"
+
+#include "todo.hpp"
+#include "types.hpp"
+
+internal esp_err_t api_tasks_upcoming_handler(httpd_req_t *req)
+{
+ httpd_resp_set_type(req, "application/json");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
+
+ cJSON *root = cJSON_CreateObject();
+ cJSON *users_arr = cJSON_AddArrayToObject(root, "users");
+
+ for (int u = 0; u < MAX_USERS; u++)
+ {
+ if (!g_Users[u].active)
+ continue;
+
+ // Collect incomplete tasks for this user
+ task_t *user_tasks[MAX_TASKS];
+ int count = 0;
+
+ for (int t = 0; t < MAX_TASKS; t++)
+ {
+ if (g_Tasks[t].active && g_Tasks[t].user_id == g_Users[u].id &&
+ !g_Tasks[t].completed)
+ {
+ user_tasks[count++] = &g_Tasks[t];
+ }
+ }
+
+ // Sort by due_date ascending
+ sort_tasks_by_due_date(user_tasks, count);
+
+ // Build user object with top 3
+ cJSON *user_obj = cJSON_CreateObject();
+ cJSON_AddNumberToObject(user_obj, "id", g_Users[u].id);
+ cJSON_AddStringToObject(user_obj, "name", g_Users[u].name);
+
+ cJSON *tasks_arr = cJSON_AddArrayToObject(user_obj, "tasks");
+ int limit = count < 3 ? count : 3;
+ for (int i = 0; i < limit; i++)
+ {
+ cJSON *t_obj = cJSON_CreateObject();
+ cJSON_AddNumberToObject(t_obj, "id", user_tasks[i]->id);
+ cJSON_AddStringToObject(t_obj, "title", user_tasks[i]->title);
+ cJSON_AddNumberToObject(t_obj, "due_date",
+ (double)user_tasks[i]->due_date);
+ cJSON_AddBoolToObject(t_obj, "completed", user_tasks[i]->completed);
+ cJSON_AddItemToArray(tasks_arr, t_obj);
+ }
+
+ cJSON_AddItemToArray(users_arr, user_obj);
+ }
+
+ const char *json = cJSON_PrintUnformatted(root);
+ httpd_resp_sendstr(req, json);
+
+ free((void *)json);
+ cJSON_Delete(root);
+
+ return ESP_OK;
+}
+
+internal const httpd_uri_t api_tasks_upcoming_uri = {
+ .uri = "/api/tasks/upcoming",
+ .method = HTTP_GET,
+ .handler = api_tasks_upcoming_handler,
+ .user_ctx = NULL};
diff --git a/Provider/main/api/tasks/update.cpp b/Provider/main/api/tasks/update.cpp
new file mode 100644
index 0000000..6ef59ce
--- /dev/null
+++ b/Provider/main/api/tasks/update.cpp
@@ -0,0 +1,77 @@
+// POST /api/tasks/update — Modify a task
+// Body: {"id":1, "title":"...", "due_date":..., "completed":true}
+// All fields except "id" are optional
+
+#include "cJSON.h"
+#include "esp_http_server.h"
+
+#include "todo.hpp"
+#include "types.hpp"
+
+internal esp_err_t api_tasks_update_handler(httpd_req_t *req)
+{
+ httpd_resp_set_type(req, "application/json");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
+
+ char buf[256];
+ int received = httpd_req_recv(req, buf, sizeof(buf) - 1);
+ if (received <= 0)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Empty body");
+ return ESP_FAIL;
+ }
+ buf[received] = '\0';
+
+ cJSON *body = cJSON_Parse(buf);
+ if (!body)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Invalid JSON");
+ return ESP_FAIL;
+ }
+
+ cJSON *id_item = cJSON_GetObjectItem(body, "id");
+ if (!cJSON_IsNumber(id_item))
+ {
+ cJSON_Delete(body);
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Missing 'id'");
+ return ESP_FAIL;
+ }
+
+ task_t *task = find_task((uint16)id_item->valueint);
+ if (!task)
+ {
+ cJSON_Delete(body);
+ httpd_resp_send_err(req, HTTPD_404_NOT_FOUND, "Task not found");
+ return ESP_FAIL;
+ }
+
+ // Update fields if present
+ cJSON *title_item = cJSON_GetObjectItem(body, "title");
+ if (cJSON_IsString(title_item))
+ {
+ strlcpy(task->title, title_item->valuestring, sizeof(task->title));
+ }
+
+ cJSON *due_date_item = cJSON_GetObjectItem(body, "due_date");
+ if (cJSON_IsNumber(due_date_item))
+ {
+ task->due_date = (int64)due_date_item->valuedouble;
+ }
+
+ cJSON *completed_item = cJSON_GetObjectItem(body, "completed");
+ if (cJSON_IsBool(completed_item))
+ {
+ task->completed = cJSON_IsTrue(completed_item);
+ }
+
+ cJSON_Delete(body);
+
+ httpd_resp_sendstr(req, "{\"status\":\"ok\"}");
+ return ESP_OK;
+}
+
+internal const httpd_uri_t api_tasks_update_uri = {.uri = "/api/tasks/update",
+ .method = HTTP_POST,
+ .handler =
+ api_tasks_update_handler,
+ .user_ctx = NULL};
diff --git a/Provider/main/api/users/add.cpp b/Provider/main/api/users/add.cpp
new file mode 100644
index 0000000..8cedea5
--- /dev/null
+++ b/Provider/main/api/users/add.cpp
@@ -0,0 +1,67 @@
+// POST /api/users — Create a new user
+// Body: {"name": "Alice"}
+
+#include "cJSON.h"
+#include "esp_http_server.h"
+
+#include "types.hpp"
+#include "user.hpp"
+
+
+internal esp_err_t api_users_post_handler(httpd_req_t *req)
+{
+ httpd_resp_set_type(req, "application/json");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
+
+ char buf[128];
+ int received = httpd_req_recv(req, buf, sizeof(buf) - 1);
+ if (received <= 0)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Empty body");
+ return ESP_FAIL;
+ }
+ buf[received] = '\0';
+
+ cJSON *body = cJSON_Parse(buf);
+ if (!body)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Invalid JSON");
+ return ESP_FAIL;
+ }
+
+ cJSON *name_item = cJSON_GetObjectItem(body, "name");
+ if (!cJSON_IsString(name_item) || strlen(name_item->valuestring) == 0)
+ {
+ cJSON_Delete(body);
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Missing 'name'");
+ return ESP_FAIL;
+ }
+
+ user_t *user = add_user(name_item->valuestring);
+ cJSON_Delete(body);
+
+ if (!user)
+ {
+ httpd_resp_send_err(req, HTTPD_500_INTERNAL_SERVER_ERROR,
+ "User limit reached");
+ return ESP_FAIL;
+ }
+
+ cJSON *resp = cJSON_CreateObject();
+ cJSON_AddNumberToObject(resp, "id", user->id);
+ cJSON_AddStringToObject(resp, "name", user->name);
+
+ const char *json = cJSON_PrintUnformatted(resp);
+ httpd_resp_sendstr(req, json);
+
+ free((void *)json);
+ cJSON_Delete(resp);
+
+ return ESP_OK;
+}
+
+internal const httpd_uri_t api_users_post_uri = {.uri = "/api/users",
+ .method = HTTP_POST,
+ .handler =
+ api_users_post_handler,
+ .user_ctx = NULL};
diff --git a/Provider/main/api/users/list.cpp b/Provider/main/api/users/list.cpp
new file mode 100644
index 0000000..6ac59c5
--- /dev/null
+++ b/Provider/main/api/users/list.cpp
@@ -0,0 +1,41 @@
+// GET /api/users — List all active users
+
+#include "cJSON.h"
+#include "esp_http_server.h"
+
+#include "types.hpp"
+#include "user.hpp"
+
+
+internal esp_err_t api_users_get_handler(httpd_req_t *req)
+{
+ httpd_resp_set_type(req, "application/json");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
+
+ cJSON *arr = cJSON_CreateArray();
+
+ for (int i = 0; i < MAX_USERS; i++)
+ {
+ if (g_Users[i].active)
+ {
+ cJSON *obj = cJSON_CreateObject();
+ cJSON_AddNumberToObject(obj, "id", g_Users[i].id);
+ cJSON_AddStringToObject(obj, "name", g_Users[i].name);
+ cJSON_AddItemToArray(arr, obj);
+ }
+ }
+
+ const char *json = cJSON_PrintUnformatted(arr);
+ httpd_resp_sendstr(req, json);
+
+ free((void *)json);
+ cJSON_Delete(arr);
+
+ return ESP_OK;
+}
+
+internal const httpd_uri_t api_users_get_uri = {.uri = "/api/users",
+ .method = HTTP_GET,
+ .handler =
+ api_users_get_handler,
+ .user_ctx = NULL};
diff --git a/Provider/main/api/users/remove.cpp b/Provider/main/api/users/remove.cpp
new file mode 100644
index 0000000..7cb7da6
--- /dev/null
+++ b/Provider/main/api/users/remove.cpp
@@ -0,0 +1,47 @@
+// DELETE /api/users?id=N — Delete a user and cascade-delete their tasks
+
+#include "esp_http_server.h"
+
+#include "api/tasks/store.hpp"
+#include "api/users/store.hpp"
+#include "types.hpp"
+
+internal esp_err_t api_users_delete_handler(httpd_req_t *req)
+{
+ httpd_resp_set_type(req, "application/json");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
+
+ char query[32] = {};
+ if (httpd_req_get_url_query_str(req, query, sizeof(query)) != ESP_OK)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Missing query param 'id'");
+ return ESP_FAIL;
+ }
+
+ char id_str[8] = {};
+ if (httpd_query_key_value(query, "id", id_str, sizeof(id_str)) != ESP_OK)
+ {
+ httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST, "Missing query param 'id'");
+ return ESP_FAIL;
+ }
+
+ uint8 id = (uint8)atoi(id_str);
+
+ // Cascade: remove all tasks belonging to this user
+ remove_tasks_for_user(id);
+
+ if (!remove_user(id))
+ {
+ httpd_resp_send_err(req, HTTPD_404_NOT_FOUND, "User not found");
+ return ESP_FAIL;
+ }
+
+ httpd_resp_sendstr(req, "{\"status\":\"ok\"}");
+ return ESP_OK;
+}
+
+internal const httpd_uri_t api_users_delete_uri = {.uri = "/api/users",
+ .method = HTTP_DELETE,
+ .handler =
+ api_users_delete_handler,
+ .user_ctx = NULL};
diff --git a/Provider/main/api/users/store.cpp b/Provider/main/api/users/store.cpp
new file mode 100644
index 0000000..a49ce71
--- /dev/null
+++ b/Provider/main/api/users/store.cpp
@@ -0,0 +1,56 @@
+// User data store: CRUD helpers and seed data
+
+#include "api/users/store.hpp"
+
+// Find a user by ID, returns nullptr if not found
+internal user_t *find_user(uint8 id)
+{
+ for (int i = 0; i < MAX_USERS; i++)
+ {
+ if (g_Users[i].active && g_Users[i].id == id)
+ {
+ return &g_Users[i];
+ }
+ }
+ return nullptr;
+}
+
+// Add a user, returns pointer to new user or nullptr if full
+internal user_t *add_user(const char *name)
+{
+ for (int i = 0; i < MAX_USERS; i++)
+ {
+ if (!g_Users[i].active)
+ {
+ g_Users[i].id = g_NextUserId++;
+ strlcpy(g_Users[i].name, name, sizeof(g_Users[i].name));
+ g_Users[i].active = true;
+ return &g_Users[i];
+ }
+ }
+ return nullptr;
+}
+
+// Remove a user by ID, returns true if found and removed
+internal bool remove_user(uint8 id)
+{
+ for (int i = 0; i < MAX_USERS; i++)
+ {
+ if (g_Users[i].active && g_Users[i].id == id)
+ {
+ g_Users[i].active = false;
+ g_Users[i].id = 0;
+ g_Users[i].name[0] = '\0';
+ return true;
+ }
+ }
+ return false;
+}
+
+// Populate dummy users on boot for development iteration
+internal void seed_users()
+{
+ add_user("Alice");
+ add_user("Bob");
+ add_user("Charlie");
+}
diff --git a/Provider/main/api/users/store.hpp b/Provider/main/api/users/store.hpp
new file mode 100644
index 0000000..63ce26f
--- /dev/null
+++ b/Provider/main/api/users/store.hpp
@@ -0,0 +1,11 @@
+#pragma once
+
+#include "types.hpp"
+#include "user.hpp"
+
+
+// Data store operations for users
+internal user_t *find_user(uint8 id);
+internal user_t *add_user(const char *name);
+internal bool remove_user(uint8 id);
+internal void seed_users();
diff --git a/Provider/main/api/users/unity.cpp b/Provider/main/api/users/unity.cpp
new file mode 100644
index 0000000..e1792ed
--- /dev/null
+++ b/Provider/main/api/users/unity.cpp
@@ -0,0 +1,6 @@
+// clang-format off
+#include "api/users/store.cpp"
+#include "api/users/list.cpp"
+#include "api/users/add.cpp"
+#include "api/users/remove.cpp"
+// clang-format on
diff --git a/Provider/main/http_server.cpp b/Provider/main/http_server.cpp
index 7eb87b8..ea98a0a 100644
--- a/Provider/main/http_server.cpp
+++ b/Provider/main/http_server.cpp
@@ -19,6 +19,8 @@
#include "api/ota/status.cpp"
#include "api/system/info.cpp"
#include "api/system/reboot.cpp"
+#include "api/tasks/unity.cpp"
+#include "api/users/unity.cpp"
internal const char *TAG = "HTTP_SERVER";
@@ -170,7 +172,8 @@ internal esp_err_t static_file_handler(httpd_req_t *req)
internal esp_err_t cors_options_handler(httpd_req_t *req)
{
httpd_resp_set_hdr(req, "Access-Control-Allow-Origin", "*");
- httpd_resp_set_hdr(req, "Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+ httpd_resp_set_hdr(req, "Access-Control-Allow-Methods",
+ "GET, POST, DELETE, OPTIONS");
httpd_resp_set_hdr(req, "Access-Control-Allow-Headers", "Content-Type");
httpd_resp_set_status(req, "204 No Content");
httpd_resp_send(req, NULL, 0);
@@ -216,7 +219,7 @@ internal httpd_handle_t start_webserver(void)
httpd_config_t config = HTTPD_DEFAULT_CONFIG();
config.uri_match_fn = httpd_uri_match_wildcard;
- config.max_uri_handlers = 10; // We have info, reboot, options, and static
+ config.max_uri_handlers = 20;
httpd_handle_t server = NULL;
ESP_LOGI(TAG, "Starting HTTP Server on port: '%d'", config.server_port);
@@ -238,6 +241,20 @@ internal httpd_handle_t start_webserver(void)
httpd_register_uri_handler(server, &api_ota_firmware_uri);
httpd_register_uri_handler(server, &api_ota_bundle_uri);
+ // Register todo list API routes
+ httpd_register_uri_handler(server, &api_users_get_uri);
+ httpd_register_uri_handler(server, &api_users_post_uri);
+ httpd_register_uri_handler(server, &api_users_delete_uri);
+ httpd_register_uri_handler(server, &api_tasks_upcoming_uri);
+ httpd_register_uri_handler(server, &api_tasks_get_uri);
+ httpd_register_uri_handler(server, &api_tasks_post_uri);
+ httpd_register_uri_handler(server, &api_tasks_update_uri);
+ httpd_register_uri_handler(server, &api_tasks_delete_uri);
+
+ // Populate dummy data for development
+ seed_users();
+ seed_tasks();
+
#ifdef CONFIG_CALENDINK_DEPLOY_WEB_PAGES
// Register static file handler last as a catch-all wildcard if deployed
httpd_uri_t static_get_uri = {.uri = "/*",
diff --git a/Provider/main/main.cpp b/Provider/main/main.cpp
index a20e95a..b9e26fb 100644
--- a/Provider/main/main.cpp
+++ b/Provider/main/main.cpp
@@ -4,6 +4,7 @@
// SDK
#include "esp_log.h"
#include "esp_ota_ops.h"
+#include "esp_psram.h"
#include "esp_system.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
@@ -11,6 +12,7 @@
#include "nvs_flash.h"
#include "soc/gpio_num.h"
+
// Project headers
#include "appstate.hpp"
#include "types.hpp"
@@ -28,6 +30,8 @@ extern "C" void app_main()
{
printf("Hello, Calendink OTA! [V1.1]\n");
+ printf("PSRAM size: %d bytes\n", esp_psram_get_size());
+
httpd_handle_t web_server = NULL;
esp_err_t err = nvs_flash_init();
diff --git a/Provider/main/todo.hpp b/Provider/main/todo.hpp
new file mode 100644
index 0000000..01582ee
--- /dev/null
+++ b/Provider/main/todo.hpp
@@ -0,0 +1,20 @@
+#pragma once
+
+#include
+
+#include "types.hpp"
+#include "user.hpp"
+
+struct task_t
+{
+ uint16 id; // Auto-assigned (1–65535, 0 = empty slot)
+ uint8 user_id; // Owner (matches user_t.id)
+ char title[64]; // Task description
+ int64 due_date; // Unix timestamp (seconds)
+ bool completed; // Done flag
+ bool active; // Slot in use
+};
+
+constexpr int MAX_TASKS = 32;
+internal task_t g_Tasks[MAX_TASKS] = {};
+internal uint16 g_NextTaskId = 1;
diff --git a/Provider/main/user.hpp b/Provider/main/user.hpp
new file mode 100644
index 0000000..77434ac
--- /dev/null
+++ b/Provider/main/user.hpp
@@ -0,0 +1,16 @@
+#pragma once
+
+#include
+
+#include "types.hpp"
+
+struct user_t
+{
+ uint8 id; // Auto-assigned (1–255, 0 = empty slot)
+ char name[32]; // Display name
+ bool active; // Slot in use
+};
+
+constexpr int MAX_USERS = 8;
+internal user_t g_Users[MAX_USERS] = {};
+internal uint8 g_NextUserId = 1;
diff --git a/Provider/tdd/todo_list.md b/Provider/tdd/todo_list.md
index 0f6bef8..7d90650 100644
--- a/Provider/tdd/todo_list.md
+++ b/Provider/tdd/todo_list.md
@@ -114,19 +114,31 @@ g_Users[MAX_USERS=8] │ completed: bool │
```
Provider/main/
-├── user.hpp # user_t struct, g_Users[], seed_users()
-├── todo.hpp # task_t struct, g_Tasks[], seed_tasks()
+├── user.hpp # user_t struct, g_Users[] (data only)
+├── todo.hpp # task_t struct, g_Tasks[] (data only)
├── api/
│ ├── users/
-│ │ └── manage.cpp # User CRUD handlers
+│ │ ├── store.hpp # Forward declarations for user operations
+│ │ ├── store.cpp # find_user, add_user, remove_user, seed_users
+│ │ ├── list.cpp # GET /api/users
+│ │ ├── add.cpp # POST /api/users
+│ │ ├── remove.cpp # DELETE /api/users
+│ │ └── unity.cpp # Includes all users/*.cpp
│ ├── tasks/
-│ │ └── manage.cpp # Task CRUD + upcoming handlers
+│ │ ├── store.hpp # Forward declarations for task operations
+│ │ ├── store.cpp # find_task, add_task, remove_task, sort, seed_tasks
+│ │ ├── list.cpp # GET /api/tasks?user_id=N
+│ │ ├── upcoming.cpp # GET /api/tasks/upcoming
+│ │ ├── add.cpp # POST /api/tasks
+│ │ ├── update.cpp # POST /api/tasks/update
+│ │ ├── remove.cpp # DELETE /api/tasks
+│ │ └── unity.cpp # Includes all tasks/*.cpp
│ ├── system/
│ │ ├── info.cpp
│ │ └── reboot.cpp
│ └── ota/
│ └── ...
-├── http_server.cpp # +includes, +handlers, +CORS update
+├── http_server.cpp # includes tasks/unity.cpp + users/unity.cpp
└── main.cpp # Entry point (unchanged)
```
-
- {part.label}
-
- {#if part.label === otaStatus.active_partition || part.label === otaStatus.running_firmware_label}
- Active
- {/if}
+ {#if currentView === 'dashboard'}
+
+
+
-
- {#if showRebootConfirm}
-
+
+
+
-
-
-
+
+
+
+
+ {#if upcomingData.users.length > 0}
+
+
+
+
+
+
+ + System Info +
+
+ {#each infoItems as item}
+
+
+
-
+ {item.icon}
+ {item.label}
-
- Type {part.type} / Sub {part.subtype}
+
+ {#if status === "loading"}
+
+ {:else}
+ {item.value}
+ {/if}
-
+
+
+ {formatBytes(part.size)}
-
- {#if part.app_version}
- v{part.app_version}
- {/if}
- {#if part.free !== undefined}
-
- {formatBytes(part.free)} free
+ {/each}
+
+
+
+
+
+ + Partition Table +
+ Flash: 16MB +
+ {#if status === "loading"}
+
+ {/each}
+ {/if}
+ Loading memory layout...
+ {:else}
+ {#each otaStatus.partitions as part}
+
+
-
+
+
+
+ {part.label}
+
+ {#if part.label === otaStatus.active_partition || part.label === otaStatus.running_firmware_label}
+ Active
+ {/if}
+
+
+ Type {part.type} / Sub {part.subtype}
- {/if}
+
+
{formatBytes(part.size)}
+
+ {#if part.app_version}
+ v{part.app_version}
+ {/if}
+ {#if part.free !== undefined}
+
+ {formatBytes(part.free)} free
+
+ {/if}
+
+
+
+ { status = "rebooting"; isRecovering = true; }} />
+
+
+
+
+
+
+
+
+
+
+
+ + Device Control +
++ Restart the ESP32 microcontroller +
+
+
-
+
+ + 📋 Upcoming Tasks +
+
+ {#each upcomingData.users as user}
+
-
+
{/each}
- {/if}
- {user.name}
+ {#if user.tasks.length === 0} +No pending tasks
+ {:else} +
+ {#each user.tasks as task}
+
+ {/if}
+
+ {formatRelativeDate(task.due_date)}
+
+ {task.title}
+
+ {/each}
+
-
-
+
+
- { status = "rebooting"; isRecovering = true; }} />
-
+ {/if}
-
+ {/if}
+
+ {:else if currentView === 'tasks'}
+
+
-
-
+ - Device Control -
-- Restart the ESP32 microcontroller -
+
+ {/if}
+
+
+ {#if showRebootConfirm}
+
+
-
-
-
+
Confirm Reboot
++ Are you sure you want to reboot the ESP32? The device will be temporarily unavailable. +
+
+
+
+
-
- {/if}
+
diff --git a/Provider/frontend/src/lib/Sidebar.svelte b/Provider/frontend/src/lib/Sidebar.svelte
new file mode 100644
index 0000000..b2f402b
--- /dev/null
+++ b/Provider/frontend/src/lib/Sidebar.svelte
@@ -0,0 +1,135 @@
+
+
+
+
+
diff --git a/Provider/frontend/src/lib/TaskManager.svelte b/Provider/frontend/src/lib/TaskManager.svelte
new file mode 100644
index 0000000..bb9e7e1
--- /dev/null
+++ b/Provider/frontend/src/lib/TaskManager.svelte
@@ -0,0 +1,456 @@
+
+
+
-
- Confirm Reboot
-- Are you sure you want to reboot the ESP32? The device will be temporarily unavailable. -
-
-
-
-
-
+
+
+
diff --git a/Provider/frontend/src/lib/UserManager.svelte b/Provider/frontend/src/lib/UserManager.svelte
new file mode 100644
index 0000000..a5671a2
--- /dev/null
+++ b/Provider/frontend/src/lib/UserManager.svelte
@@ -0,0 +1,269 @@
+
+
+
+
+
+ {#if showAddForm}
+
+ {/if}
+
+ Tasks
+ {#if !showAddForm} + + {/if} +
+ {#each tasks as task}
+
+ {:else}
+
+ {#if editingTaskId === task.id}
+
+ {:else}
+
+ {:else}
+
+ handleToggleComplete(task)}
+ class="task-checkbox"
+ />
+
+
+ {task.title}
+
+ {formatRelativeDate(task.due_date)}
+
+
+
+
+ {#if confirmDeleteId === task.id}
+
+
+ {:else}
+
+ {/if}
+
+ {/if}
+ No tasks yet. Add one above!
+ {/each}
+ Select or add a user to see their tasks.
+ {/if}
+
+ {#if error}
+ {error}
+ {/if}
+
+
+
+ {#if error}
+
+
+
diff --git a/Provider/frontend/src/lib/api.js b/Provider/frontend/src/lib/api.js
index 72029bb..82783a3 100644
--- a/Provider/frontend/src/lib/api.js
+++ b/Provider/frontend/src/lib/api.js
@@ -116,3 +116,127 @@ export async function uploadOTABundle(file) {
return res.json();
}
+
+// ─── User Management ─────────────────────────────────────────────────────────
+
+/**
+ * Fetch all users.
+ * @returns {Promise{error}
+ {/if}
+