VarastoVahti Käyttöohje

VarastoVahti on ammattimainen varastonhallintatyökalu WooCommerce-verkkokauppoihin. Se tarjoaa yhdellä silmäyksellä:

• Varaston kokonaisarvon — ostoarvo, myyntiarvo, kate, ALV-erittely
• Ennusteet ja tilausehdotukset — kulutusnopeuden perusteella
• Historiatrendit — päivittäisestä snapshotista
• ABC-analyysin — Pareto-periaatteella
• Automaattiset raportit — sähköpostiin tai webhookiin
• Matalan varaston hälytykset

2.1 Vaatimukset

• WordPress 6.0+
• PHP 7.4+
• WooCommerce 7.0+ (HPOS-tuki)
• Voimassa oleva VarastoVahti-lisenssi

2.2 Asennus

1. 1

   Lataa varastovahti.zip tai siirrä kansio polkuun /wp-content/plugins/varastovahti/.

2. 2

   Aktivoi lisäosa Lisäosat-valikosta.

3. 3

   Siirry Tuotteet → Varastolistaus → Lisenssi ja syötä lisenssiavain.

4. 4

   Aktivoinnin jälkeen lisäosa luo tarvittavat tietokantataulut ja käynnistää 365 päivän myyntihistorian backfillin taustalla.

2.3 Lisenssin aktivointi

• Lisenssi-välilehdellä syötetään ostettu lisenssiavain.
• Lisenssi varmennetaan PluginPlus-palvelimelta automaattisesti.
• Ilman voimassa olevaa lisenssiä toiminnot ovat poissa käytöstä — vain Asetukset ja Lisenssi -välilehdet näkyvät.
• Päivitykset tulevat suoraan WordPressin lisäosapäivitysten kautta lisenssin ollessa voimassa.

Lisäosalla on seitsemän välilehteä. Käymme ne läpi järjestyksessä.

3.1 Yleisnäkymä

Pääsivu, jossa näkyvät:

• Tilastoboxit — ostoarvo (ALV 0 %), myyntiarvo (ALV 0 %), arvioitu kate ja tuote-/kappalemäärät
• Pikasuodattimet — Kaikki / Varastossa / Vähissä / Loppu
• Haku — nimen tai SKU:n perusteella
• Kategoriasuodatus
• Tuotetaulukko — tuote, SKU, ID, varastosaldo (värikoodattuna), ostohinta, myyntihinta, ALV %, rivikohtaiset summat
• Lataa CSV -painike — vie suodatettu listaus heti CSV-tiedostoon (UTF-8 + BOM, avautuu Excelissä)
• Tulosta raportti -painike — avaa tulostusystävällisen näkymän selaimessa (tallennettavissa PDF:ksi)

Värikoodaus:

3.2 Ennusteet

Kulutusnopeus- ja tilausennustenäkymä:

• MA7 / MA30 / MA90 — kulutuksen liukuva keskiarvo 7/30/90 päivän ajalta
• Trendi — kasvaako vai laskeeko kulutus
• Runway — montako päivää nykyinen varasto kestää
• ROP (Reorder Point) — milloin tilaus pitäisi tehdä toimitusajan perusteella
• Suositeltu tilausmäärä — laskettu tavoitekattavuuden mukaan
• Ennusteet — 30 / 60 / 90 / 180 päivälle

Asetukset-välilehdellä säädetään: toimitusaika, tavoitekattavuus, runway-varoitusraja.

3.3 Historia

Päivittäinen snapshot varaston arvosta:

• Trendikaavio 90 päivän ajalta (Chart.js)
• Näyttää ostoarvon, myyntiarvon ja kappalemäärän kehityksen
• Snapshot otetaan automaattisesti kerran vuorokaudessa, kun ominaisuus on käytössä asetuksissa
• Vanhin data säilyy niin kauan kuin tietokantarivit ovat tallessa

3.4 ABC-analyysi

Pareto 80/20 -luokittelu myyntiarvon perusteella:

Auttaa kohdentamaan huomion oikeisiin tuotteisiin ja tunnistamaan ylimääräiset SKU:t.

3.5 Raportit

Raporttikeskus, jossa luodaan ja ajastetaan raportteja.

Raporttityypit (10 kpl)

Formaatit

Toimitustavat

Ajastus

Action Schedulerilla:

• Manuaalinen — vain kun "Aja nyt" -painiketta painetaan
• Päivittäin / Viikoittain / Kuukausittain
• Jokaisen pohjan vieressä — näkyy seuraavan ajon kellonaika

Arkisto

• Kaikki ajetut raportit listataan omalla arkistosivulla
• Lataa raportit allekirjoitetuilla URL:eilla (nonce-suojattu)
• Automaattinen siivous 60 päivän jälkeen

3.6 Asetukset

Yksi näkymä, jossa kaikki säädöt:

3.7 Lisenssi

• Aktivointi / deaktivointi
• Lisenssin tila ja voimassaoloaika
• Yhdistettyjen sivustojen määrä
• Manuaalinen tarkistus

5.1 Ostohinnat

• Luetaan post metasta — oletuksena _cogs_total_value (WooCommerce Cost of Goods, core)
• Vaihtoehdot: _wc_cog_cost, _purchase_price, _atum_cost
• Variaatio perii emon ostohinnan, jos sillä ei ole omaa
• Vaihdettavissa Asetukset-välilehdeltä

5.2 ALV-laskenta

• Ensisijaisesti tuotteen verokortilta (WC_Tax::get_base_tax_rates())
• Variaatio perii emon verokortin kun tax_class = inherit
• Jos verokorttia ei ole määritelty → asetuksissa määritelty oletus-ALV (25,5 %)

5.3 Suorituskyky

• Totaalit ja rivilistaukset välimuistitettu (transient)
• Välimuisti tyhjenee automaattisesti tuotteen tallennus- ja varastomuutoshookeista
• Verokannat muistetaan request-tasolla
• Velocity-laskenta cachetetaan 15 minuutiksi
• CSV-vienti streamataan 500 tuotteen erissä — muistiystävällinen yli 10 000 tuotteen varastoissa
• Snapshot-, raportti- ja hälytysajot suoritetaan Action Schedulerilla → ei timeoutteja

5.4 Turvallisuus

• Kaikki latauslinkit nonce-suojattuja
• CSV/XLSX formula-injection -suojaus
• Webhook-URL:t SSRF-validoitu (estää sisäverkkokutsut)
• Raporttiparametrit whitelistataan per raporttityyppi
• Tiedostot tallennetaan satunnaisilla tunnisteilla, kansiot suojattu .htaccess + index.php + index.html + web.config
• Lisenssi-API pakottaa HTTPS:n
• Vaadittu oikeus: manage_woocommerce

5.5 HPOS-yhteensopivuus

Lisäosa on yhteensopiva WooCommerce High-Performance Order Storagen kanssa — toimii sekä custom order tables -moodissa että legacy-tilassa.

5.6 Käännökset

• Text domain: varastovahti
• Käännöstiedostot: languages/
• Pohjana: suomenkielinen, käännettävissä Loco Translatella tai vastaavalla

Lisäosa luo kolme omaa taulua ($wpdb->prefix -etuliitteellä):