viewo-helpdesk 1.0.0__py3-none-any.whl

viewo_helpdesk/__init__.py

@@ -0,0 +1,38 @@
+#==============================================================================
+# C O P Y R I G H T
+#------------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+#==============================================================================
+
+import importlib.metadata
+import os
+
+import utilo
+
+import viewo_helpdesk.__patch__
+from viewo_helpdesk.api import api_call
+from viewo_helpdesk.config import API_PREFIX
+from viewo_helpdesk.config import SECRET_KEY
+from viewo_helpdesk.config import VIEWO_HELPDESK
+from viewo_helpdesk.config import board
+from viewo_helpdesk.config import configure
+from viewo_helpdesk.message import Dialog
+from viewo_helpdesk.message import Dialogs
+from viewo_helpdesk.message import Message
+from viewo_helpdesk.message import Messages
+from viewo_helpdesk.message.action import start_conversion
+from viewo_helpdesk.message.action import write_message
+from viewo_helpdesk.message.collect import load_dialogs
+from viewo_helpdesk.message.collect import load_messages
+from viewo_helpdesk.message.collect import load_users
+from viewo_helpdesk.message.collect import valid_dialog
+from viewo_helpdesk.message.collect import valid_user
+from viewo_helpdesk.message.path import userpath
+from viewo_helpdesk.message.serialize import dump_message
+
+__version__ = importlib.metadata.version('viewo-helpdesk')
+
+ROOT = os.path.abspath(utilo.join(os.path.dirname(__file__), '..'))

viewo_helpdesk/__main__.py

@@ -0,0 +1,26 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import os
+
+import utilo
+
+import viewo_helpdesk
+import viewo_helpdesk.app
+import viewo_helpdesk.config
+
+CONFIG = {
+    viewo_helpdesk.config.VIEWO_HELPDESK:
+        os.environ.get(
+            viewo_helpdesk.config.VIEWO_HELPDESK,
+            utilo.join(utilo.tmpdir(viewo_helpdesk.ROOT), 'viewo_helpdesk'),
+        )
+}
+
+instance = viewo_helpdesk.app.create(CONFIG)  # pylint:disable=C0103

viewo_helpdesk/__patch__.py

@@ -0,0 +1,8 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================

viewo_helpdesk/api/__init__.py

@@ -0,0 +1,101 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import functools
+import http
+
+import flask
+import flask_login
+import utilo
+
+import viewo_helpdesk
+import viewo_helpdesk.config
+
+api_auth = flask.Blueprint('api_auth', __name__)  # pylint:disable=C0103
+api_message = flask.Blueprint('api_message', __name__)  # pylint:disable=C0103
+
+__all__ = ['api_auth', 'api_message', 'auth', 'delete', 'post', 'present']
+
+
+def dump(data, name='', uri='') -> str:
+    uri = uri if uri else flask.request.path
+    name = name if name else 'data'
+    data = utilo.simplify(data)  # pylint:disable=E1101
+    connected = {'uri': uri, name: data}
+    json = flask.jsonify(connected)
+    return json
+
+
+def success(message: str = 'completed', **args):
+    result = flask.jsonify({
+        'message': message,
+        **args,
+    })
+    return result, http.HTTPStatus.OK
+
+
+def notfound(message: str):
+    result = flask.jsonify({
+        'error': 'not found',
+        'message': message,
+    })
+    return result, http.HTTPStatus.NOT_FOUND
+
+
+def bad(message: str):
+    result = flask.jsonify({
+        'error': 'bad request',
+        'message': message,
+    })
+    return result, http.HTTPStatus.BAD_REQUEST
+
+
+def internal(message: str):
+    result = flask.jsonify({
+        'error': 'internal',
+        'message': message,
+    })
+    return result, http.HTTPStatus.INTERNAL_SERVER_ERROR
+
+
+def api_call(path):
+    return viewo_helpdesk.config.API_PREFIX + path
+
+
+def valid_user(function):
+
+    @functools.wraps(function)
+    def decorated_function(*args, **kwargs):
+        userid = kwargs['userid']
+        currentuser = flask_login.current_user
+        if not currentuser.is_authenticated:
+            return bad('login required')
+        if not userid and not currentuser.is_admin:
+            return notfound('not accessable')
+        if userid and not currentuser.is_admin:
+            if not viewo_helpdesk.valid_user(userid):
+                return notfound(f'could not locate `{userid}`')
+            if currentuser.get_id() != userid:
+                return notfound('not accessable')
+        return function(*args, **kwargs)
+
+    return decorated_function
+
+
+def valid_dialog(function):
+
+    @functools.wraps(function)
+    def decorated_function(*args, **kwargs):
+        userid = kwargs['userid']
+        date = kwargs['date']
+        if not viewo_helpdesk.valid_dialog(userid, date):
+            return notfound(f'could not locate `{userid}` `{date}`')
+        return function(*args, **kwargs)
+
+    return decorated_function

