Add Asset Management app

Assets from purchase invoice lines, straight-line depreciation/amortization with salvage value, disposals, and [Asset Mgmt] sources in Batch GL Entries. Green third workspace with an app access guard.
This commit is contained in:
Thanakorn
2026-09-15 09:50:55 +07:00
parent 9512d440dd
commit c957280aa5
46 changed files with 4316 additions and 131 deletions
+9
View File
@@ -0,0 +1,9 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_once '../../../assets/utils/classes_as/AssetManager.php';
$answer['output'] = (new AssetManager($pdo2, $company_id))->getList((int)($data['invoice_id'] ?? 0));
$answer['success'] = 1;
exit(json_encode($answer));
+21
View File
@@ -0,0 +1,21 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_once '../../../assets/utils/classes_as/AssetManager.php';
require_once '../../../assets/utils/classes_as/AssetRunManager.php';
try {
$answer['output'] = (new AssetManager($pdo2, $company_id))->getStats();
$answer['due'] = (new AssetRunManager($pdo2, $company_id))->dueSummary();
$answer['success'] = 1;
} catch (PDOException $e) {
error_log('[asset stats] ' . $e->getMessage());
$answer['message'] = 'Database error, please try again.';
http_response_code(500);
} catch (Exception $e) {
$answer['message'] = $e->getMessage();
http_response_code(400);
}
exit(json_encode($answer));
+11
View File
@@ -0,0 +1,11 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_once '../../../assets/utils/classes_as/AssetCategoryManager.php';
$categories = new AssetCategoryManager($pdo2, $company_id);
$answer['output'] = $categories->getAll();
$answer['stats'] = $categories->getStats();
$answer['success'] = 1;
exit(json_encode($answer));
+63
View File
@@ -0,0 +1,63 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_once '../../../assets/utils/classes/UsageGuard.php';
require_once '../../../assets/utils/classes_ac/PostingWindowGuard.php';
require_once '../../../assets/utils/classes_ac/GlManager.php';
require_once '../../../assets/utils/classes_as/AssetRunManager.php';
$action = (string)($data['action'] ?? 'list');
$class = trim((string)($data['asset_class'] ?? ''));
$through = trim((string)($data['through_period'] ?? ''));
$run_id = (int)($data['run_id'] ?? 0);
if (in_array($action, ['run', 'void'], true)) {
require_role($user_role, ['owner', 'admin']);
}
try {
$runs = new AssetRunManager($pdo2, $company_id);
switch ($action) {
case 'list':
$answer['output'] = $runs->getList($class);
break;
case 'preview':
$answer['output'] = $runs->preview($class, $through);
break;
case 'detail':
$answer['output'] = $runs->getDetail($run_id);
break;
case 'run':
$created = dbTransaction($pdo2, fn($pdo) => (new AssetRunManager($pdo, $company_id))->run($class, $through, $user_id));
(new UsageGuard($pdo1, $company_id, $packages))->increment();
$answer['output'] = $created;
$answer['message'] = count($created) . ' run(s) created. Accounting posts them from Batch GL Entries.';
break;
case 'void':
dbTransaction($pdo2, function ($pdo) use ($company_id, $run_id, $pdo1) {
$gl = new GlManager($pdo, $company_id, new PostingWindowGuard($pdo1, $company_id));
(new AssetRunManager($pdo, $company_id))->void($run_id, $gl);
});
$answer['message'] = 'Run voided.';
break;
default:
throw new Exception('Invalid action.');
}
$answer['success'] = 1;
} catch (PDOException $e) {
$answer['message'] = 'Database error, please try again.';
http_response_code(500);
} catch (Exception $e) {
$answer['message'] = $e->getMessage();
http_response_code(400);
}
exit(json_encode($answer));
+28
View File
@@ -0,0 +1,28 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_once '../../../assets/utils/classes_as/AssetManager.php';
try {
$assets = new AssetManager($pdo2, $company_id);
if (($data['action'] ?? '') === 'line') {
$answer['output'] = $assets->getInvoiceLine((int)($data['invoice_id'] ?? 0), (int)($data['item_id'] ?? 0));
} else {
$answer['output'] = $assets->getCapitalizableLines(
(string)($data['date_from'] ?? ''),
(string)($data['date_to'] ?? '')
);
}
$answer['success'] = 1;
} catch (PDOException $e) {
error_log('[asset invoice lines] ' . $e->getMessage());
$answer['message'] = 'Database error, please try again.';
http_response_code(500);
} catch (Exception $e) {
$answer['message'] = $e->getMessage();
http_response_code(400);
}
exit(json_encode($answer));
+70
View File
@@ -0,0 +1,70 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_once '../../../assets/utils/classes/UsageGuard.php';
require_once '../../../assets/utils/classes_ac/PostingWindowGuard.php';
require_once '../../../assets/utils/classes_ac/GlManager.php';
require_once '../../../assets/utils/classes_as/AssetManager.php';
$action = (string)($data['action'] ?? '');
$id = (int)($data['id'] ?? 0);
$messages = [
'create' => 'Asset saved as a draft.',
'update' => 'Asset saved.',
'activate' => 'Asset activated. Accounting posts its capitalization from Batch GL Entries.',
'delete' => 'Draft asset deleted.',
'void' => 'Asset voided.',
'dispose' => 'Disposal recorded. Accounting posts it from Batch GL Entries.',
'undo_disposal' => 'Disposal undone.',
];
if (!isset($messages[$action])) {
$answer['message'] = 'Invalid action.';
http_response_code(400);
exit(json_encode($answer));
}
// Staff may prepare assets; everything that changes the books is owner/admin.
require_role($user_role, in_array($action, ['create', 'update'], true) ? ['owner', 'admin', 'staff'] : ['owner', 'admin']);
if ($action !== 'create' && $id <= 0) {
$answer['message'] = 'Missing asset id.';
http_response_code(400);
exit(json_encode($answer));
}
try {
$result_id = dbTransaction($pdo2, function ($pdo) use ($action, $id, $data, $company_id, $user_id, $pdo1) {
$assets = new AssetManager($pdo, $company_id);
$gl = new GlManager($pdo, $company_id, new PostingWindowGuard($pdo1, $company_id));
switch ($action) {
case 'create':
case 'update': return $assets->save($data, $user_id);
case 'activate': $assets->activate($id); break;
case 'delete': $assets->delete($id); break;
case 'void': $assets->void($id, $gl); break;
case 'dispose': $assets->dispose($id, $data); break;
case 'undo_disposal': $assets->undoDisposal($id, $gl); break;
}
return $id;
});
if ($action === 'create') {
(new UsageGuard($pdo1, $company_id, $packages))->increment();
}
$answer['success'] = 1;
$answer['output'] = ['id' => $result_id];
$answer['message'] = $messages[$action];
} catch (PDOException $e) {
$answer['message'] = 'Database error, please try again.';
http_response_code(500);
} catch (Exception $e) {
$answer['message'] = $e->getMessage();
http_response_code(400);
}
exit(json_encode($answer));
+22
View File
@@ -0,0 +1,22 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_role($user_role, ['owner', 'admin']);
require_once '../../../assets/utils/classes_as/AssetCategoryManager.php';
try {
$id = (new AssetCategoryManager($pdo2, $company_id))->save($data);
$answer['success'] = 1;
$answer['output'] = ['id' => $id];
$answer['message'] = !empty($data['id']) ? 'Category updated.' : 'Category created.';
} catch (PDOException $e) {
error_log('[asset category] ' . $e->getMessage());
$answer['message'] = 'Database error, please try again.';
http_response_code(500);
} catch (Exception $e) {
$answer['message'] = $e->getMessage();
http_response_code(400);
}
exit(json_encode($answer));
+15
View File
@@ -0,0 +1,15 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_role($user_role, ['owner', 'admin']);
require_once '../../../assets/utils/classes_as/AssetCategoryManager.php';
$id = (int)($data['id'] ?? 0);
if (!$id) { $answer['message'] = 'Missing id'; exit(json_encode($answer)); }
(new AssetCategoryManager($pdo2, $company_id))->deactivate($id);
$answer['success'] = 1;
$answer['message'] = 'Category deactivated.';
exit(json_encode($answer));
+19
View File
@@ -0,0 +1,19 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_once '../../../assets/utils/classes_as/AssetManager.php';
try {
$answer['output'] = (new AssetManager($pdo2, $company_id))->getDetail((int)($data['id'] ?? 0));
$answer['success'] = 1;
} catch (PDOException $e) {
error_log('[asset retrieve] ' . $e->getMessage());
$answer['message'] = 'Database error, please try again.';
http_response_code(500);
} catch (Exception $e) {
$answer['message'] = $e->getMessage();
http_response_code(400);
}
exit(json_encode($answer));
@@ -0,0 +1,15 @@
<?php
session_start();
require_once '../../../assets/utils/db_auth.php';
require_app_access('asset');
require_once '../../../assets/utils/classes_as/AssetCategoryManager.php';
$id = (int)($data['id'] ?? 0);
if (!$id) { $answer['message'] = 'Missing id'; exit(json_encode($answer)); }
$row = (new AssetCategoryManager($pdo2, $company_id))->getById($id);
if (!$row) { $answer['message'] = 'Category not found'; exit(json_encode($answer)); }
$answer['output'] = $row;
$answer['success'] = 1;
exit(json_encode($answer));