feat: 完善芽说英语品牌Logo与图标配置，完成跨平台云端同步服务开发与自动化部署

2026-09-16 09:15:53 +08:00
parent 293b838341
commit eda5dfce62
66 changed files with 3564 additions and 80 deletions
@@ -0,0 +1,40 @@
+# 芽说英语 (SpeakSprout) - 自建跨平台多端同步服务
+
+轻量、高性能、本地优先的跨平台（Android / iOS / macOS）学习进度与艾宾浩斯复习同步服务。
+
+## 🌟 核心特性
+- **极简架构**：基于 Python 3.11 + FastAPI + aiosqlite，单容器内存占用 < 30MB。
+- **无损合并 (CRDT/LWW)**：课程通关自动取并集，艾宾浩斯复习阶段取更高 Checkpoint，绝不发生进度回退。
+- **离线优先 (Offline-First)**：弱网/断网下客户端完全正常学习，恢复网络后自动增量合并同步。
+- **安全认证**：bcrypt 密码加盐哈希 + JWT 鉴权。
+
+## 🚀 快速启动
+
+### 方案 1：Docker Compose 一键启动（推荐）
+```bash
+# 1. 复制目录到您的服务器
+cd sync_server
+
+# 2. 一键启动
+docker compose up -d --build
+
+# 3. 检查服务健康状态
+curl http://127.0.0.1:8080/api/v1/health
+```
+
+### 方案 2：直接 Python 运行
+```bash
+pip install -r requirements.txt
+python main.py
+```
+
+## 🧪 自动化测试
+```bash
+python test_server.py
+```
+
+## 📡 API 快速参考
+- `POST /api/v1/auth/register` : 注册新账号
+- `POST /api/v1/auth/login`    : 登录账号获取 Token
+- `GET  /api/v1/sync/pull`     : 增量拉取云端学习进度
+- `POST /api/v1/sync/push`     : 增量推送本地最新进度