Cash Flow Prognose

Installatie- en gebruikershandleiding (Manager.forecast)

1. Wat doet dit programma

Cash Flow Prognose toont per periode hoeveel geld er binnenkomt en uitgaat:

2. Wat heb je nodig

3. Installeren

  1. Pak de ontvangen Manager.forecast-*.zip uit naar de computer, zodat de map Manager.forecast ontstaat — bij voorkeur als C:\Manager\Manager.forecast (Windows) of ~/Manager/Manager.forecast (Linux). Windows: rechtsklik → Alles uitpakken. Daarna verder bij hoofdstuk 4 (snelkoppeling) en 5 (Setup).
  2. Meer is er niet: het programma is standalone (alleen server_forecast.py, geen extra pakketten).
  3. De server vindt het .manager-bestand zelf op de standaardlocaties (Documenten, AppData).
Staat je administratie ergens anders? Kopieer bedrijvenmap.example.txt naar bedrijvenmap.txt en zet er 1 volledig pad in, bijvoorbeeld C:\Data\Manager\Businesses of C:\Users\{naam}\AppData\Local\Manager (vervang {naam} door je Windows-gebruikersnaam). Let op: gebruik altijd C:\Users\... — “Gebruikers” is alleen de weergavenaam in de Verkenner, op de schijf bestaat alleen C:\Users. Kopieer je een pad uit de Verkenner (bv. C:\Gebruikers\HuibKuiper\Documenten\...), vervang dan Gebruikers door Users en Documenten door Documents. Twijfel? Open cmd en typ echo %USERPROFILE%. Op Windows staat de data meestal onder %LOCALAPPDATA%\Manager (plak dit in de adresbalk van de Verkenner en zoek de map met .manager-bestanden). Werkt meteen, zonder herstart. Onder de tabel staat altijd uit welke map wordt gelezen.

4. Starten en stoppen

Windows: dubbelklik start-forecast.bat (met controle en melding; opent ook http://127.0.0.1:4451) of start-forecast.vbs (stil, zonder browser).

Linux / Mac: ./start-forecast.sh (opent ook de pagina als dat kan)

Stoppen: stop-forecast.bat / .vbs of ./stop-forecast.sh.

Alles tegelijk stoppen (eigen beheer, zit bij Manager.licence en wordt niet meegeleverd): stop-alles-manager.bat / .vbs of ./stop-alles-manager.sh.

Openen: http://127.0.0.1:4451

Snelkoppeling op het Bureaublad: draai één keer in deze map maak-snelkoppeling-in-map.bat (Windows, map C:\Manager\Manager.forecast) of bash maak-snelkoppeling-in-map.sh (Linux, map ~/Manager/Manager.forecast). Er ontstaan snelkoppelingen ín de map — kopieer die zelf naar het Bureaublad. Linux: daarna per bestand rechtsklik → “Toestaan en starten”. Details: LEESMIJ-snelkoppeling.txt.

Sluit het startvenster niet te snel: het meldt of de server echt luistert op poort 4451 (of “draait al”). Alleen bij een fout blijft het venster met uitleg open.

5. Setup — API-sleutel (eenmalig per bedrijf)

  1. Klik op Setup bovenaan.
  2. Je ziet alle gevonden bedrijven, met ✓ als de sleutel er is.
  3. Plak per bedrijf de sleutel en klik Opslaan.

De sleutels staan in het bestand .env naast de server (1 regel per bedrijf: Bedrijfsnaam=sleutel). Dit bestand is alleen-leesbaar voor jouw account. Er wordt geen api_keys.json meer gebruikt; een oude api_keys.json wordt eenmalig automatisch meegelezen.

Zie je een bedrijf niet? Dan staat het .manager-bestand niet in de gezochte map — zie hoofdstuk 3 (bedrijvenmap).

6. Normaal gebruik

7. Problemen oplossen

ProbleemOplossing
Startvenster flitst wegGebruik start-forecast.bat (toont het resultaat 4 seconden). Alleen bij een fout blijft het open staan.
“Python niet gevonden”Python 3.9+ installeren en Add Python to PATH aanvinken.
“Server niet bereikbaar”Poort 4451 bezet (eerst stoppen), geen schrijfrechten in de map, of Python-fout — toon details met python server_forecast.py.
Dropdown is leegNog geen sleutels: open Setup en plak per bedrijf de sleutel.
Geen API-sleutel / http-401Sleutel ontbreekt of is verlopen — via Setup een nieuwe plakken.
NO LICENCE (rood) / knoppen uitGeen geldige licentie — vraag een code aan in Manager.licence (programma Manager.forecast) en plak hem bij Setup.
Aantal prognoses verschilt per computerElke computer heeft zijn eigen .manager-bestand. Verschil = verschil in data.
Nieuwe prognose niet zichtbaarSluit in Manager.io de administratie en open hem opnieuw, klik daarna op Update.
Verkeerd bedrijf / verkeerde mapKijk naar de bronregel onder de tabel welke map wordt gelezen; gebruik zo nodig bedrijvenmap.txt.
Fout melden / supportStuur server_forecast.log mee. Daarin staan de startcontrole en foutmeldingen, maar geen API-sleutels of licentiecode. Controleer wel of de bedrijfsnaam of het pad erin staat die je liever niet deelt.

8. Bestanden

BestandWaarvoor
server_forecast.pyHoofdprogramma: pagina + API + DB-lezer.
start-forecast.bat / .sh / .vbsStarten.
stop-forecast.bat / .sh / .vbsStoppen.
install-manager-forecast.bat + Custom-Button-Manager.forecast.htmlOptioneel (Windows): knop in Manager.io om forecast te starten en stoppen.
maak-snelkoppeling-in-map.bat / .shMaakt snelkoppelingen ín de map (met pictogram); zelf naar het Bureaublad kopiëren.
LEESMIJ-snelkoppeling.txtStappen voor Bureaublad-snelkoppeling (Windows + Linux).
forecast.ico / forecast-256.pngPictogram voor de snelkoppeling (Windows / Linux).
lockup-blue.pngLogo rechtsboven op de pagina en in de print.
handleiding.htmlDeze handleiding (Nederlands + Engels).
LEESMIJ.html / LEESMIJ.txtKorte startpagina (HTML) + korte verwijzing (tekst) naar deze handleiding.
.envAPI-sleutels + licentie-code LICENCE_CODE (wordt aangemaakt bij Setup, nooit delen).
.env.exampleVoorbeeldformaat.
bedrijvenmap.example.txtVoorbeeld voor eigen bedrijvenmap.
server_forecast.logStartcontrole en foutmeldingen; handig bij support (zie §7).

9. Veiligheid

10. Licentie (Manager.licence)