FAMA LOGISTICS

Version 1 scope Operating foundation Branches, stock, clients, sales, logistics, expenses

Dashboard

Search Lang

Action Secure Login to load branch-scoped actions.

Login required-Sign in to load your branch dashboard

Branch operating snapshot

Founder view across China logistics and Africa trading companies

Branch	Entity Type	Manager	Warehouse Stock	Sales	Shipments	Expenses	Status	Actions
Login to load your branch-scoped dashboard

Today’s action queue

Login to load branch actions

Exception follow-up log

Assigned owners, due dates, and resolution status

Follow-up	Exception	Branch	Owner	Due	Status	Action note	Actions
Login to load records for your branch only

Branch directory

Each branch has a manager and assigned operating scope

Branch	Country/City	Manager	Staff	Role	Market Report	Status	Actions
Login to load records for your branch only

Role permissions

Founder role can be assigned to multiple trusted founder accounts Founder Account 1: Founder / CEO Founder Account 2: Co-founder / Director Founder accounts see all branches, update stock, and approve expenses Manager sees own branch and updates stock Warehouse staff updates stock only Accountant approves expenses Client tracks own shipment only

Staff account directory

Real login accounts scoped by branch and role

Name	Email	Role	Branch	Status	Created	Actions
Login to load staff accounts

Client records0Waiting for live backend

Wholesale buyers0Waiting for live backend

Logistics clients0Waiting for live backend

Mixed clients0Waiting for live backend

Follow ups0Waiting for live backend

Client dashboard

Own shipments, invoices, currency swaps, and founder replies

Shipments0Own logistics records

Open invoices0Awaiting payment

Currency swaps0Requests and replies

ShipmentsLogin to load your shipments

InvoicesLogin to load your invoices

Founder replies appear here.

My account

Email, country, and active client access

NameLogin required

EmailLogin required

CountryLogin required

Client profile

Required during transaction

Client database

Cumulative real client record

Client	Phone	Country	Type	Transactions	Last Activity	Status	Actions
Login to load records for your branch only

Client history

Latest client activity

Login to load records for your branch only

Founder currency swap inbox

Requests awaiting Founder review

PendingLogin as Founder to load requests

Currency swap conversation

Founder replies are sent to the client account

Select a request to review the latest client/founder exchange.

Currency swap desk

Client requests are reviewed and answered by Founder accounts

Request	Buying	Paying	Status	Actions
Login to load records for your branch only

Product records0Waiting for live backend

QR identities0Waiting for live backend

Categories0Waiting for live backend

Destination branches0Waiting for live backend

Stock units0Waiting for live backend

Product master list

Single source of truth for goods

Stock Keeping Unit	QR ID	Product	Category	Supplier	Buy Price	Sell Price	Stock	Margin	Batch	Destination	Actions
Login to load records for your branch only

Product record fields

Product identityName, stock keeping unit, QR ID, category, photos

Purchase detailSupplier, buy price, batch

Sales detailBranch selling price and margin

Movement detailWarehouse, container, status

Restock / market demand applications

Branch demand requests requiring Founder decision

Request	Branch	Product	Current	Requested	Demand	Target Price	Status	Actions
Login to load records for your branch only

Login required-Warehouse records load after login

Warehouse view

Choose location

QR scan console Open a goods record from carton, pallet, or client package code

QR ID Scan location Action Scan result appears above the table

Live video paneFuture CCTV/IP camera integration

Version 1 focuses on stock records, count proof, photos, invoices, and warehouse status. Live video can be integrated after the warehouse data foundation is stable.

Goods in warehouse

System quantity versus counted quantity

QR ID	Stock Keeping Unit / Batch	Goods	Warehouse	System Qty	Counted Qty	Reserved	Condition	Proof	Status	Actions
Login to load records for your branch only

Proof packet

Login required

Secure

QR record Scan to open full goods record, count history, photos, supplier, and movement trail.

PhotoStack A count label

InvoiceSupplier invoice attached

Manager noteConfirm before sale or transfer

AuditLogin to load audit history

Inbound receipt

Warehouse staff entry

Print and attach QR Attach to carton, pallet, or client package before warehouse storage.

Inbound queue

Received, inspected, and stored

ID	QR ID	Date	Goods	Source	Warehouse	Qty	Proof	Status	Actions
Login to load records for your branch only

Outbound dispatch board

Every stock exit requires reason and proof

ID	QR ID	Reason	Goods	From	Destination	Qty	Transport	Status	Actions
Login to load records for your branch only

Dispatch documents

OUT-4407

Outbound noteApproved by China HQ Admin

Truck proofDriver ID and loading photos

Client goodsClient can track own shipment

Shipment stages

Login required

China warehouseGoods received

Origin portLogin to load port status

Sea transitVessel departed

CustomsLogin to load customs status

Local warehousePending delivery

Client tracking portal

Shipment ID + client phone verification

Enter shipment details to view client-safe progress.

Branch transfer board

Request, approve, ship, and receive inter-branch stock moves

Transfer	QR ID	Goods	Source	Destination	Qty	Cost	Shipment	Status	Actions
Login to load records for your branch only

Shipment tracking board

Client and internal logistics records

Shipment	QR ID	Client	Mode	Origin	Destination	Container/AWB	Expected arrival	Stage	Status	Actions
Login to load records for your branch only

Sales orders--Waiting for live backend

Invoices issued--Commercial invoice PDF records

Outstanding balance--Invoices needing payment follow-up

Paid receipts--Receipt PDFs issued after payment

Payment risk--Partially paid or overdue invoices

Wholesale sales ledger

Branch trading records

Order	Invoice	Client	Phone	Branch	Product	Qty	Total	Payment	Stock Rule	Actions
Login to load records for your branch only

