Browse Source

Started writing README

Matteo Zeccoli Marazzini 5 years ago
parent
commit
105695b365
1 changed files with 33 additions and 2 deletions
  1. 33 2
      README.md

+ 33 - 2
README.md

@@ -1,3 +1,34 @@
-# lcmlog
+# lcmlog-server
 
-Tool for reading and writing the lcm staff logs
+Server side of a tool for reading and writing the lcm staff logs
+The program doen't accept any command line options.
+The first line of the input can be `GET`, `POST` or `UPDATE`.
+
+## The two kind of the logs
+To do
+
+## The authenticsation process
+To do
+
+## The three methods
+### GET
+The `GET` method is used to print all the logs that meet the required criteria.
+The second line of the input is the kind of the log to search for (see below), and it is the only mandatory parameter.
+The third line is the date: only logs whose date contains the searched for date are printed. The format for the date has not been decided yet, so currently any string can be inserted here.
+The fourth line is a list of comma separated tags to search for.
+The fifth line is the name of the user to search for.
+
+### POST
+The `POST` method is used to add a log to the database.
+The second line of the input is the kind (se below).
+The third one is the date.
+The fourth one is a list of comma separated tags.
+The remainder of the file (until EOF is met) is the content of the log.
+
+### UPDATE
+The `UPDATE` method is used to regenerate the internal server database.
+It should only be called if a log file is added by hand, or if some of the log files get renamed or corrupted.
+It assumes that all the log files are correctly formatted.
+
+## The format of the log files
+To do