Commands Overview
This section provides comprehensive documentation for all artisan commands available in the FVN.li project.
Command Categories
Fix Commands
Data repair and maintenance commands for ensuring database consistency.
Command | Purpose | Key Options |
|---|---|---|
| Comprehensive character data fixes |
|
| Report platform support issues |
|
Feed Commands
Processing of the itch.io feed for automatic game discovery and updates.
Command | Purpose |
|---|---|
| Process itch.io feed for game updates |
Game Jam Commands
Management and enrichment of game jam information.
Command | Purpose | Key Options |
|---|---|---|
| Fetch additional details for game jams |
|
Games Commands
Comprehensive game data management, media processing, and information updates.
Command | Purpose | Key Options |
|---|---|---|
| Clean up old game version downloads |
|
| Import stats JSON for a game version |
|
| Process and optimize game screenshots |
|
| Process and optimize game thumbnails |
|
| Refresh game information from itch.io |
|
| Refresh feedless games | Various filtering options |
| Reimport version statistics | Version targeting options |
| Update games from watchlist | Collection management options |
Notification Commands
User notification processing and delivery system.
Command | Purpose | Key Options |
|---|---|---|
| Process pending browser push notifications |
|
| Queue notifications for game updates |
|
Rater Commands
User rating behavior management and moderation tools.
Command | Purpose | Key Options |
|---|---|---|
| Mark or unmark a rater as suspicious |
|
Ratings Commands
Import and management of game ratings data from itch.io.
Command | Purpose | Key Options |
|---|---|---|
| Backfill missing ratings by scanning events |
|
| Import latest ratings from itch.io | None (automatic import) |
Sitemap Commands
SEO optimization through XML sitemap generation.
Command | Purpose |
|---|---|
| Generate the sitemap.xml file |
General Usage Guidelines
Getting Help
Use php artisan COMMAND --help for detailed help on any specific command.
Common Patterns
Dry Run: Many commands support
--dry-runto preview changesTargeting: Most commands support
--game-id=IDfor specific gamesBatch Processing: Commands often include
--limitoptions for batch controlVerbose Output: Use
-vfor detailed execution information
Performance Considerations
Resource Usage: Media processing and bulk operations can be resource-intensive
API Limits: Commands that interact with itch.io respect rate limiting
Batch Sizes: Adjust batch sizes based on system resources and requirements
Scheduling: Many commands are designed for automated/scheduled execution
Error Handling
All commands include comprehensive error handling with retry logic for temporary failures and detailed logging for troubleshooting.
Data Flow Diagrams
Game Update Processing Flow
This diagram shows how game updates flow from itch.io through the system to user notifications:
Watchlist and Creator Discovery Flow
This diagram shows how new games are discovered through watchlists and creator following:
Game Data Processing Pipeline
This diagram shows the complete game data processing pipeline from import to analysis:
Ratings and Game Jam Data Flow
This diagram shows how ratings and game jam information are processed:
System Architecture Overview
This diagram shows the overall command architecture and how different command categories interact: