= Use-case 1 – Испраќање и обработка на податоци =
 * '''Initiating actor:''' Client application (Agent / Collector)
 * '''Other actors:''' Administrator
'''Description:'''
Клиентската апликација периодично собира системски, процесни и мрежни податоци и ги испраќа до серверот со X-Env-Token. Серверот го проверува токенот, го ажурира записот за компјутерот, ја заменува тековната состојба (snapshot) и по потреба додава во историја според поставките на околината.
'''Scenario:'''
1. Агентот ги собира податоците на компјутерот.
2. Агентот испраќа POST барање со заглавие X-Env-Token.
3. Системот го проверува токенот:
{{{
SET search_path TO project;
SELECT tenant_id, env_name
FROM env_tokens
WHERE token = 'ENV_TOKEN_DEFAULT_TEST'
  AND (expires_at IS NULL OR expires_at > now());
}}}
4. Системот го ажурира (или создава) записот за компјутерот:
{{{
INSERT INTO computers (tenant_id, env_name, name, "user", ip, os, first_seen, last_seen, sysmon_available)
VALUES (1, 'default', 'PC-ADMIN', 'admin', '192.168.1.10', 'Windows 11 Pro', now(), now(), true)
ON CONFLICT (tenant_id, name)
DO UPDATE SET last_seen = now(), ip = EXCLUDED.ip, os = EXCLUDED.os;
}}}
5. Системот ја заменува тековната snapshot состојба на метриките:
{{{
DELETE FROM computer_history_current
WHERE computer_id = (SELECT id FROM computers WHERE tenant_id=1 AND name='PC-ADMIN');
INSERT INTO computer_history_current
(computer_id, cpu_usage, ram_usage, disk_usage, network_sent_mb, network_recv_mb, timestamp)
VALUES ((SELECT id FROM computers WHERE tenant_id=1 AND name='PC-ADMIN'), 45.0, 62.0, 71.0, 130.0, 100.0, now());
}}}
6. Системот ги заменува тековните процеси, и додава во историја само ако е овозможено за околината:
{{{
DELETE FROM computer_processes_current
WHERE computer_id = (SELECT id FROM computers WHERE tenant_id=1 AND name='PC-ADMIN');
INSERT INTO computer_processes_current
(computer_id, pid, name, cpu_percent, memory_mb, username, cmdline, timestamp)
VALUES ((SELECT id FROM computers WHERE tenant_id=1 AND name='PC-ADMIN'), 1234, 'chrome.exe', 12.5, 350.2, 'admin', 'chrome', now());
INSERT INTO computer_processes_history
(computer_id, pid, name, cpu_percent, memory_mb, username, cmdline, timestamp)
SELECT (SELECT id FROM computers WHERE tenant_id=1 AND name='PC-ADMIN'), 1234, 'chrome.exe', 12.5, 350.2, 'admin', 'chrome', now()
WHERE (SELECT save_process_history FROM env_settings WHERE tenant_id=1 AND env_name='default') = true;
}}}
7. Системот зачувува безбедносен/Sysmon настан и враќа успешен одговор:
{{{
INSERT INTO sysmon_events (computer_id, event_id, event_type, message, timestamp, details)
VALUES ((SELECT id FROM computers WHERE tenant_id=1 AND name='PC-ADMIN'), 1, 'Process Create', 'Process created: chrome.exe', now(), '{}');
}}}