From c23fa95640ac213daba447d832917ad086900cb8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rafa=C5=82=20Ty=C5=84ski?= <rafal.tynski@gmail.com>
Date: Sun, 4 Oct 2026 05:42:48 +0200
Subject: [PATCH] docs(readme): document dev ports, TLS certs and default proxy

---
 README.md | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 3009ed5..d295b7f 100644
--- a/README.md
+++ b/README.md
@@ -19,24 +19,34 @@ Platforma Małopolskiego Hubu Innowacji Społecznych (MVP hackathonu).
   Windows nie kojarzy domyślnie plików `.ps1`, dlatego skrypty uruchamiaj przez
   `pwsh` (np. `pwsh ./scripts/docker-push.ps1`), a nie przez dwuklik / samo
   `./scripts/docker-push.ps1`. Instalacja: https://aka.ms/powershell
+  (PowerShell 7.6.6: https://github.com/powershell/powershell/releases#release-v7.6.6)
 
 ## Praca lokalna
 
-Backend (dev) nasłuchuje na `https://localhost:7080`.
+Backend (dev) domyślnie nasłuchuje na `http://localhost:5078` (profil `http`), a opcjonalnie na `https://localhost:7080` (profil `https`). Dev-serwer Vite działa po HTTPS na `https://localhost:7081` i przekierowuje `/api` do backendu (`http://localhost:5078`).
+
+Certyfikat HTTPS dla Vite pochodzi z `dotnet dev-certs` — wygeneruj go raz (wymaga `pwsh`):
 
 ```pwsh
-# terminal 1 — backend
+pwsh ./scripts/dev-certs.ps1   # lub: npm --prefix client run certs
+```
+
+```pwsh
+# terminal 1 — backend (profil http, port 5078)
 dotnet run --project backend
 
-# terminal 2 — client (Vite, proxy /api -> http://localhost:5078)
+# terminal 2 — client (Vite, https://localhost:7081, proxy /api -> http://localhost:5078)
 npm --prefix client install
 npm --prefix client run dev
 ```
 
+Aby użyć profilu `https` backendu (port 7080), uruchom `dotnet run --project backend --launch-profile https` i zmień `proxy.target` w `client/vite.config.ts` na `https://localhost:7080`. Domyślna konfiguracja nie wymaga żadnych zmiennych środowiskowych.
+
 ## Skrypty
 
 ```pwsh
-npm --prefix client run dev      # uruchamia Vite (dev server)
+npm --prefix client run dev      # uruchamia Vite (dev server, HTTPS :7081)
+npm --prefix client run certs    # eksport certyfikatu dev do client/.certs (dotnet dev-certs)
 npm --prefix client run build    # buduje aplikację Vite do client/dist
 npm --prefix client run copy     # kopiuje client/dist -> backend/wwwroot
 node scripts/build.mjs           # buduje całość (client + copy + backend)