docs: add configuration section and reorder README

- Move configuration section before usage
- Document multi-profile config.toml structure
- Clarify that config and remote providers are planned (not yet implemented)
- Add config multi-profile and remote providers to status table
- Add usage argument table

Author: madkoding

README.md

@@ -24,6 +24,8 @@ Git Reports es una herramienta construida en Rust que analiza repositorios Git y
 | Análisis de commits | ✅ |
 | Métricas de contribuidores | ✅ |
 | Exportación de reportes | 🚧 WIP |
+| Configuración multi-perfil (config.toml) | ⏳ Planificado |
+| Soporte providers remotos (GitHub/GitLab/Bitbucket) | ⏳ Planificado |
 | Visualización web | ⏳ Planificado |
 
 ## 🚀 Inicio Rápido
@@ -41,12 +43,80 @@ cd git-reports
 cargo build --release
 ```
 
-### Uso
+## ⚙️ Configuración
+
+> **Estado**: ⏳ Planificado — aún no implementado. El diseño de la configuración está definido en [config.toml.example](config.toml.example) como referencia para la implementación futura.
+
+Git Reports trabajará con perfiles: cada uno agrupa un email, un token y una lista de repositorios remotos. Esto permite manejar varias empresas, providers y cuentas desde un único archivo.
+
+### Archivo de configuración
+
+```bash
+cp config.toml.example config.toml
+```
+
+Estructura de `config.toml`:
+
+```toml
+[[profile]]
+name    = "trabajo"
+email   = "yo@empresa.com"
+token   = "ghp_xxxxxxxxxxxxxxxxxxxx"   # Personal Access Token del provider
+
+  [[profile.repo]]
+  provider = "github"     # github | gitlab | bitbucket
+  owner    = "mi-empresa"
+  name     = "mi-repo"
+```
+
+### Múltiples empresas, correos y tokens
+
+Cada `[[profile]]` es una identidad independiente. Puedes tener tantos como necesites:
+
+| Situación | Solución |
+|---|---|
+| Varias empresas | Un perfil por empresa, cada uno con su email y token |
+| Mismo correo en GitHub y Bitbucket | Un perfil por provider, con su propio token |
+| Freelance + trabajo + personal | Un perfil por contexto |
+
+```toml
+[[profile]]
+name  = "empresa-a"
+email = "yo@empresa-a.com"
+token = "ghp_..."          # GitHub PAT de empresa-a
+  [[profile.repo]]
+  provider = "github"
+  owner = "empresa-a"
+  name  = "backend-api"
+
+[[profile]]
+name  = "empresa-b"
+email = "yo@empresa-b.com"
+token = "glpat-..."        # GitLab PAT de empresa-b
+  [[profile.repo]]
+  provider = "gitlab"
+  owner = "empresa-b"
+  name  = "infra-scripts"
+```
+
+Ver [config.toml.example](config.toml.example) para un ejemplo completo con todos los casos.
+
+> ⚠️ Agrega `config.toml` a tu `.gitignore` para no exponer tokens.
+
+## 🖥️ Uso
+
+> **Estado actual**: solo analiza repositorios locales ya clonados.
 
 ```bash
 cargo run --release -- --repo /path/to/repo --output report.json
 ```
 
+| Argumento | Descripción | Default |
+|---|---|---|
+| `--repo` | Ruta local al repositorio | `.` |
+| `--output` | Archivo JSON de salida | — |
+| `--period` | Periodo: `week`, `month`, `all` | `week` |
+
 ## 🛠️ Stack Tecnológico
 
 - **Lenguaje**: Rust