refactor: notes-python — описательные имена файлов/ресурсов + комментарии

Python файлы:
- handler.py → sql_runner.py   (entrypoint: sql_runner.handle)
- handler.py → notes_crud.py   (entrypoint: notes_crud.handle)
- handler.py → notes_list.py   (entrypoint: notes_list.handle)

TF ресурсы переименованы:
- sless_function.notes         → sless_function.notes_crud
- sless_trigger.notes_http     → sless_trigger.notes_crud_http
- sless_job.create_table       → sless_job.notes_table_init
- sless_job.create_index       → sless_job.notes_index_init
- archive_file.notes           → archive_file.notes_crud_zip
- archive_file.sql_runner      → archive_file.sql_runner_zip
- archive_file.notes_list      → archive_file.notes_list_zip

Добавлены подробные комментарии во все .tf файлы

examples/notes-python/sql-runner.tf

@@ -1,19 +1,26 @@
-# 2025-06-05
-# sql-runner.tf — универсальная функция для выполнения SQL запросов.
-# Используется джобами для DDL операций (CREATE TABLE, индексы, миграции).
-# event.statements — массив SQL строк, выполняются последовательно в одной транзакции.
+# 2026-03-09
+# sql-runner.tf — служебная DDL-функция для инициализации и миграций БД.
+#
+# ВАЖНО: эта функция не имеет HTTP-триггера — только вызов через sless_job.
+# Это сделано намеренно: функция выполняет произвольный SQL, и открывать её
+# наружу через HTTP было бы небезопасно.
 
-data "archive_file" "sql_runner" {
+# Упаковка исходников в zip для загрузки в кластер.
+# archive_file пересоздаёт zip при изменении любого файла в source_dir.
+data "archive_file" "sql_runner_zip" {
   type        = "zip"
   source_dir  = "${path.module}/code/sql-runner"
   output_path = "${path.module}/dist/sql-runner.zip"
 }
 
+# Сама функция в кластере.
+# entrypoint = "sql_runner.handle" → файл sql_runner.py, функция handle().
+# memory_mb=128 достаточно — DDL запросы не требуют памяти на вычисления.
 resource "sless_function" "sql_runner" {
   namespace   = "default"
   name        = "sql-runner"
   runtime     = "python3.11"
-  entrypoint  = "handler.handle"
+  entrypoint  = "sql_runner.handle"
   memory_mb   = 128
   timeout_sec = 30
 
@@ -21,6 +28,7 @@ resource "sless_function" "sql_runner" {
     PG_DSN = var.pg_dsn
   }
 
-  code_path = data.archive_file.sql_runner.output_path
-  code_hash = filesha256("${path.module}/code/sql-runner/handler.py")
+  code_path = data.archive_file.sql_runner_zip.output_path
+  # code_hash — при изменении кода terraform пересобирает образ функции
+  code_hash = filesha256("${path.module}/code/sql-runner/sql_runner.py")
 }