structure.md

Structure générale du mediakit
==============================

Les répertoires
---------------

files/
    Contient les fichiers des médias.

formats/
    Contient les vidéos en plusieurs formats ???

formats_srt/
    Contient les sous-titres liés aux formats ???

ftp/
    Répertoire scanné par le mediakit pour ajouter des médias.

skins/
    Répertoire contenant différentes skins css à utiliser pour videoJS.

srt/
    Contient des sous-titres

test/
    ???

tmp/
    Répertoire de travail pour les médias ???

tmp_srt/
    Répertoire de travail pour les sous-titres ???

video/
    Répertoire pour videoJS ???


Les fichiers
------------

index.php
    Présente un formulaire pour filtrer les médias, puis la liste des médias trouvés.
    Présente aussi le moniteur si demandé par l'utilisateur.
    -> config.php
    -> head.php
    -> private.php
    -> foot.php

config.php
    Connexion à la base de données, initialisation des valeurs de configuration.
    -> bdd.php
    -> functions.php

bdd.php
    Connexion à la base de données.

functions.php
    Ensemble de fonctions utilitaires.

head.php
    En-tête HTML pour un début de page propre.

private.php
    Remplace index.php. Appelée depuis index.php si l'utilisateur est identifié.
    Ressemble très fortement à index.php.
    Permet d'editer pas mal de choses sur les médias.
    -> config.php
    -> head.php
    -> tags.php
    -> edittc.php
    -> subtitles.php
    -> edit.php
    -> foot.php

foot.php
    Pied de page HTML.

tags.php
    Permet à un utilisateur identifié de gérer les tags d'un média.
    -> config.php
    -> head.php
    -> foot.php

taggroup_del.php => n'existe pas !

taggroup_rename.php
    Formulaire pour renommer un groupe de tags

taggroup_edit.php
    Formulaire permettant d'éditer un groupe de tags en supprimant / renommant des tags

tag_rename.php
    Formulaire pour renommer un tag.

tag_del.php
    Détruit le tag et reviens à la page du groupe.

tag_add.php
    Permet d'ajouter un tag à un groupe de tags existant.

view.php
    Permet de visualiser un média suivant son type et s'il a été converti ou pas.
    -> view2.php
    -> embed1.php

view2.php
    Permet d'afficher une vidéo de type webm ou mp4 (non flash donc) en utilisant videoJS.

embed1.php
    Fournit soit une aide, soit le média en mode embarqué.

rss.php
    Fournit un flux RSS pour le mediakit.

get.php
    Permet de télécharger la vidéo (ou un extrait) dans un format spécifié (suivant les disponibilités)
    -> formats.php

formats.php
    Fournit une liste de formats utilisables ainsi que les fonctions permettant de télécharger ces
    différents formats.

edittc.php
    Permet d'éditer les TimeCode d'un média.
    -> edittc_form.php
    -> edittc_list.php

edittc_form.php
    Permet d'ajouter un TimeCode à un média.

edittc_list.php
    Liste tous les TimeCodes d'un média. Permet de supprimer l'un d'eux.

edittc_del.php
    Supprime un TimeCode d'un media.

subtitles.php
    Permet de gérer les sous-titres d'un média en uploadant des fichiers .srt par langue.

edit.php
    Permet d'éditer les informations d'un média.
    -> component_multiselect.php

component_multiselect.php
    Permet d'afficher un div contenant des éléments gérables en javascript.

srt/get.php
    Permet de télécharger le fichier de sous-titre spécifié.

newfiles.php
    Analyse la présence de fichiers dans un répertoire spécifique. Si des fichiers sont présents,
    ils sont rajoutés au mediakit.

prepareformat.php
    Créer les formats manquants des médias de la base de données.

export.php
    Crée un fichier CSV contenant tous les médias existants sur le mediakit avec certaines infos.

key.php ???
    Semble permettre de créer une clef FLV pour un média.

oldfiles.php
    Ajoute au fichier bad.txte la liste des médias qui n'ont pas de fichier associé.
    Spécifie le DAR et le PAR pour les médias vidéos ne les connaissant pas déjà uniquement.

parse.php
    Effectue le même genre de traitement que prepareformat.php. Surement un script pour rattraper
    les erreurs du passé.

phpinfo.php
    De quoi afficher le phpinfo.

plusone.php
    Semble insérer une vidéo dans le mediakit et créer une liste de formats dans lesquels
    convertir la vidéo.

prepareformat_un.php
    Semble être une ancienne version de prepareformat.php.

subtitles_encode.php
    Script de traitement des sous-titres.

t.php
    Script de mise à jour de la taille des médias dans la base.

test.php
    Script pour tester la bonne lecture de l'entête HTTP 'RANGE'.


La base de données
------------------

formats
~~~~~~~

Les formats de compression proposés.
Contient un nom, un type, un type MIME, une extension


media
~~~~~

Les médias enregistrés.
Contient un nom de fichier, un titre, une description, un répertoire, des dates ???, un statut,
un type, une taille, un mtime ??? , un codec video, un format de pixel, une taille x, une taille y,
un nombre de frames par seconde, PAR, DAR, une durée, un codec audio, un taux, un nombre de canaux,
un taux de bits, un flag de notification de média privé


mediaformat
~~~~~~~~~~~

Les formats disponibles pour les médias.
Contient un média, un format, une taille, une autre taille ???


mediatag
~~~~~~~~

Les tags associés aux médias.
Contient un média, un tag


srt
~~~

Les soustitres disponibles pour chaque média de type vidéo.
Contient un media, une langue, un encoded ???, des dates ???


tag
~~~

Les tags généralement utilisables.
Contient un nom, un groupe de tags


taggroup
~~~~~~~~

Groupes de tags.
Contient un nom


tc
~~

Les TimeCode marqués dans les vidéos ou les audios.
Contient un média, un début, une fin, une description


tctag
~~~~~

Les tags associés aux TimeCodes des vidéos.
Contient un TimeCode, un tag