{"id":16799701,"url":"https://github.com/tomplus/ufaktura","last_synced_at":"2026-05-20T06:08:38.340Z","repository":{"id":66171639,"uuid":"116869884","full_name":"tomplus/ufaktura","owner":"tomplus","description":"uFaktura - ekstremalnie prosty system do wystawiania faktur","archived":false,"fork":false,"pushed_at":"2023-11-03T23:35:06.000Z","size":6684,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-23T14:22:29.661Z","etag":null,"topics":["faktura","php","yii2"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tomplus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-01-09T20:56:22.000Z","updated_at":"2023-03-17T22:49:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"68b59d74-3021-42f2-841d-107fa4806db8","html_url":"https://github.com/tomplus/ufaktura","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomplus%2Fufaktura","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomplus%2Fufaktura/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomplus%2Fufaktura/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomplus%2Fufaktura/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomplus","download_url":"https://codeload.github.com/tomplus/ufaktura/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243976493,"owners_count":20377692,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["faktura","php","yii2"],"created_at":"2024-10-13T09:29:32.812Z","updated_at":"2026-05-20T06:08:38.309Z","avatar_url":"https://github.com/tomplus.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"![GitHub release](https://img.shields.io/github/release/tomplus/ufaktura)\n\n# uFaktura (micro-faktura)\n\nmicro-Faktura to prosty serwis do wystawiania faktur, działający w przeglądarce.\nMoże zostać uruchomiony na serwerze hostingowym lub na komputerze stacjonarnym.\nPozwala wystawiać najprostsze faktury (max. 3 pozycje) dla podatników\nzwolnionych z VAT (dawniej rachunki). Jest to narzędzie idealne dla osób prowadzących, \ndziałalność usługową dla niewielkiej liczby klientów.\n\nCechy charakterystyczne:\n\n* do samodzielnego uruchomienia serwerze hostingowym z PHP i bazą danych\n* możliwość uruchomienia na komputerze domowym\n* prosty schemat bazy danych do ew. eksportu do dodatkowych narzedzi (np. Excel)\n* faktura może zawierać maksymalnie 3 pozycje\n* tylko faktury zwolnione z VAT\n* generuje fakturę w formacie PDF do wydruku lub wysyłki przez mailem\n* brak autoryzacji / autentykacji - zadbaj o to konfigurujac serwer HTTP\n* projekt otwarty oparty o PHP i framework Yii - możesz go łatwo dostosować do własnych potrzeb\n\n# Instalacja\n\n## Na serwerze z PHP i Postgresql (hosting)\n\nTo zalecany wariant instalacji, który umożliwia dostęp do serwisu przez przeglądarkę\ninternetową.\n\n### Wymagania\n\n* PHP 5.4 lub nowszy\n* Baza danych - do wyboru: mysql, postgresql, sqlite.\n\n### Instalacja\n\n* Pobierz archiwum wydanej wersji (zakładka [Releases](https://github.com/tomplus/ufaktura/releases))\n* Rozpakuj do podkatalogu na serwerze hostingowym\n* Zabezpiecz katalog (htaccess)\n* Wskaż domene (lub sub-domenę) na podkatalog `web/`\n* Utwórz bazę danych i wgraj schemat korzystając z odpowiednich plików z repozytorium (katalog db).\n\n### Konfiguracja\n\nKonfiguracja dostępu do bazy znajduje się w pliku: `src/config/db.php`. Otwórz \ngo w edytorze i zmień wartośc `dsn` w zależności od typu bazy danych\n\n#### MySQL\n\nSchemat bazy danych znajduje się w pliku [db/db.mysql.sql](db/db.mysql.sql).\n\n```php\n\u003c?php\nreturn [\n    'class' =\u003e 'yii\\db\\Connection',\n    'dsn' =\u003e 'mysql:host=localhost;dbname=yii2basic',\n    'username' =\u003e 'ufaktura',\n    'password' =\u003e 'pass',\n    'charset' =\u003e 'utf8',\n];\n```\n\n#### PostgreSQL\n\nSchemat bazy danych znajduje się w pliku [db/db.postgresql.sql](db/db.postgresql.sql).\n\n```php\n\u003c?php\nreturn [\n    'class' =\u003e 'yii\\db\\Connection',\n    'dsn' =\u003e 'pgsql:host=localhost;dbname=yii2basic'\n    'username' =\u003e 'ufaktura',\n    'password' =\u003e 'pass',\n];\n```\n\n#### SQLite\n\nBaza zalecana przy uruchamianiu serwisu na własnym komputerze, patrz niżej.\nGotowa pusta baza danych znajduje się w katalogu `db` wydania.\n\n\n```php\n\u003c?php\nreturn [\n    'class' =\u003e 'yii\\db\\Connection',\n    'dsn' =\u003e 'sqlite:../db/ufaktura.db'\n];\n```\n\n### Uruchomienie\n\nPo wejściu na adres strony i potwierdzeniu hasła dostępu, program jest gotowy do pracy.\nZanim wystawisz pierwszą fakturę, dodaj profil (swoje dane) oraz klientów.\n\n## Na własnym komputerze (Docker)\n\nTen sposób instalacji pozwala uruchomić serwis na Twoim komputerze domowym lub\nw firmie.\n\n### Wymagania\n\n* Linux, Windows, Mac\n* Docker (https://docs.docker.com/engine/installation/)\n\n### Instalacja\n\n1. Pobranie obazu kontenera\n\n```\ndocker pull tpimages/ufaktura:latest\n```\n\nZamiast `latest` możesz podać dowolną inną wydaną wersje.\n\n2. Utwórz katalog w którym zapisywane będą dane (baza sqlite) i skopiuj tam pustą bazę z kontenera. Operację wykonujemy tylko raz\n   aby utworzyć pustą bazę.\n\n```\nmkdir /home/tomplus/ufaktura\nchown 65534:65534 /home/tomplus/ufaktura\ndocker run --volume=/home/tomplus/ufaktura:/tmp -it --rm --name ufaktura tpimages/ufaktura:latest cp /ufaktura/db/ufaktura.db /tmp/\n```\n\n3. Uruchom obraz wskazując katalog z baza danych\n\n```\ndocker run -p 8080:8080 --volume=/home/tomplus/ufaktura:/ufaktura/db -it --rm --name ufaktura tpimages/ufaktura:latest\n```\n\nSerwis jest dostepny z przeglądarki pod adresem http://localhost:8080\n\n### Konfiguracja\n\n## Ze źródeł (dla ekspertów)\n\nTo sposób dla programistów, którzy chcą zmodyfikować serwis.\n\n### Wymagania\n\n* PHP 5.4 lub nowszy\n* Pakiety dodatkowe (przykład dla Ubuntu):\n  ```apt-get install sqlite3 php-mbstring php-bcmath php-xml php-pgsql php-mysql php-sqlite3```\n* PHP Composer (https://getcomposer.org/download/)\n\n### Instalacja\n\n1. Aplikacja znajduje się w katalogu `src/`\n\n```\ncd src/\n```\n\n2. Instalacja zależności z `composer.json`.\n\n```\n./composer.phar install\n```\n\n3. Utworzenie pustej bazy danych sqlite3\n\n```\ncd db\nmake\n```\n\n4. Uruchomienie serwera w PHP\n```\n./yii serve\n```\n\n4. Serwis jest dostępny pod adresem http://localhost:8080 Wprowadzane zmiany od razu wpływaja na działanie aplikacji.\n\n# Licencja\n\nAplikacja udostępniona na licencji [MIT](https://pl.wikipedia.org/wiki/Licencja_MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomplus%2Fufaktura","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomplus%2Fufaktura","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomplus%2Fufaktura/lists"}