Logistack - User contributions [en-gb]

Logistack Requirements

2025-10-16T16:03:08Z

Lee Miller: /* Troubleshooting */

= LogiStack Pro — Server Requirements =

This page lists supported environments and sizing guidance for running LogiStack Pro (web app, customer portal, admin).

== '''Don't be cheap with hosting!!!''' ==

Hostinger (who I use and are brilliant), provide full VPS server hosting from between £120 (4 CPU cores) and £228 (8 CPU cores), use my referral code for 20% off and a free .co.uk domain name - subscribe using [https://hostinger.com?REFERRALCODE=U0JLEECHR9VC this link].

I also provide fully managed hosting, it's more than Hostinger, but you do nothing, I manage the hosting on your behalf, install Logistack, create the domain name, again a free .co.uk and create domain related email addresses e.g. <nowiki>info@your-domain.co.uk</nowiki> or <nowiki>jim@your-domain.co.uk</nowiki>

My server has 16 CPU Cores, and enough space for 1000s of websites, though I'm not planning to host more than 20.

== Summary ==
* Application stack: PHP + MySQL or MariaDB on Apache or Nginx
* Operating system: Linux preferred (Ubuntu/Debian/Alma/Rocky); Windows Server possible
* Access: HTTPS required; SMTP needed for outbound mail
* Storage: Local disk for POD images and invoice PDFs; delivery videos are hosted externally and linked

== Minimum (single site) ==
* Web server: Apache 2.4+ or Nginx 1.18+
* PHP: 8.1+ (8.2/8.3 recommended)
* Database: MySQL 8.0+ or MariaDB 10.5+
* CPU and RAM: 1 vCPU, 1–2 GB RAM
* Disk: 10–20 GB
* TLS: Valid HTTPS certificate
* Mail: Authenticated SMTP account

== Recommended (production) ==
* OS: Ubuntu LTS (22.04 or 24.04) or equivalent
* Web server: Nginx with PHP-FPM, or Apache 2.4 with PHP-FPM
* PHP: 8.2+ with OPcache enabled
* Database: MySQL 8.0.34+ or MariaDB 10.6+ (local or managed)
* CPU and RAM: 2–4 vCPU, 4–8 GB RAM (scale with drivers and customers)
* Disk: 50–100 GB SSD (separate volume for /uploads)
* Backups: Daily database dumps and file snapshots (retain 30 days)
* Monitoring: Uptime, disk usage, and error log alerts

== API Keys ==
* OpenAI API Key
* Google Maps API key

== Required PHP extensions ==
* pdo_mysql
* mbstring
* intl
* openssl
* curl
* json
* fileinfo
* zip
* gd or imagick
* opcache

== Suggested php.ini settings ==
<pre>
memory_limit = 512M
upload_max_filesize = 256M
post_max_size = 32M
max_execution_time = 300
max_input_time = 300
expose_php = Off
date.timezone = Europe/London
session.cookie_httponly = 1
session.cookie_secure = 1
opcache.enable = 1
</pre>

== Database settings ==
* Engine: MySQL 8.0+ or MariaDB 10.5+
* Charset and collation: utf8mb4 / utf8mb4_unicode_ci
* Grant a least-privilege application user to the app database.

== Email (SMTP) ==
* Required for sending invoice PDFs and notifications.
* Needs host, port, username, password, and TLS (typically port 587 or 465).

== HTTPS and security ==
* Enforce HTTPS (TLS 1.2+).
* Keep OS, web server, PHP, database, and extensions up to date.

== Cron jobs (recommended) ==
* Nightly database backup
* Log rotation
* Optional: mail retry queue and temporary file cleanup

=== Example crontab line (02:15) ===
<pre>
15 2 * * * /usr/bin/mysqldump -ulogistack -p'***' logistack | gzip > /backups/logistack-$(date +\%F).sql.gz
</pre>

== Firewall and ports ==
* Inbound: 80 (HTTP) and 443 (HTTPS)
* Outbound: 443 for SMTP/API endpoints and video embeds
* Restrict SSH (22) to admin IPs only

== Sizing notes ==
* POD images: approx. 0.3–1.5 MB each
* Invoice PDFs: approx. 30–300 KB each
* Start with 50–100 GB for /uploads; review quarterly

== Troubleshooting ==
* Blank page or 500: check web server and PHP error logs; confirm required PHP extensions.
* Upload failures: increase upload_max_filesize and post_max_size; verify folder permissions.
* Emails not sending: verify SMTP credentials and connectivity; try port 587 with TLS.
* Thumbnails not generating: confirm gd

See [[Troubleshooting]] for more detailed info

Logistack Requirements

2025-10-16T16:01:28Z

Lee Miller: /* Suggested php.ini settings */

2025-10-14T19:29:30Z

Lee Miller: /* Extra Protection */

== Overview ==

95% of the pages in Logistack are hidden to Admins and Superusers, which provides amazing security in its own right.

Beyond that, all data is protected inside a MySQL database.

== Tests ==

* [https://securityheaders.com/?q=pro.logistack.co.uk&followRedirects=on Security Header] - A+
* [https://www.ssllabs.com/ssltest/analyze.html?d=pro.logistack.co.uk SSL Labs] - A A A A
* [https://developer.mozilla.org/en-US/observatory/analyze?host=pro.logistack.co.uk Mozilla HTTP Observatory] - A+

== Extra Protection ==

Most protected pages are set to display errors, which under ordinary circumstances would be asking for trouble! However, the way I've set things up, to make providing support easier, is to use redirects, let me explain ...

This is what a normal PHP error looks like;

<code>Parse error: syntax error, unexpected '}', expecting ')' in /var/www/app.php on line 7</code>

The issue is that when this displays publically, it provides an "in." Showing <code>/var/www/app.php</code> (or any full server path) to the public is classic information disclosure. On its own, it’s not a hack, but it materially helps attackers.

With Logistack, when an error like this occurs, a normal user (non-admin), is redirected to a page that says, "An error occurred please inform admin." And when admin visit this page, they're provided with a log number, and a line of code that tells me, exactly what's wrong, without compromising the security of your website.

What would normally be a 500 error at best, becomes a tool to fix your site.

Logistack Security

2025-10-14T19:21:57Z

Lee Miller: Created page with "== Overview == 95% of the pages in Logistack are hidden to Admins and Superusers, which provides amazing security in its own right. Beyond that, all data is protected inside a MySQL database. == Tests == * [https://securityheaders.com/?q=pro.logistack.co.uk&followRedirects=on Security Header] - A+ * [https://www.ssllabs.com/ssltest/analyze.html?d=pro.logistack.co.uk SSL Labs] - A A A A * [https://developer.mozilla.org/en-US/observatory/analyze?host=pro.logistack.co.u..."

Security and privacy

2025-10-14T18:26:32Z

Lee Miller:

== ICO Registered ==

In using Logistack as a business in the UK, you will need to register with the Information Commissioners Office, there is a charge of £55 / year if you pay by direct debit.

== Example Privacy Policy ==

Based on everything that Logistack collects.

-------

'''PRIVACY POLICY'''

Last updated October 14, 2025

This Privacy Notice for Venture Logistics Ltd ('we', 'us', or 'our'), describes how and why we might access, collect, store, use, and/or share ('process') your personal information when you use our services ('Services'), including when you:

Visit our website at logistack.co.uk or any website of ours that links to this Privacy Notice

Use Courier. Venture Logistics is a UK courier/delivery company. We provide an online portal where customers book jobs, track deliveries, view Proof of Delivery (POD), and download invoices. We hold the names, address, phone and email.

Engage with us in other related ways, including any sales, marketing, or events

Questions or concerns? Reading this Privacy Notice will help you understand your privacy rights and choices. We are responsible for making decisions about how your personal information is processed. If you do not agree with our policies and practices, please do not use our Services. If you still have any questions or concerns, please contact us at lee@venture-logistics.co.uk.

'''SUMMARY OF KEY POINTS'''

This summary provides key points from our Privacy Notice, but you can find out more details about any of these topics by clicking the link following each key point or by using our table of contents below to find the section you are looking for.

What personal information do we process? When you visit, use, or navigate our Services, we may process personal information depending on how you interact with us and the Services, the choices you make, and the products and features you use. Learn more about personal information you disclose to us.

Do we process any sensitive personal information? Some of the information may be considered 'special' or 'sensitive' in certain jurisdictions, for example your racial or ethnic origins, sexual orientation, and religious beliefs. We do not process sensitive personal information.

Do we collect any information from third parties? We do not collect any information from third parties.

How do we process your information? We process your information to provide, improve, and administer our Services, communicate with you, for security and fraud prevention, and to comply with law. We may also process your information for other purposes with your consent. We process your information only when we have a valid legal reason to do so. Learn more about how we process your information.

In what situations and with which parties do we share personal information? We may share information in specific situations and with specific third parties. Learn more about when and with whom we share your personal information.

How do we keep your information safe? We have adequate organisational and technical processes and procedures in place to protect your personal information. However, no electronic transmission over the internet or information storage technology can be guaranteed to be 100% secure, so we cannot promise or guarantee that hackers, cybercriminals, or other unauthorised third parties will not be able to defeat our security and improperly collect, access, steal, or modify your information. Learn more about how we keep your information safe.

What are your rights? Depending on where you are located geographically, the applicable privacy law may mean you have certain rights regarding your personal information. Learn more about your privacy rights.

How do you exercise your rights? The easiest way to exercise your rights is by submitting a data subject access request, or by contacting us. We will consider and act upon any request in accordance with applicable data protection laws.

Want to learn more about what we do with any information we collect? Review the Privacy Notice in full.

== 1. WHAT INFORMATION DO WE COLLECT? ==

Personal information you disclose to us

In Short: We collect personal information that you provide to us.

We collect personal information that you voluntarily provide to us when you register on the Services, express an interest in obtaining information about us or our products and Services, when you participate in activities on the Services, or otherwise when you contact us.

Personal Information Provided by You. The personal information that we collect depends on the context of your interactions with us and the Services, the choices you make, and the products and features you use. The personal information we collect may include the following:

* names
* phone numbers
* email addresses
* mailing addresses
* usernames
* passwords
* billing addresses

'''Sensitive Information'''

We do not process sensitive information.

All personal information that you provide to us must be true, complete, and accurate, and you must notify us of any changes to such personal information.

== 2. HOW DO WE PROCESS YOUR INFORMATION? ==

In Short: We process your information to provide, improve, and administer our Services, communicate with you, for security and fraud prevention, and to comply with law. We may also process your information for other purposes with your consent.

We process your personal information for a variety of reasons, depending on how you interact with our Services, including:

To facilitate account creation and authentication and otherwise manage user accounts. We may process your information so you can create and log in to your account, as well as keep your account in working order.

To deliver and facilitate delivery of services to the user. We may process your information to provide you with the requested service.

To fulfil and manage your orders. We may process your information to fulfil and manage your orders, payments, returns, and exchanges made through the Services.

To enable user-to-user communications. We may process your information if you choose to use any of our offerings that allow for communication with another user.

To comply with our legal obligations. We may process your information to comply with our legal obligations, respond to legal requests, and exercise, establish, or defend our legal rights.

== 3. WHEN AND WITH WHOM DO WE SHARE YOUR PERSONAL INFORMATION? ==

In Short: We may share information in specific situations described in this section and/or with the following third parties.

We may need to share your personal information in the following situations:

Business Transfers. We may share or transfer your information in connection with, or during negotiations of, any merger, sale of company assets, financing, or acquisition of all or a portion of our business to another company.

When we use Google Maps Platform APIs. We may share your information with certain Google Maps Platform APIs (e.g. Google Maps API, Places API). Google Maps uses GPS, Wi-Fi, and cell towers to estimate your location. GPS is accurate to about 20 meters, while Wi-Fi and cell towers help improve accuracy when GPS signals are weak, like indoors. This data helps Google Maps provide directions, but it is not always perfectly precise.

== 4. DO WE USE COOKIES AND OTHER TRACKING TECHNOLOGIES? ==

In Short: We may use cookies and other tracking technologies to collect and store your information.

We may use cookies and similar tracking technologies (like web beacons and pixels) to gather information when you interact with our Services. Some online tracking technologies help us maintain the security of our Services and your account, prevent crashes, fix bugs, save your preferences, and assist with basic site functions.

We also permit third parties and service providers to use online tracking technologies on our Services for analytics and advertising, including to help manage and display advertisements, to tailor advertisements to your interests, or to send abandoned shopping cart reminders (depending on your communication preferences). The third parties and service providers use their technology to provide advertising about products and services tailored to your interests which may appear either on our Services or on other websites.

Specific information about how we use such technologies and how you can refuse certain cookies is set out in our Cookie Notice.

== 5. DO WE OFFER ARTIFICIAL INTELLIGENCE-BASED PRODUCTS? ==

In Short: We offer products, features, or tools powered by artificial intelligence, machine learning, or similar technologies.

As part of our Services, we offer products, features, or tools powered by artificial intelligence, machine learning, or similar technologies (collectively, 'AI Products'). These tools are designed to enhance your experience and provide you with innovative solutions. The terms in this Privacy Notice govern your use of the AI Products within our Services.

'''Our AI Products'''

Our AI Products are designed for the following functions:

* AI bots

'''How We Process Your Data Using AI'''

All personal information processed using our AI Products is handled in line with our Privacy Notice and our agreement with third parties. This ensures high security and safeguards your personal information throughout the process, giving you peace of mind about your data's safety.

== 6. HOW LONG DO WE KEEP YOUR INFORMATION? ==

In Short: We keep your information for as long as necessary to fulfil the purposes outlined in this Privacy Notice unless otherwise required by law.

We will only keep your personal information for as long as it is necessary for the purposes set out in this Privacy Notice, unless a longer retention period is required or permitted by law (such as tax, accounting, or other legal requirements). No purpose in this notice will require us keeping your personal information for longer than sixty (60) months past the termination of the user's account.

When we have no ongoing legitimate business need to process your personal information, we will either delete or anonymise such information, or, if this is not possible (for example, because your personal information has been stored in backup archives), then we will securely store your personal information and isolate it from any further processing until deletion is possible.

== 7. HOW DO WE KEEP YOUR INFORMATION SAFE? ==

In Short: We aim to protect your personal information through a system of organisational and technical security measures.

We have implemented appropriate and reasonable technical and organisational security measures designed to protect the security of any personal information we process. However, despite our safeguards and efforts to secure your information, no electronic transmission over the Internet or information storage technology can be guaranteed to be 100% secure, so we cannot promise or guarantee that hackers, cybercriminals, or other unauthorised third parties will not be able to defeat our security and improperly collect, access, steal, or modify your information. Although we will do our best to protect your personal information, transmission of personal information to and from our Services is at your own risk. You should only access the Services within a secure environment.

== 8. DO WE COLLECT INFORMATION FROM MINORS? ==

In Short: We do not knowingly collect data from or market to children under 18 years of age.

We do not knowingly collect, solicit data from, or market to children under 18 years of age, nor do we knowingly sell such personal information. By using the Services, you represent that you are at least 18 or that you are the parent or guardian of such a minor and consent to such minor dependent’s use of the Services. If we learn that personal information from users less than 18 years of age has been collected, we will deactivate the account and take reasonable measures to promptly delete such data from our records. If you become aware of any data we may have collected from children under age 18, please contact us at lee@venture-logistics.co.uk.

== 9. WHAT ARE YOUR PRIVACY RIGHTS? ==

In Short: You may review, change, or terminate your account at any time, depending on your country, province, or state of residence.

Withdrawing your consent: If we are relying on your consent to process your personal information, which may be express and/or implied consent depending on the applicable law, you have the right to withdraw your consent at any time. You can withdraw your consent at any time by contacting us by using the contact details provided in the section 'HOW CAN YOU CONTACT US ABOUT THIS NOTICE?' below.

However, please note that this will not affect the lawfulness of the processing before its withdrawal nor, when applicable law allows, will it affect the processing of your personal information conducted in reliance on lawful processing grounds other than consent.

'''Account Information'''

If you would at any time like to review or change the information in your account or terminate your account, you can:

Contact us using the contact information provided.

Upon your request to terminate your account, we will deactivate or delete your account and information from our active databases. However, we may retain some information in our files to prevent fraud, troubleshoot problems, assist with any investigations, enforce our legal terms and/or comply with applicable legal requirements.

Cookies and similar technologies: Most Web browsers are set to accept cookies by default. If you prefer, you can usually choose to set your browser to remove cookies and to reject cookies. If you choose to remove cookies or reject cookies, this could affect certain features or services of our Services.

If you have questions or comments about your privacy rights, you may email us at lee@venture-logistics.co.uk.

== 10. CONTROLS FOR DO-NOT-TRACK FEATURES ==

Most web browsers and some mobile operating systems and mobile applications include a Do-Not-Track ('DNT') feature or setting you can activate to signal your privacy preference not to have data about your online browsing activities monitored and collected. At this stage, no uniform technology standard for recognising and implementing DNT signals has been finalised. As such, we do not currently respond to DNT browser signals or any other mechanism that automatically communicates your choice not to be tracked online. If a standard for online tracking is adopted that we must follow in the future, we will inform you about that practice in a revised version of this Privacy Notice.

== 11. DO WE MAKE UPDATES TO THIS NOTICE? ==

In Short: Yes, we will update this notice as necessary to stay compliant with relevant laws.

We may update this Privacy Notice from time to time. The updated version will be indicated by an updated 'Revised' date at the top of this Privacy Notice. If we make material changes to this Privacy Notice, we may notify you either by prominently posting a notice of such changes or by directly sending you a notification. We encourage you to review this Privacy Notice frequently to be informed of how we are protecting your information.

== 12. HOW CAN YOU CONTACT US ABOUT THIS NOTICE? ==

If you have questions or comments about this notice, you may contact our Data Protection Officer (DPO) by email at lee@venture-logistics.co.uk, by phone at 07788821121, or contact us by post at:

Venture Logistics Ltd
Data Protection Officer
57, Braeburn Road
Great Horkesley
COLCHESTER
CO6 4FH,
United Kingdom

== 13. HOW CAN YOU REVIEW, UPDATE, OR DELETE THE DATA WE COLLECT FROM YOU? ==

Based on the applicable laws of your country, you may have the right to request access to the personal information we collect from you, details about how we have processed it, correct inaccuracies, or delete your personal information. You may also have the right to withdraw your consent to our processing of your personal information. These rights may be limited in some circumstances by applicable law. To request to review, update, or delete your personal information, please fill out and submit a data subject access request.

= Security =

See the article on [[Logistack Security]]

Security and privacy

2025-10-14T17:15:58Z

Lee Miller: Created page with "== ICO Registered == In using Logistack as a business in the UK, you will need to register with the Information Commissioners Office, there is a charge of £55 / year if you pay by direct debit. == Example Privacy Policy == Based on everything that Logistack collects. ------- '''PRIVACY POLICY''' Last updated October 14, 2025 This Privacy Notice for Venture Logistics Ltd ('we', 'us', or 'our'), describes how and why we might access, collect, store, use, and/or sha..."

Booking Module

2025-10-14T06:50:37Z

Lee Miller: /* Video Demonstration */

The Booking Module is designed to create an easy method from customers to book services, it comes with multiple section for your customer to add everything about their delivery.

-----

https://logistack.co.uk/uploads/bookings.jpg

== Video Demonstration ==

Watch video full screen for better clarity, and hit the gear icon to set quality to 1080 HD.

<youtube></youtube>

Quote Calculator

2025-10-14T06:39:52Z

Lee Miller: /* Video Guide */

= Quote Calculator Module =

See the video below for a demo on how this module works and how to edit the calculation factors.

== Summary ==
The Quote Calculator provides a highly accurate cost of delivery, in real time from a postcode. It combines distance, fuel, labour, and regional surcharges (e.g., London/ULEZ/C-Charge), and then produces a customer-facing price with transparent line items.

== Audience ==
* '''Admins:''' configure pricing, surcharges, and rules.
* '''Staff:''' generate quick quotes for callers.
* '''Customers:''' Self-serve accurate quotes via the website.

== Capabilities ==
* Distance-based pricing from depot to destination and return.
* Cost model: fuel (mpg × diesel £/L), labour £/hr, base fee, per-mile, and regional surcharges.
* All quotes requests are record in administration along with customer phone and email for easy follow up.

== Configuration ==
All values below are configurable in Settings.

=== Core Cost Parameters ===

* '''Depot postcode:''' e.g., <code>CO64FH</code>
* '''Base fee (£):''' e.g., <code>25.00</code>
* '''Per-mile rate (£/mile):''' e.g., <code>1.10</code>
* '''Labour rate (£/hr):''' e.g., <code>17.50</code>
* '''Diesel price (£/L):''' e.g., <code>1.42</code>
* '''Vehicle MPG (UK):''' e.g., <code>38.0</code>

=== Regional Surcharges ===

* '''London surcharge (£):''' e.g., <code>50.00</code>
* '''ULEZ / Congestion:''' fixed amounts or pass-through (configurable)
* '''Dartford Crossing'''
* '''London Tunnels'''

=== Presentation ===

* '''VAT behaviour:''' include/exclude
* '''Discount codes:''' applied when creating an invoice

== Price Formula (reference) ==
<pre>
distance_miles = route_distance(from=Depot, to=Postcode[, return=true|false])

fuel_litres = (distance_miles / vehicle_mpg_uk) * 4.546
fuel_cost = fuel_litres * diesel_price_per_litre

labour_hours = ( (distance_miles / avg_mph) + (loading_minutes/60) ) * crew_count
labour_cost = labour_hours * labour_rate_per_hour

mileage_cost = distance_miles * per_mile_rate
surcharges_total = london_surcharge + ulez + congestion + extras

subtotal = base_fee + mileage_cost + fuel_cost + labour_cost + surcharges_total
subtotal = max(subtotal, minimum_charge)
price_rounded = apply_rounding(subtotal)
final_price = apply_vat(price_rounded)
</pre>

'''Example (illustrative):'''
<pre>
Depot CO6 4FH → SW1A 1AA (one-way 68 mi), MPG 38, Diesel £1.42/L
fuel_litres ≈ (68 / 38) * 4.546 = 8.13 L
fuel_cost ≈ 8.13 * 1.42 = £11.55
mileage = 68 * £1.10 = £74.80
labour = 2.0 hrs * £17.50 = £35.00 (example)
surcharges = London £50.00
subtotal = base £25 + £74.80 + £11.55 + £35 + £50 = £196.35 → rounded to £195/£200 per rule
</pre>

== Permissions ==
* '''Admin:''' can configure pricing, view logs, export quotes.
* '''Manager:''' can view logs and export quotes.
* '''Staff:''' can create quotes
* '''Customer / visitors:''' can generate quotes.

== User Flow ==
# Enter destination postcode (no space e.g. CO43FH).
# Click '''Calculate'''. A quotation is displayed along with a break down of the costs.
# Quotation saved in administration.
# Happy with quotation? Click here to Book the delivery.
# Customer books the service.
#Booking sent to administration.

== Database ==

All 2.8 million postcodes are included, from England, Scotland and Wales.

The database, an .sql file, was incredibly difficult to refine to the point where it was possible to upload, its current size is 88MB, was reduced from an initial 1.2GB.

== Validation ==
* UK postcode format (server + client).
* Numeric bounds for miles, rates, and surcharges.
* Permission checks on pricing endpoints (only Admin may change settings).
* Rate limiting on public calculator to prevent abuse.

== Caching & Performance ==
* Postcode → lat/lon cached in '''postcode_cache''' (TTL configurable).
* Distance calculation memoised for last N lookups.
* Enable '''Preserve log''' in DevTools when debugging Network requests.
* Consider CDN caching for static calculator assets.

== Errors & Troubleshooting ==
* '''“No price returned”''' Only 2 possibilities, 1. The user entered the postcode with a space, or a customization of the quote_calc_save.php file.
* '''“Feels slow”''' Because Google Routes plans the route using roads (not as the crow flies), destinations a long way from your depot will take longer to calculate, thus the quote takes longer to appear - this is normal.
* '''“Google Error message”''' Almost always due to adding the API Key incorrectly - the only fix is changing via the database (phpMyAdmin).
* Provide a full report using [[Troubleshooting|How to Report an Issue]].

== Admin Tips ==
* Review minimum charge and rounding quarterly.
* Keep diesel price updated weekly.
* Use discount codes sparingly; prefer fixed-price overrides for special jobs.
* Add London/ULEZ/C-Charge as separate line items to keep audits clean.

== FAQ ==
* '''Can I include return mileage?''' Yes, the calculator is set up for the total journey distance - why would we only charge for half the journey?
* '''Do customers see line items?''' Public view a full breakdown of the cost by default, this can be modified. Admin can see what's important (Name, Phone & email, postcode, distance and price.
* '''How do I change the settings?''' Watch the video below for a full explanation.
* '''Why does the mileage seem high?''' The journey distance is for there and back.

== Release Notes ==
* '''v1.8.7''' – UI polish, faster list rendering, clearer errors on failed POD upload; minor rounding fixes in PDFs (see Release Notes).

== Roadmap ==

A few additions in the pipeline, both UI and functionality improvements - see Logistack development [[Roadmap]] for more info.

== Video Guide ==

Watch video full screen for better clarity, and hit the gear icon to set quality to 1080 HD.

<youtube>Uxe2vjdGYxM</youtube>

2025-10-13T11:50:20Z

Lee Miller: /* How to Report an Issue */

Logistack is stable software with many months of development and testing. I've installed on several environments, both locally and externally, and it should under most circumstances perform perfectly without error. That said, the software, being mostly a back-end platform, includes error reporting code that will create a a snippet of code at the top of the page, giving the reason why the error occurred.

'''Do not attempt to edit any core (back-end) .php files,''' it is a fragile language that will, cause an error, and the inability to view the affected page.

== Reporting Errors ==

Do not, under any circumstance, post PHP errors at our GitHub support, doing this can lead to the hijacking of your website!

== How to Report an Issue ==

Logistack includes a detailed error reporting mechanism, that uses the 500 error page.

Whenever there's a significant error, or in some circumstances a warning, an error log is created, and the error is shown on that page.

You'll need to be logged as an admin to see this page, all non-admins are redirected to a page asking them to report the incident.

In the first instance, copy this message, create a new issue at the GitHub Community, and paste the message.

Remove the path, just leaving the file name.

== Using Developer Tools ==

Amazing tool that makes debugging a lot easier.

For a video guide on how to use developer tools, see [[Developer Tools Guide]]

== Privacy & Security ==

* '''Never share API keys, cookies, Authorization headers, or a full JSON Web Token''' - not even with me!
* Mask secrets like: <code>sk-****last4</code>.
* Remove personal data unless it is essential to reproduce the issue.

Lee Miller: /* Overview */

== Overview ==

Logistack's mobile app implement two technology stacks;

# The majority uses a slimmed down version of Logistack desktop, allowing it to utilize the database.
# The Tracking module implements Android - see below for more.

View the '''[https://pro.logistack.co.uk/mobile/mobile_jobs.php mobile app]'''

The app allows access to Admins, Superusers, Drivers and Customers.

* '''Admins''' - jobs uploaded to the app from Logistack database, all data viewable, i.e. driver location (tracking), job status, PODs and notes.
* '''Drivers''' - Upload PODs and add notes.
* '''Customers''' - most data viewable, i.e. driver location (tracking), job status and PODs, but not notes.

== Tracking ==

To provide '''constant''' tracking, it isn't practical to use PHP, without modifying the settings of the mobile device, which in turn leads to inefficient use of the battery.

== Notes ==

Used to report issues concerning the delivery, that you don't want the customer to see.

== App Status ==

Project started 11/10/2025, expected completion early 2026.

== Release Note ==

Stable - But not ready for use, still needs the tracking to be reliable.