MangaTrakr

Application web pour suivre la lecture des mangas. Suivre facilement sa progression pour une meilleure expérience de lecture.

Fonctionnalités

• Espace d'administration
• Inscription sur invitation
• Authentification avec login/mdp
• Gérer son compte utilisateur
• Rechercher un manga dans la base de données
• Rechercher un manga avec l'API
• Consulter le détail d'un manga
• Gérer son suivi depuis une scanthèque
• Calendrier de sortie de mangas
• Exporter sa scanthèque
• Authentification avec Google
• Traduction Anglais et Français
• Améliorer les fonctionnalités existantes
• Inscription ouvert

Pour commencer

Pré-requis

• PHP >= 8.1
• Composer v2
• NodeJS
• MariaDB

Installation

Éxécutez les commandes ci-dessous pour installer le projet.

• Avec Docker :

- make docker-compose-up
- App disponible sur localhost:8080 
- Utilisateur de démo :  demo@demo.fr / password

• Avec Symfony CLI + Commande make :

- make first-install ## Pour installer les dépendences
- make npm-build ## Pour compiler les assets
- symfony console app:init-datas ## Initialiser les données nécessaires en bdd

• Sinon :

- composer install 
- npm install --force
- npm run build
- php bin/console security:check
- php bin/console doctrine:database:create --if-not-exists
- php bin/console doctrine:database:migrate --no-interaction
- php bin/console app:init-datas ## Initialiser les données nécessaires en bdd

Démarrage

• Avec Symfony CLI + Commande make :

- make sf-start 

• Sinon :

- php bin/console server:start -d

Stack technique

• Symfony 6.4 - Framework PHP
• Doctrine ORM
• Twig
• MariaDB
• doctrine/doctrine-fixtures-bundle
• symfony/webpack-encore-bundle - Module Bundler
• knpuniversity/oauth2-client-bundle - OAuth2 client
• fakerphp/faker - Librairie PHP
• easycorp/easyadmin-bundle - Générateur d'administrateur pour Symfony
• knplabs/knp-paginator-bundle - Bundle de pagination
• phpoffice/phpspreadsheet - Librairie PHP (Xls, Csv, Pdf, etc.)
• symfony/stimulus-bundle - Framework Javascript
• stimulus-use - Collection de composants Stimulus
• symfony/ux-twig-component
• HtmX - Framework Front-end
• Flowbite - Librairie de composants UI
• Tailwindcss - Framework CSS

Outils QA & Tests utilisés

• friendsofphp/php-cs-fixer - PHP Coding Standards Fixer
• phpstan/phpstan - PHP Static Analysis Tool
• nunomaduro/phpinsights - Static Analysis Tool
• phpro/grumphp -
• symfony/test-pack - PHP Unit

Commandes consoles

• Pour générer un utilisateur :
  • php bin/console app:create-user
• Pour tester l'envoi d'un email avec la config SMTP :
  • php bin/console app:test-email emailFrom emailTo
• Pour initialiser les données fictive:
  • php bin/console doctrine:fixtures:load

Ressources externes utilisées

• API REST :
  • Jikan API 4.0.0
  • MangaUpdates API 1.0.0
• Illustrations : Transhumans
• Avatars : UI Faces
• Google Fonts :
  • Bangers
  • Sora