Prosta aplikacja do ewidencji sprzętu i magazynu w warsztacie/pracowni: kategorie, lokalizacje (magazyn → regał → półka → pojemnik), automatyczne numery ewidencyjne z kodami QR, kartoteka przedmiotu (zdjęcia, specyfikacja, wartość, stan), wypożyczenia (także zestawy i rezerwacje) z bazą kontaktów i protokołami wydania/zwrotu w PDF, inwentaryzacja, materiały eksploatacyjne, serwis (naprawy, przeglądy okresowe, gwarancje), historia zmian i na razie uproszczony eksport ofert sprzedaży do CSV. Do tego publiczna strona „pchli targ” dla wystawionych ofert, webowy instalator i moduł samo-aktualizacji przez panel administratora.
Do tego appka instaluje się jako PWA na telefonie/tablecie i skanuje kody QR oraz kreskowe (EAN/UPC) wprost kamerą przeglądarki — nietrafiony skan proponuje szybkie dodanie nowego przedmiotu.
Zbudowana na Laravel 12 + MariaDB, w pełni dwujęzyczna (PL/EN).
Skąd nazwa? „Craty” to połączenie polskiego „Graty” (sprzęt/rupiecie w warsztacie) i angielskiego „crate” (skrzynka) — appka zaczynała jako wewnętrzne narzędzie „Graty” i zachowała podobne brzmienie przy zmianie nazwy na wersję open source.
Craty jest i zostanie prostym programem do ewidencji magazynu. Nigdy nie stanie się pełnoprawnym sklepem internetowym: nie ma i nie będzie w nim koszyka, składania zamówień, płatności online, wysyłek ani obsługi klientów jak w sklepie.
Funkcje sprzedaży ograniczają się celowo do dwóch rzeczy:
- kontakt z właścicielem: publiczna strona „pchli targ” pokazuje, co jest do sprzedania, a zainteresowany pisze albo dzwoni na podany e-mail lub telefon i dalej umawiacie się sami, lokalnie;
- linki do popularnych serwisów ogłoszeniowych, takich jak OLX, Allegro czy Vinted, gdzie ta sama rzecz może być wystawiona.
Propozycje rozbudowy w stronę sklepu (koszyk, płatności, zamówienia) będą odrzucane jako niezgodne z założeniami projektu.
Dotyczy instalacji poza Dockerem (patrz Wdrożenie na hostingu
niżej) — kreator instalacji (/install) sam sprawdza to wszystko i pokazuje,
czego ewentualnie brakuje, zanim pozwoli przejść dalej.
- PHP ≥ 8.3
- Rozszerzenia PHP:
pdo_mysql,mbstring,gd,zip,bcmath,exif,intl - MySQL 8+ lub MariaDB 10.3+
- Apache z
mod_rewriteiAllowOverride All. Appka nie ma osobnego katalogupublic/— cały kod (w tym.env) leży w tym samym katalogu coindex.php, a jego ochrona przed dostępem z przeglądarki zależy wyłącznie od reguł w.htaccess. BezAllowOverride All(domyślne ustawienie wielu hostingów toAllowOverride None) Apache po cichu ignoruje te reguły i cały kod źródłowy staje się publicznie pobieralny. Nginx nie czyta.htaccessw ogóle, więc wymagałby ręcznego przepisania tych reguł na konfigurację Nginx — appka nie dostarcza tego gotowego. - Zapis (uprawnienia dla użytkownika PHP) do katalogów
app-storage/ibootstrap/cache/ - HTTPS — wymagany do skanowania kamerą (PWA) i realnie zalecany zawsze; zwykły HTTP na produkcji przeglądarki traktują jako niebezpieczny kontekst i blokują dostęp do kamery
Najprostszy sposób: jeden kontener z aplikacją i bazą danych w środku, bez pobierania kodu, composera ani npm.
docker run -d --name craty --restart unless-stopped \
-p 8000:8000 \
-v craty-data:/var/www/html/app-storage \
ghcr.io/cyryllo/craty:latestalbo z Docker Compose, pobierając gotowy plik:
curl -O https://raw.githubusercontent.com/cyryllo/craty/main/docker/release/compose.yml
docker compose up -dPotem otwórz http://localhost:8000 i przejdź krótki kreator instalacji: nazwa aplikacji, adres i konto administratora. O bazę danych kreator nie pyta, bo jest już skonfigurowana w kontenerze (z losowym hasłem).
Wszystkie dane (baza, zdjęcia, kody QR, konfiguracja) leżą w jednym wolumenie craty-data, więc kopia zapasowa to kopia tego wolumenu, a usunięcie kontenera niczego nie kasuje.
Aktualizacja to pobranie nowego obrazu (moduł Aktualizacje w panelu w wersji Docker tylko to podpowiada, zamiast przyjmować paczkę .zip):
docker compose pull && docker compose up -d
# albo bez Compose: docker pull ghcr.io/cyryllo/craty:latest, potem usuń i uruchom kontener ponownie z tym samym wolumenemZmiany w bazie danych z nowej wersji wprowadzają się same przy starcie kontenera. Obraz działa na komputerach x86 i ARM (np. Raspberry Pi 4/5). Do skanowania kamerą z telefonu potrzebny jest HTTPS, czyli w praktyce reverse proxy z certyfikatem (np. Caddy, Nginx Proxy Manager, Traefik) przed portem 8000.
Do pracy nad kodem Craty, nie do codziennego używania:
git clone https://github.com/cyryllo/craty.git
cd craty
cp .env.example .env
docker compose up -d
npm install && npm run build
./art migrate --seedAplikacja: http://localhost:8000 — konta startowe (hasło: password):
admin@craty.test, magazynier@craty.test.
Własne dane logowania do bazy: przed pierwszym docker compose up
zmień DB_DATABASE/DB_USERNAME/DB_PASSWORD (i opcjonalnie
DB_ROOT_PASSWORD) w pliku .env — Docker Compose czyta ten sam plik, więc
kontener MariaDB założy bazę/użytkownika z tymi wartościami. Zmiana tego
już PO pierwszym uruchomieniu (gdy wolumen bazy istnieje) nic nie da — trzeba
wtedy usunąć wolumen (docker compose down -v) i wystartować od nowa.
Appka ma webowy kreator instalacji pod /install — sam generuje .env,
prosi o dane do bazy i zakłada konto administratora. Nie trzeba composera
ani npm na serwerze — vendor/ i zbudowany frontend (build/) są już w
środku paczki.
php artisan release:build (uruchamiane w tym repo, nie na hostingu)
produkuje jedną paczkę do app-storage/app/releases/craty-{wersja}.zip
— appka nie ma osobnego katalogu public/ (patrz .htaccess/index.php
w korzeniu repo), więc ta sama paczka służy zarówno do świeżej instalacji,
jak i do aktualizacji już postawionej instalacji przez panel:
- Świeża instalacja: rozpakuj całą zawartość wprost do document
rootu (
public_htmlalbo odpowiednik u Twojego hostingu) — bez żadnej ręcznej edycji. Paczka ma już gotowyindex.phpi pliki.htaccessblokujące dostęp z przeglądarki do.env, kodu źródłowego ivendor/. Wejdź na/install. - Aktualizacja: zaloguj się jako admin → Ustawienia → Aktualizacje →
wgraj tę samą paczkę.
.envi dane użytkowników (app-storage/app/ public,app-storage/logs, symlinkstorage) nigdy nie są nadpisywane.
Limit rozmiaru wgrywanego pliku: paczka to zwykle kilkanaście–
kilkadziesiąt MB (zawiera cały vendor/ i skompilowany frontend), a
domyślne limity PHP (post_max_size, zwykle 8M; upload_max_filesize,
zwykle 2M) tego nie przepuszczą — upload padnie z błędem 413 Content Too Large, zanim żądanie w ogóle dotrze do aplikacji. Obraz Dockera z tego
repo ma to już podniesione (128M), ale na zwykłym hostingu trzeba
samodzielnie podbić obie wartości w php.ini (albo w .htaccess/panelu
hostingu, jeśli nie ma dostępu do php.ini) i zrestartować PHP/serwer.
Skanowanie kamerą wymaga HTTPS (albo localhost, stąd działa bez
niczego dodatkowego na dev) — przeglądarki nie dają dostępu do kamery na
zwykłym HTTP w produkcji. Zadbaj o certyfikat, zanim ktoś się zdziwi, że
„skaner nie działa”.
Po każdej aktualizacji warto sprawdzić swoją instalację skryptem z repozytorium:
./security-check https://twoja-domena.plSkrypt wykonuje wyłącznie zapytania odczytu, bez logowania, więc można go
bezpiecznie uruchamiać na produkcji. Sprawdza, czy nie da się pobrać plików
z kodem lub hasłami, czy nie ma listingu katalogów, czy panel wymaga
logowania, czy strona błędu nie zdradza szczegółów, oraz nagłówki,
ciasteczka i przekierowanie na HTTPS. Uprawnienia do każdej strony
aplikacji i typowe ataki (wgrywanie skryptów, wstrzykiwanie kodu)
sprawdzają automatyczne testy w tests/Feature/Security/.
Znalazłeś lukę bezpieczeństwa? Zgłoś ją prywatnie przez GitHub Security Advisories, a nie w publicznym zgłoszeniu.
Craty to młody projekt rozwijany po godzinach i szukam osób, które będą go używać. Nie trzeba umieć programować, żeby pomóc:
- Używaj i mów, co nie działa. Każdy błąd zgłoszony przez formularz zgłoszenia błędu przybliża stabilną wersję. Zrzut ekranu i numer wersji (widać go w stopce) bardzo pomagają.
- Podziel się pomysłem. Brakuje Ci czegoś w codziennym porządkowaniu gratów? Opisz to w formularzu propozycji, najlepiej na przykładzie z życia.
- Powiedz innym. Gwiazdka na GitHubie i polecenie Craty znajomym z warsztatu, hackerspace'u czy grupy majsterkowiczów naprawdę pomagają.
- Programujesz? Pull requesty są mile widziane. Przy większej zmianie najlepiej najpierw opisz ją w zgłoszeniu, żebyśmy ustalili kierunek.
Zgłaszać można po polsku albo po angielsku.
Craty rozwija się etapami. Nowe większe funkcje trafiają do modułów, które włączasz w Ustawieniach, gdy są potrzebne, i wyłączasz, gdy nie są. Kolejność ułożona jest tak, żeby każdy etap korzystał z poprzedniego:
- v1.5, bezpieczeństwo danych: kopie zapasowe z panelu (także na hostingach bez dostępu do konsoli), dziennik aktywności (logowania, zmiany kont i ustawień) i ulepszony import oraz eksport CSV.
Dalej, do decyzji: obsługa wielu niezależnych pracowni w jednej instalacji z API dla innych narzędzi, a aplikacja na Androida tylko wtedy, gdyby wersja instalowana z przeglądarki się nie sprawdziła.
Masz pomysł albo potrzebę, której Craty dziś nie spełnia? Opisz ją w zgłoszeniach na GitHubie. Każdą fajną funkcję rozważę, o ile pasuje do założeń projektu (program magazynowy, nie sklep).
- INSTRUKCJA.md — instrukcja użytkownika (główne funkcje, struktura magazynowa)
- CHANGELOG.md — historia zmian