viewo_helpdesk/api/auth.py

@@ -0,0 +1,102 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import dataclasses
+import functools
+import http
+
+import flask
+import flask_login
+
+import viewo_helpdesk.api
+import viewo_helpdesk.config
+
+NO_ACCESS = 'LOGIN REQUIRED'
+
+
+@dataclasses.dataclass
+class FlaskUser(flask_login.UserMixin):
+    identifier: str = None
+
+    def get_id(self):
+        return self.identifier
+
+    @property
+    def is_admin(self):
+        return self.identifier == viewo_helpdesk.config.ADMIN_NAME
+
+
+def create_loginmanager(app):
+    loginmanager = flask_login.LoginManager()
+    loginmanager.login_view = 'api_auth.show_login'
+    loginmanager.init_app(app)
+
+    loginmanager._user_callback = load_user  # pylint:disable=W0212
+
+
+def verify_password(user: str, password: str) -> bool:
+    if user == viewo_helpdesk.config.ADMIN_NAME:
+        if password == viewo_helpdesk.config.ADMIN_PASSWORD:
+            return True
+    return False
+
+
+def login(user, password) -> bool:
+    if not verify_password(user, password):
+        return False
+    user = load_user(user)
+    flask_login.login_user(user)
+    return True
+
+
+def load_user(userid):
+    return FlaskUser(identifier=userid)
+
+
+@viewo_helpdesk.api.api_auth.route('/auth')
+def show_login():
+    return NO_ACCESS, http.HTTPStatus.UNAUTHORIZED
+
+
+@viewo_helpdesk.api.api_auth.route('/logout')
+def logout():
+    flask_login.logout_user()
+    return 'DONE'
+
+
+@viewo_helpdesk.api.api_auth.route('/auth', methods=['POST'])
+def check_login():
+    if flask_login.current_user.is_authenticated:
+        return 'DONE'
+
+    user = flask.request.form['user']
+    password = flask.request.form['password']
+
+    # verify
+    if not verify_password(user, password):
+        return 'INVALID PASSWORD', http.HTTPStatus.NOT_FOUND
+
+    # login
+    login(user, password)
+    if flask_login.current_user.is_admin:
+        return flask.jsonify({'link': '/admin/messages/list'})
+    return 'DONE'
+
+
+def admin_required(func):
+
+    @functools.wraps(func)
+    def decorated_view(*args, **kwargs):
+        if not flask_login.current_user.is_authenticated:
+            return flask.current_app.login_manager.unauthorized()
+        if not flask_login.current_user.is_admin:
+            return flask.current_app.login_manager.unauthorized()
+        return func(*args, **kwargs)
+
+    return decorated_view

viewo_helpdesk/api/delete.py

@@ -0,0 +1,8 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================

viewo_helpdesk/api/post.py

@@ -0,0 +1,49 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import flask
+import flask_login
+import utilo
+
+import viewo_helpdesk
+import viewo_helpdesk.api
+
+
+@viewo_helpdesk.api.api_message.route('/dialog/add', methods=['POST'])
+def message_add() -> str:
+    parent = flask.request.form.get('parent', None)
+    userid = flask.request.form.get('userid', None)
+    date = utilo.now()
+    title = flask.request.form.get('title', None)
+    text = flask.request.form.get('text', None)
+    category = flask.request.form.get('category', None)
+
+    new_dialog = parent is None
+    admin = flask_login.current_user.is_admin
+    if not admin:
+        userid = flask_login.current_user.get_id()
+
+    message = viewo_helpdesk.Message(
+        parent=None if new_dialog else parent,
+        userid=userid,
+        date=date,
+        title=title,
+        text=text,
+        writer=userid if not admin else None,
+        category=category,
+    )
+    if new_dialog:
+        viewo_helpdesk.start_conversion(message, current=date)
+    else:
+        viewo_helpdesk.write_message(message, current=date)
+
+    done = {'date': date}
+    uri = viewo_helpdesk.api_call(f'/dialog/{userid}/{date}')
+    dumped = viewo_helpdesk.api.dump(done, name='success', uri=uri)
+    return dumped

viewo_helpdesk/api/present.py

