Document Backup Update

document/front_design/README.md

@@ -0,0 +1,68 @@
+# Front Design For GeSong System
+
+## Content
+### Before
+### Front(User)
+#### 1. Index Page
+#### 2. Search Page
+#### 3. History Page
+#### 4. List Page
+#### 5. Confirm Page
+### Back(Admin)
+#### 1. Access Page
+#### 2. Audit Page
+#### 3. List Page
+#### 4. System Page
+
+## Before
+#### All template use WebApi to deal the operate
+#### Recommand Vue.js, but you still can use jQuery(Ajax) :D
+#### All Response Code (Int)
+##### `10000` `Success`
+
+## Front(User)
+
+### Index Page
+#### The index page use the root path ("/"),
+#### Server will response a 301 code to jump to search page ("/search")
+
+### Search Page
+#### The search page use the path "/search"
+#### A user have to log in to use the search function
+#### WebApi Interface Detail:
+##### Path: `/api/search`
+##### Method: `POST`
+##### Args:
+###### `keyword` `string` `keyword of the song`
+###### `token` `string` `user token`
+##### Response Format: `Json`
+##### Json Args: 
+###### `code` `int` `response code`
+###### `content` `list` `list of songs`
+##### List of Songs Args(content):
+###### `pid` `int` `platform id`
+###### `id` `int` `song id(platform)`
+###### `name` `string` `name of song`
+###### `artists` `list` `list of artists`
+###### `album` `dict` `album of this song`
+###### `url` `string` `the media url of this song`
+##### List of Artists Args:
+###### `id` `int` `artist id(platform)`
+###### `name` `string` `name of this artist`
+###### `cover` `string` `image url of this aritist`
+##### Album Args:
+###### `id` `int` `album id(platform)`
+###### `name` `string` `name of this album`
+###### `cover` `string` `image url of this album`
+
+### History Page
+#### The history page use the path "/history"
+#### Anybody can directly get history of songs
+#### WebApi Interface Detail:
+##### Path: `/api/history`
+##### Method: `GET`
+##### Args: `Nothing`
+##### Response Format: `Json`
+##### Json Args:
+###### `code` `int` `response code`
+###### `content` `list` `list of history songs`

gesong/__init__.py

@@ -0,0 +1,10 @@
+'''
+   Copyright Ghink Network Studio © 2014
+   MIT Fengming High School Techy Group & Radio Station
+   Website: https://www.ghink.net, https://radio.fmhs.club, https://techy.fmhs.club
+   Main Program by Bigsk (https://www.xiaxinzhe.cn)
+'''
+
+from flask import Flask
+
+APP = Flask("GeSong System")

gesong/__main__.py

@@ -0,0 +1,45 @@
+'''
+   Copyright Ghink Network Studio © 2014
+   MIT Fengming High School Techy Group & Radio Station
+   Website: https://www.ghink.net, https://radio.fmhs.club, https://techy.fmhs.club
+   Main Program by Bigsk (https://www.xiaxinzhe.cn)
+'''
+
+from __init__ import *
+
+import route
+
+import os, json
+from threading import Thread
+from flask import Flask
+from urllib.request import urlopen
+
+# Define network check function
+def network(source = r"http://www.baidu.com", retry = 3):
+    flag = False
+    for _ in range(retry):
+        try:
+            fp = urlopen(source)
+            fp.read(100).decode()
+            fp.close()
+        except:
+            pass
+        else:
+            flag = True
+    return flag
+# Define json check function
+def check_json(content):
+    try:
+        json.loads(content)
+    except:
+        return False
+    else:
+        return True
+    finally:
+        return False
+# Define main function
+def main():
+    APP.run("127.0.0.1", 8000)
+
+if __name__ == "__main__":
+    main()

gesong/route.py

@@ -0,0 +1,22 @@
+'''
+   Copyright Ghink Network Studio © 2014
+   MIT Fengming High School Techy Group & Radio Station
+   Website: https://www.ghink.net, https://radio.fmhs.club, https://techy.fmhs.club
+   Main Program by Bigsk (https://www.xiaxinzhe.cn)
+'''
+
+from __init__ import *
+
+import json, time
+
+def ping():
+   return json.dumps({
+      "ping": "pong",
+      "time": time.time()
+   },
+   ensure_ascii = False,
+   sort_keys = True,
+   indent = 4,
+   separators = (',', ':'))
+
+APP.add_url_rule("/ping", view_func = ping)