init

README.md

@@ -0,0 +1,53 @@
+# Przykładowa aplikacja CRUD FLASK
+
+Flask to lekki framework webowy dla języka Python, zaliczany do kategorii mikro-frameworków. Oznacza to, że dostarcza jedynie podstawowej infrastruktury do budowy aplikacji internetowych, pozwalając jednocześnie na elastyczne poszerzanie funkcjonalności za pomocą zewnętrznych bibliotek.
+
+Prosty przykład aplikacji CRUD zaprogramowany przy pomocy Flash i SQLAlchemy.
+
+## Dlaczego ORM?
+
+- Operujesz na obiektach (Contact) zamiast pisać SQL i ręcznie mapować kolumny.
+- Lepsza czytelność i mniejsza szansa na błędy typu literówki w zapytaniach.
+- Później łatwo dołożyć migracje (Alembic), relacje 1‑N itd.
+
+
+## Wirtualny katalog projektu
+
+```
+W terminalu Visual Studio Code:
+
+python -m venv .venv
+source .venv/bin/activate # Windows: .venv\Scripts\activate
+pip install -r requirements.txt
+```
+
+Zawartość requiremens.txt
+
+```
+Flask>=3.0
+SQLAlchemy>=2.0
+Flask-SQLAlchemy>=3.1
+```
+
+## Uruchomienie
+
+python app.py
+
+lub
+
+python3 app.py
+
+## CRUD_flask_example struktura projektu
+
+```
+├─ app.py
+├─ requirements.txt
+├─ database.db
+├─ templates/
+│ ├─ base.html
+│ ├─ index.html
+│ └─ form.html
+└─ static/
+└─ style.css
+```
+