@@ -0,0 +1,43 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import viewo_helpdesk
+import viewo_helpdesk.api
+import viewo_helpdesk.api.auth
+
+
+@viewo_helpdesk.api.api_message.route(
+    '/dialogs/<string(length=16):userid>',
+    methods=['GET'],
+)
+@viewo_helpdesk.api.valid_user
+def dialogs(userid):
+    result = viewo_helpdesk.load_dialogs(userid)
+    dumped = viewo_helpdesk.api.dump(result, 'dialogs')
+    return dumped
+
+
+@viewo_helpdesk.api.api_message.route('/dialogs', methods=['GET'])
+@viewo_helpdesk.api.auth.admin_required
+def get_dialog():
+    result = viewo_helpdesk.load_dialogs()
+    dumped = viewo_helpdesk.api.dump(result, 'dialogs')
+    return dumped
+
+
+@viewo_helpdesk.api.api_message.route(
+    '/dialog/<string(length=16):userid>/<int:date>',
+    methods=['GET'],
+)
+@viewo_helpdesk.api.valid_user
+@viewo_helpdesk.api.valid_dialog
+def dialog_get(userid: str, date: int):
+    messages = viewo_helpdesk.load_messages(userid, date)
+    dumped = viewo_helpdesk.api.dump(messages, 'messages')
+    return dumped

viewo_helpdesk/app.py

@@ -0,0 +1,45 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import flask
+import flask_bootstrap
+
+import viewo_helpdesk
+import viewo_helpdesk.api.auth
+import viewo_helpdesk.api.post
+import viewo_helpdesk.api.present
+from viewo_helpdesk.api import api_auth
+from viewo_helpdesk.api import api_message
+from viewo_helpdesk.view import *  # pylint:disable=wildcard-import
+from viewo_helpdesk.view import view_login
+from viewo_helpdesk.view import view_user
+
+
+def create(config=None) -> flask.Flask:
+    appi = flask.Flask(__name__)
+    appi.secret_key = viewo_helpdesk.SECRET_KEY
+
+    viewo_helpdesk.api.auth.create_loginmanager(appi)
+
+    appi.config.setdefault('BOOTSTRAP_SERVE_LOCAL', True)
+    flask_bootstrap.Bootstrap5(app=appi)
+
+    if config:
+        appi.config.update(config)
+
+    # view
+    appi.register_blueprint(view_admin)
+    appi.register_blueprint(view_login)
+    appi.register_blueprint(view_user)
+
+    # api
+    appi.register_blueprint(api_auth, url_prefix=viewo_helpdesk.API_PREFIX)
+    appi.register_blueprint(api_message, url_prefix=viewo_helpdesk.API_PREFIX)
+
+    return appi

viewo_helpdesk/cli.py

@@ -0,0 +1,76 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2021-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import argparse
+import collections
+import sys
+
+import utilo
+
+
+def main():
+    config = eval_cli()
+    # setup logging
+    utilo.level_setup(level=config.verbose)
+    app = create_app()
+    # run app
+    app.run(
+        host=config.host,
+        port=config.port,
+        debug=config.debug,
+    )
+
+
+Config = collections.namedtuple(
+    'Config',
+    'host, port, debug, verbose',
+)
+
+
+def eval_cli():
+    parser = argparse.ArgumentParser()
+    parser.add_argument('--host', default='localhost', help='run on url')
+    parser.add_argument('--port', default=5000, help='run on port')
+    parser.add_argument(
+        '--debug',
+        action='store_true',
+        help='run in debug mode',
+    )
+    parser.add_argument(
+        '--verbose',
+        '-V',
+        action='count',
+        default=0,
+        help='define level of logging',
+    )
+    parser.add_argument(
+        '--version',
+        action='store_true',
+        help='print version and quit',
+    )
+    argv = parser.parse_args()
+    if argv.version:
+        import viewo_helpdesk
+        utilo.log(viewo_helpdesk.__version__)
+        sys.exit(utilo.SUCCESS)
+    result = Config(
+        argv.host,
+        int(argv.port),
+        argv.debug,
+        argv.verbose,
+    )
+    return result
+
+
+def create_app():
+    import viewo_helpdesk.config
+    config = viewo_helpdesk.config.validate()
+    import viewo_helpdesk.app
+    result = viewo_helpdesk.app.create(config=config)
+    return result

viewo_helpdesk/config.py

@@ -0,0 +1,52 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import os
+import sys
+
+import configos
+import flask
+import utilo
+
+VIEWO_HELPDESK = 'VIEWO_HELPDESK'
+
+ADMIN_NAME = configos.env('ADMIN_NAME', default='admin')
+ADMIN_PASSWORD = configos.env('ADMIN_PASSWORD', default='secret')  # nosec
+
+SECRET_KEY = b'helmut_max_power_abs29.nsTODOThisIsVerySecreyISwarTODO'
+
+API_PREFIX = '/api/v0'
+
+
+def helpdesk() -> str:
+    path = flask.current_app.config[VIEWO_HELPDESK]
+    os.makedirs(path, exist_ok=True)
+    return path
+
+
+def board() -> str:
+    path = utilo.join(helpdesk(), 'messages')
+    os.makedirs(path, exist_ok=True)
+    return path
+
+
+def configure(path):
+    flask.current_app.config[VIEWO_HELPDESK] = path
+
+
+def validate():
+    try:
+        _ = os.environ[VIEWO_HELPDESK]
+    except KeyError:
+        utilo.error(f'could not start app, define `{VIEWO_HELPDESK}`')
+        sys.exit(utilo.FAILURE)
+    config = {
+        VIEWO_HELPDESK: os.environ[VIEWO_HELPDESK],
+    }
+    return config

