# Coltura

CRM/ERP — Symfony 8 (API Platform 4) + Nuxt 4

## Stack

- **Backend** : PHP 8.4, Symfony 8, API Platform 4, Doctrine ORM, PostgreSQL 16
- **Frontend** : Nuxt 4 (SPA), Vue 3, Pinia, Tailwind CSS, @malio/layer-ui
- **Auth** : JWT HTTP-only cookie (Lexik)
- **Infra** : Docker Compose (dev + prod multi-stage)
- **CI/CD** : Gitea Actions (auto-tag + build Docker)

## Quick Start

```bash
make start           # Demarrer les containers Docker
make install         # Composer, migrations, fixtures, build Nuxt
```

Dev frontend (hot reload) :

```bash
make dev-nuxt        # Port 3003
```

## Ports

| Service    | Port |
|------------|------|
| API (Nginx)| 8083 |
| Frontend   | 3003 |
| PostgreSQL | 5436 |

## Commandes

| Commande | Description |
|----------|-------------|
| `make start` | Demarrer les containers |
| `make stop` | Arreter les containers |
| `make restart` | Redemarrer les containers |
| `make install` | Install complet |
| `make reset` | Tout supprimer et reinstaller |
| `make dev-nuxt` | Serveur dev Nuxt (hot reload) |
| `make shell` | Shell dans le container PHP |
| `make cache-clear` | Vider le cache Symfony |
| `make migration-migrate` | Lancer les migrations |
| `make fixtures` | Charger les fixtures |
| `make db-reset` | Reset BDD + migrations + fixtures |
| `make test` | PHPUnit |
| `make php-cs-fixer-allow-risky` | Fix code style PHP |
| `make logs-dev` | Tail logs Symfony |

## Structure

```
src/                 # Backend Symfony
  Entity/            # Entites Doctrine
  ApiResource/       # Ressources API Platform
  State/             # Providers & Processors
  Repository/        # Repositories Doctrine
  DataFixtures/      # Fixtures
config/              # Config Symfony
migrations/          # Migrations Doctrine
frontend/            # App Nuxt 4
  pages/             # Pages Vue
  layouts/           # Layouts
  components/        # Composants
  composables/       # Composables (useApi, useAppVersion)
  stores/            # Stores Pinia (auth, ui)
  services/          # Services API + DTOs
  i18n/              # Traductions
infra/
  dev/               # Docker dev (Dockerfile, nginx, php.ini, xdebug)
  prod/              # Docker prod (multi-stage, nginx, php-prod.ini)
.gitea/workflows/    # CI Gitea (auto-tag, build Docker)
```

## CI/CD

- **Auto Tag** : push sur `develop` → bump `config/version.yaml` → tag `vX.Y.Z`
- **Build Docker** : push tag `v*` → build image multi-stage → push Gitea Registry

Secrets requis dans Gitea :
- `RELEASE_TOKEN` — PAT avec droits `write:repository`
- `REGISTRY_TOKEN` — token pour le registry Docker

## Credentials (dev)

| Username | Password | Role |
|----------|----------|------|
| admin | admin | ROLE_ADMIN |
| alice | alice | ROLE_USER |
| bob | bob | ROLE_USER |

## Conventions

### Commits

```
<type>(<scope optionnel>) : <message>
```

Types : `build`, `chore`, `ci`, `docs`, `feat`, `fix`, `perf`, `refactor`, `revert`, `style`, `test`