tomh104/nat-as-server
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

expanded log activity

Browse Source
This commit is contained in:
tom.hempel
2026-06-01 22:46:48 +02:00
parent da394c5525
commit e5ac069dc4
6 changed files with 62 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

59
lib/api_log.php
View File

@ -7,13 +7,14 @@
* Recorded activity (not routine website page loads):
* - app_sync: GET /app_questionnaires (mobile sync)
* - app_change: POST/PUT/PATCH/DELETE from the Android app
* - web_change: POST/PUT/PATCH/DELETE from the management website
* - web_change: POST/PUT/PATCH/DELETE from the management website (incl. translation labels)
* - web_export: Website downloads (CSV/ZIP/JSON exports, translation bundle)
*
* Set QDB_API_LOG=0 to disable. Logs live under logs/api/ (gitignored).
*/
/** @var list<string> */
const QDB_API_LOG_ACTIVITIES = ['app_sync', 'app_change', 'web_change'];
const QDB_API_LOG_ACTIVITIES = ['app_sync', 'app_change', 'web_change', 'web_export'];
function qdb_api_log_enabled(): bool
{
@ -69,13 +70,30 @@ function qdb_api_log_classify_activity(string $method, string $client, string $r
return $client === 'web' ? 'web_change' : 'app_change';
}
if ($method === 'GET' && $route === 'app_questionnaires' && $client !== 'web') {
return 'app_sync';
if ($method === 'GET') {
if ($route === 'app_questionnaires' && $client !== 'web') {
return 'app_sync';
}
if (qdb_api_log_is_website_download($route)) {
return 'web_export';
}
}
return null;
}
/** Website GET that downloads or exports data (not routine list/load). */
function qdb_api_log_is_website_download(string $route): bool
{
if (in_array($route, ['export', 'backup'], true)) {
return true;
}
if ($route === 'translations' && !empty($_GET['exportBundle'])) {
return true;
}
return false;
}
/** @param array<string, mixed> $context */
function qdb_api_log_begin(string $method, string $route, array $context = []): void
{
@ -753,19 +771,26 @@ function qdb_api_log_sort_changes_for_display(array $changes): array
{
$priority = [
'username' => 0,
'role' => 1,
'clientcode' => 2,
'action' => 3,
'query.id' => 4,
'query.clients' => 5,
'query.clientcode' => 6,
'query.answers' => 7,
'query.translations' => 8,
'supervisorid' => 9,
'userid' => 10,
'mustchangepassword' => 11,
'password' => 12,
'location' => 13,
'type' => 1,
'text' => 2,
'languagecode' => 3,
'id' => 4,
'role' => 5,
'clientcode' => 6,
'action' => 7,
'query.id' => 10,
'query.clients' => 11,
'query.clientcode' => 12,
'query.answers' => 13,
'query.translations' => 14,
'query.bundle' => 15,
'query.exportall' => 16,
'query.exportbundle' => 17,
'supervisorid' => 18,
'userid' => 19,
'mustchangepassword' => 20,
'password' => 21,
'location' => 22,
];
usort($changes, static function (array $a, array $b) use ($priority): int {