ToramCalculator 是一个为 Toram Online 游戏开发的辅助工具。通过模拟战斗过程，帮助玩家找到最优的配置方案。
- 🎮 队伍配置优化
- ⚔️ 战斗过程模拟
- 📊 逐帧数据分析
- 📈 数据可视化展示
- 🔗 配置分享功能
- 📚 内置游戏 Wiki 库
- 技术栈: SolidJS, Tailwind CSS, Babylon.js, Editor.js, TanStack
- 职责: 用户界面展示、交互处理、动画效果
- 技术栈: XState
- 职责: 核心业务逻辑、状态管理、模拟器计算
- 技术栈: pgLite, kysely, ElectricSQL, PostgreSQL, zod
- 职责: 数据访问、存储管理、数据同步、数据验证
- 技术栈: cuid2, jose, js-cookie
- 职责: ID 生成、JWT 处理、Cookie 管理、Web Workers、WASM
.
├── .husky/ # Git hooks 配置
├── backend/ # 后端服务配置
├── db/ # 数据库相关
│ ├── clientDB/ # 客户端数据库文件
│ └── serverDB/ # 服务端数据库文件
├── public/ # 静态资源
├── src/ # 应用逻辑源代码
│ ├── components/ # 页面组件
│ ├── lib/ # 工具函数库
│ ├── locales/ # 国际化文件
│ ├── repositories/ # 数据库交互方法
│ ├── routes/ # 应用路由
│ ├── styles/ # 样式文件
│ └── worker/ # 工作线程
└── test/ # 测试文件
提交信息格式：type(scope): subject
| 类型 | 说明 |
|---|---|
| ✨ feat | 新增功能 |
| 🐛 fix | bug 修复 |
| 📝 docs | 文档更新 |
| 💄 style | 代码格式修改（不影响逻辑） |
| 🔨 refactor | 代码重构 |
| ⚡️ perf | 性能优化 |
| ✅ test | 测试相关 |
| 📦 build | 构建系统修改 |
| 🔧 ci | CI 配置修改 |
| 🎫 chore | 其他修改 |
| ⏪ revert | 回滚提交 |
- 🐳 Docker
- 📦 Node.js >= 20
- 🔧 pnpm >= 9.15.2
首次开发或数据架构变更时，执行以下命令：
# 1. 安装依赖
pnpm install
# 2. 复制环境变量文件
cp .env.example .env
# 3. 执行完整初始化
pnpm dev:init这个命令会：
- 生成所有必要的数据库架构和类型定义
- 启动 PostgreSQL 数据库（自动执行初始化 SQL）
- 启动 Electric 同步服务
日常开发时，只需执行：
# 1. 设置开发环境（如果需要重置数据）
pnpm dev:setup
# 2. 启动开发服务器
pnpm dev项目使用两个数据库：
-
服务端数据库（PostgreSQL）
- 使用
db/baseSchema.prisma作为基础架构定义 - 通过 Docker 自动初始化
- 使用 Electric 进行数据同步
- 使用
-
客户端数据库（PGLite）
- 基于服务端架构生成
- 支持本地写入和数据同步
- 使用视图合并本地和同步数据
- 所有枚举类型定义在
db/enums.ts - 使用
generator.js将枚举注入到数据库架构 - 生成的类型定义在
db/dataEnums.ts
pnpm dev- 启动开发服务器pnpm dev:setup- 重置并启动开发环境pnpm dev:init- 初始化开发环境pnpm db:studio- 打开 Prisma Studio 查看数据库pnpm db:backup- 备份数据库pnpm db:restore- 恢复数据库备份
⚠️ 注意：每次修改db/baseSchema.prisma或db/enums.ts后，都需要重新执行pnpm dev:init。
- 构建应用：
pnpm package- 部署生成的
bundle.tar.gz