viewo_helpdesk/fixtures.py

@@ -0,0 +1,41 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import pytest
+
+import viewo_helpdesk.api.auth
+import viewo_helpdesk.app
+
+
+@pytest.fixture
+def appi(td):
+    """Create and configure a new app instance for each test."""
+    # create the app with common test config
+    created = viewo_helpdesk.app.create(config={
+        'VIEWO_HELPDESK': td.tmpdir,
+        'TESTING': True,
+    })
+    with created.app_context():
+        yield created
+
+
+@pytest.fixture
+def client(appi, mp):  # pylint:disable=W0621
+    """A test client for the app."""
+    with mp.context() as context:
+
+        def verify_password(user: str, password: str) -> bool:  # pylint:disable=W0613
+            return True
+
+        context.setattr(
+            viewo_helpdesk.api.auth,
+            'verify_password',
+            verify_password,
+        )
+        yield appi.test_client()

viewo_helpdesk/message/__init__.py

@@ -0,0 +1,38 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import dataclasses
+
+
+@dataclasses.dataclass
+class Message:
+    """\
+    >>> Message()
+    Message(...)
+    """
+    parent: int = None
+    userid: str = None
+    date: int = None
+    title: str = None
+    text: str = None
+    writer: str = None
+    category: int = None
+
+
+Messages = list[Message]
+
+
+@dataclasses.dataclass
+class Dialog:
+    userid: str = None
+    date: int = None
+    title: str = None
+
+
+Dialogs = list[Dialog]

viewo_helpdesk/message/action.py

@@ -0,0 +1,52 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import os
+
+import utilo
+
+import viewo_helpdesk
+import viewo_helpdesk.message
+import viewo_helpdesk.message.path
+import viewo_helpdesk.message.serialize
+
+
+def delete_message(userid: str, date: int):  # pylint:disable=W0613
+    pass
+
+
+def delete_history(userid: str):  # pylint:disable=W0613
+    pass
+
+
+def start_conversion(
+    message: viewo_helpdesk.message.Message,
+    current: int = None,
+) -> int:
+    current = f'{utilo.now()}' if current is None else f'{current}'
+    outpath = utilo.join(viewo_helpdesk.userpath(message.userid), current)
+    # start new conversion folder
+    os.makedirs(outpath, exist_ok=True)
+    first_message = utilo.join(outpath, current)
+    dumped = viewo_helpdesk.dump_message(message)
+    utilo.file_create(first_message, dumped)
+    return current
+
+
+def write_message(message: viewo_helpdesk.message.Message, current: int = None):
+    current = f'{utilo.now()}' if current is None else f'{current}'
+    if message.writer is None:
+        current = f'{current}!'
+    dumped = viewo_helpdesk.dump_message(message)
+    outpath = utilo.join(
+        viewo_helpdesk.userpath(message.userid),
+        f'{message.parent}',
+        current,
+    )
+    utilo.file_create(outpath, dumped)

viewo_helpdesk/message/collect.py

