Assetora Quickstart, as shipped in the download

ASSETORA — QUICKSTART
=====================

Self-hosted fixed-asset & depreciation register — PHP + MySQL/SQLite. Records
asset costs and computes depreciation only (no payments, no bank/ledger
integration, not tax or accounting advice).


REQUIREMENTS
------------
  - PHP 8.1+ with extensions: pdo, pdo_sqlite (or pdo_mysql)
  - MySQL 5.7+ / MariaDB 10+ OR SQLite 3 (SQLite requires no extra setup)
  - A web server (Apache with mod_rewrite, or Nginx with try_files)
  - No Composer packages, no API keys, no external services.


SHARED HOSTING / CPANEL (RECOMMENDED FOR MOST BUYERS)
------------------------------------------------------
1. Upload the contents of the `app/` folder to your web root (e.g. public_html/)
   or a subdirectory (e.g. public_html/assets/).

2. Make sure this directory is writable by PHP:
     data/

   Via cPanel File Manager: right-click -> Permissions -> set to 755 or 775.

3. Visit https://yourdomain.com/install/ in your browser.

4. Fill in the installer:
     - Database: choose MySQL (fill in host/name/user/pass) or SQLite (no setup)
     - Business name, currency, timezone
     - Your admin name, email + password

5. The installer writes config.php, seeds a few starter categories, and redirects
   you to the login page.

6. Log in, then:
     - Add your fixed assets (cost, salvage, useful life, method)
     - Adjust categories under Setup > Categories
     - Open any asset to see its book value and full depreciation schedule
     - Record disposals; run the Depreciation report for any month or year


TRY IT WITH DEMO DATA FIRST
---------------------------
  - On the register, click "Load demo data" for a realistic mix of assets
    (straight-line + reducing-balance, a gain-on-disposal, a loss-on-disposal,
    and a fully-depreciated asset), then "Reset all data" when done.
  - Or from the command line:  php bin/demo.php
      (login: admin@assetora.app / admin123)


VPS / SELF-HOSTED (APACHE)
--------------------------
  <VirtualHost *:80>
    DocumentRoot /var/www/assetora/app
    <Directory /var/www/assetora/app>
      AllowOverride All
      Require all granted
    </Directory>
  </VirtualHost>


NGINX
-----
  root /var/www/assetora/app;
  location / { try_files $uri /index.php?$query_string; }
  location ~ \.php$ { include fastcgi_params; fastcgi_pass unix:/run/php/php8.3-fpm.sock;
                      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; }
  location ~ /(src|data|bin|tests|controllers)/ { deny all; }
  location ~ (config\.php|\.sqlite|\.demo-mode)$ { deny all; }


DOCKER (QUICK TEST)
-------------------
  docker run --rm -p 8080:8080 \
    -v "$(pwd)/app:/var/www/html" \
    -w /var/www/html \
    php:8.3-cli \
    php -S 0.0.0.0:8080 router.php

  Then visit http://localhost:8080/install/


DEPRECIATION & REPORTS
----------------------
  - Straight line: (cost - salvage) spread evenly over the useful life; the final
    period absorbs the rounding remainder so accumulated depreciation equals
    exactly (cost - salvage) at end of life. Book value never drops below salvage.
  - Reducing balance: the % rate you enter is applied to the book value each month
    in exact integer cents; book value never crosses salvage.
  - Book values are computed on view for any as-of date (no month-end close, no cron).
  - Depreciation report > pick a year (and optionally a month + category) > Export
    PDF or CSV. The PDF is a genuine, dependency-free PDF. The CSV is safe to open in
    Excel / Google Sheets (formula-injection hardened).


POST-INSTALL SECURITY CHECKLIST
--------------------------------
  [ ] config.php is protected (the .htaccess does this automatically)
  [ ] data/ is not web-accessible (.htaccess blocks it automatically)
  [ ] Use HTTPS in production
  [ ] Keep PHP updated


NOTES
-----
  * Money is stored as integer cents; no floating-point rounding touches a figure.
  * The whole register is kept in one currency (set in Settings).
  * Assetora records asset costs and computes depreciation only. It moves no money,
    integrates no bank/ledger/payment system, and is NOT tax or accounting advice.
    Confirm depreciation methods and rates with your accountant.