https://github.com/manakjiri/fakturyfy

základní nástroj pro tvorbu faktur a správu subjektů pro OSVČ
https://github.com/manakjiri/fakturyfy

finance freelance tools

Last synced: 6 months ago
JSON representation

základní nástroj pro tvorbu faktur a správu subjektů pro OSVČ

• Host: GitHub
• URL: https://github.com/manakjiri/fakturyfy
• Owner: manakjiri
• License: gpl-3.0
• Created: 2024-02-09T08:05:13.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-24T09:06:40.000Z (about 1 year ago)
• Last Synced: 2024-08-24T10:24:51.070Z (about 1 year ago)
• Topics: finance, freelance, tools
• Language: Python
• Homepage:
• Size: 607 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Fakturyfy.py

Základní nástroj pro tvorbu faktur a správu subjektů pro OSVČ. Většinu implementace jsme sepsali během soukromého dvoudenního "hackathonu", jde o webovou nadstavbu nad forkem projektu [InvoiceGenerator](https://github.com/by-cx/InvoiceGenerator). Návrhy, opravy a vylepšení jsou vítány.

![priklad](/docs/faktura.png)

Službu můžete nasadit čistě lokálně nebo na Vaší lokální síti, **služba s žádným jiným způsobem nasazení nepočítá** - chybí login či jakékoliv jiné zabezpečení přístupu. Nesnažíme se stvořit další účetní systém, jde o jednoduchý nástroj.

Veškerá data jsou uložena v sqlite databázi (definice subjektů) a vygenerované faktury jsou ukládány přehledně do složek ve formátu PDF.

## Instalace

[![Publish Docker image](https://github.com/manakjiri/fakturyfy/actions/workflows/docker-push.yaml/badge.svg?branch=main)](https://github.com/manakjiri/fakturyfy/actions/workflows/docker-push.yaml)

Celá služba je zabalena do jednoho docker containeru, jehož image je dostupný na [docker hub](https://hub.docker.com/r/manakjiri/fakturyfy).

### Docker compose (doporučeno)

Stáhněte si šablonu souboru [deploy/docker-compose.yaml](https://raw.githubusercontent.com/manakjiri/fakturyfy/refs/heads/main/deploy/docker-compose.yaml) a případně upravte dle instrukcí v něm. 

Poté stačí spustit příkazem `docker compose up`, pokud vše proběhlo v pořádku a je možné zobrazit stránku nástroje (defaultně [localhost](http://localhost/)), můžete jej nechat běžet na pozadí příkazem `docker compose up -d` (spustí se i po restartu počítače).

### Docker

Pro rychlé vyzkoušení je možné spustit jedním příkazem

```sh

docker run --rm --name fakturyfy_server --volume ./fakturyfy-data:/data --publish 8000 manakjiri/fakturyfy:main

```

služba bude dostupná na [http://localhost:8000/](http://localhost:8000/).

Služba uchovává uživatelská data v adresáři `/data` uvnitř containeru, **tuto cestu namapujte mimo container** skrze volume tak, jak je to v příkazu výše, cestu si upravte dle potřeby.

- Můžete ji například navést do NFS adresáře na NAS úložišti, které je ideálně navázáno na offsite backup a poskytuje rollback, tak to používáme my

Novou verzi můžete stáhnout pomocí `docker pull manakjiri/fakturyfy:main`, kód bude shodný s tím, který je aktuálně na [main větvi](https://github.com/manakjiri/fakturyfy/tree/main).

## Ukázky

Správa faktur

![](/docs/sprava_faktur.png)

Tvorba faktury

![](/docs/tvorba_faktury.png)

Správa subjektů

![](/docs/sprava_subjektu.png)

Tvorba subjektu

![](/docs/tvorba_subjektu.png)