@@ -0,0 +1,109 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import os
+
+import utilo
+
+import viewo_helpdesk
+import viewo_helpdesk.config
+
+
+def load_messages(userid: str, date: int) -> 'viewo_helpdesk.Messages':
+    date = f'{date}'
+    board = viewo_helpdesk.board()
+    path = utilo.join(board, userid, date)
+    dates = utilo.file_list(path)
+    # remove admin mark to clarify date
+    dates = [item.replace('!', '') for item in dates]
+    loaded = [load_message(userid, date, msgdate) for msgdate in dates]
+    # sort by date
+    loaded.sort(key=lambda x: x.date)
+    return loaded
+
+
+def load_message(
+    userid: str,
+    start: int,
+    date: str = None,
+) -> 'viewo_helpdesk.Message':
+    # load header if no date is given
+    date = date if date else start
+    start, date = f'{start}', f'{date}'
+    board = viewo_helpdesk.board()
+    message = viewo_helpdesk.Message(
+        userid=userid,
+        parent=start,
+        date=int(date),
+    )
+    path = utilo.join(board, userid, start)
+    if os.path.exists(utilo.join(path, date)):
+        # user message
+        path = utilo.join(path, date)
+        message.writer = userid
+    else:
+        # admin message
+        path = utilo.join(path, f'{date}!')
+    message_raw = utilo.file_read(path)
+    title, text = message_raw.split('\n\n', maxsplit=1)
+    if title != 'None':
+        message.title = title
+    message.text = text
+    return message
+
+
+def load_dialogs(user: str = None) -> 'viewo_helpdesk.Dialogs':
+    board = viewo_helpdesk.board()
+    result = []
+    users = utilo.directory_list(board) if user is None else [user]  # pylint:disable=E1101
+    for userid in users:
+        dialogs = utilo.directory_list(utilo.join(board, userid))  # pylint:disable=E1101
+        for dialog in dialogs:
+            dialog = int(dialog)
+            title = load_message(userid, dialog, dialog).title
+            result.append(
+                viewo_helpdesk.Dialog(
+                    userid=userid,
+                    date=dialog,
+                    title=title,
+                ))
+    return result
+
+
+def load_users() -> list:
+    board = viewo_helpdesk.board()
+    users = utilo.file_list(board)
+    return users
+
+
+def valid_user(userid: str) -> bool:
+    board = viewo_helpdesk.board()
+    userpath = utilo.join(board, userid)
+    if not os.path.exists(userpath):
+        return False
+    return True
+
+
+def valid_dialog(userid: str, date: int) -> bool:
+    if not valid_user(userid):
+        return False
+    date = f'{date}'
+    board = viewo_helpdesk.board()
+    dialogpath = utilo.join(board, userid, date)
+    if not os.path.exists(dialogpath):
+        return False
+    return True
+
+
+def load_after(date: int, userid: int = None):  # pylint:disable=W0613
+    pass
+
+
+def load_before(data: int, userid: int = None):  # pylint:disable=W0613
+    pass

viewo_helpdesk/message/path.py

@@ -0,0 +1,17 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import utilo
+
+import viewo_helpdesk
+
+
+def userpath(userid: str) -> str:
+    result = utilo.join(viewo_helpdesk.board(), userid)
+    return result

viewo_helpdesk/message/serialize.py

@@ -0,0 +1,15 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import viewo_helpdesk.message
+
+
+def dump_message(message: viewo_helpdesk.message.Message) -> str:
+    raw = f'{message.title}\n\n{message.text}'
+    return raw

viewo_helpdesk/templates/admin/base.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="de">
+
+<body>
+
+    {% if current_user %}
+    <a href="{{ url_for('api_auth.logout') }}">Logout</a>
+    {% endif %}
+
+    {% block content %}
+
+    {% endblock %}
+</body>

viewo_helpdesk/templates/admin/index.html

@@ -0,0 +1,33 @@
+{% extends 'admin/base.html' %}
+
+{% block content %}
+<h2>Nachrichten</h2>
+<hr>
+{% if not dialogs %}
+Keine Nachrichten verfügbar.
+{% else %}
+<table class="small_table table table-striped table-bordered">
+    <thead>
+        <tr>
+            <th>Title</th>
+            <th>Datum</th>
+            <th class="small">Action</th>
+        </tr>
+    </thead>
+    <tbody>
+        {% for dialog in dialogs %}
+        <tr>
+            <td>{{dialog['title']}}</td>
+            <td>{{dialog['date']}}</td>
+            <td>
+                <a href="{{ url_for('view_admin.messages_show', userid=dialog['userid'], date=dialog['date']) }}">
+                    Öffnen</a>
+            </td>
+        </tr>
+        {% endfor %}
+    </tbody>
+</table>
+
+{% endif %}
+
+{% endblock %}

viewo_helpdesk/templates/admin/reply.html

@@ -0,0 +1,5 @@
+<h2>Nachrichten</h2>
+<ul>
+    <li><a href="{{ url_for('view_admin.messages_list') }}">Messages</a></li>
+</ul>
+<hr>

viewo_helpdesk/templates/admin/show.html

@@ -0,0 +1,25 @@
+<h2>Nachrichten</h2>
+
+<ul>
+    <li><a href="{{ url_for('view_admin.messages_list') }}">Messages</a></li>
+</ul>
+<hr />
+
+{% for message in messages %}
+{% if message['title'] %}
+<h3>{{message['title']}}</h3>
+{% endif %}
+
+{% if  message['writer'] %}
+User: {{message['writer']}}<br />
+{% else %}
+User: Admin<br />
+{% endif %}
+
+Date: {{message['date']}}<br />
+<p>{{message['text']}}</p>
+____________________<br />
+{% endfor %}
+
+<a href="{{ url_for('view_admin.messages_show', userid=dialog['userid'], date=dialog['date']) }}">
+    Anworten</a>

