db->table('expenses'); $builder->where('expense_id', $expense_id); return ($builder->get()->getNumRows() == 1); // TODO: === } /** * Gets category info */ public function get_expense_category(int $expense_id): object // TODO: This function is never called in the code { $builder = $this->db->table('expenses'); $builder->where('expense_id', $expense_id); $expense_category = model(Expense_category::class); return $expense_category->get_info($builder->get()->getRow()->expense_category_id); // TODO: refactor out the nested function call. } /** * Gets employee info */ public function get_employee(int $expense_id): object // TODO: This function is never called in the code { $builder = $this->db->table('expenses'); $builder->where('expense_id', $expense_id); $employee = model(Employee::class); return $employee->getInfo($builder->get()->getRow()->employee_id); // TODO: refactor out the nested function call. } /** * @param array $expense_ids * @return ResultInterface */ public function get_multiple_info(array $expense_ids): ResultInterface { $builder = $this->db->table('expenses'); $builder->whereIn('expenses.expense_id', $expense_ids); $builder->orderBy('expense_id', 'asc'); return $builder->get(); } /** * Gets rows */ public function get_found_rows(string $search, array $filters): int { return $this->search($search, $filters, 0, 0, 'expense_id', 'asc', true); } /** * Searches expenses * * @param string $search * @param array $filters * @param int|null $rows * @param int|null $limit_from * @param string|null $sort * @param string|null $order * @param bool|null $count_only * @return ResultInterface|false|string */ public function search(string $search, array $filters, ?int $rows = 0, ?int $limit_from = 0, ?string $sort = 'expense_id', ?string $order = 'asc', ?bool $count_only = false): false|string|ResultInterface { // Set default values if ($rows == null) $rows = 0; if ($limit_from == null) $limit_from = 0; if ($sort == null) $sort = 'expense_id'; if ($order == null) $order = 'asc'; if ($count_only == null) $count_only = false; $config = config(OSPOS::class)->settings; $builder = $this->db->table('expenses AS expenses'); // get_found_rows case if ($count_only) { $builder->select('COUNT(DISTINCT expenses.expense_id) as count'); } else { $builder->select(' expenses.expense_id, MAX(expenses.date) AS date, MAX(suppliers.company_name) AS supplier_name, MAX(expenses.supplier_tax_code) AS supplier_tax_code, MAX(expenses.amount) AS amount, MAX(expenses.tax_amount) AS tax_amount, MAX(expenses.payment_type) AS payment_type, MAX(expenses.description) AS description, MAX(employees.first_name) AS first_name, MAX(employees.last_name) AS last_name, MAX(expense_categories.category_name) AS category_name '); } $builder->join('people AS employees', 'employees.person_id = expenses.employee_id', 'LEFT'); $builder->join('expense_categories AS expense_categories', 'expense_categories.expense_category_id = expenses.expense_category_id', 'LEFT'); $builder->join('suppliers AS suppliers', 'suppliers.person_id = expenses.supplier_id', 'LEFT'); $builder->groupStart(); $builder->like('employees.first_name', $search); $builder->orLike('expenses.date', $search); $builder->orLike('employees.last_name', $search); $builder->orLike('expenses.payment_type', $search); $builder->orLike('expenses.amount', $search); $builder->orLike('expense_categories.category_name', $search); $builder->orLike('CONCAT(employees.first_name, " ", employees.last_name)', $search); $builder->groupEnd(); $builder->where('expenses.deleted', $filters['is_deleted']); if (empty($config['date_or_time_format'])) { $builder->where('DATE_FORMAT(expenses.date, "%Y-%m-%d") BETWEEN ' . $this->db->escape($filters['start_date']) . ' AND ' . $this->db->escape($filters['end_date'])); } else { $builder->where('expenses.date BETWEEN ' . $this->db->escape(rawurldecode($filters['start_date'])) . ' AND ' . $this->db->escape(rawurldecode($filters['end_date']))); } if ($filters['only_debit']) { $builder->like('expenses.payment_type', lang('Expenses.debit')); } if ($filters['only_credit']) { $builder->like('expenses.payment_type', lang('Expenses.credit')); } if ($filters['only_cash']) { $builder->groupStart(); $builder->like('expenses.payment_type', lang('Expenses.cash')); $builder->orWhere('expenses.payment_type IS NULL'); $builder->groupEnd(); } if ($filters['only_due']) { $builder->like('expenses.payment_type', lang('Expenses.due')); } if ($filters['only_check']) { $builder->like('expenses.payment_type', lang('Expenses.check')); } if ($count_only) { // TODO: replace this with `if ($count_only)` return $builder->get()->getRow()->count; } $builder->groupBy('expense_id'); $builder->orderBy($sort, $order); if ($rows > 0) { $builder->limit($rows, $limit_from); } return $builder->get(); } /** * Gets information about a particular expense */ public function get_info(int $expense_id): object { $builder = $this->db->table('expenses AS expenses'); $builder->select(' expenses.expense_id AS expense_id, expenses.date AS date, suppliers.company_name AS supplier_name, expenses.supplier_id AS supplier_id, expenses.supplier_tax_code AS supplier_tax_code, expenses.amount AS amount, expenses.tax_amount AS tax_amount, expenses.payment_type AS payment_type, expenses.description AS description, expenses.employee_id AS employee_id, expenses.deleted AS deleted, employees.first_name AS first_name, employees.last_name AS last_name, expense_categories.expense_category_id AS expense_category_id, expense_categories.category_name AS category_name '); $builder->join('people AS employees', 'employees.person_id = expenses.employee_id', 'LEFT'); $builder->join('expense_categories AS expense_categories', 'expense_categories.expense_category_id = expenses.expense_category_id', 'LEFT'); $builder->join('suppliers AS suppliers', 'suppliers.person_id = expenses.supplier_id', 'LEFT'); $builder->where('expense_id', $expense_id); $query = $builder->get(); if ($query->getNumRows() == 1) { // TODO: === return $query->getRow(); } $empty_obj = $this->getEmptyObject('expenses'); $empty_obj->supplier_name = null; $empty_obj->first_name = null; $empty_obj->last_name = null; return $empty_obj; } /** * Initializes an empty object based on database definitions * @param string $table_name * @return object */ private function getEmptyObject(string $table_name): object { // Return an empty base parent object, as $item_id is NOT an item $empty_obj = new stdClass(); // Iterate through field definitions to determine how the fields should be initialized foreach ($this->db->getFieldData($table_name) as $field) { $field_name = $field->name; if (in_array($field->type, ['int', 'tinyint', 'decimal'])) { $empty_obj->$field_name = ($field->primary_key == 1) ? NEW_ENTRY : 0; } else { $empty_obj->$field_name = null; } } return $empty_obj; } /** * Inserts or updates an expense */ public function save_value(array &$expense_data, int $expense_id = NEW_ENTRY): bool { $builder = $this->db->table('expenses'); if ($expense_id == NEW_ENTRY || !$this->exists($expense_id)) { if ($builder->insert($expense_data)) { $expense_data['expense_id'] = $this->db->insertID(); return true; } return false; } $builder->where('expense_id', $expense_id); return $builder->update($expense_data); } /** * Deletes a list of expense_category */ public function delete_list(array $expense_ids): bool { $builder = $this->db->table('expenses'); $this->db->transStart(); $builder->whereIn('expense_id', $expense_ids); $success = $builder->update(['deleted' => 1]); $this->db->transComplete(); $success &= $this->db->transStatus(); return $success; } /** * Gets the payment summary for the expenses (expenses/manage) view */ public function get_payments_summary(string $search, array $filters): array // TODO: $search is passed but never used in the function { $config = config(OSPOS::class)->settings; // get payment summary $builder = $this->db->table('expenses'); $builder->select('payment_type, COUNT(amount) AS count, SUM(amount) AS amount'); $builder->where('deleted', $filters['is_deleted']); if (empty($config['date_or_time_format'])) { $builder->where('DATE_FORMAT(date, "%Y-%m-%d") BETWEEN ' . $this->db->escape($filters['start_date']) . ' AND ' . $this->db->escape($filters['end_date'])); } else { $builder->where('date BETWEEN ' . $this->db->escape(rawurldecode($filters['start_date'])) . ' AND ' . $this->db->escape(rawurldecode($filters['end_date']))); } if ($filters['only_cash']) { $builder->like('payment_type', lang('Expenses.cash')); } if ($filters['only_due']) { $builder->like('payment_type', lang('Expenses.due')); } if ($filters['only_check']) { $builder->like('payment_type', lang('Expenses.check')); } if ($filters['only_credit']) { $builder->like('payment_type', lang('Expenses.credit')); } if ($filters['only_debit']) { $builder->like('payment_type', lang('Expenses.debit')); } $builder->groupBy('payment_type'); return $builder->get()->getResultArray(); } /** * Gets the payment options to show in the expense forms */ public function get_payment_options(): array { return get_payment_options(); } /** * Gets the expense payment */ public function get_expense_payment(int $expense_id): ResultInterface { $builder = $this->db->table('expenses'); $builder->where('expense_id', $expense_id); return $builder->get(); } }