Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/DanielRivera03/SistemaBancario/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through cloning the CashMan H.A. repository, installing its Composer dependencies, and performing the URL and CSS configuration changes that are required before the application will run. Because the codebase embeds a default server port of 90 in several places, these post-clone edits are mandatory — the application will not redirect or render styles correctly until they are applied.
If the global URL ($UrlGlobal) is not updated to match your actual server address and port, all session redirects will point to the wrong host and the application will not function correctly. Complete steps 6 and 7 before attempting to log in.

Installation Steps

1

Clone the repository

Clone the project from GitHub to your local machine or server:
git clone https://github.com/DanielRivera03/SistemaBancario.git
2

Navigate to the application directory

The PHP application lives inside the CashManHA sub-folder of the repository:
cd SistemaBancario/CashManHA
3

Install Composer dependencies

Run Composer to download bramus/router and luecano/numero-a-letras:
composer install
Composer will create a vendor/ directory inside CashManHA/ containing all resolved packages.
4

Configure your web server

Point your web server’s document root at the project root (SistemaBancario/) or configure a virtual host. The application expects to be reachable at a path like /CashManHA/.Apache virtual host example:
<VirtualHost *:90>
    DocumentRoot "/path/to/SistemaBancario"
    ServerName localhost
    <Directory "/path/to/SistemaBancario">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
Restart Apache after making changes: apachectl restart
5

Verify the application loads

Open your browser and navigate to the configured URL. Using the default port:
http://localhost:90/CashManHA/
If you see the CashMan H.A. login page, the web server and PHP are working. Proceed to configure the URL and CSS settings below before attempting to log in.

Global URL Configuration

The codebase constructs the base application URL dynamically using $_SERVER['SERVER_NAME'] but always appends the hardcoded port :90. This variable must reflect the actual address and port your web server uses. Files to update:
  • controlador/cIniciosSesionesUsuarios.php
  • controlador/cGestionesCashman.php
In both files, locate the $UrlGlobal declaration and update the port (and path if necessary) to match your environment:
// Default value in both controller files:
$UrlGlobal = "http://" . $_SERVER['SERVER_NAME'] . ":90" . "/CashManHA" . '/';

// Example — change to port 80 (standard HTTP, no port needed in URL):
$UrlGlobal = "http://" . $_SERVER['SERVER_NAME'] . "/CashManHA/";

// Example — keep port 90 as-is:
$UrlGlobal = 'http://localhost:90/CashManHA/';
This URL is used as the base for all session redirect targets and the links embedded in automated email messages.

CSS URL Configuration

Several icon font stylesheets are imported inside vista/css/style.css using absolute @import url(...) rules that also hardcode http://localhost:90/. If your server uses a different port or hostname, these imports will silently fail and the application will display without icons or correct styling. File to update: vista/css/style.css Find and replace every occurrence of http://localhost:90 with your server’s base address. The affected lines begin around line 62:
/* Before — default hardcoded imports */
@import url("http://localhost:90/CashManHA/vista/icons/simple-line-icons/css/simple-line-icons.css");
@import url("http://localhost:90/CashManHA/vista/icons/font-awesome-old/css/font-awesome.min.css");
/* ... and several more @import lines */

/* After — updated to your server */
@import url("http://localhost:8080/CashManHA/vista/icons/simple-line-icons/css/simple-line-icons.css");
@import url("http://localhost:8080/CashManHA/vista/icons/font-awesome-old/css/font-awesome.min.css");

Profile Images

The vista/images/ directory stores user profile pictures. If images appear broken after cloning, download the complete images folder from the external Google Drive link referenced in the README and place (or replace) its contents at:
SistemaBancario/CashManHA/vista/images/
Google Drive link: https://drive.google.com/file/d/1BUKOcMmnws7Am91ilkKR6j9IoDXlmzkd/view?usp=sharing

Build docs developers (and LLMs) love