viewo_helpdesk/templates/base.html

@@ -0,0 +1,19 @@
+<!doctype html>
+<html lang="de">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport"
+          content="width=device-width, initial-scale=1">
+
+    <title>{% block title %}viewo helpdesk{% endblock %}</title>
+
+    {{ bootstrap.load_css() }}
+</head>
+<body>
+
+    {% block content %}{% endblock %}
+
+    {{ bootstrap.load_js() }}
+
+</body>
+</html>

viewo_helpdesk/templates/helper.mac

@@ -0,0 +1,16 @@
+{% macro button(id='', caption='', img='', alt='', style='', class='', data_dismiss='', onclick='', padding='', width='100%', height='100%') -%}
+<button type="button" {% if id %} id="{{ id }}" {% endif %}
+    {% if style %} style="{{ style }}" {% endif %}
+    {% if class %} class="{{ class}}" {% endif %}
+    {% if data_dismiss %} data-dismiss="{{ data_dismiss }}" {% endif %}
+    {% if onclick %} onclick="{{ onclick }}" {% endif %}
+    >
+    {% if img %}
+    <img src="{{ url_for('static', filename=img) }}" {% if alt %}
+        alt="{{ alt }}" {% endif %} width="{{width}}" height="{{height}}" />
+    {% endif %}
+    {% if caption %}
+    {{ caption }}
+    {% endif %}
+</button>
+{%- endmacro %}

viewo_helpdesk/templates/login.html

@@ -0,0 +1,78 @@
+{% extends "base.html" %}
+
+{% from 'helper.mac' import button %}
+
+{% block title %}Admin - Login{% endblock %}
+
+{% block content %}
+<h1>Login</h1>
+
+<div class="container" id="nogoodnews">
+    {% for message in get_flashed_messages() %}
+    <div class="alert alert-warning">
+        {{ button(caption='&times;', class='close', data_dismiss='alert') }}
+        {{ message }}
+    </div>
+    {% endfor %}
+</div>
+
+<div class="container">
+    <form method="POST" id="validate_login" role="form" class="form-horizontal">
+        <div class="form-group">
+            <labbel for="user" class="col-sm-2 control-label">Benutzer:</labbel>
+            <div class="col-sm-3">
+                <input type="text" class="form-control" name="user" value="{{user}}">
+            </div>
+        </div>
+
+        <div class="form-group">
+            <labbel for="password" class="col-sm-2 control-label">Passwort:</labbel>
+            <div class="col-sm-3">
+                <input type="password" class="form-control" name="password" value="{{password}}">
+            </div>
+        </div>
+
+        <div class="form-group">
+            <labbel class="col-sm-2 control-label"></labbel>
+            <div class="col-sm-3">
+                <button type="submit" class="btn btn-default">Anmelden</button>
+            </div>
+        </div>
+    </form>
+</div>
+{% endblock %}
+
+{% block scripts %}
+{{ super() }}
+<script type="text/javascript">
+    $("#validate_login").submit(function (event) {
+        event.preventDefault();
+        let user = $("input[name='user']")[0].value
+        let password = $("input[name='password']")[0].value
+        login(user, password)
+    });
+
+    function login(user, password) {
+        let url = `/api/v0/auth`
+        $.ajax(url, {
+            method: "POST",
+            data: { 'user': user, 'password': password },
+            success: function (response) {
+                window.location.replace(response['link'])
+            },
+            error: function () {
+                user_error('invalid login data')
+            }
+        })
+    }
+
+    function user_error(message) {
+        let entry = `<div class="alert alert-warning">
+                <button type="button" class="close" data-dismiss="alert">&times;</button>
+                ${message}
+                </div>`
+        $('#nogoodnews').append(entry)
+    }
+
+</script>
+{% endblock %}

viewo_helpdesk/view/__init__.py

@@ -0,0 +1,16 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import flask
+
+view_admin = flask.Blueprint('view_admin', __name__)  # pylint:disable=C0103
+view_login = flask.Blueprint('view_login', __name__)  # pylint:disable=C0103
+view_user = flask.Blueprint('view_user', __name__)  # pylint:disable=C0103
+
+__all__ = ['admin', 'login', 'user', 'view_admin', 'view_login', 'view_user']

viewo_helpdesk/view/admin.py

