Tarot readings: AI-written, drawn on the server, sold as units
CI / test (push) Successful in 1m29s
CI / build (push) Successful in 5m52s
CI / deploy (push) Skipped

A new Kártyajóslás page: choose a spread (1, 3 or 5 cards), ask a
question, pick the cards from the fanned deck and watch them turn over;
the reading is written by the detailed-analysis model from the cards,
their positions and base meanings, the question and the reader's Sun,
Moon and Ascendant. The server shuffles and draws, so nobody can draw
again for free. A reading is a 'tarot' analysis (worker, retries,
fallback, refunds and admin regeneration as for analyses), uses one
'tarot' unit, and survives recalculations; deleting the account
deletes it.

Packages carry 2/5/10 readings, the new +5 kártyajóslás addon costs
1 000 Ft. The card artwork comes from the tarot design studio
(celestial astrolabe style); the deck JSON is shared by the frontend
and the prompt. A public example is at /kartyajoslas/pelda.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
This commit is contained in:
feco
2026-11-20 14:35:50 +00:00
co-authored by Claude Opus 5.5
parent 54af54cd39
commit b0fc547b73
36 changed files with 2957 additions and 46 deletions
+9 -2
View File
@@ -185,7 +185,7 @@ pub struct DeleteMe {
}
/// GDPR: deletes the account and everything that belongs to it (charts,
/// synastries using them, analyses, shares, sessions, credits).
/// synastries using them, analyses, tarot readings, shares, sessions, credits).
pub async fn delete_me(
State(state): St,
auth: AuthUser,
@@ -195,7 +195,14 @@ pub async fn delete_me(
if req.confirm != "DELETE" {
return Err(ApiError::BadRequest("set confirm to \"DELETE\" to delete the account".into()));
}
sqlx::query("DELETE FROM users WHERE id = $1").bind(auth.id()).execute(&state.db).await?;
let mut tx = state.db.begin().await?;
// Tarot readings belong to no chart: they go with the account.
sqlx::query("DELETE FROM analyses WHERE kind = 'tarot' AND requested_by = $1")
.bind(auth.id())
.execute(&mut *tx)
.await?;
sqlx::query("DELETE FROM users WHERE id = $1").bind(auth.id()).execute(&mut *tx).await?;
tx.commit().await?;
tracing::info!(user = %auth.id(), "account deleted");
Ok((StatusCode::NO_CONTENT, jar.add(removal_cookie(&state.config))))
}
+7 -3
View File
@@ -46,6 +46,7 @@ pub async fn list_users(
i64,
i64,
i64,
i64,
);
let rows: Vec<Row> = sqlx::query_as(
"SELECT u.id, u.email, u.display_name, u.roles, u.email_verified_at IS NOT NULL, u.created_at, u.last_login_at, \
@@ -53,7 +54,8 @@ pub async fn list_users(
(SELECT COALESCE(SUM(delta), 0)::bigint FROM credit_ledger l WHERE l.user_id = u.id AND l.unit = 'natal'), \
(SELECT COALESCE(SUM(delta), 0)::bigint FROM credit_ledger l WHERE l.user_id = u.id AND l.unit = 'synastry'), \
(SELECT COALESCE(SUM(delta), 0)::bigint FROM credit_ledger l WHERE l.user_id = u.id AND l.unit = 'forecast'), \
(SELECT COALESCE(SUM(delta), 0)::bigint FROM credit_ledger l WHERE l.user_id = u.id AND l.unit = 'question') \
(SELECT COALESCE(SUM(delta), 0)::bigint FROM credit_ledger l WHERE l.user_id = u.id AND l.unit = 'question'), \
(SELECT COALESCE(SUM(delta), 0)::bigint FROM credit_ledger l WHERE l.user_id = u.id AND l.unit = 'tarot') \
FROM users u \
WHERE $1::text IS NULL OR u.email ILIKE $1 OR u.display_name ILIKE $1 \
ORDER BY u.created_at DESC LIMIT $2 OFFSET $3",
@@ -65,12 +67,14 @@ pub async fn list_users(
.await?;
let users: Vec<Value> = rows
.into_iter()
.map(|(id, email, name, roles, verified, created, last_login, charts, natal, synastry, forecast, question)| {
.map(|(id, email, name, roles, verified, created, last_login, charts, natal, synastry, forecast, question, tarot)| {
json!({
"id": id, "email": email, "display_name": name, "roles": roles, "email_verified": verified,
"created_at": rfc3339(created), "last_login_at": rfc3339_opt(last_login),
"charts": charts,
"analyses_left": {"natal": natal, "synastry": synastry, "forecast": forecast, "question": question},
"analyses_left": {
"natal": natal, "synastry": synastry, "forecast": forecast, "question": question, "tarot": tarot,
},
})
})
.collect();
+13 -6
View File
@@ -386,11 +386,18 @@ pub async fn regenerate(
if row.status == "pending" || row.status == "running" {
return Err(ApiError::conflict("analysis_in_progress", "Ez az elemzés éppen készül."));
}
let kind = Kind::parse(&row.kind).ok_or_else(|| ApiError::Internal(format!("unknown kind {}", row.kind)))?;
let hash = target_hash(&state.db, &row).await?;
let hash = hash.ok_or(ApiError::NotFound("analysis"))?;
let (model, fallback) = crate::models::models_for(&state, kind).await?;
let (cache_key, prompt_version) = versions(&state, kind.as_str(), &hash, &model, &row.language).await?;
let (kind, model, fallback, cache_key, prompt_version) = if row.kind == "tarot" {
// A tarot reading: the analysis model, the same cards, never cached.
let (model, fallback) = crate::models::models_for(&state, Kind::Natal).await?;
("tarot", model, fallback, format!("tarot|{id}"), state.config.prompt_version.clone())
} else {
let kind = Kind::parse(&row.kind).ok_or_else(|| ApiError::Internal(format!("unknown kind {}", row.kind)))?;
let hash = target_hash(&state.db, &row).await?;
let hash = hash.ok_or(ApiError::NotFound("analysis"))?;
let (model, fallback) = crate::models::models_for(&state, kind).await?;
let (cache_key, prompt_version) = versions(&state, kind.as_str(), &hash, &model, &row.language).await?;
(kind.as_str(), model, fallback, cache_key, prompt_version)
};
let mut tx = state.db.begin().await?;
let row: AnalysisRow = sqlx::query_as(&format!(
"UPDATE analyses SET status = 'pending', content = NULL, error = NULL, model_used = NULL, \
@@ -410,6 +417,6 @@ pub async fn regenerate(
// Wakes the worker, as a new analysis does.
sqlx::query("SELECT pg_notify('analyses', '')").execute(&mut *tx).await?;
tx.commit().await?;
tracing::info!(%id, kind = kind.as_str(), "analysis regenerated");
tracing::info!(%id, kind, "analysis regenerated");
Ok(Json(row.view()))
}
+3
View File
@@ -23,6 +23,7 @@ mod questions;
mod recalculate;
mod shares;
mod synastries;
mod tarot;
pub use recalculate::run as recalculate;
@@ -102,6 +103,8 @@ pub fn router(state: Arc<AppState>) -> Router {
.route("/v1/analyses/{id}", get(analyses::get_one))
.route("/v1/analyses/{id}/questions", get(questions::list).post(questions::ask))
.route("/v1/questions/{id}", get(questions::get_one))
.route("/v1/tarot/readings", get(tarot::list).post(tarot::create))
.route("/v1/tarot/readings/{id}", get(tarot::get_one))
// sharing
.route("/v1/promo-codes/redeem", post(promo::redeem))
.route("/v1/admin/promo-codes", get(promo::list).post(promo::create))
+1
View File
@@ -64,6 +64,7 @@ pub async fn mock(
(None, Some(Unit::Forecast)) => "addon_forecast",
(None, Some(Unit::Person)) => "addon_persons",
(None, Some(Unit::Question)) => "addon_questions",
(None, Some(Unit::Tarot)) => "addon_tarot",
_ => return Err(ApiError::BadRequest("give either package or unit".into())),
};
let package = packages::find(id).ok_or(ApiError::NotFound("package"))?;
+3 -2
View File
@@ -1,6 +1,6 @@
//! `backend recalculate`: after a change in the calculation, recalculates
//! every stored chart, comparison and forecast with the horoscope service,
//! then deletes all analyses and queues them again: a short summary and a
//! then deletes all analyses (but the tarot readings) and queues them again: a short summary and a
//! detailed analysis for every chart, one analysis for every comparison and
//! every forecast. Nobody is charged; each analysis is requested in the name
//! of the owner, in the owner's language.
@@ -90,7 +90,8 @@ pub async fn run(state: &AppState) -> anyhow::Result<()> {
}
tracing::info!(count = forecast_hashes.len(), "forecasts recalculated");
let deleted = sqlx::query("DELETE FROM analyses").execute(db).await?.rows_affected();
// Tarot readings depend on no calculation: they stay.
let deleted = sqlx::query("DELETE FROM analyses WHERE kind <> 'tarot'").execute(db).await?.rows_affected();
let mut queued = 0;
for c in &charts {
let language = locale(db, c.owner_id).await?;
+212
View File
@@ -0,0 +1,212 @@
//! Tarot readings. The server shuffles and draws the cards (so nobody can
//! draw again for free until a card they like comes), stores them with the
//! question as a `tarot` analysis and spends one `tarot` unit; the worker
//! writes the reading with the model of the detailed analyses. A failed
//! reading gives its unit back.
use analysis_prompt::tarot::{self, Spread};
use analysis_prompt::{Kind, TAROT_QUESTION_MAX_CHARS};
use axum::Json;
use axum::extract::{Path, State};
use axum::http::StatusCode;
use axum_extra::extract::WithRejection;
use rand::seq::SliceRandom;
use rand::{Rng, rng};
use serde::Deserialize;
use serde_json::{Value, json};
use time::OffsetDateTime;
use uuid::Uuid;
use super::{Body, IdPath, St};
use crate::auth::AuthUser;
use crate::credits::{self, Unit};
use crate::error::{ApiError, ApiResult};
use crate::views::{rfc3339, rfc3339_opt};
/// How often a card comes up reversed.
const REVERSED_SHARE: f64 = 0.28;
/// The readings listed on the page, newest first.
const LIST_LIMIT: i64 = 100;
#[derive(Debug, sqlx::FromRow)]
pub struct ReadingRow {
pub id: Uuid,
pub status: String,
pub tarot: Value,
pub content: Option<Value>,
pub error: Option<String>,
pub credits_charged: i32,
pub attempts: i32,
pub created_at: OffsetDateTime,
pub completed_at: Option<OffsetDateTime>,
}
const COLUMNS: &str = "id, status, tarot, content, error, credits_charged, attempts, created_at, completed_at";
impl ReadingRow {
/// The reading as users see it: the cards with their positions (the model
/// and the reader's signs are left out).
pub fn view(&self) -> Value {
let spread = tarot::spread(self.tarot["spread"].as_str().unwrap_or_default());
let positions = spread.map(|s| s.positions).unwrap_or_default();
let cards: Vec<Value> = self.tarot["cards"]
.as_array()
.into_iter()
.flatten()
.enumerate()
.map(|(i, c)| {
let position = positions.get(i);
json!({
"card": c["card"],
"reversed": c["reversed"],
"position": position.map(|p| p.title),
"about": position.map(|p| p.about),
})
})
.collect();
json!({
"id": self.id,
"status": self.status,
"spread": self.tarot["spread"],
"spread_name": spread.map(|s| s.name),
"question": self.tarot["question"],
"cards": cards,
"content": self.content,
"error": self.error,
"credits_charged": self.credits_charged,
"attempts": self.attempts,
"created_at": rfc3339(self.created_at),
"completed_at": rfc3339_opt(self.completed_at),
})
}
}
/// Shuffles the deck and draws one card per position.
fn draw(spread: &Spread) -> Vec<Value> {
let mut rng = rng();
let mut ids: Vec<&str> = tarot::deck().iter().map(|c| c.id.as_str()).collect();
ids.shuffle(&mut rng);
ids.into_iter()
.take(spread.positions.len())
.map(|id| json!({ "card": id, "reversed": rng.random_bool(REVERSED_SHARE) }))
.collect()
}
/// The Sun, Moon and Ascendant signs of the user's own chart (the Ascendant
/// only with a known birth time).
async fn big_three(
state: &crate::AppState,
user: Uuid,
) -> Result<(Option<String>, Option<String>, Option<String>), ApiError> {
let chart: Option<Value> = sqlx::query_scalar(
"SELECT result FROM charts WHERE owner_id = $1 AND kind = 'own' ORDER BY is_primary DESC, created_at LIMIT 1",
)
.bind(user)
.fetch_optional(&state.db)
.await?;
let Some(chart) = chart else { return Ok((None, None, None)) };
let sign_of = |id: &str| {
chart["points"]
.as_array()
.into_iter()
.flatten()
.find(|p| p["id"] == id)
.and_then(|p| p["sign"].as_str())
.map(str::to_string)
};
let time_known = chart["time"]["time_known"].as_bool().unwrap_or(false);
let ascendant = chart["angles"]["ascendant"]["sign"].as_str().filter(|_| time_known).map(str::to_string);
Ok((sign_of("sun"), sign_of("moon"), ascendant))
}
pub async fn list(State(state): St, auth: AuthUser) -> ApiResult<Json<Value>> {
let rows: Vec<ReadingRow> = sqlx::query_as(&format!(
"SELECT {COLUMNS} FROM analyses WHERE kind = 'tarot' AND requested_by = $1 ORDER BY created_at DESC LIMIT $2"
))
.bind(auth.id())
.bind(LIST_LIMIT)
.fetch_all(&state.db)
.await?;
let left = credits::balance(&mut *state.db.acquire().await?, auth.id()).await?.tarot;
Ok(Json(json!({ "readings": rows.iter().map(ReadingRow::view).collect::<Vec<_>>(), "left": left })))
}
pub async fn get_one(State(state): St, auth: AuthUser, WithRejection(Path(id), _): IdPath) -> ApiResult<Json<Value>> {
let row: ReadingRow = sqlx::query_as(&format!(
"SELECT {COLUMNS} FROM analyses WHERE id = $1 AND kind = 'tarot' AND requested_by = $2"
))
.bind(id)
.bind(auth.id())
.fetch_optional(&state.db)
.await?
.ok_or(ApiError::NotFound("reading"))?;
Ok(Json(row.view()))
}
#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
pub struct NewReading {
spread: String,
question: Option<String>,
}
/// Draws the cards and queues the reading (one `tarot` unit).
pub async fn create(
State(state): St,
auth: AuthUser,
WithRejection(Json(req), _): Body<NewReading>,
) -> ApiResult<(StatusCode, Json<Value>)> {
let spread = tarot::spread(&req.spread).ok_or_else(|| ApiError::BadRequest("unknown spread".into()))?;
let question = req.question.map(|q| q.trim().replace("\r\n", "\n")).filter(|q| !q.is_empty());
if question.as_ref().is_some_and(|q| q.chars().count() > TAROT_QUESTION_MAX_CHARS) {
return Err(ApiError::BadRequest(format!(
"the question is at most {TAROT_QUESTION_MAX_CHARS} characters long"
)));
}
let open: bool = sqlx::query_scalar(
"SELECT EXISTS (SELECT 1 FROM analyses WHERE kind = 'tarot' AND requested_by = $1 \
AND status IN ('pending', 'running'))",
)
.bind(auth.id())
.fetch_one(&state.db)
.await?;
if open {
return Err(ApiError::conflict(
"tarot_in_progress",
"Az előző jóslásod még készül. Várd meg, és utána húzz újra.",
));
}
let (sun, moon, ascendant) = big_three(&state, auth.id()).await?;
let reading = json!({
"spread": spread.id,
"question": question,
"cards": draw(spread),
"sun": sun,
"moon": moon,
"ascendant": ascendant,
});
// The model of the detailed analyses writes the readings too.
let (model, fallback) = crate::models::models_for(&state, Kind::Natal).await?;
let language = super::auth::validate_locale(&state, Some(&auth.user.locale))?;
let id = Uuid::now_v7();
let mut tx = state.db.begin().await?;
let row: ReadingRow = sqlx::query_as(&format!(
"INSERT INTO analyses (id, kind, requested_by, language, model, prompt_version, cache_key, status, \
credits_charged, fallback_model, tarot) \
VALUES ($1, 'tarot', $2, $3, $4, $5, $6, 'pending', 1, $7, $8) RETURNING {COLUMNS}"
))
.bind(id)
.bind(auth.id())
.bind(&language)
.bind(&model)
.bind(&state.config.prompt_version)
.bind(format!("tarot|{id}"))
.bind(&fallback)
.bind(&reading)
.fetch_one(&mut *tx)
.await?;
credits::spend(&mut tx, auth.id(), Unit::Tarot, id).await?;
tx.commit().await?;
tracing::info!(user = %auth.id(), %id, spread = spread.id, "tarot reading queued");
Ok((StatusCode::ACCEPTED, Json(row.view())))
}