Changes between Version 4 and Version 5 of AdvancedApplicationDevelopment

Timestamp:

06/14/26 20:26:37 (2 days ago)

Author:

211101

Comment:

--

AdvancedApplicationDevelopment

@@ -2 +2 @@
 
 За да се разликуваат трансакциите во системот како ентитети и трансакциите како теоретски поим во областа на датабазите, првите ќе ги нарекувам "финансиски трансакции", а вторите "трансакции во датабаза" во понатамошните спомнувања
-=== Трансакции во датабаза
-- [wiki:Transaction1 Атомично креирање на финансиска трансакција со една помошна финансиска трансакција]
-- [wiki:Transaction2 Атомично креирање на финансиска трансакција со повеќе помошни финансиски трансакции]
-- [wiki:Transaction3 Ажурирање на финансиска трансакција со поништување на претходните ефекти]
 
 === Pooling на конекции
+Го користам пакетот `postgres.js` (инстанциран во [source:/app/lib/db.ts]), кој автоматски воспоставува pooling. Без потреба од дополнителни конфигурации, овој систем одржува активни конекции(стандардно 10 паралелни конекции) што драстично ја намалува латенцијата помеѓу серверските акции во Next.js и операциите на базата на податоци.
+
+Овој систем е заштитен од дуплирање на конекции при hot-reload во развојна околина, со зачувување на инстанцата во `global` објектот.
+
+=== Трансакции во датабаза
+Користам `sql.begin()` блокови за секоја операција што бара прво проверка или повеќекратен упис, елиминирајќи го ризикот од race conditions. 
+
+'''Пример 1: Внесување на финансиска трансакција''' 
+
+Сместена во [source:/app/(app)/add/actions.ts#L205:292], акцијата `addTransaction` ги извршува следните чекори како една атомична целина:
+ 1. Впишува основен запис во табелата `transaction`.
+ 2. Впишува релациони записи во `transaction_breakdown`.
+ 3. Го ажурира балансот на соодветната сметка во `transaction_account`.
+ 4. Селектира постојни или внесува нови тагови во `tag`.
+ 5. Гради поврзување во табелата `tag_assigned_to_transaction`.
+
+'''Пример 2: Валидација и манипулација врз основа на проверка'''
+
+За да се осигураме дека нема да се зачуваат дупликати поради истовремени кликови или барања(race conditions), се користи истата `sql.begin()` логика при креирање и промена на профили:
+- '''Регистрација на профил:''' Во [source:/app/(auth)/actions.ts#L68:79] проверката дали внесениот `email` веќе постои се извршува во иста трансакција со креирањето на новиот профил. Доколку друга регистрација се обиде со истиот мејл во тој момент, трансакцијата се блокира.
+- '''Ажурирање на профил:''' При промена на email во [source:/app/(app)/profile/actions.ts#L35:51], сите проверки за преклопување и самата `UPDATE` команда се спроведуват атомично.
+- '''Додавање тагови:''' Во [source:app/(app)/add/actions.ts#L80:90], акцијата за додавање нов таг користи трансакција за првично да изврши `SELECT` и да провери дали постои таг со тоа име, пред да направи `INSERT`.
+
+'''Заштитен механизам:''' Ако било кој од чекорите во блоковите врати грешка(на пример: тагот веќе постои, балансот е невалиден или податоците се некомплетни), целиот `sql.begin` блок прави '''rollback''' и извршувањето се прекинува, што значи дека ниту еден делумен податок не останува трајно зачуван во базата.