Advanced Player Store - Jobs DLC

🏢 RS STORE [OWNED] — Player-Owned Businesses, Staff, Stock, Supply Runs & Real Analytics

💡 Overview

Turn shops into real player businesses. Players buy a store, then run it: employees and salaries, physical stock, wholesale supply missions, custom prices, coupons and gift cards — with a full analytics dashboard and every dollar tracked. DLC for the RS Store base; both run side by side.

💻 A dedicated boss-menu NUI at each store's management point — dashboard, bank, inventory, staff, transactions, promotions — matching the "24/7" theme. ESX • QBCore • Qbox.

🛠️ Everything Created In Game

No config lists: /createstore , walk to place the vendor NPC (your heading is captured), then the management point — saved to the database, up for sale.

Six types supported, including a black market with zero blips and its own hidden supplier.

Move points anytime (/setmanage, /setdrive), all commands ACE-protected and re-checked server-side.

💰 Ownership & Resale

A player buys the store at the golden $ marker — ownership is per player in the database, independent from framework jobs.

Configurable max stores per player.

Player-to-player resale: the owner sets a price, the store goes back on sale, and the seller is paid even offline. The business balance stays with the store.

📦 Physical Stock

Customers buy the store's real inventory — when it's out, it's out.

Restock from your own items, or launch a supply run.

Stock status at a glance: in stock / low / out, searchable and paginated.

🚚 Supply Runs (wholesale restocking)

Grab a delivery van at the depot, buy cargo at wholesale price (default 60% of base) paid atomically from the company account, deliver to the store, return the van — the margin is your profit.

Cargo is 100% server-side and virtual — no real items, no dupe. Cancel, timeout, losing the van or disconnecting refunds the undelivered cargo.

Per-type suppliers: legal stores share a warehouse; the black market restocks at its own blip-less supplier deep in the quarry.

🧑‍💼 Boss Menu (tab by tab)

📊 Dashboard — treasury curve (7/30/90 days), "this month" KPIs (revenue, sales, average basket, net margin), top products & payment split.

🏦 Bank — balance, deposit, withdraw, open/close the store, sell the store.

📦 Inventory — stock status, restock from your items, custom prices, start a supply run.

👥 Employees — hire the nearest player, grades, salaries, fire.

🧾 Transactions — filterable, paginated feed of every movement with running balance.

🎟️ Coupons — percent or fixed promo codes (min basket, max uses, expiry), validated server-side at checkout.

🎁 Gift cards — prepaid credit codes customers pay with; the value was offered, so no money can ever be created.

🏷️ Price Policy & Roles

Managers set each product's sale price within configurable bounds (50%–300% of base) — pricing is gameplay.

Internal roles per store: Employee (stock), Manager (+ money & prices), Co-manager (+ staff) — the owner has everything.

Automatic salaries paid from the company account.

💳 Money — Two Auto-Detected Modes

RS Banking mode: a real business account per store (own IBAN), card/terminal payments in the shop, offline resale payout.

Standalone mode: zero dependency — atomic SQL balance with server-side guards.

The account belongs to the store, not the player: it survives resales.

Every movement (sales, deposits, withdrawals, salaries, restocks) feeds a structured event log with balance snapshots — the dashboard reads the same in both modes.

🔫 Robberies That Actually Hurt

With the base's robbery module, hold-ups on owned stores are zero-sum: the loot is debited from the owner's company account and handed to the robber as dirty money.

Criminals rob real businesses; owners feel it in the books.

🔀 Two Modes Per Store

Player-owned by default, or place case-by-case autonomous NPC shops (/createstore auto) — always open, infinite stock, classic money sink.

One switch (Config.PlayerStores) turns the whole DLC autonomous if you prefer.

📟 Persistence & Admin

Auto-installing database — all tables created and migrated on first boot, no manual SQL import.

Every state change survives restarts: owner, stock, prices, staff, balance, coupons, gift cards.

Full admin toolkit: /createstore, /setmanage, /setdrive, /deletestore, /depotpos.

🧩 Framework & System Compatibility

Frameworks: ESX • QBCore • Qbox (auto detection).

Inventories: ox_inventory • qb-inventory • qs-inventory • native.

Banking: RS Banking (business accounts + card terminal) — optional, full standalone mode without it.

Requires: RS Store base (shared NUI, catalog & bridge) + oxmysql.

Everything is automatically detected for plug-and-play setup.

🚀 Key Features Summary

✅ Buy, run and resell real stores — staff, salaries, physical stock, custom prices.

✅ Wholesale supply missions with virtual anti-dupe cargo and automatic refunds.

✅ Boss menu with real analytics: treasury curve, monthly KPIs, top products, full ledger.

✅ Coupons & gift cards with exploit-safe, server-side validation.

✅ Two money modes (RS Banking business account or standalone) — auto-detected.

✅ Auto-installing DB, multi-framework, EN / FR, fully configurable.

🎥 Preview:* https://www.youtube.com/watch?v=eSnGZP8CnVY*