start to restructure the project tree

aircox/programs/README.md

@@ -0,0 +1,32 @@
+# Aircox Programs
+
+This application defines all base models and basic control of them. We have:
+* **Nameable**: generic class used in any class needing to be named. Includes some utility functions;
+* **Program**: the program itself;
+* **Diffusion**: occurrence of a program planified in the timetable. For rerun, informations are bound to the initial diffusion;
+* **Schedule**: describes diffusions frequencies for each program;
+* **Track**: track informations in a playlist of a diffusion;
+* **Sound**: information about a sound that can be used for podcast or rerun;
+* **Log**: logs
+
+
+## Architecture
+A Station is basically an object that represent a radio station. On each station, we use the Program object, that is declined in two different type:
+* **Scheduled**: the diffusion is based on a timetable and planified through one Schedule or more; Diffusion object represent the occurrence of these programs;
+* **Streamed**: the diffusion is based on random playlist, used to fill gaps between the programs;
+
+Each program has a directory in **AIRCOX_PROGRAMS_DIR**; For each, subdir:
+* **archives**: complete episode record, can be used for diffusions or as a podcast
+* **excerpts**: excerpt of an episode, or other elements, can be used as a podcast
+
+
+## manage.py's commands
+* **diffusions_monitor**: update/create, check and clean diffusions; When a diffusion is created, its type is unconfirmed, and requires a manual approval to be on the timetable.
+* **sound_monitor**: check for existing and missing sounds files in programs directories and synchronize the database. Can also check for the quality of file and synchronize the database according to them.
+* **sound_quality_check**: check for the quality of the file (don't update database)
+
+
+## Requirements
+* Sox (and soxi): sound file monitor and quality check
+* requirements.txt for python's dependecies
+