Project
Pangu Terminal
A progression planner for Wuthering Waves. Community college capstone, finished in 2026.
What it does
Wuthering Waves makes you collect a lot of different materials to level up a character or a weapon. Pangu Terminal does the arithmetic.
- Plans. You choose a character or weapon and the level you want. The app adds up every material that upgrade costs.
- Inventory. You enter what you own. The app subtracts it and shows what is missing. If you have spare lower-tier materials, it counts what you could craft from them at three to one.
- Farming. For each missing material it estimates how many runs you need. The drop rates come from a community spreadsheet, not from official game data.
- Advice. It can send a plan's numbers to a language model and get back a short suggestion for what to farm first.
How it's built
- Rails 8.1 with Hotwire. Changing an inventory amount re-renders the affected rows with Turbo Streams. There is no page reload and no front-end framework.
- The game rules live in service objects, outside the controllers, so each rule can be tested on its own.
- PostgreSQL. Plan results are stored as JSONB. I wrote about the schema.
- A versioned REST API with seven endpoints. API keys are bearer tokens. Only a SHA-256 hash of each key is stored, so a key is shown once, when you create it. Each key is limited to 60 requests a minute.
- The capstone was deployed with Docker and Kamal 2 on a DigitalOcean droplet. I wrote about the deployment errors. The demo is hosted on Render now.
- Tests run in GitHub Actions on every pull request.
- The advice feature uses the RubyLLM gem.
Ruby on Rails 8.1HotwirePostgreSQLDockerKamal 2RubyLLMGitHub Actions
Links
The project is finished. I'm not adding features.