90 lines
2.9 KiB
Markdown
90 lines
2.9 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Project Overview
|
|
|
|
Dify is an open-source platform for developing LLM applications with an intuitive interface combining agentic AI workflows, RAG pipelines, agent capabilities, and model management.
|
|
|
|
The codebase consists of:
|
|
|
|
- **Backend API** (`/api`): Python Flask application with Domain-Driven Design architecture
|
|
- **Frontend Web** (`/web`): Next.js 15 application with TypeScript and React 19
|
|
- **Docker deployment** (`/docker`): Containerized deployment configurations
|
|
|
|
## Development Commands
|
|
|
|
### Backend (API)
|
|
|
|
All Python commands must be prefixed with `uv run --project api`:
|
|
|
|
```bash
|
|
# Start development servers
|
|
./dev/start-api # Start API server
|
|
./dev/start-worker # Start Celery worker
|
|
|
|
# Run tests
|
|
uv run --project api pytest # Run all tests
|
|
uv run --project api pytest tests/unit_tests/ # Unit tests only
|
|
uv run --project api pytest tests/integration_tests/ # Integration tests
|
|
|
|
# Code quality
|
|
./dev/reformat # Run all formatters and linters
|
|
uv run --project api ruff check --fix ./ # Fix linting issues
|
|
uv run --project api ruff format ./ # Format code
|
|
uv run --directory api basedpyright # Type checking
|
|
```
|
|
|
|
### Frontend (Web)
|
|
|
|
```bash
|
|
cd web
|
|
pnpm lint # Run ESLint
|
|
pnpm eslint-fix # Fix ESLint issues
|
|
pnpm test # Run Jest tests
|
|
```
|
|
|
|
## Testing Guidelines
|
|
|
|
### Backend Testing
|
|
|
|
- Use `pytest` for all backend tests
|
|
- Write tests first (TDD approach)
|
|
- Test structure: Arrange-Act-Assert
|
|
|
|
## Code Style Requirements
|
|
|
|
### Python
|
|
|
|
- Use type hints for all functions and class attributes
|
|
- No `Any` types unless absolutely necessary
|
|
- Implement special methods (`__repr__`, `__str__`) appropriately
|
|
|
|
### TypeScript/JavaScript
|
|
|
|
- Strict TypeScript configuration
|
|
- ESLint with Prettier integration
|
|
- Avoid `any` type
|
|
|
|
## Important Notes
|
|
|
|
- **Environment Variables**: Always use UV for Python commands: `uv run --project api <command>`
|
|
- **Comments**: Only write meaningful comments that explain "why", not "what"
|
|
- **File Creation**: Always prefer editing existing files over creating new ones
|
|
- **Documentation**: Don't create documentation files unless explicitly requested
|
|
- **Code Quality**: Always run `./dev/reformat` before committing backend changes
|
|
|
|
## Common Development Tasks
|
|
|
|
### Adding a New API Endpoint
|
|
|
|
1. Create controller in `/api/controllers/`
|
|
1. Add service logic in `/api/services/`
|
|
1. Update routes in controller's `__init__.py`
|
|
1. Write tests in `/api/tests/`
|
|
|
|
## Project-Specific Conventions
|
|
|
|
- All async tasks use Celery with Redis as broker
|
|
- **Internationalization**: Frontend supports multiple languages with English (`web/i18n/en-US/`) as the source. All user-facing text must use i18n keys, no hardcoded strings. Edit corresponding module files in `en-US/` directory for translations.
|