@@ -0,0 +1,53 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import flask
+import flask_login
+
+import viewo_helpdesk.api.auth
+import viewo_helpdesk.message.collect
+import viewo_helpdesk.view
+
+
+@viewo_helpdesk.view.view_admin.route('/admin/messages/list')
+@flask_login.login_required
+def messages_list():
+    """Route public pages which are visible without any permissions."""
+    dialogs = viewo_helpdesk.message.collect.load_dialogs()
+    headers = [
+        viewo_helpdesk.message.collect.load_message(item.userid, item.date)
+        for item in dialogs
+    ]
+    return flask.render_template('admin/index.html', dialogs=headers)
+
+
+@viewo_helpdesk.view.view_admin.route(
+    '/admin/messages/reply/<string(length=16):userid>/<int:date>',
+    methods=['GET'],
+)
+@flask_login.login_required
+def messages_reply(userid: str, date: int):  # pylint:disable=W0612,W0613
+    # messages = viewo_helpdesk.message.collect.load_messages(userid, date)
+    pass
+
+
+@viewo_helpdesk.view.view_admin.route(
+    '/admin/messages/show/<string(length=16):userid>/<int:date>',
+    methods=['GET'],
+)
+@flask_login.login_required
+def messages_show(userid: str, date: int):
+    messages = viewo_helpdesk.message.collect.load_messages(userid, date)
+    dialog = viewo_helpdesk.Dialog(userid, date)
+    rendered = flask.render_template(
+        'admin/show.html',
+        messages=messages,
+        dialog=dialog,
+    )
+    return rendered

viewo_helpdesk/view/login.py

@@ -0,0 +1,31 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================
+
+import flask
+import flask_login
+
+import viewo_helpdesk.api.auth
+import viewo_helpdesk.view
+
+
+@viewo_helpdesk.view.view_login.route('/admin/login')
+def login_show():
+    """Route public pages which are visible without any permissions."""
+    if flask_login.current_user.get_id() is not None:
+        return flask.redirect(flask.url_for('view_admin.messages_list'))
+    return flask.render_template('login.html')
+
+
+@viewo_helpdesk.view.view_login.route('/admin/login', methods=['POST'])
+def login_check():
+    user = flask.request.form.get('user', None)
+    password = flask.request.form.get('password', None)
+    if not viewo_helpdesk.api.auth.login(user, password):
+        return flask.render_template('login.html')
+    return flask.redirect(flask.url_for('view_admin.messages_list'))

viewo_helpdesk/view/user.py

@@ -0,0 +1,8 @@
+# =============================================================================
+# C O P Y R I G H T
+# -----------------------------------------------------------------------------
+# Copyright (c) 2020-2023 by Helmut Konrad Schewe. All rights reserved.
+# This file is property of Helmut Konrad Schewe. Any unauthorized copy,
+# use or distribution is an offensive act against international law and may
+# be prosecuted under federal law. Its content is company confidential.
+# =============================================================================

viewo_helpdesk-1.0.0.dist-info/METADATA

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: viewo_helpdesk
+Version: 1.0.0
+Author-email: Helmut Konrad Schewe <helmutus@outlook.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/anaticulae/viewo-helpdesk
+Project-URL: Repository, https://github.com/anaticulae/viewo-helpdesk
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: bootstrap-flask<3.0.0,>=2.6.0
+Requires-Dist: configos<2.0.0,>=1.0.4
+Requires-Dist: flask-login<1.0.0,>=0.6.3
+Requires-Dist: flask<4.0.0,>=3.1.3
+Requires-Dist: flask_bootstrap<4.0.0.0,>=3.3.7.1
+Requires-Dist: utilo<3.0.0,>=2.112.1
+Provides-Extra: dev
+Requires-Dist: utilotest==1.1.1; extra == "dev"
+Dynamic: license-file
+
+# viewo_helpdesk

