dayuse-commands（日用命令）

Dayuse App Commands

Overview

All local development commands for the Dayuse.com project use Python Invoke (prefixed with inv) and must be run through pipenv from the current working directory.

Prerequisites

• Docker Desktop running
• pipenv installed (pip install pipenv)

Critical Rules

1. Always prefix commands with pipenv run to ensure the correct Python environment: pipenv run inv <command>
2. Docker containers must be running for most commands. If unsure, run pipenv run inv up first.
3. Never run inv directly without pipenv run — it may use the wrong Python/invoke version.

Quick Reference

Infrastructure

Start & Stop

# Full setup: build + start + install deps + migrate DB
pipenv run inv start

# Build Docker images + start containers (no install/migrate)
pipenv run inv up

# Build Docker images only
pipenv run inv build

# Stop all containers
pipenv run inv stop

# Destroy everything (containers, volumes, networks) — DESTRUCTIVE
pipenv run inv destroy

Monitoring

# List container status
pipenv run inv ps

# Show container logs
pipenv run inv logs

# Open bash shell in builder container
pipenv run inv builder

Workers (RabbitMQ consumers)

# Start worker containers
pipenv run inv start-workers

# Stop worker containers
pipenv run inv stop-workers

PHP Backend Testing

# Full test suite (creates test DB + fixtures + PHPUnit)
pipenv run inv tests

# Run PHPUnit only (assumes test DB already exists)
pipenv run inv phpunit

# Run specific test(s) by filter
pipenv run inv phpunit --filter-tests=MyTestClass
pipenv run inv phpunit --filter-tests=testMethodName

# Run with code coverage
pipenv run inv phpunit --coverage

# Create/reset test database with fixtures
pipenv run inv create-test-env

# Import specific fixtures
pipenv run inv import-fixtures

PHP Code Quality

# PHPStan static analysis (level 10)
pipenv run inv phpstan

# PHP-CS-Fixer — auto-fix code style
pipenv run inv cs-fix

# PHP-CS-Fixer — check only (dry-run, used in CI)
pipenv run inv cs-fix --dry-run

# PHP syntax + YAML + Twig linting
pipenv run inv lint

# Validate Doctrine schema against entities
pipenv run inv schema-validate

Frontend (Next.js / React)

Web

# Jest tests
pipenv run inv front-web-test

# ESLint
pipenv run inv front-web-lint

# TypeScript type check
pipenv run inv front-web-type

# Prettier formatting check
pipenv run inv front-web-prettier

# Unit tests (alternative)
pipenv run inv tests-unit-front

# Reset frontend API cache
pipenv run inv reset-frontend-api

Mobile App

# Unit tests
pipenv run inv test-app

# ESLint
pipenv run inv lint-app

# TypeScript compliance
pipenv run inv typing-app

# Format check
pipenv run inv format-app

# Check XCode plist files
pipenv run inv check-plist

Database

# Run pending migrations
pipenv run inv migrate

# Generate a new migration
pipenv run inv make-migration

# Load a SQL dump into dayuse_dev
pipenv run inv mysql-load-dump

# Snapshot current MySQL volume (for fast restore later)
pipenv run inv volume-mysql-snapshot

# Restore MySQL volume from snapshot
pipenv run inv volume-mysql-snapshot-restore

Elasticsearch

# Rebuild hotel index (full)
pipenv run inv es-build-hotel

# Rebuild hotel index for specific country
pipenv run inv es-build-hotel --country=FR

# Rebuild POI index
pipenv run inv es-build-poi

# Rebuild billing index
pipenv run inv es-build-billing

# Rebuild order index
pipenv run inv es-build-order

# Setup ES snapshot
pipenv run inv es-setup-snapshot

# Reset ES snapshot
pipenv run inv es-reset-snapshot

# Restore hotel index from snapshot
pipenv run inv es-restore-hotel-snapshot

# Restore POI index from snapshot
pipenv run inv es-restore-poi-snapshot

Translations

# Download translations from Loco (frontend + backend)
pipenv run inv loco-download

# Download translations, commit, and push (for releases)
pipenv run inv finalize-release

Other Utilities

# Clear Symfony cache
pipenv run inv cache-clear

# Clear dev.log
pipenv run inv log-clear

# Install all dependencies (composer + yarn)
pipenv run inv install

# Install composer dependencies only
pipenv run inv composer-install

# Generate SSL certificates
pipenv run inv generate-certificates

# Display help with local URLs
pipenv run inv help

CI Pipeline Commands

When running in CI mode, first set the CI flag:

pipenv run inv ci

CI runs these checks (all must pass):

1. pipenv run inv phpunit — PHP unit tests
2. pipenv run inv phpstan — Static analysis
3. pipenv run inv cs-fix --dry-run — Code style check
4. pipenv run inv lint — Syntax linting
5. pipenv run inv schema-validate — Doctrine schema
6. pipenv run inv front-web-lint — Frontend ESLint
7. pipenv run inv front-web-type — Frontend TypeScript
8. pipenv run inv front-web-prettier — Frontend formatting

Local Development URLs

Once containers are running (pipenv run inv up):

Troubleshooting

Containers not starting

Symptoms: inv up fails or containers crash Solution:

pipenv run inv destroy
pipenv run inv start

Test DB out of date

Symptoms: PHPUnit fails with schema errors Solution:

pipenv run inv create-test-env
pipenv run inv phpunit

pipenv not found or wrong Python

Symptoms: pipenv: command not found or import errors Solution:

pip install pipenv
pipenv install

Elasticsearch index empty or stale

Symptoms: Search returns no results Solution:

pipenv run inv es-build-hotel
pipenv run inv es-build-poi