How ivaqis/arknights-tracker works
Goyfield.moe is an Arknights: Endfield pull tracker and game-data reference. The main user workflow is to track or import pulls, then view pull-derived statistics; the README documents browser-local pull retention and frontend requests to the backend during imports. The frontend also models game data, crafting/buildings, and events. The backend provides API and persistence capabilities, but the sampled sources expose only application setup and a generic controller, so most endpoint-level connections are omitted rather than inferred.
Main entry points: api API clients · gameData Game data models · PullParser.ts Pull processing · Controller.ts API controllers
Components 22
Pull tracking
- Pull processing
arknights-tracker/src/lib/classes/pulls/PullParser.ts - Pull statistics
arknights-tracker/src/lib/classes/pulls/PullStatsCalculator.ts - Pull merging
arknights-tracker/src/lib/classes/pulls/PullMerger.ts
API services
- API clients
arknights-tracker/src/lib/api - Pull import
arknights-tracker/src/lib/api/import - Pull sync
arknights-tracker/src/lib/api/syncPulls - Global banner stats
arknights-tracker/src/lib/api/globalBannerStats - Profile lookup
arknights-tracker/src/lib/api/getProfileId
Game data
- Game data models
arknights-tracker/src/lib/classes/gameData - Item catalog
arknights-tracker/src/lib/classes/storages/items/ItemStorage.ts - Mining buildings
arknights-tracker/src/lib/classes/storages/buildings/MinerStorage.ts - Vaporizer buildings
arknights-tracker/src/lib/classes/storages/buildings/VaporizerStorage.ts - Crafting recipes
arknights-tracker/src/lib/classes/searchers/recipes - Game events
arknights-tracker/src/lib/classes/storages/events/GameEventStorage.ts
Backend services
- HTTP application
goyfield-backend/src/App.ts - API controllers
goyfield-backend/src/api/controllers/Controller.ts - Postgres data
goyfield-backend/src/database - Image moderation
goyfield-backend/src/services/sightengineNsfwValidator/SightengineNsfwValidator.ts
External services
- Browser local storage
- PostgreSQL
- Sightengine
Other components
- Tracker user
Connections 17
- Tracker user → Pull processing: tracks pulls
README.md - Pull processing → Pull statistics: calculates stats
- Pull processing → Pull merging: merges pulls
- Tracker user → API clients: imports pulls
README.md - API clients → Pull import: uses import endpoints
- API clients → Pull sync: uses sync endpoints
- API clients → Global banner stats: requests statistics
- API clients → Profile lookup: looks up profile
- Tracker user → Browser local storage: retains pulls
README.md - HTTP application → API controllers: routes requests
goyfield-backend/src/App.ts - API controllers → Postgres data: handles API data
- Postgres data → PostgreSQL: persists data
README.md - Image moderation → Sightengine: checks images
goyfield-backend/src/services/sightengineNsfwValidator/SightengineNsfwValidator.ts - Item catalog → Game data models: builds item models
arknights-tracker/src/lib/classes/storages/items/ItemStorage.ts - Mining buildings → Game data models: constructs miners
arknights-tracker/src/lib/classes/storages/buildings/MinerStorage.ts - Game events → Game data models: stores event models
- Crafting recipes → Game data models: uses recipe data