FitMop/GEMINI.md

Gemini Global Configuration (GEMINI.md)

This document provides a set of global instructions and principles for the Gemini CLI to follow during our interactions.

Reference:

• Project Architecture: ALWAYS refer to this document for the technical layout and data flows of the system.

Environment Management

• Startup Rule: ALWAYS start the application using make run. NEVER try to start individual services manually or use the old fitmop.sh.
• Shutdown: Use Ctrl+C to stop the services.

Code Quality & Standards

1. Verification & Quality Gates

Strict Rule: ALWAYS run make check before marking a task as complete. This command performs:

• Linting & Formatting: (Ruff, ESLint, Prettier)
• Testing: Runs all unit tests.
• Coverage: Enforces 100% line coverage for both backend and frontend.

Action:

• If make check fails, the task is NOT DONE. Fix ALL errors, warnings, and coverage drops.
• DO NOT rely on individual commands (like pytest or npm test) for final verification. make check is the single source of truth.
• New Code: Must have 100% test coverage and adhere to best practices.

2. Error Handling & Logging

• No Print Statements: Use logging in Python and console.error (with prefix) in Vue.
• Fail Fast: Let exceptions bubble up to the global handler in backend/src/main.py.
• Validation: Use Pydantic models for all API requests and responses.

3. Documentation

• Refer to CONTRIBUTING.md for detailed guidelines.
• Keep task.md and implementation_plan.md updated throughout the task.