From e004ea696b7f7e78ab9b542d8c4ab0468601488c Mon Sep 17 00:00:00 2001
From: feco
Date: Tue, 17 Nov 2026 16:19:20 +0000
Subject: [PATCH] Packages: from one analysis to unlimited, admin can give them
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
A fixed catalog (packages.rs, reasoning in docs/csomagok.md): Egy elemzés
2 990 Ft, Páros 6 990 Ft, Család 11 990 Ft (featured), Korlátlan 17 990 Ft
for a year, and two top-ups. Every grant is a package_orders row; units are
credit_ledger rows with reason 'package' and never expire. The unlimited
package is a time-limited 'unlimited' entitlement: analyses use no unit and
persons have no limit, with a daily fair-use cap (UNLIMITED_DAILY_LIMIT, 5);
buying it again extends it by a year.
- GET /v1/packages, mock payment by package id, /v1/me unlimited_until
- POST /v1/admin/users/{id}/packages: give a package as a gift
- /csomagok page; the paid step of an analysis offers three packages with
the bigger one featured; person packs use the catalog; admin user list
has a package column
- PERSON_PACK_SIZE is replaced by the catalog's +5 személy top-up
Co-Authored-By: Claude Opus 5.5
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
---
crates/db/migrations/0012_packages.sql | 26 ++
deploy/docker-compose.yml | 2 +-
docker-compose.yml | 2 +-
docs/csomagok.md | 39 +++
services/backend/README.md | 8 +-
services/backend/src/config.rs | 8 +-
services/backend/src/main.rs | 1 +
services/backend/src/packages.rs | 285 ++++++++++++++++++
services/backend/src/persons.rs | 7 +-
services/backend/src/routes/account.rs | 2 +
services/backend/src/routes/admin.rs | 56 +++-
services/backend/src/routes/analyses.rs | 14 +-
services/backend/src/routes/mod.rs | 4 +-
services/backend/src/routes/payments.rs | 80 +++--
services/backend/src/tests.rs | 99 +++++-
.../frontend/src/app/admin/AdminUsers.tsx | 93 +++++-
services/frontend/src/app/admin/page.tsx | 2 +-
services/frontend/src/app/csomagok/page.tsx | 97 ++++++
services/frontend/src/app/globals.css | 50 ++-
.../frontend/src/app/kepletek/[id]/page.tsx | 1 +
.../src/app/osszevetesek/[id]/page.tsx | 1 +
services/frontend/src/app/profil/page.tsx | 5 +-
services/frontend/src/app/szemelyek/page.tsx | 2 +-
.../frontend/src/app/szemelyek/uj/page.tsx | 2 +-
.../src/components/DetailedAnalysis.tsx | 29 +-
.../frontend/src/components/PackageCards.tsx | 180 +++++++++++
.../frontend/src/components/PersonPacks.tsx | 64 +---
.../frontend/src/components/SiteHeader.tsx | 1 +
services/frontend/src/lib/types.ts | 23 +-
29 files changed, 1019 insertions(+), 164 deletions(-)
create mode 100644 crates/db/migrations/0012_packages.sql
create mode 100644 docs/csomagok.md
create mode 100644 services/backend/src/packages.rs
create mode 100644 services/frontend/src/app/csomagok/page.tsx
create mode 100644 services/frontend/src/components/PackageCards.tsx
diff --git a/crates/db/migrations/0012_packages.sql b/crates/db/migrations/0012_packages.sql
new file mode 100644
index 0000000..cecd653
--- /dev/null
+++ b/crates/db/migrations/0012_packages.sql
@@ -0,0 +1,26 @@
+-- Packages: every purchase or admin grant of a package is an order; the units
+-- it gives are credit_ledger rows pointing at it (reason 'package'), and the
+-- unlimited package is a time-limited 'unlimited' entitlement.
+CREATE TABLE package_orders (
+ id uuid PRIMARY KEY,
+ user_id uuid NOT NULL REFERENCES users ON DELETE CASCADE,
+ package text NOT NULL,
+ source text NOT NULL CHECK (source IN ('admin', 'mock', 'stripe')),
+ price_huf integer NOT NULL DEFAULT 0 CHECK (price_huf >= 0),
+ note text,
+ created_by uuid REFERENCES users ON DELETE SET NULL,
+ created_at timestamptz NOT NULL DEFAULT now()
+);
+
+CREATE INDEX package_orders_user_idx ON package_orders (user_id, created_at DESC);
+
+ALTER TABLE credit_ledger DROP CONSTRAINT credit_ledger_reason_check;
+ALTER TABLE credit_ledger ADD CONSTRAINT credit_ledger_reason_check
+ CHECK (reason IN ('monthly_grant', 'analysis', 'chat', 'refund', 'admin_adjust', 'purchase', 'person', 'package'));
+ALTER TABLE credit_ledger ADD COLUMN order_id uuid REFERENCES package_orders ON DELETE SET NULL;
+
+-- 'unlimited': analyses and persons without limit until expires_at.
+ALTER TABLE entitlements DROP CONSTRAINT entitlements_entitlement_check;
+ALTER TABLE entitlements ADD CONSTRAINT entitlements_entitlement_check
+ CHECK (entitlement IN ('unlimited_persons', 'unlimited'));
+ALTER TABLE entitlements ADD COLUMN expires_at timestamptz;
diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml
index 393d7aa..040a095 100644
--- a/deploy/docker-compose.yml
+++ b/deploy/docker-compose.yml
@@ -88,7 +88,7 @@ services:
# Stand-in payment (adds an analysis unit at once) until Stripe is connected.
MOCK_PAYMENTS: ${MOCK_PAYMENTS:-true}
FREE_PERSON_SLOTS: ${FREE_PERSON_SLOTS:-0}
- PERSON_PACK_SIZE: ${PERSON_PACK_SIZE:-5}
+ UNLIMITED_DAILY_LIMIT: ${UNLIMITED_DAILY_LIMIT:-5}
depends_on:
postgres:
condition: service_healthy
diff --git a/docker-compose.yml b/docker-compose.yml
index 3136b2b..fb9d433 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -56,7 +56,7 @@ services:
# Stand-in payment (adds an analysis unit at once) until Stripe is connected.
MOCK_PAYMENTS: ${MOCK_PAYMENTS:-true}
FREE_PERSON_SLOTS: ${FREE_PERSON_SLOTS:-0}
- PERSON_PACK_SIZE: ${PERSON_PACK_SIZE:-5}
+ UNLIMITED_DAILY_LIMIT: ${UNLIMITED_DAILY_LIMIT:-5}
depends_on:
postgres:
condition: service_healthy
diff --git a/docs/csomagok.md b/docs/csomagok.md
new file mode 100644
index 0000000..ce02437
--- /dev/null
+++ b/docs/csomagok.md
@@ -0,0 +1,39 @@
+# Csomagok és árazás
+
+A katalógus a kódban van: `services/backend/src/packages.rs` (`CATALOG`). Ár- vagy tartalomváltozás egy deploy.
+
+## Költség
+
+Egy részletes képletelemzés és egy kapcsolati elemzés is kb. **$0,21 (≈ 80 Ft)** Opus 5.5-tel; a rövid összefoglaló kb. $0,01. A fizetési szolgáltató díja kb. 1,5% + 85 Ft tranzakciónként. Az árak bruttók (27% áfa).
+
+## A lépcső
+
+| Csomag | Tartalom | Ár | Elemzésenként | Külön megvéve | Megtakarítás |
+|---|---|---|---|---|---|
+| Egy elemzés | 1 képletelemzés | 2 990 Ft | 2 990 Ft | – | – |
+| Páros | 2 képletelemzés, 1 kapcsolati, 1 személy | 6 990 Ft | 2 330 Ft | 9 868 Ft | 29% |
+| **Család** (Legnépszerűbb) | 6 képletelemzés, 5 kapcsolati, 5 személy | 11 990 Ft | 1 090 Ft | 37 380 Ft | 68% |
+| Korlátlan | minden korlátlanul, 12 hónapig | 17 990 Ft | – | – | – |
+| +1 kapcsolati elemzés | kiegészítő | 3 490 Ft | | | |
+| +5 személy | kiegészítő | 1 990 Ft | | | |
+
+## Miért így (a nagyobb felé terelés)
+
+- **Horgony:** az Egy elemzés ára (2 990 Ft) az egységár. Minden más ehhez mérve látszik olcsónak; a kártyákon áthúzva ott a „külön megvéve” ár.
+- **Kis lépések, nagy ugrások:** minden szint csak egy kicsivel drágább az előzőnél, de sokkal többet ad. Páros: +4 000 Ft-ért háromszor annyi elemzés. Család: +5 000 Ft-ért majdnem négyszer annyi. Korlátlan: +6 000 Ft-ért nincs határ. A kártyán ki is írjuk: „Csak +5 000 Ft a Páros csomaghoz képest”.
+- **Csali:** a Páros szándékosan „csak jó” ajánlat (−29%), hogy mellette a Család (−68%) kiugorjon. A Család kapja a kiemelést és a „Legnépszerűbb” címkét.
+- **A Korlátlan mint felső horgony:** a Család ára mellette mérsékeltnek tűnik; aki sokakat venne fel, annak a 6 000 Ft különbség semmiség.
+- **Drága kiegészítők:** a +1 kapcsolati elemzés 3 490 Ft, többe kerül, mint egy képletelemzés, és a Páros már kettő árán ad egyet kettőtök képletével együtt. Aki darabonként venne, annak jobban megéri csomagot venni.
+- **A vásárlás pillanatában** (a „Részletes elemzés kérése” után) nem egy darabot kínálunk, hanem három csomagot egymás mellett, kiemelt Családdal.
+- **Nem jár le:** a megvett elemzések megmaradnak, ezért a nagyobb csomag nem kockázat a vevőnek.
+
+## Korlátlan csomag
+
+Egy év; ha még tart, egy újabb a lejárathoz ad hozzá egy évet. Méltányos használat: naponta legfeljebb `UNLIMITED_DAILY_LIMIT` (alapból 5) új részletes elemzés. Legrosszabb esetben is jóval a csomag ára alatt marad a költség, ha valaki nem visszaélésszerűen használja; a napi korlát a gépi tömeges lekérést fogja meg.
+
+## Későbbre
+
+- Stripe-bekötés: a `package_orders.source = 'stripe'` már helyet kapott.
+- Bevezető kedvezmény vagy kupon (pl. az első 100 vásárlónak).
+- Ajándékba adható csomag (karácsony, Valentin-nap): a Páros és a Család jó ajándék.
+- Számlázás (NAV Online Számla) a vásárlásokhoz.
diff --git a/services/backend/README.md b/services/backend/README.md
index 97975ec..5970d43 100644
--- a/services/backend/README.md
+++ b/services/backend/README.md
@@ -14,9 +14,9 @@ Felhasználók, belépés, mentett születési képletek, szinasztriák és megh
| `COOKIE_DOMAIN` | – | pl. `.sorsfonalak.hu`, ha a frontend és az API más aldomainen fut |
| `SESSION_TTL_DAYS` | `30` | a munkamenet élettartama |
| `PASSWORD_LOGIN` | `false` | e-mail + jelszó regisztráció és belépés; élesben ki van kapcsolva (csak Google, Apple, Facebook), a jelszavas végpontok ilyenkor 403-at adnak |
-| `MOCK_PAYMENTS` | `false` | próbafizetés a Stripe bekötéséig: a `POST /v1/payments/mock` azonnal jóváír egy elemzési egységet (`{"unit": "natal"}`) vagy személycsomagot (`{"package": "persons"}` / `"persons_unlimited"`); a compose-fájlokban egyelőre `true` |
+| `MOCK_PAYMENTS` | `false` | próbafizetés a Stripe bekötéséig: a `POST /v1/payments/mock` `{"package": ""}` azonnal jóváírja a katalógus egy csomagját (`{"unit": "natal"}` rövidítés: a legkisebb ilyen csomag); a compose-fájlokban egyelőre `true` |
| `FREE_PERSON_SLOTS` | `0` | ennyi személyt vehet fel csomag nélkül egy felhasználó |
-| `PERSON_PACK_SIZE` | `5` | ennyi személy van egy személycsomagban |
+| `UNLIMITED_DAILY_LIMIT` | `5` | a Korlátlan csomaggal naponta ennyi új részletes elemzés kérhető (méltányos használat; utána 429 `fair_use_limit`) |
| `GOOGLE_CLIENT_IDS` | – | Google OAuth kliens-azonosító(k); üresen a Google-belépés ki van kapcsolva |
| `BOOTSTRAP_ADMIN_EMAILS` | – | ezek a címek regisztrációkor vagy belépéskor admin szerepet kapnak (így lesz meg az első admin) |
| `SUPPORTED_LOCALES` | `hu,en` | felület- és elemzésnyelvek; az első az alapértelmezett |
@@ -48,6 +48,7 @@ Felhasználók, belépés, mentett születési képletek, szinasztriák és megh
| Végpont | Guard | Leírás |
|---|---|---|
| `GET /v1/config` | – | Google kliens-azonosító, `password_login`, nyelvek, elemző és összefoglaló modell |
+| `GET /v1/packages` | – | a csomagkatalógus árral, tartalommal, megtakarítással, elemzésenkénti árral (lásd `docs/csomagok.md`) |
| `POST /v1/auth/register` | – | `{email, password, display_name?, locale?}` → munkamenet; megerősítő e-mailt küld |
| `POST /v1/auth/login` | – | `{email, password}` |
| `POST /v1/auth/google` | – | `{id_token}`; `created: true`, ha most jött létre a fiók |
@@ -76,6 +77,7 @@ Felhasználók, belépés, mentett születési képletek, szinasztriák és megh
| `GET /v1/public/shares/{slug}` | – | a megosztott tartalom (oldal + OG-kép adatai) |
| `GET /v1/admin/users?q=` | admin | felhasználók kereséssel, szerepekkel, megmaradt elemzésekkel |
| `PATCH /v1/admin/users/{id}` | admin | `{roles: [...]}`; a saját admin szerep nem vehető el |
+| `POST /v1/admin/users/{id}/packages` | admin | `{package, note?}`: csomag kiosztása ajándékként (`package_orders`, ár 0) |
| `POST /v1/admin/users/{id}/credits` | admin | `{unit: natal\|synastry, delta, note?}`: elemzések jóváírása vagy levonása |
| `GET /v1/admin/prompts` | admin | a tömör és a részletes elemzés system promptja nyelvenként: érvényes szöveg, alapértelmezett, változatok |
| `PUT /v1/admin/prompts/{kind}/{language}` | admin | `{system}` új változatként menti (`null` vagy az alapértelmezett szöveg: vissza a beépítettre); az új elemzések `prompt_version`-je `v2-r` |
@@ -122,5 +124,5 @@ A [worker](../worker/README.md) kiküldi az e-maileket, megírja az elemzéseket
## Korlátok
- **Saját születési adatok módosítása:** az első mentés után egy órán belül még háromszor javíthatók, utána naponta egyszer (`birth_data_changes` tábla). A tiltott módosítás 429-et ad `birth_data_change_limit` kóddal, a felhasználónak szóló üzenettel („A rendszer csak napi egy módosítást engedélyez. …”). A `/v1/me` `birth_change` mezője mutatja, él-e a napi korlát. Más emberek képleteit ez nem érinti.
-- **Személyek** (más emberek képletei, `charts.kind = 'person'`): minden új személy egy `person` egységet használ (`credit_ledger`, `reason = 'person'`); a törlés nem adja vissza. Egységet a személycsomag ad (`PERSON_PACK_SIZE` darab), a korlátlan csomag az `entitlements` tábla `unlimited_persons` sora. Ha elfogyott, 409 `person_limit_reached`. Egy személy születési adatai a felvétel után egy órán belül javíthatók (`PATCH /v1/charts/{id}` `birth` mezővel), utána 409 `person_locked`. Részletes elemzés (képlet vagy összevetés) után sem (409 `person_analysed`), és akkor sem, ha valaki más összevetésében szerepel (409 `person_in_synastry`); a saját, elemzés nélküli összevetései a javításkor törlődnek. A `/v1/me` `persons` mezője: `used`, `limit`, `left`, `unlimited`.
+- **Személyek** (más emberek képletei, `charts.kind = 'person'`): minden új személy egy `person` egységet használ (`credit_ledger`, `reason = 'person'`); a törlés nem adja vissza. Helyet a csomagok adnak; korlátlan az `unlimited_persons` jogosultsággal és futó Korlátlan csomaggal. Ha elfogyott, 409 `person_limit_reached`. Egy személy születési adatai a felvétel után egy órán belül javíthatók (`PATCH /v1/charts/{id}` `birth` mezővel), utána 409 `person_locked`. Részletes elemzés (képlet vagy összevetés) után sem (409 `person_analysed`), és akkor sem, ha valaki más összevetésében szerepel (409 `person_in_synastry`); a saját, elemzés nélküli összevetései a javításkor törlődnek. A `/v1/me` `persons` mezője: `used`, `limit`, `left`, `unlimited`.
- **Admin:** nincs módosítási korlát, korlátlan személy, a személyek adatai bármikor javíthatók, és a részletes elemzés ingyenes (nem fogy egység).
diff --git a/services/backend/src/config.rs b/services/backend/src/config.rs
index 96536ea..12211c7 100644
--- a/services/backend/src/config.rs
+++ b/services/backend/src/config.rs
@@ -49,8 +49,8 @@ pub struct Config {
pub max_charts_per_user: i64,
/// `FREE_PERSON_SLOTS` (default 0): persons a user may add without a package.
pub free_person_slots: i64,
- /// `PERSON_PACK_SIZE` (default 5): persons in one person package.
- pub person_pack_size: i64,
+ /// `UNLIMITED_DAILY_LIMIT` (default 5): new detailed analyses a day with the unlimited package.
+ pub unlimited_daily_limit: i64,
}
fn var(name: &str) -> Option {
@@ -105,7 +105,7 @@ impl Config {
prompt_version: var("ANALYSIS_PROMPT_VERSION").unwrap_or_else(|| "v2".into()),
max_charts_per_user: parsed("MAX_CHARTS_PER_USER", 1000)?,
free_person_slots: parsed("FREE_PERSON_SLOTS", 0)?,
- person_pack_size: parsed("PERSON_PACK_SIZE", 5)?,
+ unlimited_daily_limit: parsed("UNLIMITED_DAILY_LIMIT", 5)?,
};
if config.session_ttl_days < 1 {
bail!("SESSION_TTL_DAYS must be at least 1");
@@ -135,7 +135,7 @@ impl Config {
prompt_version: "v1".into(),
max_charts_per_user: 50,
free_person_slots: 5,
- person_pack_size: 5,
+ unlimited_daily_limit: 3,
}
}
}
diff --git a/services/backend/src/main.rs b/services/backend/src/main.rs
index dc2f9ec..8f45927 100644
--- a/services/backend/src/main.rs
+++ b/services/backend/src/main.rs
@@ -13,6 +13,7 @@ mod config;
mod credits;
mod error;
mod google;
+mod packages;
mod persons;
mod routes;
#[cfg(test)]
diff --git a/services/backend/src/packages.rs b/services/backend/src/packages.rs
new file mode 100644
index 0000000..9d6ffe2
--- /dev/null
+++ b/services/backend/src/packages.rs
@@ -0,0 +1,285 @@
+//! Packages: what a user can buy (or an admin can give). The catalog is
+//! fixed here; see `docs/csomagok.md` for the reasoning behind it.
+//!
+//! A package gives analysis units and person slots (`credit_ledger` rows
+//! with reason `package`) that never expire, or a time-limited `unlimited`
+//! entitlement: analyses and persons without limit, with a daily fair-use cap.
+
+use serde_json::{Value, json};
+use sqlx::PgConnection;
+use time::OffsetDateTime;
+use uuid::Uuid;
+
+use crate::credits::Unit;
+use crate::error::ApiError;
+
+/// List prices of the single items, for showing what a package saves.
+const NATAL_PRICE: i64 = 2_990;
+const SYNASTRY_PRICE: i64 = 3_490;
+const PERSON_PRICE: i64 = 398; // 1 990 Ft for five
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum Tier {
+ /// The main ladder, shown side by side.
+ Main,
+ /// Top-ups for those who already have something.
+ Addon,
+}
+
+#[derive(Debug, Clone, Copy)]
+pub struct Package {
+ pub id: &'static str,
+ pub name: &'static str,
+ pub tagline: &'static str,
+ pub tier: Tier,
+ /// Gross price (27% VAT included).
+ pub price_huf: i64,
+ pub natal: i64,
+ pub synastry: i64,
+ pub persons: i64,
+ /// Months of unlimited analyses and persons.
+ pub unlimited_months: Option,
+ /// Badge on the card ("Legnépszerűbb").
+ pub badge: Option<&'static str>,
+}
+
+pub const CATALOG: [Package; 6] = [
+ Package {
+ id: "single",
+ name: "Egy elemzés",
+ tagline: "Egy részletes képletelemzés: neked vagy egy felvett személynek.",
+ tier: Tier::Main,
+ price_huf: 2_990,
+ natal: 1,
+ synastry: 0,
+ persons: 0,
+ unlimited_months: None,
+ badge: None,
+ },
+ Package {
+ id: "couple",
+ name: "Páros",
+ tagline: "Te és ő: mindkettőtök képlete és a kapcsolati elemzés.",
+ tier: Tier::Main,
+ price_huf: 6_990,
+ natal: 2,
+ synastry: 1,
+ persons: 1,
+ unlimited_months: None,
+ badge: None,
+ },
+ Package {
+ id: "family",
+ name: "Család",
+ tagline: "Az egész család: öt személy, mindenki képlete, és öt kapcsolat.",
+ tier: Tier::Main,
+ price_huf: 11_990,
+ natal: 6,
+ synastry: 5,
+ persons: 5,
+ unlimited_months: None,
+ badge: Some("Legnépszerűbb"),
+ },
+ Package {
+ id: "unlimited",
+ name: "Korlátlan",
+ tagline: "Egy évig bárki, bármennyi elemzés és összevetés.",
+ tier: Tier::Main,
+ price_huf: 17_990,
+ natal: 0,
+ synastry: 0,
+ persons: 0,
+ unlimited_months: Some(12),
+ badge: None,
+ },
+ Package {
+ id: "addon_synastry",
+ name: "+1 kapcsolati elemzés",
+ tagline: "Egy újabb összevetés részletes elemzése.",
+ tier: Tier::Addon,
+ price_huf: 3_490,
+ natal: 0,
+ synastry: 1,
+ persons: 0,
+ unlimited_months: None,
+ badge: None,
+ },
+ Package {
+ id: "addon_persons",
+ name: "+5 személy",
+ tagline: "Még öt ember képlete (az elemzés külön jár).",
+ tier: Tier::Addon,
+ price_huf: 1_990,
+ natal: 0,
+ synastry: 0,
+ persons: 5,
+ unlimited_months: None,
+ badge: None,
+ },
+];
+
+pub fn find(id: &str) -> Option<&'static Package> {
+ CATALOG.iter().find(|p| p.id == id)
+}
+
+impl Package {
+ /// What the contents would cost one by one (`None` for the unlimited one).
+ fn list_price(&self) -> Option {
+ self.unlimited_months
+ .is_none()
+ .then(|| self.natal * NATAL_PRICE + self.synastry * SYNASTRY_PRICE + self.persons * PERSON_PRICE)
+ }
+
+ pub fn view(&self) -> Value {
+ let analyses = self.natal + self.synastry;
+ let savings = self
+ .list_price()
+ .filter(|&list| list > self.price_huf)
+ .map(|list| ((list - self.price_huf) * 100 + list / 2) / list);
+ json!({
+ "id": self.id,
+ "name": self.name,
+ "tagline": self.tagline,
+ "tier": match self.tier { Tier::Main => "main", Tier::Addon => "addon" },
+ "price_huf": self.price_huf,
+ "natal": self.natal,
+ "synastry": self.synastry,
+ "persons": self.persons,
+ "unlimited_months": self.unlimited_months,
+ "badge": self.badge,
+ "list_price_huf": self.list_price(),
+ "savings_percent": savings,
+ "per_analysis_huf": (analyses > 0).then(|| (self.price_huf + analyses / 2) / analyses),
+ })
+ }
+}
+
+/// Who gives the package.
+#[derive(Debug, Clone, Copy)]
+pub enum Source {
+ Admin,
+ Mock,
+}
+
+impl Source {
+ fn as_str(self) -> &'static str {
+ match self {
+ Source::Admin => "admin",
+ Source::Mock => "mock",
+ }
+ }
+}
+
+/// Records an order and gives its contents, inside the caller's transaction.
+pub async fn grant(
+ tx: &mut PgConnection,
+ user_id: Uuid,
+ package: &Package,
+ source: Source,
+ created_by: Option,
+ note: Option<&str>,
+) -> Result {
+ let order = Uuid::now_v7();
+ let price = match source {
+ Source::Admin => 0,
+ Source::Mock => package.price_huf,
+ };
+ sqlx::query(
+ "INSERT INTO package_orders (id, user_id, package, source, price_huf, note, created_by) \
+ VALUES ($1, $2, $3, $4, $5, $6, $7)",
+ )
+ .bind(order)
+ .bind(user_id)
+ .bind(package.id)
+ .bind(source.as_str())
+ .bind(price as i32)
+ .bind(note)
+ .bind(created_by)
+ .execute(&mut *tx)
+ .await?;
+ for (unit, n) in [(Unit::Natal, package.natal), (Unit::Synastry, package.synastry), (Unit::Person, package.persons)]
+ {
+ if n == 0 {
+ continue;
+ }
+ sqlx::query(
+ "INSERT INTO credit_ledger (id, user_id, unit, delta, reason, order_id, note, created_by) \
+ VALUES ($1, $2, $3, $4, 'package', $5, $6, $7)",
+ )
+ .bind(Uuid::now_v7())
+ .bind(user_id)
+ .bind(unit.as_str())
+ .bind(n as i32)
+ .bind(order)
+ .bind(package.name)
+ .bind(created_by)
+ .execute(&mut *tx)
+ .await?;
+ }
+ if let Some(months) = package.unlimited_months {
+ // Buying again extends from the current end, not from today.
+ sqlx::query(
+ "INSERT INTO entitlements (user_id, entitlement, note, created_by, expires_at) \
+ VALUES ($1, 'unlimited', $2, $3, now() + make_interval(months => $4)) \
+ ON CONFLICT (user_id, entitlement) DO UPDATE SET \
+ expires_at = greatest(entitlements.expires_at, now()) + make_interval(months => $4), \
+ note = EXCLUDED.note, created_by = EXCLUDED.created_by",
+ )
+ .bind(user_id)
+ .bind(package.name)
+ .bind(created_by)
+ .bind(months as i32)
+ .execute(&mut *tx)
+ .await?;
+ }
+ Ok(order)
+}
+
+/// Until when the user's unlimited package runs (`None`: none, or it ended).
+pub async fn unlimited_until(conn: &mut PgConnection, user_id: Uuid) -> Result