# Pastas de usuários por nome

## Alteração realizada

Cada usuário passa a possuir um identificador físico persistente no campo `users.storage_folder`.
O valor é criado a partir do nome do usuário, normalizado para uso seguro no sistema de arquivos.

Exemplo:

- Nome: `José Cláudio Dias`
- Pasta: `jose-claudio-dias`

Em caso de nomes repetidos, o sistema utiliza sufixos (`jose-claudio-dias-2`, por exemplo).
A alteração posterior do nome cadastral não renomeia a pasta, evitando perda de referências.

## Estrutura criada automaticamente

Ao criar um usuário:

- `files/{nome-do-usuario}`
- `thumbnails/{nome-do-usuario}`
- `versions/{nome-do-usuario}`

Uploads, miniaturas e novas versões passam a utilizar esse identificador.

## Atualização de uma instalação existente

Execute na raiz do projeto:

```bash
php database/migrate_user_named_folders.php
```

O script:

1. adiciona `storage_folder` à tabela `users`;
2. atribui uma pasta nominal exclusiva a cada usuário existente;
3. cria as pastas físicas necessárias;
4. não move nem apaga arquivos antigos.

Os arquivos antigos permanecem acessíveis porque seus caminhos continuam registrados em `drive_items.stored_name` e `file_versions.stored_name`. Novos uploads passam a ser gravados na pasta nominal.