Gecko [ bdeworldwide.com ]

Name	Size	Permission
.pkexec	[ DIR ]	drwxr-xr-x
.well-known	[ DIR ]	drwxr-xr-x
1ftspxk	[ DIR ]	drwxr-xr-x
1xbqevo	[ DIR ]	drwxr-xr-x
GCONV_PATH=.	[ DIR ]	drwxr-xr-x
ac-software	[ DIR ]	drwxrwxrwx
app	[ DIR ]	drwxrwxrwx
bootstrap	[ DIR ]	drwxrwxrwx
config	[ DIR ]	drwxrwxrwx
database	[ DIR ]	drwxrwxrwx
feomraj	[ DIR ]	drwxr-xr-x
images	[ DIR ]	drwxr-xr-x
orfq1pi	[ DIR ]	drwxr-xr-x
public	[ DIR ]	drwxrwxrwx
resources	[ DIR ]	drwxrwxrwx
routes	[ DIR ]	drwxrwxrwx
sikwlrz	[ DIR ]	drwxr-xr-x
storage	[ DIR ]	drwxrwxrwx
tests	[ DIR ]	drwxrwxrwx
tkuweoh	[ DIR ]	drwxr-xr-x
vendor	[ DIR ]	drwxrwxrwx
yiupscq	[ DIR ]	drwxr-xr-x
zotiedb	[ DIR ]	drwxr-xr-x
.editorconfig	258 B	-rw-rw-rw-
.env	1.3 KB	-rw-rw-rw-
.env.example	1.11 KB	-rw-rw-rw-
.gitattributes	186 B	-rw-rw-rw-
.gitignore	286 B	-rw-rw-rw-
.htaccess	479 B	-rw-r--r--
.mad-root	0 B	-rw-r--r--
.phpunit.result.cache	2.36 KB	-rw-rw-rw-
README.md	3.14 KB	-rw-rw-rw-
ac_software	84 KB	-rw-rw-rw-
artisan	350 B	-rw-rw-rw-
composer.json	2.35 KB	-rw-rw-rw-
composer.lock	299.75 KB	-rw-rw-rw-
error_log	1.6 KB	-rw-r--r--
goat1.php	143.87 KB	-rw-r--r--
index.php	1.18 KB	-rw-r--r--
license-wvos.php	629 B	-rw-r--r--
package.json	383 B	-rw-rw-rw-
phpunit.xml	1.15 KB	-rw-rw-rw-
postcss.config.js	93 B	-rw-rw-rw-
pwnkit	10.99 KB	-rwxr-xr-x
robots.txt	86 B	-rw-r--r--
signgwph_acsoftware	156 KB	-rw-r--r--
tailwind.config.js	551 B	-rw-rw-rw-
vite.config.js	263 B	-rw-rw-rw-
wp-blog-header.php	0 B	-rw-r--r--
wp-load.php	0 B	-rw-r--r--

Code Editor : README.md

# AC Software

Laravel 11 accounting and financial management system built from the PRD.

## What Is Included

- Multi-business switcher with isolated data per business.
- Double-entry ledger engine with balanced debit/credit lines.
- Live dashboard cards for Income, Expenses, Profit, Cash, Capital, and Bank.
- Capital, Cash, Bank transfer, Income, Expenses, Purchase, Assets, A/C Receivable, A/C Payable, and Loan entry forms.
- Transaction ledger showing the generated double-entry lines.
- Daily, Weekly, Monthly reports.
- Trial Balance, Income Statement, and Financial Position Statement.
- Live calculation bar on every page for Income, Expenses, Profit, Cash, Capital, and Bank.
- Admin customization for software name, tagline, logo, favicon, and theme colors.
- Admin timezone setting so Today filters and transaction default dates match the selected country/timezone.
- Admin business management for adding/editing multiple isolated businesses.
- Admin data control for monthly CSV sheet export, branch data clearing, and branch deletion with typed confirmation.
- First-run web installer for cPanel/shared hosting database setup and owner account creation.
- Login/logout authentication with owner-only admin controls.
- Account Management for adding users, assigning roles, and granting business access.
- Clean USD starter data for two businesses: AC Manufacturing and AC Trading.

## Local Run With XAMPP PHP

From this folder:

```powershell
D:\xampp\php\php.exe artisan migrate:fresh --seed --force
D:\xampp\php\php.exe artisan serve --host=127.0.0.1 --port=8000
```

Open:

```text
http://127.0.0.1:8000
```

Admin pages:

```text
/admin/settings
/admin/businesses
/admin/accounts
/admin/data
```

## First-Run Installation On Hosting

Upload the project files to your hosting account, point the domain to the Laravel `public` folder, then open the domain.

If your hosting cannot point the domain to `public`, upload the full project into the domain folder and make sure these root files are also uploaded:

```text
index.php
.htaccess
```

The root `.htaccess` sends `/install`, `/login`, and all clean URLs into Laravel. In cPanel File Manager, enable hidden files so `.htaccess` is visible and uploaded.

If the software is not installed yet, it redirects to:

```text
/install
```

The installer checks PHP/server requirements, asks for database host/name/user/password, runs the SQL migrations automatically, then creates the first business and owner account. After installation it writes `APP_INSTALLED=true` and locks the installer.

## Tests

```powershell
D:\xampp\php\php.exe artisan test
```

## Database

The local `.env` is configured for SQLite so the app runs even if XAMPP MySQL is stopped.

To use XAMPP MySQL/MariaDB, create a database named `ac_software`, then change `.env`:

```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=ac_software
DB_USERNAME=root
DB_PASSWORD=
```

Then run:

```powershell
D:\xampp\php\php.exe artisan migrate:fresh --seed --force
```

## Development Seeder Login

Only local development seeding creates:

```text
owner@acsoftware.test
password
```

Production installation uses the owner email and password entered in the installer.

${this.title}

Code Editor : README.md