Logistica

Changelog — Logistica

All notable changes to this app are recorded here. Newest entries on top.

[2026-07-08]

• Fixed: releasing items no longer errors with "Cargo ID is required." On the Release Items screen you can now simply tick the quantity for whichever item(s) you want to release straight from the shipment's itemized list and confirm — the system picks up each item's ID automatically. You can release several items at once in a single confirm.
• Write-off (subsidy) on a shipment. The shipment charges section now has a Write-off field — a fixed amount you can knock off a shipment's total as a subsidy or goodwill discount. E.g. on a ₦2,000,000 charge, a ₦50,000 write-off leaves ₦1,950,000 to pay. The breakdown now shows the Subtotal, the Write-off, and the final Total as separate lines on the admin page, the customer's tracking page, and the shared receipt.
• Custom CBM rate per shipment. You can now give an individual shipment its own discounted CBM rate that overrides the container's general rate — for that shipment only. Tick "Use a custom CBM rate for this shipment" in Edit Details and enter the rate (e.g. charge ₦120,000/CBM for one customer while the container stays at ₦200,000 for everyone else). The custom rate is clearly flagged as "custom rate" in the charge breakdown, sticks even when the container is updated, and works alongside the write-off and the flat service charge — each shown as its own line.

[2026-07-07]

• Flat service charge per container. Each container now has a Service charge field (set it when creating or editing a container). It's a fixed fee that's automatically added to every shipment in that container — regardless of the shipment's size, weight or goods category. When a shipment arrives, its total becomes: shipping charge (CBM + goods category) plus the container's flat service charge. The service charge appears as its own line in the charge breakdown on the admin shipment page, the customer's tracking page, and the shared receipt — so both you and the customer see it clearly and separately. Admins and staff can both set it.
• Staff can now fully edit containers — for real this time. Saving a container edit was silently failing for staff: the save tried to update a business-wide setting (the shared rate-category list) that only admins can touch, so the whole save was rejected with "permission denied" and nothing changed. Staff can now update container details, change the status (Booked / In Transit / Arrived Warehouse), set the CBM rates and rate categories, and save any edits — all without needing admin/settings access.
• Staff can now reach the Accounts section on their phone. On mobile, the bottom bar only fits four shortcuts, and Accounts (and Support) were dropping off the end with no way to get to them. Staff now have a "More" button in the bottom bar that opens Accounts, Support, and Sign out — so staff can open Accounts and record company expenses from their phone.
• Container expenses form fixed for mobile. The "add expense" box on a container was cramped into one squeezed line where you couldn't see the amount you were typing. It's now a clean, full-width stacked form — a roomy Description field, an Amount field that clearly shows the number as you type it, and a full-width "Add Expense" button — with comfortable spacing and bigger tap targets.

[2026-07-03]

• Tutorials rewritten — short, step-by-step, and current. All five in-app tutorial articles now walk through the real screens in numbered steps. They no longer describe the old property-rental workflow (rent, repairs, landlords) or booking-time rates — they cover today's flow: container CBM rates per goods type, automatic charging on Arrived Warehouse, part-payments, customer PINs and self sign-up, and staff logins.
• Promotional copy refreshed. The proposal, email, and social swipe files now pitch the cargo business Logistica actually is (auto charges on arrival, live customer tracking, Paystack part-payments, container profit & loss) with correct Naira pricing, replacing the outdated "$10/mo rental properties" copy.
• Staff can now delete shipments and containers, and open Reports. Expanding on the earlier role split, staff members can now delete a shipment, delete an entire container, and view the Reports section (collections and numbers). Settings, Paystack, and staff management remain admin/owner only.

[2026-07-02]

• Activity log now always names the person who actually did it. Even with the owner still signed in on the same device, a staff member's actions are now recorded under that staff member's own name — never the owner's or the business name. Each person's login decides whose name appears in the log, independent of the business/profile name and any settings.
• Clear roles: Admin vs Staff. Staff members can sign in, view shipments and customers, and record shipments and payments — but they can no longer open Settings, configure Paystack, manage other staff, or delete records (shipments or whole containers). Anyone you promote to the Admin role gets the exact same full access as you (settings, Paystack, everything). Restricted buttons and menu items are now hidden for staff so each person only sees what their role allows.
• Staff can now fully manage containers and accounts. Staff members can create and edit containers, set and update each container's shipping rates and charges, and add, edit and remove container expenses. They also have full access to the Accounts section to input, edit and manage company expenses and records. (Deleting an entire container remains admin/owner only.)

