Fix PR #1 follow-ups: sync multilingual READMEs, improve config comment

- Sync Web Portal docs to README_zh.md and README_ar.md
- config.py: use <BASE_URL> placeholder instead of hardcoded http://host:9527
- Remove extra blank line in README.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: JihaoXin

README.md

@@ -201,7 +201,6 @@ The web app is configured via `webapp.env` located in your ARK config directory
 
 </details>
 
-
 <details>
 <summary><strong>Direct orchestrator invocation</strong></summary>
 

README_ar.md

@@ -163,21 +163,41 @@ ark new mma --from-pdf proposal.pdf
 | `ark list` | سرد جميع المشاريع وحالتها |
 | `ark webapp install` | تثبيت خدمة بوابة الويب |
 
+---
+
+## بوابة الويب
+
+يتضمن ARK بوابة ويب لإدارة المشاريع وعرض الدرجات وتوجيه الوكلاء.
+
+### الإعدادات
+
+يتم تكوين تطبيق الويب عبر `webapp.env` الموجود في دليل إعدادات ARK (الافتراضي: `.ark/webapp.env` في جذر المشروع). يتم إنشاؤه تلقائيًا عند أول تشغيل لـ `ark webapp`.
+
+#### المصادقة والوصول
+- **SMTP**: مطلوب لتسجيل الدخول بالرابط السحري. عيّن `SMTP_HOST` و`SMTP_USER` و`SMTP_PASSWORD`.
+- **تقييد الوصول**: استخدم `ALLOWED_EMAILS` (مستخدمون محددون) أو `EMAIL_DOMAINS` (مؤسسات كاملة).
+- **Google OAuth**: اختياري. عيّن `GOOGLE_CLIENT_ID` و`GOOGLE_CLIENT_SECRET`.
+
+### أوامر الإدارة
+
+| الأمر | الوصف |
+|:------|:------|
+| `ark webapp` | بدء التطبيق في الواجهة (مفيد للتصحيح). |
+| `ark webapp release` | وسم الكود الحالي ونشره في شجرة العمل الإنتاجية. |
+| `ark webapp install [--dev]` | تثبيت وبدء كخدمة `systemd` للمستخدم. |
+| `ark webapp status` | عرض حالة خدمة systemd. |
+| `ark webapp restart` | إعادة تشغيل خدمة التطبيق. |
+| `ark webapp logs [-f]` | عرض أو متابعة سجلات الخدمة. |
+
 <details>
-<summary><strong>بوابة الويب (تطوير/إنتاج)</strong></summary>
+<summary><strong>تفاصيل الخدمة (إنتاج مقابل تطوير)</strong></summary>
 
 | | الإنتاج | التطوير |
 |--|:--------|:--------|
-| المنفذ | 9527 | 1027 |
-| الخدمة | `ark-webapp` | `ark-webapp-dev` |
-| بيئة Conda | `ark-prod` | `ark-dev` |
-| الكود | `~/.ark/prod/` (مقفل على وسم git) | المستودع الحالي (مباشر) |
-
-```bash
-ark webapp release              # وسم + نشر للإنتاج
-ark webapp install              # بدء الإنتاج (المنفذ 9527)
-ark webapp install --dev        # بدء التطوير (المنفذ 1027)
-```
+| **المنفذ** | 9527 | 1027 |
+| **اسم الخدمة** | `ark-webapp` | `ark-webapp-dev` |
+| **بيئة Conda** | `ark-prod` | `ark-dev` |
+| **مصدر الكود** | `~/.ark/prod/` (مقفل) | المستودع الحالي (مباشر) |
 
 </details>
 

README_zh.md

@@ -163,21 +163,41 @@ ARK 使用 PyMuPDF + Claude Haiku 解析 PDF，预填向导，从提取的规格
 | `ark list` | 列出所有项目及状态 |
 | `ark webapp install` | 安装 Web 门户服务 |
 
+---
+
+## Web 门户
+
+ARK 提供基于 Web 的门户，用于管理项目、查看评分和控制智能体。
+
+### 配置
+
+Web 应用通过 `webapp.env` 配置，位于 ARK 配置目录（默认：项目根目录下的 `.ark/webapp.env`）。首次运行 `ark webapp` 时自动创建。
+
+#### 认证与访问
+- **SMTP**：魔法链接登录所需。设置 `SMTP_HOST`、`SMTP_USER` 和 `SMTP_PASSWORD`。
+- **访问限制**：使用 `ALLOWED_EMAILS`（指定用户）或 `EMAIL_DOMAINS`（整个组织）限制访问。
+- **Google OAuth**：可选。设置 `GOOGLE_CLIENT_ID` 和 `GOOGLE_CLIENT_SECRET`。
+
+### 管理命令
+
+| 命令 | 描述 |
+|:-----|:-----|
+| `ark webapp` | 前台启动应用（适用于调试）。 |
+| `ark webapp release` | 打 tag 并部署到生产环境工作树。 |
+| `ark webapp install [--dev]` | 安装并启动为 `systemd` 用户服务。 |
+| `ark webapp status` | 查看 systemd 服务状态。 |
+| `ark webapp restart` | 重启 Web 应用服务。 |
+| `ark webapp logs [-f]` | 查看或追踪服务日志。 |
+
 <details>
-<summary><strong>Web 门户（开发/生产环境）</strong></summary>
+<summary><strong>服务详情（生产 vs. 开发）</strong></summary>
 
 | | 生产环境 | 开发环境 |
 |--|:---------|:---------|
-| 端口 | 9527 | 1027 |
-| 服务名 | `ark-webapp` | `ark-webapp-dev` |
-| Conda 环境 | `ark-prod` | `ark-dev` |
-| 代码 | `~/.ark/prod/`（锁定 git tag） | 当前 repo（实时生效） |
-
-```bash
-ark webapp release              # 打 tag + 部署到生产
-ark webapp install              # 启动生产服务（端口 9527）
-ark webapp install --dev        # 启动开发服务（端口 1027）
-```
+| **端口** | 9527 | 1027 |
+| **服务名** | `ark-webapp` | `ark-webapp-dev` |
+| **Conda 环境** | `ark-prod` | `ark-dev` |
+| **代码来源** | `~/.ark/prod/`（锁定版本） | 当前 repo（实时生效） |
 
 </details>
 

ark/webapp/config.py

@@ -74,7 +74,7 @@ def _write_default_env():
 ADMIN_EMAILS=
 
 # Google OAuth (optional). Get credentials at console.cloud.google.com → APIs & Services → Credentials.
-# Redirect URI to register: http://{hostname}:9527/auth/google/callback
+# Redirect URI to register: <BASE_URL>/auth/google/callback  (use the BASE_URL value above)
 GOOGLE_CLIENT_ID=
 GOOGLE_CLIENT_SECRET=