forge/arma/server/addons/bank/functions/fnc_initSessionManager.sqf
Jacob Schmidt ff7ff0c4e5 Implement org credit line debt and bank repayment flow (#2)
## Summary

This finishes the org credit line workflow so it behaves like reserved treasury-backed credit instead of a simple member allowance.

## What changed

- reserve org funds immediately when a credit line is assigned
- track credit lines with:
  - approved amount
  - available amount
  - outstanding principal
  - interest rate
  - amount due
- consume reserved credit during store checkout without charging org funds a second time
- add credit line repayment through the bank app
- sync richer credit line state into org and bank payloads/UI
- keep legacy `amount` compatibility mapped to available credit for older consumers

## User-facing behavior

- assigning a credit line now reduces available org funds immediately
- spending on `credit_line` reduces available credit and creates debt with interest
- the bank app now shows outstanding credit debt and allows repayment from personal bank funds
- the org treasury view now shows reserved credit and outstanding due totals

## Validation

- `cargo fmt`
- `npm run build:webui`
- `cargo test -p forge-services --quiet`
- `cargo test -p forge-server --quiet`

## Follow-up checks

- validate in-game that assigning a credit line reduces org funds immediately
- validate store checkout with `credit_line` updates available credit and debt correctly
- validate bank repayment decreases player bank balance, increases org funds, and reduces amount due

Co-authored-by: Jacob Schmidt <innovativestudios@outlook.com>
Reviewed-on: #2
2026-04-02 16:50:38 -05:00

103 lines
3.3 KiB
Plaintext

#include "..\script_component.hpp"
/*
* File: fnc_initSessionManager.sqf
* Author: IDSolutions
* Date: 2026-03-16
* Last Update: 2026-04-02
* Public: No
*
* Description:
* Initializes the bank session manager for managing ATM/bank
* session state, mode resolution, and PIN authorization.
*
* Parameter(s):
* None
*
* Returns:
* Session manager object [HASHMAP OBJECT]
*
* Example(s):
* call forge_server_bank_fnc_initSessionManager
*/
#pragma hemtt ignore_variables ["_self"]
GVAR(BankSessionManager) = createHashMapObject [[
["#type", "BankSessionManager"],
["getSessionState", compileFinal {
params [["_uid", "", [""]]];
private _session = GVAR(SessionRegistry) getOrDefault [_uid, createHashMap];
if (_session isEqualTo createHashMap) then {
_session = createHashMapFromArray [
["atmAuthorized", false],
["mode", "bank"]
];
GVAR(SessionRegistry) set [_uid, _session];
};
_session
}],
["setSessionState", compileFinal {
params [["_uid", "", [""]], ["_fieldValuePairs", createHashMap, [createHashMap]]];
if (_uid isEqualTo "") exitWith { createHashMap };
private _session = +(_self call ["getSessionState", [_uid]]);
{ _session set [_x, _y]; } forEach _fieldValuePairs;
GVAR(SessionRegistry) set [_uid, _session];
_session
}],
["resolveMode", compileFinal {
params [["_mode", "bank", [""]]];
private _finalMode = toLowerANSI _mode;
if !(_finalMode in ["atm", "bank"]) then { _finalMode = "bank"; };
_finalMode
}],
["syncSessionMode", compileFinal {
params [["_uid", "", [""]], ["_mode", "", [""]], ["_resetAuthorization", false, [false]]];
private _current = _self call ["getSessionState", [_uid]];
private _finalMode = if (_mode isEqualTo "") then {
_current getOrDefault ["mode", "bank"]
} else {
_self call ["resolveMode", [_mode]]
};
private _atmAuthorized = _current getOrDefault ["atmAuthorized", false];
if (_finalMode isEqualTo "atm") then {
if (_resetAuthorization || { (_current getOrDefault ["mode", "bank"]) isNotEqualTo "atm" }) then {
_atmAuthorized = false;
};
} else {
_atmAuthorized = false;
};
_self call ["setSessionState", [_uid, createHashMapFromArray [
["atmAuthorized", _atmAuthorized],
["mode", _finalMode]
]]]
}],
["submitPin", compileFinal {
params [["_uid", "", [""]], ["_pin", "", [""]]];
if (_uid isEqualTo "") exitWith { false };
_self call ["setSessionState", [_uid, createHashMapFromArray [["atmAuthorized", false], ["mode", "atm"]]]];
if !(GVAR(BankStore) call ["validatePin", [_uid, _pin]]) exitWith {
GVAR(BankStore) call ["hydrateSession", [_uid, "atm", false]];
false
};
_self call ["setSessionState", [_uid, createHashMapFromArray [["atmAuthorized", true], ["mode", "atm"]]]];
GVAR(BankMessenger) call ["sendNotification", [_uid, "info", "Bank", "ATM access granted."]];
GVAR(BankStore) call ["hydrateSession", [_uid, "atm", false]];
true
}]
]];
GVAR(BankSessionManager)