soft/dashboard/README.md

# Dashboard for Mageia buildsystem
Romain d'Alverny <rda> for Mageia.Org

Code is available in http://svn.mageia.org/svn/soft/dashboard/
under MIT license, see LICENSE.txt.

## About

This is quite an ugly functional sample to get a first idea of what
we can have.

Here, we focus on the chain from code source of individual projects to the
final ISO to download:

 - individual source projects (Box/01_UpstreamProjects.php, disabled for now)
 - source packages in Mageia (Box/02_)
 - build system (Box/03_)
 - cauldron packages (Box/04_)
 - ISO build (Box/5_, disabled for now)

For each step, we aim to gather as meaningful data as possible: status, QA,
availability, things broken or to improve.


## Requirements

 - PHP 5.2+


## Usage

Call make_report.php > report.html


## Next

Basically, in the future, we need:

 * a service that fetches data from severals sources and normalize them
   into a local data store; that doesn't prevent data sources to be published
   in a practical form (say, UTF-8, json format, public API)

 * a renderer (cron-called or on-the-fly) that publishes easy to grasp metrics
   in visual forms.


1	rda	1101	# Dashboard for Mageia buildsystem
2			Romain d'Alverny <rda> for Mageia.Org
3
4			Code is available in http://svn.mageia.org/svn/soft/dashboard/
5			under MIT license, see LICENSE.txt.
6
7			## About
8
9			This is quite an ugly functional sample to get a first idea of what
10			we can have.
11
12			Here, we focus on the chain from code source of individual projects to the
13			final ISO to download:
14
15			- individual source projects (Box/01_UpstreamProjects.php, disabled for now)
16			- source packages in Mageia (Box/02_)
17			- build system (Box/03_)
18			- cauldron packages (Box/04_)
19			- ISO build (Box/5_, disabled for now)
20
21			For each step, we aim to gather as meaningful data as possible: status, QA,
22			availability, things broken or to improve.
23
24
25			## Requirements
26
27			- PHP 5.2+
28
29
30			## Usage
31
32			Call make_report.php > report.html
33
34
35			## Next
36
37			Basically, in the future, we need:
38
39			* a service that fetches data from severals sources and normalize them
40			into a local data store; that doesn't prevent data sources to be published
41			in a practical form (say, UTF-8, json format, public API)
42
43			* a renderer (cron-called or on-the-fly) that publishes easy to grasp metrics
44			in visual forms.
45
46
47