PRTS Paratranz Remake Translation System

一个面向公开协作场景的现代翻译工作台。

它的重点不是机器翻译，也不是 Git 源码同步，而是专注于高效的翻译协作、精细的权限管理以及稳定的版本追踪。

✨ 核心特性

• 🏢 多组织、多项目架构：单一部署即可支持多个独立翻译组运行。
• 🌍 多原文到单目标语言：完美适配诸如 EN/JP/KR -> CN 的多源交叉翻译场景。
• 📦 文档级 JSON 导入导出：无缝对接游戏/软件等结构化本地化资源。
• 🏷️ 灵活的文档标签：支持分类筛选与批量管理。
• 📜 简单实用的版本历史：清晰记录每一个翻译条目的变更轨迹（Who, When, What）。
• 🔐 细粒度权限管控：涵盖角色、单用户覆写、文档级范围限定以及多级审核流（译文 -> 校对 -> 批准）。

---

🏗️ 技术栈选型

后端：

• Go + chi (路由)
• PostgreSQL (核心数据) + Redis (缓存与会话)
• Docker Compose (编排)

前端：

• React + TypeScript + Vite
• TanStack Router (类型安全路由) + TanStack Query (服务端状态)
• Zustand (客户端状态)
• Tailwind CSS (样式原子化)

---

🚀 快速开始 (本地开发)

1. 环境准备

确保已安装 Go 1.25.3+、Docker 和 Docker Compose。

克隆环境变量配置：

# Linux / macOS
cp .env.example .env

# Windows PowerShell
Copy-Item .env.example .env

2. 启动基础设施与初始化数据库

启动依赖服务（PostgreSQL, Redis）并执行数据库自动迁移与种子数据填充：

# 启动依赖组件
docker compose up -d postgres redis

# 等待数据库就绪后，执行迁移与种子数据填充
go run ./cmd/migrate

执行完毕后，数据库会自动创建表结构并写入演示用的组织、项目及账户数据。旧版本数据库中的演示明文密码也会自动升级为 bcrypt 哈希。

🔑 默认演示账号：

• 管理员：admin@example.com / admin123
• 校对员：reviewer@example.com / reviewer123

3. 启动应用

整理 Go 模块：

go mod tidy

开启两个终端分别启动 API 与后台 Worker：

# 终端 1: 启动 API 服务 (端口: 18080)
go run ./cmd/api

# 终端 2: 启动异步任务 Worker
go run ./cmd/worker

前端项目的启动请参考 UI/GEMINI_README.md，前端开发环境已在 web/ 目录初始化完毕，默认端口为 13000。

---

📂 目录结构

PRTS_TranslationSystem/
├── cmd/
│   ├── api/          # 后端 API 入口
│   ├── worker/       # 异步任务 Worker 入口
│   └── migrate/      # 数据库迁移工具
├── internal/
│   ├── app/          # 核心启动与装配逻辑
│   ├── config/       # 环境变量解析
│   ├── handlers/     # HTTP 请求处理
│   ├── middleware/   # 鉴权、日志等中间件
│   ├── platform/     # 基础工具与响应封装
│   └── store/        # 数据库仓储接口
├── db/
│   └── migrations/   # SQL 迁移文件
├── docs/             # 架构设计与需求文档
├── deploy/           # 生产环境部署脚本及 Compose 文件
├── web/              # 前端 React + Vite 项目代码
└── UI/               # 早期给 AI 助手提供的前端开发指令

---

🛠️ Docker Compose 完整启动

如果你不想在宿主机直接跑 Go，可以使用 Docker Compose 一键拉起完整环境（含 API、Worker、Postgres、Redis）：

docker compose up --build

服务停止指令：docker compose down

---

🚢 服务器部署

推荐方式是：

1. 在服务器上手动 git pull
2. 执行一条交互式命令完成部署

不再使用 GitHub Actions 远程部署。

1. 服务器环境准备

sudo apt update
sudo apt install -y git docker.io docker-compose-plugin
sudo systemctl enable --now docker
sudo groupadd docker || true
sudo usermod -aG docker $USER
newgrp docker

验证：

docker ps

2. 拉代码

sudo mkdir -p /opt/prts-translation-system
sudo chown -R $USER:$USER /opt/prts-translation-system
cd /opt/prts-translation-system
git clone git@github.com:LocalizeLimbusCompany/PRTS.git repo
cd repo

3. 准备配置

cp .env.example .env

至少修改：

POSTGRES_PASSWORD=换成强密码
DATABASE_URL=postgres://postgres:换成强密码@postgres:5432/prts_translation_system?sslmode=disable
EDGE_PORT=18000

注意：

• 不再默认占用 80
• 默认监听 18000
• 你后续自己用 Nginx / Caddy / 宝塔做反代

4. 一条命令交互式部署

chmod +x ./deploy/local-deploy.sh
sh ./deploy/local-deploy.sh

如果你之前已经部署过旧版本，并且上传头像时报“保存头像失败”或“上传目录无写权限”，先执行一次：

mkdir -p /opt/prts-translation-system/uploads /opt/prts-translation-system/exports
sudo chown -R $USER:$USER /opt/prts-translation-system/uploads /opt/prts-translation-system/exports

脚本会交互询问：

• 后端镜像名
• 前端镜像名
• 对外监听端口
• 是否重新构建后端
• 是否重新构建前端

默认行为：

• 本地构建后端镜像 prts-backend-local
• 本地构建前端镜像 prts-web-local
• 默认使用国内镜像源：
  • GOPROXY=https://goproxy.cn,direct
  • GOSUMDB=off
  • NPM registry=https://registry.npmmirror.com
• 执行数据库迁移
• 启动整套服务

5. 访问

如果你的服务器 IP 是 1.2.3.4，默认访问：

http://1.2.3.4:18000

6. 以后如何更新

以后在服务器上只需要：

cd /opt/prts-translation-system/repo
sh ./deploy/update.sh

这条命令会：

• git pull
• 重新进入交互式部署
• 重新构建并迁移

---

💡 API 调试示例 (点击展开)

健康检查

curl http://localhost:18080/healthz

获取登录 Token

curl -X POST http://localhost:18080/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@example.com","password":"admin123"}'

获取条目列表 (带 Token)

curl -H "Authorization: Bearer <token>" \
  "http://localhost:18080/api/v1/projects/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb/units?page=1&pageSize=50"

上传 JSON 导入任务

curl -X POST http://localhost:18080/api/v1/projects/bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb/imports \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d @example-import.json