# VIIZIA

Application de **consolidation financière multi-comptes et multi-utilisateurs**. Imports de relevés bancaires (PDF, CSV), vue unifiée des flux, collaboration en équipe (5 rôles : SUPERADMIN, ADMIN, MANAGER, USER, PARTENAIRE).

## Documentation

Toute la documentation projet est dans [`docs/`](docs/) :
- [Vision produit](docs/specifications/00-vision.md)
- [Architecture technique](docs/specifications/01-architecture-technique.md)
- [Modèle de données](docs/specifications/02-modele-donnees.md)
- [Rôles et permissions](docs/specifications/03-roles-permissions.md)
- [Import PDF / CSV](docs/specifications/04-import-donnees.md)
- [Interfaces MVP](docs/specifications/05-interfaces-mvp.md)

Conventions à respecter : [`docs/guidelines/`](docs/guidelines/).

## Stack

- **PHP 8.3** + **Symfony 7**
- **MySQL 8**
- **Bulma 1** (CSS) + **Font Awesome 6** (icônes), via CDN
- **Docker Compose** pour le dev local

## Démarrage rapide

### Pré-requis

- **Docker Desktop** (ou Docker Engine + Compose v2).
- Aucun PHP / Composer / Node nécessaire en local : tout passe par les containers.

### Premier démarrage

```bash
# 1. Cloner le repo
git clone https://neoloop-admin@bitbucket.org/neoloop/viizia.git
cd viizia

# 2. Préparer l'env local (déjà fourni en valeurs de dev)
cp .env.docker.example .env.local

# 3. Construire et lancer la stack
docker compose up -d --build

# 4. Installer les dépendances PHP dans le container
docker compose exec viizia-php composer install
```

L'application est disponible sur **http://localhost:8180**.

### Services exposés

| Service | URL | Notes |
|---|---|---|
| Application | http://localhost:8180 | nginx + PHP-FPM |
| phpMyAdmin | http://localhost:8182 | identifiants : `root` / `rootpw` |
| MailHog (UI) | http://localhost:8184 | mails de dev capturés |
| MySQL (client externe) | `127.0.0.1:8181` | identifiants : `viizia` / `viizia` |

> Plage de ports VIIZIA : **8180-8199** (cf. [`docs/guidelines/docker-conventions.md`](docs/guidelines/docker-conventions.md)).

## Commandes utiles

```bash
# Logs
docker compose logs -f viizia-php
docker compose logs -f viizia-nginx

# Console Symfony
docker compose exec viizia-php bin/console cache:clear
docker compose exec viizia-php bin/console debug:router
docker compose exec viizia-php bin/console list

# Composer
docker compose exec viizia-php composer require <package>

# Shell dans le container PHP
docker compose exec viizia-php sh

# Arrêter la stack
docker compose down

# Reset complet (efface la BDD !)
docker compose down -v
```

## Workflow Git

GitFlow allégé : branches `master` (prod), `develop` (intégration), `feature/*`, `fix/*`, `hotfix/*`, `chore/*`. Conventional commits.

Procédure complète et auth Bitbucket : [`docs/guidelines/git-workflow.md`](docs/guidelines/git-workflow.md).

## Licence

Propriétaire — Neoloop. Tous droits réservés.