PJS 字幕组语言资产检索平台。

sekai-platform 用于整理、检索和查看字幕组积累的语言资产。一期聚焦剧情原文、历史译文、翻译版本和行级搜索能力，让组员可以在同一平台中定位剧情、查看原文、检索既有译文，并按字幕组租户隔离管理译文资产。

平台当前以 Project SEKAI 剧情资产为主要对象。原文来自 Moe Sekai / Exmeaning 公共数据源，译文通过导入接口进入平台。原文作为全平台共享资产，译文和翻译版本按租户隔离。

同时为了维护便利性合并了SekaiText-Next的服务端数据，使用户账户可以统一化管理。

一期后端核心能力和部署交付已完成，前端已进入应用骨架和登录闭环阶段。

gantt
    title 一期后端项目进度（已完成）
    dateFormat  YYYY-MM-DD
    axisFormat  %m/%d

    section 后端已完成
    Phase 0 仓库基础           :done, p0, 2026-05-03, 1d
    Phase 1 共享约定           :done, p1, 2026-05-03, 1d
    Phase 2 数据库             :done, p2, 2026-05-04, 1d
    Phase 3 鉴权和租户         :done, p3, 2026-05-04, 1d
    Phase 4 外部数据源同步     :done, p4, 2026-05-04, 1d
    Phase 5 搜索索引           :done, p5, 2026-05-05, 1d
    Phase 6 搜索 API           :done, p6, 2026-05-05, 1d
    Phase 7 历史译文批量导入   :done, p7, 2026-05-05, 1d
    Phase 8 剧情详情           :done, p8, 2026-05-05, 1d
    后端部署交付              :done, deploy, after p8, 1d

前端当前已完成项目初始化、应用骨架、登录与租户上下文，后续继续接入搜索、资产阅读、导入和管理能力。

gantt
    title 一期前端项目进度
    dateFormat  YYYY-MM-DD
    axisFormat  %m/%d

    section 前端
    项目初始化                 :done, web0, 2026-05-07, 1d
    应用骨架和登录闭环         :done, web1, 2026-05-07, 1d
    搜索和资产只读主路径       :active, web2, after web1, 2d
    导入和租户管理             :web3, after web2, 1d
    同步运维和联调部署         :web4, after web3, 1d

• 原文同步：从 Moe Sekai / Exmeaning 同步活动剧情、主线剧情、卡面剧情、区域对话和特殊剧情原文。
• 历史译文导入：导入字幕组既有 JSON 译文资产，并保留翻译版本和署名信息。
• 统一搜索：检索全平台共享原文和译文，结果定位到剧情、章节和具体行。
• 剧情详情：查看剧情、原文行、翻译版本和译文行。
• 规划中的开放 API：通过独立 OpenApiService 提供开放 API 监听端口，当前暂不开放业务接口。
• 后端部署：提供 Docker Compose 本地环境、服务器 Compose 部署和 GitHub Actions 构建部署入口。

一期采用 ASP.NET Core 微服务架构，使用 Docker Compose 组织本地和服务器运行环境。

本地依赖：

• .NET SDK 10
• Docker Desktop 或兼容 Docker Compose v2 的运行环境
• 本地 .NET 工具通过 dotnet tool restore 安装

复制本地配置样例：

cp .env.example .env

生成本地内部服务 token 密钥：

scripts/generate-internal-auth-keys.sh >> .env

启动基础设施和服务容器：

docker compose up --build

API Service 健康检查：

curl http://localhost:8080/health

运行部署冒烟测试：

SMOKE_PASSWORD=your-local-login-password scripts/deployment-smoke.sh

运行抢活专项冒烟测试：

SMOKE_PASSWORD=your-local-login-password scripts/claiming-smoke.sh
CLAIM_SMOKE_RUN_CLAIMS=1 SMOKE_PASSWORD=your-local-login-password scripts/claiming-smoke.sh

常用工程命令：

dotnet build SekaiPlatform.sln
dotnet test tests/integration-tests/SekaiPlatform.IntegrationTests.csproj

• 平台业务 API 文档维护在 Apifox 项目 8210187，文档站：https://sekai-platform.apifox.cn/。
• 开放 API 文档维护在 Apifox 项目 8216122。
• 总体设计
• 接口草案
• 开放 API 草案
• 数据模型
• 外部数据源
• 安全模型
• 一期后端交付状态
• Docker Compose 与 GitHub Actions 部署说明

• 当前仓库不维护本地 OpenAPI 源文件，正式 API 文档以 Apifox 为准。
• 涉及架构、数据模型、接口或关键业务流程的改动，先查看 docs/design/ 下的相关设计文档。
• 涉及后端交付状态和剩余部署事项的改动，先查看 docs/plan/。