Sales summary

This month

Paid sales-

Pending-

Top branch-

Top product-

Invoice workspace

Sales Orders → Invoices → Payments → Receipts

FAMA LOGISTICS Commercial Invoice

Verify invoice

Invoice No.-

Client-

Phone-

StatusLogin required

Product	Qty	Unit Price	Total
Login to load invoice details

Useful statusesQuotation, Proforma invoice, Commercial invoice, Paid receipt

Payment statesDraft, sent, partially paid, paid, overdue, cancelled, refunded

Audit trailLogin to load branch-scoped audit history.

Scan QR or enter invoice number to verify payment status.

Stock rules

Draft invoice does not reduce stock Proforma invoice can reserve stock Confirmed commercial invoice deducts stock Cancelled invoice restores stock Refunded invoice requires founder/finance review

Expense entry

Manager submission

Approval queue

Proof required before approval

ID	Branch	Manager	Category	Amount	Proof	Status	Actions
Login to load records for your branch only

Report library

Inventory ReportDaily

Stock by warehouse

Available, reserved, damaged, missing, and in-transit quantities.

Branch scopedLogin requiredExport CSV

Shipment ReportDaily

Goods in transit

China warehouse, port, sea/air, customs, local delivery, and completed states.

Branch scopedLogin requiredClient view

Branch Transfer ReportDaily

Inter-branch stock movement

Requested, approved, in-transit, received, and proof status for goods moved between branches.

Source branchDestination branchProof status

Expense ReportWeekly

Proof and approval

Branch expenses by manager, category, proof status, and approval decision.

Branch scopedLogin requiredAudit ready

Sales ReportDaily

Wholesale sales performance

Orders, invoices, clients, payments, stock rules, and totals by branch.

Local currencyPaid statusExport CSV

Restock Demand ReportWeekly

Market demand requests

Branch restock applications with requested quantity, target price, urgency, supplier notes, and approval status.

Demand signalFounder decisionExport PDF

Currency Swap ReportWeekly

Client currency swap desk

Client swap requests, source and target currencies, rates, proof, status, and responsible sales staff.

Swap statusProof trailExport CSV

Exception ReportLive queue

Unresolved operational issues

Queue items from stock, expenses, shipments, sales, transfers, and restock requests.

SeverityNext ScreenExport PDF

Audit Trail ReportLive

User actions and record changes

Founder-only history for logins, invoices, stock, expenses, uploads, notifications, and exports.

Founder onlyExport CSVExport PDF

Notification Delivery ReportLive

WhatsApp and SMS delivery evidence

Provider SID, failure reason, recipient, channel, and queued-by history.

Role scopedExport CSVExport PDF

Invoice Aging ReportDaily

Outstanding receivables by age

Unpaid and partially paid invoices grouped by branch, client, balance, and aging bucket.

Local currencyPayment riskExport PDF

Client Statement ReportOn demand

Client invoice and payment statement

Invoice totals, paid amounts, balances, payment status, and PDF links by client.

Client ledgerLocal currencyExport CSV

Founder brief

Snapshot

Best sales branchLogin as Founder to load

Highest stock riskLogin as Founder to load

Most active portLogin as Founder to load

Expense riskLogin as Founder to load

Report preview

Generate a report to preview live rows before export

Report	Scope	Rows
Login to load branch-scoped reports

Document archive

Invoices, receipts, uploaded proofs, and generated reports

Type	ID	Title	Branch	File	Status	Created	Actions
Login to load records for your branch only

Audit trail

Founder-only history of user actions and record changes

Search Branch Action Record type

Time	User	Action	Record	Branch	Details	Actions
Login to load branch-scoped audit records

Report subscriptions

Scheduled report reminders for founders and branch managers

ID	Report	Frequency	Channel	Recipient	Status	Next run	Owner	Actions
Login to load branch-scoped report subscriptions

Notification outbox

Queued WhatsApp, SMS, and operational reminders

Time	Channel	Recipient	Message	Status	Related record	Provider	Queued by	Actions
-	Ready	Manager	Open backend to load live notifications	Ready	-	-	System	-

Database--Waiting for live backend

Schema--Migration status

Storage--Upload directories

Notifications--Provider status

Recent errors--Server log review

Runtime and storage

Not loaded

Area	Status	Path
Login as Founder to load system health

Latest backup

Database safety copy

No backup loaded Create a backup from Settings before major updates.

Recovery actions

Founder controls for backups, alerts, jobs, and notification dispatch

Recent server errors

Latest structured error log entries

Time	Request	Path	Error	Message
No server errors loaded

Configuration tables

Admin-managed basic settings

Languages5 values

EnglishChineseFrenchPortugueseSwahili

Currencies6 values

USDRMBBWPNADZMWNGN

Warehouses4 values

ChinaAfricaPortTransit

Categories2 values

ProductsExpenses

Roles6 values

FounderManagerWarehouseSalesFinanceClient

Role permission matrix

Visible modules, branch scope, and approved actions by account type

Role	Scope	Modules	Actions
Login to load role permissions

Branch company profiles

Legal names, local currencies, invoice prefixes, and PDF details

Logo	Display	Legal name	Country	Currency	Invoice prefix	Manager	Actions
Login as Founder to load branch profiles

Notification preferences

Branch delivery channels for automatic operational updates

Branch	WhatsApp	WhatsApp recipient	SMS	SMS recipient	Actions
Login as Founder to load notification preferences

Production readiness

Public URL, SMTP email, backups, and HTTPS must be configured before launch

Public URL configured for verification links SMTP sender configured for email verification and password reset Secure secret key, database path, upload path, backups, and HTTPS ready

Enabled screens

User and role management Product information management Multi-warehouse management Inbound and outbound records Sales, expenses, reports