Property Stat

À propos de Property-Stat

Property-Stat est une application Web (point de terminaison API) développée dans Laravel pour gérer le calcul des min, max et médianes sur des attributs définis arbitrairement (analyses) sur une base de données de propriétés immobilières.

Comment installer

Après avoir cloné le dépôt et changé le répertoire en root :

cadre:

Exécutez la commande suivante sur la console :

installation du compositeur

###base de données :

1- Créer une base de données Mysql vide

2- Assurez-vous que les informations d'identification de la base de données et le nom de la base de données sont correctement définis dans le fichier .env

3- Pour remplir les schémas exécutés :

php artisan migrer

4- Pour remplir quelques exemples de données, exécutez des scripts SQL :

./database/sample-data/archistar_db_properties.sql

./database/sample-data/archistar_db_analytic_types.sql

./database/sample-data/archistar_db_property_analytics.sql

Comment courir

Exécutez un serveur Web php tel que :

php -S localhost:8000 -t public

Pour tester la fumée, ouvrez votre navigateur et dans la barre d'adresse du navigateur, exécutez :

http://localhost:8000

Et cliquez sur la liste fournie sur la page d'accueil pour lancer un exemple de demande d'obtention de point final d'API (remarque : pour des raisons de simplicité, l'authentification n'est pas implémentée)

Comment tester

1- pour l'exécution des tests de vérification visuelle en ligne de commande

Exemple de calcul de statistiques au niveau national :

php artisan DB:Q "{'action' : 'statistiques', 'région' : 'AU'}"

Au niveau de l'État :

php artisan DB:Q "{'action' : 'statistiques', 'région' : 'AU,NSW'}"

Au niveau de la banlieue :

php artisan DB:Q "{'action' : 'statistiques', 'région' : 'AU,NSW,Ingleburn'}"

2- Pour les tests phpunit, exécutez simplement :

test de compositeur

(Assurez-vous d'abord que le répertoire de base de phpunit est correct dans composer.json)

Commandes utilitaires

• listant toutes les propriétés existantes:

php artisan DB:Q "{'action' : 'liste', 'sujet' : 'Propriété'}"

• listant tous les types d'analyses existants

php artisan DB:Q "{'action' : 'liste', 'sujet' : 'AnalyticType'}"

• listant toutes les valeurs analytiques des propriétés

php artisan DB:Q "{'action' : 'liste', 'sujet' : 'PropertyAnalytic'}"

• mettre à jour (ou ajouter) une valeur analytique pour une propriété (exemple)

php artisan DB:Q "{'action' : 'mise à jour', 'sujet' : 'PropertyAnalytic', 'prop_guid' : '1', 'analytic_name' : 'Prix', 'valeur' ​​: 650000}"

Exemples de points de terminaison d'API

• calculer des statistiques sur un pays, un état ou une banlieue :

http://localhost:8000/api/v1/stats/Au

http://localhost:8000/api/v1/stats/Au,NSW

http://localhost:8000/api/v1/stats/Au,NSW,Ingleburn

• ajoutermettre à jour une propriété

http://localhost:8000/api/v1/update/property?guid=10&country=UK&state=Oxford&suburb=Burmingham

• ajouter/mettre à jour un AnalyticType

http://localhost:8000/api/v1/update/analytic_type?name=land_tax&units=AUD&is_numeric=1&num_decimal_places=2

• attribuer/mettre à jour une valeur AnalyticType existante à une propriété

http://localhost:8000/api/v1/update/property_analytic?prop_guid=10&analytic_name=Price&value=850000

Licence

Property-Stat est sous licence MIT. la réutilisation/fork de code convient pour faire référence au nom de l'auteur dans vos projets.

Auteur : Maziar Navabi 15/06/2020