[2026-07-01]

• Activity log shows real people, not the business name. Staff members now appear in the activity log by their own login name when they sign in with their own staff account. And there's a new Settings → Business Info → "Your name (activity log)" field so your own actions show your personal name instead of your business/profile name (leave it empty to keep using your profile name).

[2026-06-30]

• Activity log now names the actual person. Every activity previously read "by Admin." It now shows the specific staff member who performed the action (by their name), and the owner's own actions show the owner's real name instead of a generic "Admin." (Older entries recorded before this update still show the generic label.)

[2026-06-29]

• "Change Status" is now right under the status timeline on the shipment page, so you don't have to scroll to the bottom to update a shipment.
• Editable rate categories on containers. On a container you can now add, rename, and delete the CBM rate categories (and their rates) directly from the container details — no need to go to Settings. Category names are shared across the app (booking, other containers), while each container keeps its own rates.
• Fixed: changing a shipment's category now updates its charge. If a shipment's goods type is changed (e.g. Compressed Goods → Carton), the charge immediately recalculates using the new category's rate on the container instead of keeping the old rate.
• Fixed: "Install app" now shows on phones. The install prompt on the customer dashboard previously only appeared on desktop; it now appears on Android and iPhone too (with tap-through "Add to Home Screen" steps when the browser doesn't offer a one-tap install), and still hides once the app is installed.

[2026-06-28]

• Charge by goods type. Each shipment now has a Goods Type (e.g. Compressed Goods, Bale, Carton — the list is managed under Settings → Goods Types and can be extended). On a container you set a CBM rate per goods type (plus a default for anything else). When the container is marked Arrived Warehouse, each shipment is charged using its goods type's rate on that container — e.g. 1 CBM of compressed goods at ₦50,000 = ₦50,000, 1 CBM of cartons at ₦100,000 = ₦100,000. The shipment's KG rate and discount still apply on top.
• Container status renamed "Arrived" → "Arrived Warehouse" across the app (filters, dropdowns, badges). The automatic charge + shipment-arrival logic now triggers on this status.
• Fixed: changing a shipment's status. Status changes now save reliably — cancelling a shipment correctly asks for (and records) a reason instead of silently failing, and pre-arrival shipments clearly show that their stage follows the container.
• Install button on the customer home screen. Customers now see a clear "Install" button on their dashboard to add the app to their home screen (with iPhone instructions where needed). It disappears automatically once the app is installed or already running as an app.

[2026-06-26]

• Simpler container statuses. A container now has just three stages — Booked → In Transit → Arrived — everywhere (create form, edit, filters, badges). The old "Loading" and "Closed" options were removed.
• Delivered & Partial Delivery for shipments. Once a shipment has Arrived, you can mark it Partial Delivery (some goods released) or Delivered. These options only appear after arrival; before that, a shipment's stage follows its container. Both show on the admin and customer sides.
• Edit & delete in Accounts. Every company expense can now be edited or deleted directly from the Accounts screen.
• Easier app install. The "Install app" option now also appears on iPhone/iPad with step-by-step Add-to-Home-Screen instructions, and it's hidden once the app is already installed — so you no longer hit "already installed / can't install" confusion.

[2026-06-23]

• Fixed: deleting a container after reassigning its shipments. Reassigning a shipment to another container (by typing/picking its number on the shipment) now actually moves it, so once a container's shipments have all been reassigned or removed, it deletes successfully. Previously the move only changed the displayed number, so the delete check still saw the old assignment.
• Clear "can't delete yet" dialog. When a container (or other record) still has things attached, you now get a dialog listing exactly which shipments are holding it up — each one tappable so you can go reassign or remove it — instead of a vague error.
• Fixed the Paystack "Could not load the payment library" error. The payment-library loader now loads its own copy on demand, waits for it, and never gets stuck in a failed state — so the payment modal opens reliably even after a slow or interrupted first attempt.
• Removed KG rate & discount from the customer screen. Those are now set per shipment only (see below), so they no longer appear on the customer add/edit forms.
• Per-shipment KG rate & discount. On an arrived shipment you can now set a KG rate and a discount % (with a reason) for that one shipment, overriding the customer's defaults. Each field pre-fills from the customer's setting, and editing the container later (or its CBM rate) no longer wipes a per-shipment override.
• Fixed: editing a shipment could clear its ETA. Saving the shipment edit form no longer blanks the arrival date or other fields it didn't change.
• Fixed "all paid up" showing when a balance is still owed. The customer dashboard's amount-due total was ignoring delivered shipments, so a customer with unpaid delivered shipments could wrongly see "You're all paid up." It now counts every unpaid shipment (any status except cancelled), matching the unpaid badge.
• Per-customer KG rate. You can now set an optional KG rate on each customer (Customers page / customer profile). When set, that customer's shipments are charged by weight using their own rate — it's no longer on the container.
• Per-customer discounts are back. Set an optional discount % on any customer; it's automatically applied to that customer's shipment charges on top of the container's CBM rate. Changing it updates their already-arrived shipments too.
• Customers can open any shipment — even in-transit ones. Instead of just a count, every shipment on the customer dashboard is now tappable and shows its full details (cargo list, assigned container, ETA, and current status). Charges and the payment button still appear only once a shipment has arrived.
• Container status always stays in sync with shipments. Changing a container's status now updates its shipments in both directions immediately — marking it Arrived arrives them (and their charges appear), and moving it back to In Transit or Loading moves them back (and their charges hide) on both the admin and customer sides.

Internal

• Production-readiness pass. Removed dead/broken navigation left over from the original clone: the Home dashboard no longer shows an owner view that called a non-existent endpoint or linked to a missing "Projects" page, and the staff Home quick-links now point to Containers instead of a non-existent Profile page.
• Removed the leftover "Special Projects" settings section — it toggled a page that no longer exists in Logistica.
• Copy fix: the customer portal sign-in now reads "Track your shipments, view charges, and pay your balance" instead of the old property-rental wording.
• Audited every screen: all PHP files lint clean, every client API call maps to a real handler, and every in-app link resolves to a real route.

[2026-06-22]

• Charges now come from the container — and only after it arrives. Booking a shipment no longer asks for rates: you just record the cargo, pick its container, and (optionally) note a float estimate. Each container carries its own CBM rate, KG rate and ETA. The moment you mark a container Arrived, every shipment inside it automatically becomes Arrived too and inherits that container's rate and ETA — so its charge appears instantly without re-entering anything.
• No charges shown until arrival. Shipments that are still Booked or In Transit show no charge and no payment option — for you and for the customer. Customers see a simple status like "2 shipments in transit" instead of a price, and a clear note that charges open once the goods arrive. Per-customer discounts and the optional KG charge are applied on top of the inherited container rate once arrived.
• Two business contact numbers. Set a separate call number and WhatsApp number under Settings → Business Info. Both are shown to customers on receipts and the tracking portal so they know which line to use for what. (The earlier per-customer two-number field was removed — it was added by mistake.)
• One shared set of company data across all offices. Your offices no longer keep separate, siloed data. Add a customer or book a shipment at any office and everyone — at every office — sees and can edit it. It's all one company now.
• Manage your offices. You can now edit any office (including the first/default one) and delete any office you no longer need, as long as one remains. Deleting an office never deletes data — any records tagged to it simply move to another office.
• Customers can pay part of a balance. On both the invoice page and the customer portal, customers can now enter any amount they want to pay toward an outstanding balance instead of being forced to pay the full amount at once.
• More reliable card payments. Fixed the "Payment library failed to load" error — the Paystack checkout is loaded up front and also retried on demand, so the pay button works even on slower or briefly interrupted connections.
• Clearer wording throughout. Renamed every remaining "tenant" to "customer" and replaced leftover property-rental wording (properties, IDs, agreements) with logistics-appropriate language across the app, settings, receipts, and the activity log.
• Fixed: couldn't add a shipment. Resolved the misleading "network failure" message shown when confirming a new shipment; the booking now completes and reports the real reason if anything goes wrong.

[2026-06-17]

• Your currency is now used everywhere. The currency symbol set in Settings is respected across the whole app — including the Accounts ledger and the expense entry screens, which previously showed a dollar sign. Fresh installs lock the symbol in automatically.
• Money fields format as you type. When you enter an amount anywhere — expenses, shipping rates, handling fees, discounts, prices, payments — the figure now shows thousands separators (e.g. 1,500,000) so it's easy to read exactly what you typed. For Naira, kobo decimals are ignored.

[2026-06-16]

• Configurable tax / VAT on invoices. Turn on a tax under Settings → Tax / VAT (set the label and rate) and every new shipment automatically adds it as its own line on the invoice, receipt, and customer portal. The rate is locked onto each invoice when it's created, so changing it later never alters older invoices.
• Record company expenses. New Accounts tab where you log operational costs, asset purchases, and vendor payments — categorised (Rent, Salary, Asset, Vendor, Utilities, Transport, Tax, Other) — so your real costs are captured, not just per-container ones.
• Company ledger + profit/loss. The Accounts tab shows a single ledger of every transaction — money in (customer payments) and money out (company + container expenses) — with a summary of Income, Expenses, Net Profit/Loss, and Outstanding owed to you, for any date range.
• Track containers and their profit & loss. New Containers tab: each container you load in China holds many customers' shipments. Record what the container cost you (shipping line, clearing, transport — any expense lines you like) and see its full picture at a glance — total billed, money collected, what's still outstanding from customers, and profit on both a collected and a billed basis.
• Assign shipments to a container. When booking a shipment you can now pick which container it's travelling in, so revenue rolls up to the right container automatically.
• Float estimate at booking. Add an optional rough freight quote when you book in China and share it with the customer early — the real charge is still worked out from CBM/KG when the goods arrive at the warehouse.
• See released vs. remaining goods per customer. A customer's profile now shows how many pieces have been released and how many are still in your warehouse — handy when someone has paid part of their bill and collected only some of their goods.
• Customers tab is now a full hub. Open any customer to see their details, their shipments (with balance and release status), goods released, and send them a message — all in one place.
• Removed Shared Costs. Customers don't share charges, so that section is gone — replaced by container tracking and clearer company accounts (collections, outstanding, unpaid).
• Shipping-focused customer portal. The customer app now talks shipping: "Shipments" and "Issues" instead of charges and repairs. Customers raise an issue about a shipment (with a photo) instead of "reporting a repair."
• Customers can pay in the app with Paystack. Customers sign in and settle their shipment balance online; you can also record cash and transfers yourself.
• Shipping document types. Upload categories are now Manifest, Packing List, Invoice, Receipt, Bill of Lading, Waybill, and Customs Declaration.
• Internal: every remaining "tenant" wording is now "customer".

[2026-06-15]

• Logistica is here — run your whole cargo business from one app. Book shipments, track them through Booked → In Transit → Arrived → Releasing → Delivered, and keep every customer in the loop.
• Charge by weight or volume. Set a CBM (volume) rate and a per-kg rate on each shipment; the total works itself out from your cargo's measurements, plus a handling fee, minus any discount.
• Track containers and bales. Record the container number and add each bale with its own weight and volume. Mark how many pieces have been released when customers pick up in parts.
• Pickup or delivery, your choice. Flag each shipment for warehouse pickup or delivery to the customer, with a handling fee when you need one.
• Customers track and pay online. Customers sign in to see their shipments, cargo breakdown, and balance — and pay it with Paystack, right from their phone.
• Record off-channel payments in seconds. Took cash or a bank transfer? Log it against the shipment and the balance updates instantly.
• WhatsApp a customer in one tap. From any shipment, tap WhatsApp Customer to open a chat straight to their saved number with the shipment summary ready to send.
• Split shared container costs. Pool clearing, demurrage, or consolidation costs across customers — everyone sees who has paid.
• Built-in support chat. Customers raise questions or damage claims with a photo and message back and forth with your team until resolved.
• Multiple offices, one account. Run more than one office, each with its own shipments, customers, and dashboard.
• Reports that help. Collections, outstanding, top customers, top cargo types, and daily trends — with CSV export.