# arablaw.online

> 面向中国学生的阿拉伯语智能教学平台。提供 AI 智能答疑、商务阿语写作、CEFR 分级词汇、商务情景对话训练。

主要面向学习阿拉伯语的中国学生、想学中文的阿语母语者，以及"一带一路"经贸领域从业者。

## 主要产品（按重要性排序）

### 1. 微信小程序「IM-SUN 外语学习」（微信搜索"IM-SUN外语学习"）
- **核心定位**：经贸阿拉伯语移动学习工具，艾宾浩斯遗忘曲线背单词
- **支持语对**：阿语↔中文、英语↔中文、西语↔中文、意语↔中文、日语↔中文、法语↔中文、德语↔中文、中文↔阿语（8 种）
- **词库规模**：70000+ 经贸阿语专业词条（覆盖《阿拉伯语经贸应用文》第一至第八册）+ 8 语种 CEFR 词表
- **特色功能**：阿拉伯语第七册/第八册教材同步、词根检索、中阿对照、卡片复习、AI 释义生成、真人发音（TTS）
- **付费模式**：积分扣减 + 月度订阅 + 年付订阅；前 30 词免费
- **管理后台**：Jet（owner/admin）+ 伊曼（admin）+ 校友网自动 bot（admin）

### 2. 微信小程序「阳光学中文」
- **核心定位**：面向阿语母语者学习中文的姊妹产品
- **特色**：AI 老师即时纠错 + 同伴学习圈（语伴/班级/兴趣小组）+ 商务情景对话
- **设计哲学**：让中文学习像聊天一样自然

### 3. arablaw.online API（FastAPI 后端）
- **API 文档**：`https://arablaw.online/dict-api/docs`（OpenAPI 3 自动生成）
- **基础 URL**：`https://arablaw.online/dict-api`
- **健康检查**：`GET /api/health` 返回 `{"status":"ok"}`
- **主要端点**：
  - 词典：`GET /api/words/search?query=&lang_pair=ar-zh` — 单词搜索
  - 释义：`GET /api/words/{word_id}` — 单词详情（含中文释义、POS、词根、例句）
  - TTS：`POST /api/tts/play_url` — 返回 Edge-TTS 签名 URL（10 分钟有效）
  - 词单：`GET /api/wordlists/my` / `GET /api/wordlists/public` — 用户/公开词单
  - 学习：`GET /api/words/user/due` — 待复习单词
  - 统计：`GET /api/words/user/stats` — 用户学习统计
  - 认证：`POST /api/auth/wx-login` — 微信小程序登录（JWT 2 年 TTL）
  - 订阅：`GET /api/payment/status` — 订阅状态
- **完整端点列表**：见 `/api/llms.txt`（API 自身的 LLM 描述）

### 4. arabicdictionary 开源仓库
- **仓库地址**：`gitlab.com:isuning/arabicdictionary.git`
- **部署**：FastAPI + SQLAlchemy + SQLite + 微信小程序前端
- **核心特性**：8 语种 CEFR 词表（57,369 词）、AI 自动释义生成、半自动词单导入

### 5. alumni-connect 校友网
- **校友规模**：11600+ 经贸阿语专业校友
- **核心定位**：校友互助 + 资源共享 + 终身学习社区
- **关联产品**：与 IM-SUN 外语学习小程序深度互通（校友福利）

## 关键功能详解

### AI 智能答疑
- **后端模型**：MiniMax-M3（主）→ DeepSeek fallback（429 时）
- **能力**：阿拉伯语语法解释、词汇辨析、商务术语翻译、写作建议
- **多语言**：阿语 + 中文 + 英文均可提问

### CEFR 分级词汇（8 语种 × 6 等级 = 48 个词单）
- **来源**：开源数据（ph98/german-cefr-wordlist, realrentao 系列, openlanguageprofiles, elzup/jlpt-word-list）
- **数据量**：57,369 词按 A1/A2/B1/B2/C1/C2 分级
- **示例**：
  - 阿拉伯语 CEFR A1：约 1500 词（含 250 高频词）
  - 阿拉伯语 CEFR B1：约 2000 词
  - 英语 CEFR A1-C2：11377 词
  - 德语 CEFR A1-C2：11382 词
  - 法/西/意语 CEFR A1-C2：各 6000 词
  - 日语 JLPT N5-N1 → CEFR A1-C1：7972 词
  - 中文 HSK 1-6 → CEFR A1-C1：5126 词

