Added the account management.

src/accounting/account/views.py

@@ -0,0 +1,160 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/1/30
+
+#  Copyright (c) 2023 imacat.
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+"""The views for the account management.
+
+"""
+from urllib.parse import parse_qsl, urlencode
+
+from flask import Blueprint, render_template, session, redirect, flash, \
+    url_for, request
+from werkzeug.datastructures import ImmutableMultiDict
+
+from accounting.database import db
+from accounting.locale import lazy_gettext
+from accounting.utils.pagination import Pagination
+from accounting.utils.permission import can_view, has_permission, can_edit
+from .forms import AccountForm, sort_accounts_in
+from .models import Account
+
+bp: Blueprint = Blueprint("account", __name__)
+"""The view blueprint for the account management."""
+
+
+@bp.get("", endpoint="list")
+@has_permission(can_view)
+def list_accounts() -> str:
+    """Lists the base accounts.
+
+    :return: The account list.
+    """
+    from .models import BaseAccount
+    from .query import get_account_query
+    accounts: list[BaseAccount] = get_account_query()
+    pagination: Pagination = Pagination[BaseAccount](accounts)
+    return render_template("accounting/account/list.html",
+                           list=pagination.list, pagination=pagination)
+
+
+@bp.get("/create", endpoint="create")
+@has_permission(can_edit)
+def show_add_account_form() -> str:
+    """Shows the form to add an account.
+
+    :return: The form to add an account.
+    """
+    if "form" in session:
+        form = AccountForm(ImmutableMultiDict(parse_qsl(session["form"])))
+        del session["form"]
+        form.validate()
+    else:
+        form = AccountForm()
+    return render_template("accounting/account/create.html",
+                           form=form)
+
+
+@bp.post("/store", endpoint="store")
+@has_permission(can_edit)
+def add_account() -> redirect:
+    """Adds an account.
+
+    :return: The redirection to the account detail on success, or the account
+        creation form on error.
+    """
+    form = AccountForm(request.form)
+    if not form.validate():
+        for key in form.errors:
+            for error in form.errors[key]:
+                flash(error, "error")
+        session["form"] = urlencode(list(request.form.items()))
+        return redirect(url_for("accounting.account.create"))
+    account: Account = Account()
+    form.populate_obj(account)
+    db.session.add(account)
+    db.session.commit()
+    flash(lazy_gettext("The account is added successfully"), "success")
+    return redirect(url_for("accounting.account.detail", account=account))
+
+
+@bp.get("/<account:account>", endpoint="detail")
+@has_permission(can_view)
+def show_account_detail(account: Account) -> str:
+    """Shows the account detail.
+
+    :return: The account detail.
+    """
+    return render_template("accounting/account/detail.html", obj=account)
+
+
+@bp.get("/<account:account>/edit", endpoint="edit")
+@has_permission(can_edit)
+def show_account_edit_form(account: Account) -> str:
+    """Shows the form to edit an account.
+
+    :return: The form to edit an account.
+    """
+    form: AccountForm
+    if "form" in session:
+        form = AccountForm(ImmutableMultiDict(parse_qsl(session["form"])))
+        del session["form"]
+        form.validate()
+    else:
+        form = AccountForm(obj=account)
+    return render_template("accounting/account/edit.html",
+                           account=account, form=form)
+
+
+@bp.post("/<account:account>/update", endpoint="update")
+@has_permission(can_edit)
+def update_account(account: Account) -> redirect:
+    """Updates an account.
+
+    :return: The redirection to the account detail on success, or the account
+        edit form on error.
+    """
+    form = AccountForm(request.form)
+    if not form.validate():
+        for key in form.errors:
+            for error in form.errors[key]:
+                flash(error, "error")
+        session["form"] = urlencode(list(request.form.items()))
+        return redirect(url_for("accounting.account.edit", account=account))
+    with db.session.no_autoflush:
+        form.populate_obj(account)
+    if not db.session.is_modified(account):
+        flash(lazy_gettext("The account was not modified."), "success")
+        return redirect(url_for("accounting.account.detail", account=account))
+    form.post_update(account)
+    db.session.commit()
+    flash(lazy_gettext("The account is updated successfully."), "success")
+    return redirect(url_for("accounting.account.detail", account=account))
+
+
+@bp.post("/<account:account>/delete", endpoint="delete")
+@has_permission(can_edit)
+def delete_account(account: Account) -> redirect:
+    """Deletes an account.
+
+    :return: The redirection to the account list on success, or the account
+        detail on error.
+    """
+    for l10n in account.l10n:
+        db.session.delete(l10n)
+    db.session.delete(account)
+    sort_accounts_in(account.base_code, account.id)
+    db.session.commit()
+    flash(lazy_gettext("The account is deleted successfully."), "success")
+    return redirect(url_for("accounting.account.list"))