From d9b8a1667830edd8193139261c10d13a16730de0 Mon Sep 17 00:00:00 2001
From: voidborne-d <258577966+voidborne-d@users.noreply.github.com>
Date: Sun, 17 May 2026 07:17:43 +0800
Subject: [PATCH] docs(server): align Python prerequisite with pyproject (3.12)
 (closes #1579)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The server READMEs (EN/CN/PT-BR) listed Python 3.10.\* as the
prerequisite for the Docker quickstart, but the project is pinned to
3.12 in three places that all agree:

- server/pyproject.toml: requires-python = ">=3.12,<3.13"
- server/uv.lock: requires-python = "==3.12.*"
- server/Dockerfile: ghcr.io/astral-sh/uv:python3.12-bookworm-slim

A user attempting `uv python pin 3.10.15` per the README hits:
  error: The requested Python version `3.10.15` is incompatible with
  the project `requires-python` value of `==3.12.*`.

This was reported in #1579 with the full reproduction. Scope is
intentionally minimal — only the three server READMEs, three lines
total. The pin reference is included inline so future drift between
pyproject and READMEs is easier to spot.
---
 server/README_CN.md    | 2 +-
 server/README_EN.md    | 2 +-
 server/README_PT-BR.md | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/server/README_CN.md b/server/README_CN.md
index a918d488..f47309e5 100644
--- a/server/README_CN.md
+++ b/server/README_CN.md
@@ -27,7 +27,7 @@
 #### 前置要求
 
 - **Docker Desktop**：已安装并运行
-- **Python**：3.10.\*（推荐使用 3.10.15）
+- **Python**：3.12.\*（与 `pyproject.toml` 中的 `requires-python = ">=3.12,<3.13"` 一致）
 - **Node.js**：>=18.0.0 \<23.0.0
 
 #### Triggers 托管配置
diff --git a/server/README_EN.md b/server/README_EN.md
index a405d4ec..9e5c078b 100644
--- a/server/README_EN.md
+++ b/server/README_EN.md
@@ -27,7 +27,7 @@ Note: All the above data is stored in the local PostgreSQL volume in Docker (see
 #### Prerequisites
 
 - **Docker Desktop**: Installed and running
-- **Python**: 3.10.\* (3.10.15 recommended)
+- **Python**: 3.12.\* (matches `requires-python = ">=3.12,<3.13"` in `pyproject.toml`)
 - **Node.js**: >=18.0.0 <23.0.0
 
 #### Hosting Configuration for Triggers
diff --git a/server/README_PT-BR.md b/server/README_PT-BR.md
index 44050a62..7a99ee5d 100644
--- a/server/README_PT-BR.md
+++ b/server/README_PT-BR.md
@@ -27,7 +27,7 @@ Nota: Todos os dados acima são armazenados no volume PostgreSQL local no Docker
 #### Pré-requisitos
 
 - **Docker Desktop**: Instalado e em execução
-- **Python**: 3.10.\* (3.10.15 recomendado)
+- **Python**: 3.12.\* (corresponde a `requires-python = ">=3.12,<3.13"` em `pyproject.toml`)
 - **Node.js**: >=18.0.0 \<23.0.0
 
 #### Etapas de Configuração