Navigation
About
Contribute
Follow
others

Loony and a rope

From Self Shelf Swap Community Wiki
Jump to: navigation, search

Il n'y a pas beaucoup de sens à améliorer Dime And A Shoestring, sauf à vouloir sortir un truc très rapidement. Pourtant finalement on fait une rapide version 0.02, Loony And A Rope, histoire d'avoir un truc un peu plus présentable avant la tant attendue V0.03.

La majeure différence avec Dime And A Shoestring est de pouvoir gérer plusieurs bibliothèques à la fois. Nous corrigeons les bugs constatés dans la première version, réalisons des tests intensifs.

Contents

Fonctionnalités nouvelles

Technique ou fonctionnelles

Voir aussi le Surf Meeting_07-09-2011

V.0.02

  • Gérer plusieurs bibliotheques
  • introduction de la notion d'utilisateur

V.0.03

  • application web avec Framework à définir
  • roles
    • user
    • librarian
      • ex. -> activer le reload mode
    • admin
  • mise à jour des listes à la demande, formulaire de saisie par les bibliothecaires des identifiants de leurs listes (beta)
  • JSON Tool, ou autre outil qui pourrait être écrit par MystPerl : Seb doit formaliser le Blueprint d'un outil qui pourrait être développer par un autre que lui...
  • Avoir une page listant les différentes bibliotheques et pointant vers les micro-libraries
  • Tri des bibliotheques par lieu géographiques (V0.4 ?)

Documentation

Un gros travail de documentation sur la V0.01 a été fait. This documentation is directly included into the Perl modules. Download it, install Perl on your computer (if you are a GNU/Linux or OS X user, it is already installed) and do this :

$ cd [to-the-place-where-you-download-the-stuff]
$ cd lib/
$ perldoc microlibrary.pl


It will display a very user-friendly man-style documentation :

MICROLIBRARY(1)                                  User Contributed Perl Documentation                                 MICROLIBRARY(1)
 
 
 
NAME The Microlibrary Kernel
DESCRIPTION
       This script runs a web-service thru the Open Library (OL) API, stores data send by the web-service into files and generate
       XHTML to display data in a very simple page.  The microlibraryis made to manage everithing to generate a book-shelf pages,
       using your data from Open Library. For more informations an How To, please see http://goo.gl/k375R
 
   The Self Shelf Swap Project
       This first implementation is a physical object (books) swaping/sharing system.  Our Library project is to create an online
       index which could make (in next version) possible to :
 
       Inform
           retrieve informations about registered documents
 
       Locate
           know where documents are physically based and if you can loan it )
 
       Create
           register an account & create your own Library DataBase
 
       Share
           share it with other users.
 
       Our desire is to provide a private Libraries Network in an IRL spirit, a Library of Libraries ("meta-libraries"), physically
       based (shelfs).  We don't want to provide downloadable documents.
 
       That's why our project is named "Self Shelf Swap". It's first implementation will be Bibliothek.
 
   How does-it do the job ?
       The lists
           List are considered like thematic shelfes of your library.  First the microlibrary kernel calls the Properties Reader,
           that will parse our open_library_lists file, and return an array if list ids. This array is passed as an argument to the
           build_the_list_request() subroutine of the Curl Requester, that will build and get the list requests. For each list id,
           we get a RDF flux containing books URI. Flux are stored into your hard drive by passing the RDF flux, the list id and the
           "list" flag (to specify that we manage lists) to the store_RDF_flux() of the RDF Tool.
 
       The books
           Next, for each list, we load the file on disk thru the parse_RDF_file() subroutine, passing the list id as an argument.
           We get many data thru the get_list_element() subroutine of RDFTool, that will get all books data. For more information
           about this part, see the RDFTool documentation.
 
       The View
           The Web Displayer is scattered everywhere and will be remplaced soon by a more decent system (AKA MVC). See you soon.
 
   HOW TO SET UP YOUR MICROLIBRARY
       INTERACT WITH OPEN LIBRARY AND GENERATE YOUR DATABASE
 
       To deploy and install your microlibrary, you need a GNU/Linux environment or any Perl friendly system. Dime and a shoestring
       has been only tested on Debian or Ubuntu.  Feel free to test it on other platforms and give us feedback...
 
       Install every dependencies. You can follow the DEPENDENCIES section of this documentation and test it by running the
       microlibrary.pl script. To run this script, just open a terminal, go to the dime_and_a_shoestring. Fix the $ENV{HOME}
...
  • Comment installer le projet avec Bazaar
  • Comment récupérer les modules
  • Comment déployer l'application

Introduction d'une base de données (V0.03)

Nous avons travaillé avec Christophe sur le Modele Conceptuel et le Modele Physique des Données (méthode Merise) de l'application. Les entités génériques sont définies, nous devons maintenant travailler sur les entitées "métier" ("business" in English). Voir la page spéciale concernant la base de données.

Choix d'un Framework

Nous en profitons pour tester quelques frameworks pour la V0.03 :

  • Mojolicious, très à la mode et le plus up-to-date des bonnes pratiques du web
  • Jifty Fifty : a pony
  • Catalyst, le framework MVC: le plus utilisé en Perl, avec plus d'utilisateurs et de documentation (c'est un + non négligeable plutot que de taper dans la hype)

Spécifications des Ss amoureux

=> Ici mettez le mind Map Image:LAAR_plan_schema.jpg

Personal tools