# Mandant CRM — Monorepo

## Layout
- `backend/` — Laravel 10 API + Filament admin
- `frontend/` — Nuxt 3 CSR SPA
- `docker/` — Docker Compose, nginx, PHP Dockerfile

## Dev commands (run from repo root)
```
make dev          # docker compose up -d
make stop         # docker compose down
make test         # composer test inside backend container
make lint         # composer static-analysis inside backend container
make migrate      # php artisan migrate
make fresh        # migrate:fresh --seed
make shell-php    # bash into backend container
make shell-node   # sh into frontend container
```

## Agent scope rules
- Backend feature → edit only `backend/`
- Frontend feature → edit only `frontend/`
- Auth / Docker / infra → root + both apps
- New module → follow scaffold in `.claude/skills/new-module.md`
- New history type → follow `.claude/skills/new-history-type.md`

## Commit style
feat/fix/chore/refactor/test/docs — conventional commits
Examples: `feat(client): add search endpoint`, `fix(history): soft delete cascade`