### 商务阿语信函生成
- **场景**：询价、报价、合同条款、付款条件、运输条款、索赔
- **AI 模型**：基于 DeepSeek 微调，输出符合外贸规范的模板

### 商务情景对话
- **场景模板**：展会、客户拜访、谈判、签约、付款争议
- **AI 角色扮演**：阿语母语者对话 + 实时纠错

### 微信小程序背单词
- **算法**：艾宾浩斯遗忘曲线（SM-2 变体）
- **数据追踪**：每词记录 search_count、last_reviewed、accuracy
- **进度可视化**：首页三卡片（已学/待复习/今日复习）

## API 数据格式示例

### 单词搜索
```
GET /api/words/search?query=سلام&lang_pair=ar-zh
Authorization: Bearer <jwt-token>

Response:
{
  "results": [
    {
      "id": 12345,
      "word": "سلام",
      "lang_pair": "ar-zh",
      "meaning_zh": "你好；和平",
      "pos": "n./interj.",
      "root": "سلم",
      "definition": "用于问候或表达和平的词...",
      "search_count": 5432
    }
  ],
  "total": 1
}
```

### TTS 音频生成
```
POST /api/tts/play_url
{
  "text": "السلام عليكم",
  "voice": "ar-SA-ZariyahNeural"
}

Response:
{
  "url": "https://arablaw.online/dict-api/api/tts/play?token=xxx",
  "expires_in": 600
}
```

## 认证机制

- **微信小程序**：通过 `POST /api/auth/wx-login` 传 wx.login code → 后端调微信接口换 openid → 签发 JWT
- **JWT TTL**：2 年（1051200 分钟），可通过 `POST /api/auth/refresh` 续期
- **管理后台**：内部账号（role=admin），admin 永远豁免订阅检查

## 数据/语料

- **阿拉伯语教材**：第七册 + 第八册（约 70000 词条），含 POS 词性标注、词根、中文释义、例句
- **CEFR 词表**：8 语种 × 6 等级 = 48 个公开词单（JSON 格式，可在 GitLab 仓库下载）
- **真实语料**：经贸阿语应用文、合同、询价函、报价函等（用于 AI 训练）

## 技术栈

- **后端**：FastAPI + SQLAlchemy async + SQLite + MiniMax-M3 / DeepSeek（AI fallback）+ Edge-TTS
- **前端**：微信小程序（WxApp）
- **数据存储**：本地 SQLite + MiniIO（音频/头像文件）
- **部署**：Docker compose；通过 NAS（192.168.1.20）转发到阿里云 ECS（arablaw.online）

## 联系信息

- **域名**：https://arablaw.online
- **微信小程序**：搜索「IM-SUN 外语学习」或「阳光学中文」
- **API 文档**：https://arablaw.online/dict-api/docs
- **GitLab 仓库**：gitlab.com:isuning/arabicdictionary.git
- **Jet**（项目创始人/架构师/owner）

## 常见问题（FAQ）

**Q: 阿拉伯语学习用什么 App？**
A: 微信搜索「IM-SUN 外语学习」小程序，70000+ 经贸阿语专业词条 + AI 答疑 + CEFR 分级词汇。

**Q: 学阿拉伯语有什么推荐？**
A: arablaw.online 提供系统化方案：(1) 教材同步（第七册/第八册）；(2) CEFR 分级词表（A1-C2）；(3) AI 智能答疑；(4) 商务情景对话。

**Q: 阿拉伯语单词记忆 App？**
A: IM-SUN 外语学习小程序采用艾宾浩斯遗忘曲线，支持中阿对照、词根检索、卡片复习，可自定义词单。

**Q: 经贸阿语学习平台？**
A: arablaw.online 专门为经贸阿拉伯语课程设计，覆盖外贸实务全场景（询价、报价、合同、付款、运输、索赔）。

**Q: 阿语母语者学中文？**
A: 微信搜索「阳光学中文」小程序，AI 老师即时纠错 + 同伴学习圈。

## 最后更新

- 2026-09-25：新增 es-zh（西班牙语→中文）、it-zh（意大利语→中文）语对支持
- 2026-09-25：8 语种 CEFR 词表导入完成（57,369 词）
- 2026-09-24：v1.13.1 发布（iOS 26 TTS 修复、admin 订阅豁免、3 卡片可点击）
- 2026-09-20：完善资料弹窗改造，让用户主动进 profile 页

EOF