viewo_helpdesk-1.0.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+viewo_helpdesk/__init__.py,sha256=_BWSdJ9esxh4WHGkO5yhXKQHPVJUtkCBahploX68feQ,1699
+viewo_helpdesk/__main__.py,sha256=KKau-0PKmRFwaMbRys71U3BLt2OKZ5QmxJx6MMzkhqs,942
+viewo_helpdesk/__patch__.py,sha256=TM9PAYPmQhbW1HY3Vx-bS5rXe132Z02TPBxFMad80Dk,552
+viewo_helpdesk/app.py,sha256=_-DpE7y0k8Vz0QWfCYzTUqlyC4-IPEV0hy9OctUqOTc,1587
+viewo_helpdesk/cli.py,sha256=jdWNe8tyuzrKw-mQajMYuvKAsZSXm9SQXx6UPKONbe0,2008
+viewo_helpdesk/config.py,sha256=IxfRcnQBbvRGcrNAIMUejUarMZMRQW3d9astq3PZuAg,1488
+viewo_helpdesk/fixtures.py,sha256=wwLC5MwJyxF-vqUCDfbNGOs4Y6EiE_vLYn04VGJzeS0,1352
+viewo_helpdesk/api/__init__.py,sha256=MyfdL2O_wuLk8x14ROS-bZqFg2iZSKXSnQbFSth-HwU,3015
+viewo_helpdesk/api/auth.py,sha256=LdEHXE00ERTzASqWNCy8FdGR6Yd1TzRPGZQUSE0gB1M,2800
+viewo_helpdesk/api/delete.py,sha256=TM9PAYPmQhbW1HY3Vx-bS5rXe132Z02TPBxFMad80Dk,552
+viewo_helpdesk/api/post.py,sha256=nci1-lVcMfW0ocm4T3aO0oSXWCphHfVuy7wdFS4X6DQ,1749
+viewo_helpdesk/api/present.py,sha256=31hBdxZGf7XHP5dd-03pi6iozYzzWa1ZGHW4NCdakNg,1514
+viewo_helpdesk/message/__init__.py,sha256=exqIdIi5xHWcGmX_oEDRhecqcQvb3gnrWKkX9q6wrm8,979
+viewo_helpdesk/message/action.py,sha256=V5SDoS337ae5MusHxknVJwF_BrFilthDfT2Z12cHd6o,1766
+viewo_helpdesk/message/collect.py,sha256=-fo3lRztOCs1QQ3-iPOk-vdZeLv0ossvAPNctTf_guE,3308
+viewo_helpdesk/message/path.py,sha256=Lu6jjUljsLJx2W7mU4odOZptJBDMVbf52j2ttoGQ1ws,699
+viewo_helpdesk/message/serialize.py,sha256=rErbc3L3fSz_--3ssfYJQh3RGrM-VY2VYcRX2JptBy8,713
+viewo_helpdesk/templates/base.html,sha256=Two9-YlQ55FGUdWaqewfqH-MB-rEnlinkMepnvgisXY,350
+viewo_helpdesk/templates/helper.mac,sha256=onguVAgxweL9p9CFa61Qk4fk_i3h9SsXxlOuKDUkvFE,698
+viewo_helpdesk/templates/login.html,sha256=Ka_-QDpIJJjmbq1-boEfGWOPE6BJz5qDRAk4RRFtGuE,2358
+viewo_helpdesk/templates/user.html,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+viewo_helpdesk/templates/admin/base.html,sha256=9dyd8Wg_RHnK30ZHMiQqY7evUgs0_7PR_kBHXoXxTUY,195
+viewo_helpdesk/templates/admin/index.html,sha256=sJmvv5VkAaOiweBvbSGzFXjXoSKYt-nKMLYeZF5Wem0,762
+viewo_helpdesk/templates/admin/reply.html,sha256=BUysg0eT1PEL_mX_-OEDkwwvftuTO9ixV0GCJBDpnOs,115
+viewo_helpdesk/templates/admin/show.html,sha256=L7x6QlLodI72nk09twiDi1Vvw0TyDjGLap_kltcRQDg,538
+viewo_helpdesk/view/__init__.py,sha256=NMy7eEjsXY8S5FjpbqOzoWOSTcvcI_ggshDKniZOOSw,875
+viewo_helpdesk/view/admin.py,sha256=ts26rAWYmiFH4uOgMdO56BQ0byLUiC5fpsL9T6IFdt4,1906
+viewo_helpdesk/view/login.py,sha256=VgftdbopEbYYSiBm7rlrHXok4txnWHvQU1MDt-v8f5w,1339
+viewo_helpdesk/view/user.py,sha256=TM9PAYPmQhbW1HY3Vx-bS5rXe132Z02TPBxFMad80Dk,552
+viewo_helpdesk-1.0.0.dist-info/licenses/LICENSE,sha256=9jV_XivjSpyzpEYIFKZGcjDzX8invw3EHEJsGXmGJbA,1077
+viewo_helpdesk-1.0.0.dist-info/METADATA,sha256=hzhnGwt-vE-f_iedC7TNkCh6VQH5n3ilqUyMoOKdMN0,870
+viewo_helpdesk-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+viewo_helpdesk-1.0.0.dist-info/entry_points.txt,sha256=Bw7baWjSPUNt3Gb7gi-pu-DsOgbcJUtihhmxGTKRSzw,59
+viewo_helpdesk-1.0.0.dist-info/top_level.txt,sha256=KHOSvNubdgwrbDv4TTRsCr3WPYnMv2kmDwx-118c6Fw,15
+viewo_helpdesk-1.0.0.dist-info/RECORD,,

viewo_helpdesk-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

viewo_helpdesk-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+viewo_helpdesk = viewo_helpdesk.cli:main

viewo_helpdesk-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Helmut Konrad Schewe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

viewo_helpdesk-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+viewo_helpdesk