Advanced to version 1.3.3.

Added permission checks to the reset routes in the test site.
Changed the "_journal_entries" and "_line_items" properties in the BaseTestData class from protected to private, renaming them to "__journal_entries" and "__line_items", respectively. There is no need to access it from the child classes anymore.
2023-04-13 09:56:16 +08:00 · 2023-04-13 09:54:20 +08:00 · 2023-04-13 09:28:53 +08:00 · 2023-04-13 09:25:50 +08:00 · 2023-04-13 09:23:57 +08:00 · 2023-04-13 08:30:07 +08:00
21 changed files with 1005 additions and 375 deletions
--- a/README.rst
+++ b/README.rst
@ -7,7 +7,8 @@ Description
 ===========

 *Mia! Accounting* is an accounting module for Flask_ applications.
-It implements `double-entry bookkeeping`_, and generates the following
+It is designed both for mobile and desktop environments.  It
+implements `double-entry bookkeeping`_.  It generates the following
 accounting reports:

 * Trial balance
@ -18,6 +19,18 @@ In addition, *Mia! Accounting* tracks offsets for unpaid payables and
 receivables.


+Live Demonstration and Test Site
+================================
+
+There is a `live demonstration`_ for *Mia! Accounting*.  It runs the
+same code as the `test site`_ in the `source distribution`_.  It is
+the simplest website that works with *Mia! Accounting*.  It is also
+used in the automatic tests.
+
+If you do not have a running Flask application or do not know how to
+start one, you may start with the test site.
+
+
 Installation
 ============

@ -27,22 +40,10 @@ Install *Mia! Accounting* with ``pip``:

    pip install mia-accounting

-You may also download the from the `PyPI project page`_ or the
+You may also download from the `PyPI project page`_ or the
 `release page`_ on the `Git repository`_.


-Test Site and Live Demonstration
-================================
-
-You may find a working example in the `test site`_ in the
-`source distribution`_.  It is the simplest website that works with
-*Mia! Accounting*.  It is used in the automatic tests.  It is the same
-code run for `live demonstration`_.
-
-If you do not have a running Flask application or do not know how to
-start one, you may start with the test site.
-
-
 Prerequisites
 =============

@ -191,9 +192,9 @@ Authors

 .. _Flask: https://flask.palletsprojects.com
 .. _double-entry bookkeeping: https://en.wikipedia.org/wiki/Double-entry_bookkeeping
+.. _live demonstration: https://accounting.imacat.idv.tw
 .. _test site: https://github.com/imacat/mia-accounting/tree/main/tests/test_site
 .. _source distribution: https://pypi.org/project/mia-accounting/#files
-.. _live demonstration: https://accounting.imacat.idv.tw
 .. _PyPI project page: https://pypi.org/project/mia-accounting
 .. _release page: https://github.com/imacat/mia-accounting/releases
 .. _Git repository: https://github.com/imacat/mia-accounting
@ -204,6 +205,5 @@ Authors
 .. _Tempus-Dominus: https://getdatepicker.com
 .. _UserUtilityInterface: https://mia-accounting.readthedocs.io/en/latest/accounting.utils.html#accounting.utils.user.UserUtilityInterface
 .. _init_app: https://mia-accounting.readthedocs.io/en/latest/accounting.html#accounting.init_app
-.. _flask_sqlalchemy.SQLAlchemy.create_all: https://flask-sqlalchemy.palletsprojects.com/en/3.0.x/api/#flask_sqlalchemy.SQLAlchemy.create_all
 .. _Bootstrap navigation bar: https://getbootstrap.com/docs/5.3/components/navbar/
 .. _documentation on Read the Docs: https://mia-accounting.readthedocs.io
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@ -13,7 +13,7 @@ sys.path.insert(0, os.path.abspath('../../src/'))
 project = 'Mia! Accounting'
 copyright = '2023, imacat'
 author = 'imacat'
-release = '1.3.0'
+release = '1.3.3'

 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
--- a/docs/source/intro.rst
+++ b/docs/source/intro.rst
@ -2,7 +2,8 @@ Introduction
 ============

 *Mia! Accounting* is an accounting module for Flask_ applications.
-It implements `double-entry bookkeeping`_, and generates the following
+It is designed both for mobile and desktop environments.  It
+implements `double-entry bookkeeping`_.  It generates the following
 accounting reports:

 * Trial balance
@ -13,6 +14,18 @@ In addition, *Mia! Accounting* tracks offsets for unpaid payables and
 receivables.


+Live Demonstration and Test Site
+--------------------------------
+
+There is a `live demonstration`_ for *Mia! Accounting*.  It runs the
+same code as the `test site`_ in the `source distribution`_.  It is
+the simplest website that works with *Mia! Accounting*.  It is also
+used in the automatic tests.
+
+If you do not have a running Flask application or do not know how to
+start one, you may start with the test site.
+
+
 Installation
 ------------

@ -22,22 +35,10 @@ Install *Mia! Accounting* with ``pip``:

    pip install mia-accounting

-You may also download the from the `PyPI project page`_ or the
+You may also download from the `PyPI project page`_ or the
 `release page`_ on the `Git repository`_.


-Test Site and Live Demonstration
--------------------------------
-
-You may find a working example in the `test site`_ in the
-`source distribution`_.  It is the simplest website that works with
-*Mia! Accounting*.  It is used in the automatic tests.  It is the same
-code run for `live demonstration`_.
-
-If you do not have a running Flask application or do not know how to
-start one, you may start with the test site.
-
-
 Prerequisites
 -------------

@ -110,9 +111,9 @@ Refer to the `documentation on Read the Docs`_.

 .. _Flask: https://flask.palletsprojects.com
 .. _double-entry bookkeeping: https://en.wikipedia.org/wiki/Double-entry_bookkeeping
+.. _live demonstration: https://accounting.imacat.idv.tw
 .. _test site: https://github.com/imacat/mia-accounting/tree/main/tests/test_site
 .. _source distribution: https://pypi.org/project/mia-accounting/#files
-.. _live demonstration: https://accounting.imacat.idv.tw
 .. _PyPI project page: https://pypi.org/project/mia-accounting
 .. _release page: https://github.com/imacat/mia-accounting/releases
 .. _Git repository: https://github.com/imacat/mia-accounting
@ -121,6 +122,5 @@ Refer to the `documentation on Read the Docs`_.
 .. _FontAwesome: https://fontawesome.com
 .. _Decimal.js: https://mikemcl.github.io/decimal.js
 .. _Tempus-Dominus: https://getdatepicker.com
-.. _flask_sqlalchemy.SQLAlchemy.create_all: https://flask-sqlalchemy.palletsprojects.com/en/3.0.x/api/#flask_sqlalchemy.SQLAlchemy.create_all
 .. _Bootstrap navigation bar: https://getbootstrap.com/docs/5.3/components/navbar/
 .. _documentation on Read the Docs: https://mia-accounting.readthedocs.io
--- a/pyproject.toml
+++ b/pyproject.toml
@ -17,7 +17,7 @@

 [project]
 name = "mia-accounting"
-version = "1.3.0"
+version = "1.3.3"
 description = "A Flask accounting module."
 readme = "README.rst"
 requires-python = ">=3.11"
--- a/src/accounting/journal_entry/converters.py
+++ b/src/accounting/journal_entry/converters.py
@ -20,11 +20,10 @@
 from datetime import date

 from flask import abort
-from sqlalchemy.orm import selectinload
 from werkzeug.routing import BaseConverter

 from accounting import db
-from accounting.models import JournalEntry, JournalEntryLineItem
+from accounting.models import JournalEntry
 from accounting.utils.journal_entry_types import JournalEntryType


--- a/src/accounting/templates/accounting/include/nav.html
+++ b/src/accounting/templates/accounting/include/nav.html
@ -51,12 +51,14 @@ First written: 2023/1/26
          {{ A_("Currencies") }}
        </a>
      </li>
-      <li>
-        <a class="dropdown-item {% if request.endpoint and request.endpoint.startswith("accounting.unmatched-offset.") %} active {% endif %}" href="{{ url_for("accounting.unmatched-offset.dashboard") }}">
-          <i class="fa-solid fa-link-slash"></i>
-          {{ A_("Unmatched Offsets") }}
-        </a>
-      </li>
+      {% if accounting_can_edit() %}
+        <li>
+          <a class="dropdown-item {% if request.endpoint and request.endpoint.startswith("accounting.unmatched-offset.") %} active {% endif %}" href="{{ url_for("accounting.unmatched-offset.dashboard") }}">
+            <i class="fa-solid fa-link-slash"></i>
+            {{ A_("Unmatched Offsets") }}
+          </a>
+        </li>
+      {% endif %}
      {% if accounting_can_admin() %}
        <li>
          <a class="dropdown-item {% if request.endpoint and request.endpoint.startswith("accounting.option.") %} active {% endif %}" href="{{ url_for("accounting.option.detail") }}">
--- a/tests/babel-utils-test-site.py
+++ b/tests/babel-utils-test-site.py
@ -129,5 +129,5 @@ def __update_file_rev_date(file: Path) -> None:
 main.add_command(babel_extract)
 main.add_command(babel_compile)

-if __name__ == '__main__':
+if __name__ == "__main__":
    main()
--- a/tests/babel-utils.py
+++ b/tests/babel-utils.py
@ -129,5 +129,5 @@ def __update_file_rev_date(file: Path) -> None:
 main.add_command(babel_extract)
 main.add_command(babel_compile)

-if __name__ == '__main__':
+if __name__ == "__main__":
    main()
--- a/tests/test_offset.py
+++ b/tests/test_offset.py
@ -26,9 +26,10 @@ import httpx
 from flask import Flask

 from test_site import db
-from testlib import Accounts, create_test_app, get_client, \
-    match_journal_entry_detail, JournalEntryLineItemData, \
-    JournalEntryCurrencyData, JournalEntryData, BaseTestData
+from test_site.lib import JournalEntryLineItemData, JournalEntryCurrencyData, \
+    JournalEntryData, BaseTestData
+from testlib import NEXT_URI, Accounts, create_test_app, get_client, \
+    match_journal_entry_detail

 PREFIX: str = "/accounting/journal-entries"
 """The URL prefix for the journal entry management."""
@ -51,8 +52,8 @@ class OffsetTestCase(unittest.TestCase):
            JournalEntryLineItem.query.delete()

        self.client, self.csrf_token = get_client(self.app, "editor")
-        self.data: OffsetTestData = OffsetTestData(
-            self.app, self.client, self.csrf_token)
+        self.data: OffsetTestData = OffsetTestData(self.app, "editor")
+        self.data.populate()

    def test_add_receivable_offset(self) -> None:
        """Tests to add the receivable offset.
@ -84,14 +85,14 @@ class OffsetTestCase(unittest.TestCase):
                     original_line_item=self.data.l_r_or3d)])])

        # Non-existing original line item ID
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-original_line_item_id"] = "9999"
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)

        # The same debit or credit
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-original_line_item_id"] \
            = str(self.data.l_p_or1c.id)
        form["currency-1-credit-1-account_code"] = self.data.l_p_or1c.account
@ -106,7 +107,8 @@ class OffsetTestCase(unittest.TestCase):
            account.is_need_offset = False
            db.session.commit()
        response = self.client.post(
-            store_uri, data=journal_entry_data.new_form(self.csrf_token))
+            store_uri,
+            data=journal_entry_data.new_form(self.csrf_token, NEXT_URI))
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)
        with self.app.app_context():
@ -115,7 +117,7 @@ class OffsetTestCase(unittest.TestCase):
            db.session.commit()

        # The original line item is also an offset
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-original_line_item_id"] \
            = str(self.data.l_p_of1d.id)
        form["currency-1-credit-1-account_code"] = self.data.l_p_of1d.account
@ -124,21 +126,21 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], create_uri)

        # Not the same currency
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-code"] = "EUR"
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)

        # Not the same account
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-account_code"] = Accounts.NOTES_RECEIVABLE
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)

        # Not exceeding net balance - partially offset
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-amount"] \
            = str(journal_entry_data.currencies[0].credit[0].amount
                  + Decimal("0.01"))
@ -147,7 +149,7 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], create_uri)

        # Not exceeding net balance - unmatched
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-3-amount"] \
            = str(journal_entry_data.currencies[0].credit[2].amount
                  + Decimal("0.01"))
@ -158,14 +160,14 @@ class OffsetTestCase(unittest.TestCase):
        # Not before the original line items
        old_days = journal_entry_data.days
        journal_entry_data.days = old_days + 1
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)
        journal_entry_data.days = old_days

        # Success
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        journal_entry_id: int \
@ -194,14 +196,14 @@ class OffsetTestCase(unittest.TestCase):
        journal_entry_data.currencies[0].credit[2].amount = Decimal("600")

        # Non-existing original line item ID
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-original_line_item_id"] = "9999"
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # The same debit or credit
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-original_line_item_id"] \
            = str(self.data.l_p_or1c.id)
        form["currency-1-credit-1-account_code"] = self.data.l_p_or1c.account
@ -217,7 +219,8 @@ class OffsetTestCase(unittest.TestCase):
            account.is_need_offset = False
            db.session.commit()
        response = self.client.post(
-            update_uri, data=journal_entry_data.update_form(self.csrf_token))
+            update_uri,
+            data=journal_entry_data.update_form(self.csrf_token, NEXT_URI))
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)
        with self.app.app_context():
@ -226,7 +229,7 @@ class OffsetTestCase(unittest.TestCase):
            db.session.commit()

        # The original line item is also an offset
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-original_line_item_id"] \
            = str(self.data.l_p_of1d.id)
        form["currency-1-credit-1-account_code"] = self.data.l_p_of1d.account
@ -235,21 +238,21 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not the same currency
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-code"] = "EUR"
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not the same account
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-account_code"] = Accounts.NOTES_RECEIVABLE
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not exceeding net balance - partially offset
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-amount"] \
            = str(journal_entry_data.currencies[0].debit[0].amount
                  + Decimal("0.01"))
@ -261,7 +264,7 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not exceeding net balance - unmatched
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-3-amount"] \
            = str(journal_entry_data.currencies[0].debit[2].amount
                  + Decimal("0.01"))
@ -275,14 +278,14 @@ class OffsetTestCase(unittest.TestCase):
        # Not before the original line items
        old_days: int = journal_entry_data.days
        journal_entry_data.days = old_days + 1
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)
        journal_entry_data.days = old_days

        # Success
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"],
@ -307,21 +310,21 @@ class OffsetTestCase(unittest.TestCase):
        journal_entry_data.currencies[0].credit[1].amount = Decimal("3.4")

        # Not the same currency
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-code"] = "EUR"
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not the same account
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-account_code"] = Accounts.NOTES_RECEIVABLE
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not less than offset total - partially offset
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-amount"] \
            = str(journal_entry_data.currencies[0].debit[0].amount
                  - Decimal("0.01"))
@ -333,7 +336,7 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not less than offset total - fully offset
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-2-amount"] \
            = str(journal_entry_data.currencies[0].debit[1].amount
                  - Decimal("0.01"))
@ -347,21 +350,21 @@ class OffsetTestCase(unittest.TestCase):
        # Not after the offset items
        old_days: int = journal_entry_data.days
        journal_entry_data.days = old_days - 1
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)
        journal_entry_data.days = old_days

        # Not deleting matched original line items
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        del form["currency-1-debit-1-id"]
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Success
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"],
@ -408,14 +411,14 @@ class OffsetTestCase(unittest.TestCase):
                [])])

        # Non-existing original line item ID
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-original_line_item_id"] = "9999"
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)

        # The same debit or credit
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-original_line_item_id"] \
            = str(self.data.l_r_or1d.id)
        form["currency-1-debit-1-account_code"] = self.data.l_r_or1d.account
@ -430,7 +433,8 @@ class OffsetTestCase(unittest.TestCase):
            account.is_need_offset = False
            db.session.commit()
        response = self.client.post(
-            store_uri, data=journal_entry_data.new_form(self.csrf_token))
+            store_uri,
+            data=journal_entry_data.new_form(self.csrf_token, NEXT_URI))
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)
        with self.app.app_context():
@ -439,7 +443,7 @@ class OffsetTestCase(unittest.TestCase):
            db.session.commit()

        # The original line item is also an offset
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-original_line_item_id"] \
            = str(self.data.l_r_of1c.id)
        form["currency-1-debit-1-account_code"] = self.data.l_r_of1c.account
@ -448,21 +452,21 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], create_uri)

        # Not the same currency
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-code"] = "EUR"
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)

        # Not the same account
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-account_code"] = Accounts.NOTES_PAYABLE
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)

        # Not exceeding net balance - partially offset
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-amount"] \
            = str(journal_entry_data.currencies[0].debit[0].amount
                  + Decimal("0.01"))
@ -471,7 +475,7 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], create_uri)

        # Not exceeding net balance - unmatched
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-3-amount"] \
            = str(journal_entry_data.currencies[0].debit[2].amount
                  + Decimal("0.01"))
@ -482,14 +486,14 @@ class OffsetTestCase(unittest.TestCase):
        # Not before the original line items
        old_days: int = journal_entry_data.days
        journal_entry_data.days = old_days + 1
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], create_uri)
        journal_entry_data.days = old_days

        # Success
-        form = journal_entry_data.new_form(self.csrf_token)
+        form = journal_entry_data.new_form(self.csrf_token, NEXT_URI)
        response = self.client.post(store_uri, data=form)
        self.assertEqual(response.status_code, 302)
        journal_entry_id: int \
@ -518,14 +522,14 @@ class OffsetTestCase(unittest.TestCase):
        journal_entry_data.currencies[0].credit[2].amount = Decimal("900")

        # Non-existing original line item ID
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-original_line_item_id"] = "9999"
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # The same debit or credit
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-original_line_item_id"] \
            = str(self.data.l_r_or1d.id)
        form["currency-1-debit-1-account_code"] = self.data.l_r_or1d.account
@ -541,7 +545,8 @@ class OffsetTestCase(unittest.TestCase):
            account.is_need_offset = False
            db.session.commit()
        response = self.client.post(
-            update_uri, data=journal_entry_data.update_form(self.csrf_token))
+            update_uri,
+            data=journal_entry_data.update_form(self.csrf_token, NEXT_URI))
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)
        with self.app.app_context():
@ -550,7 +555,7 @@ class OffsetTestCase(unittest.TestCase):
            db.session.commit()

        # The original line item is also an offset
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-original_line_item_id"] \
            = str(self.data.l_r_of1c.id)
        form["currency-1-debit-1-account_code"] = self.data.l_r_of1c.account
@ -559,21 +564,21 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not the same currency
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-code"] = "EUR"
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not the same account
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-account_code"] = Accounts.NOTES_PAYABLE
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not exceeding net balance - partially offset
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-amount"] \
            = str(journal_entry_data.currencies[0].debit[0].amount
                  + Decimal("0.01"))
@ -585,7 +590,7 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not exceeding net balance - unmatched
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-3-amount"] \
            = str(journal_entry_data.currencies[0].debit[2].amount
                  + Decimal("0.01"))
@ -599,14 +604,14 @@ class OffsetTestCase(unittest.TestCase):
        # Not before the original line items
        old_days: int = journal_entry_data.days
        journal_entry_data.days = old_days + 1
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)
        journal_entry_data.days = old_days

        # Success
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        journal_entry_id: int \
@ -635,21 +640,21 @@ class OffsetTestCase(unittest.TestCase):
        journal_entry_data.currencies[0].credit[1].amount = Decimal("0.9")

        # Not the same currency
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-code"] = "EUR"
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not the same account
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-credit-1-account_code"] = Accounts.NOTES_PAYABLE
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not less than offset total - partially offset
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-1-amount"] \
            = str(journal_entry_data.currencies[0].debit[0].amount
                  - Decimal("0.01"))
@ -661,7 +666,7 @@ class OffsetTestCase(unittest.TestCase):
        self.assertEqual(response.headers["Location"], edit_uri)

        # Not less than offset total - fully offset
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        form["currency-1-debit-2-amount"] \
            = str(journal_entry_data.currencies[0].debit[1].amount
                  - Decimal("0.01"))
@ -675,21 +680,21 @@ class OffsetTestCase(unittest.TestCase):
        # Not after the offset items
        old_days: int = journal_entry_data.days
        journal_entry_data.days = old_days - 1
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)
        journal_entry_data.days = old_days

        # Not deleting matched original line items
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        del form["currency-1-credit-1-id"]
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"], edit_uri)

        # Success
-        form = journal_entry_data.update_form(self.csrf_token)
+        form = journal_entry_data.update_form(self.csrf_token, NEXT_URI)
        response = self.client.post(update_uri, data=form)
        self.assertEqual(response.status_code, 302)
        self.assertEqual(response.headers["Location"],
--- a/tests/test_report.py
+++ b/tests/test_report.py
@ -23,7 +23,8 @@ from datetime import date
 import httpx
 from flask import Flask

-from testlib import create_test_app, get_client, Accounts, BaseTestData
+from test_site.lib import BaseTestData
+from testlib import create_test_app, get_client, Accounts

 PREFIX: str = "/accounting"
 """The URL prefix for the reports."""
@ -55,7 +56,7 @@ class ReportTestCase(unittest.TestCase):
        :return: None.
        """
        client, csrf_token = get_client(self.app, "nobody")
-        ReportTestData(self.app, self.client, self.csrf_token)
+        ReportTestData(self.app, "editor").populate()
        response: httpx.Response

        response = client.get(PREFIX)
@ -130,7 +131,7 @@ class ReportTestCase(unittest.TestCase):
        :return: None.
        """
        client, csrf_token = get_client(self.app, "viewer")
-        ReportTestData(self.app, self.client, self.csrf_token)
+        ReportTestData(self.app, "editor").populate()
        response: httpx.Response

        response = client.get(PREFIX)
@ -215,7 +216,7 @@ class ReportTestCase(unittest.TestCase):

        :return: None.
        """
-        ReportTestData(self.app, self.client, self.csrf_token)
+        ReportTestData(self.app, "editor").populate()
        response: httpx.Response

        response = self.client.get(PREFIX)
--- a/tests/test_site/init.py
+++ b/tests/test_site/init.py
@ -22,7 +22,8 @@ import typing as t
 from secrets import token_urlsafe

 from click.testing import Result
-from flask import Flask, Blueprint, render_template, redirect, Response
+from flask import Flask, Blueprint, render_template, redirect, Response, \
+    url_for
 from flask.testing import FlaskCliRunner
 from flask_babel_js import BabelJS
 from flask_sqlalchemy import SQLAlchemy
@ -70,6 +71,9 @@ def create_app(is_testing: bool = False) -> Flask:
    from . import auth
    auth.init_app(app)

+    from . import reset
+    reset.init_app(app)
+
    class UserUtilities(accounting.UserUtilityInterface[auth.User]):

        def can_view(self) -> bool:
@ -86,7 +90,8 @@ def create_app(is_testing: bool = False) -> Flask:
                and auth.current_user().username == "admin"

        def unauthorized(self) -> Response:
-            return redirect("/login")
+            from accounting.utils.next_uri import append_next
+            return redirect(append_next(url_for("auth.login-form")))

        @property
        def cls(self) -> t.Type[auth.User]:
--- a/tests/test_site/auth.py
+++ b/tests/test_site/auth.py
@ -17,8 +17,10 @@
 """The authentication for the Mia! Accounting demonstration website.

 """
+import typing as t
+
 from flask import Blueprint, render_template, Flask, redirect, url_for, \
-    session, request, g
+    session, request, g, Response, abort

 from . import db

@ -44,11 +46,13 @@ class User(db.Model):


@bp.get("login", endpoint="login-form")
-def show_login_form() -> str:
+def show_login_form() -> str | Response:
    """Shows the login form.

    :return: The login form.
    """
+    if "user" in session:
+        return redirect(url_for("accounting-report.default"))
    return render_template("login.html")


@ -58,11 +62,12 @@ def login() -> redirect:

    :return: The redirection to the home page.
    """
+    from accounting.utils.next_uri import inherit_next, or_next
    if request.form.get("username") not in {"viewer", "editor", "admin",
                                            "nobody"}:
-        return redirect(url_for("auth.login"))
+        return redirect(inherit_next(url_for("auth.login")))
    session["user"] = request.form.get("username")
-    return redirect(url_for("home.home"))
+    return redirect(or_next(url_for("accounting-report.default")))


@bp.post("logout", endpoint="logout")
@ -90,6 +95,31 @@ def current_user() -> User | None:
    return g.user


+def admin_required(view: t.Callable) -> t.Callable:
+    """The view decorator to require the user to be an administrator.
+
+    :param view: The view.
+    :return: The decorated view.
+    """
+
+    def decorated_view(*args, **kwargs):
+        """The decorated view that tests against a permission rule.
+
+        :param args: The arguments of the view.
+        :param kwargs: The keyword arguments of the view.
+        :return: The response of the view.
+        :raise Forbidden: When the user is denied.
+        """
+        from accounting.utils.next_uri import append_next
+        if "user" not in session:
+            return redirect(append_next(url_for("auth.login")))
+        if session["user"] != "admin":
+            abort(403)
+        return view(*args, **kwargs)
+
+    return decorated_view
+
+
 def init_app(app: Flask) -> None:
    """Initialize the localization.

--- a/tests/test_site/lib.py
+++ b/tests/test_site/lib.py
@ -0,0 +1,335 @@
+# The Mia! Accounting Demonstration Website.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/4/13
+
+#  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 common library for the Mia! Accounting demonstration website.
+
+"""
+from __future__ import annotations
+
+import typing as t
+from abc import ABC, abstractmethod
+from datetime import date, timedelta
+from decimal import Decimal
+from secrets import randbelow
+
+import sqlalchemy as sa
+from flask import Flask
+
+from . import db
+from .auth import User
+
+
+class Accounts:
+    """The shortcuts to the common accounts."""
+    CASH: str = "1111-001"
+    BANK: str = "1113-001"
+    RECEIVABLE: str = "1141-001"
+    MACHINERY: str = "1441-001"
+    PAYABLE: str = "2141-001"
+    SERVICE: str = "4611-001"
+    RENT_EXPENSE: str = "6252-001"
+    MEAL: str = "6272-001"
+
+
+class JournalEntryLineItemData:
+    """The journal entry line item data."""
+
+    def __init__(self, account: str, description: str | None, amount: str,
+                 original_line_item: JournalEntryLineItemData | None = None):
+        """Constructs the journal entry line item data.
+
+        :param account: The account code.
+        :param description: The description.
+        :param amount: The amount.
+        :param original_line_item: The original journal entry line item.
+        """
+        self.journal_entry: JournalEntryData | None = None
+        self.id: int = -1
+        self.no: int = -1
+        self.original_line_item: JournalEntryLineItemData | None \
+            = original_line_item
+        self.account: str = account
+        self.description: str | None = description
+        self.amount: Decimal = Decimal(amount)
+
+    def form(self, prefix: str, debit_credit: str, index: int,
+             is_update: bool) -> dict[str, str]:
+        """Returns the line item as form data.
+
+        :param prefix: The prefix of the form fields.
+        :param debit_credit: Either "debit" or "credit".
+        :param index: The line item index.
+        :param is_update: True for an update operation, or False otherwise
+        :return: The form data.
+        """
+        prefix = f"{prefix}-{debit_credit}-{index}"
+        form: dict[str, str] = {f"{prefix}-account_code": self.account,
+                                f"{prefix}-description": self.description,
+                                f"{prefix}-amount": str(self.amount)}
+        if is_update and self.id != -1:
+            form[f"{prefix}-id"] = str(self.id)
+        form[f"{prefix}-no"] = str(index) if self.no == -1 else str(self.no)
+        if self.original_line_item is not None:
+            assert self.original_line_item.id != -1
+            form[f"{prefix}-original_line_item_id"] \
+                = str(self.original_line_item.id)
+        return form
+
+
+class JournalEntryCurrencyData:
+    """The journal entry currency data."""
+
+    def __init__(self, currency: str, debit: list[JournalEntryLineItemData],
+                 credit: list[JournalEntryLineItemData]):
+        """Constructs the journal entry currency data.
+
+        :param currency: The currency code.
+        :param debit: The debit line items.
+        :param credit: The credit line items.
+        """
+        self.code: str = currency
+        self.debit: list[JournalEntryLineItemData] = debit
+        self.credit: list[JournalEntryLineItemData] = credit
+
+    def form(self, index: int, is_update: bool) -> dict[str, str]:
+        """Returns the currency as form data.
+
+        :param index: The currency index.
+        :param is_update: True for an update operation, or False otherwise
+        :return: The form data.
+        """
+        prefix: str = f"currency-{index}"
+        form: dict[str, str] = {f"{prefix}-code": self.code}
+        for i in range(len(self.debit)):
+            form.update(self.debit[i].form(prefix, "debit", i + 1, is_update))
+        for i in range(len(self.credit)):
+            form.update(self.credit[i].form(prefix, "credit", i + 1,
+                                            is_update))
+        return form
+
+
+class JournalEntryData:
+    """The journal entry data."""
+
+    def __init__(self, days: int, currencies: list[JournalEntryCurrencyData]):
+        """Constructs a journal entry.
+
+        :param days: The number of days before today.
+        :param currencies: The journal entry currency data.
+        """
+        self.id: int = -1
+        self.days: int = days
+        self.currencies: list[JournalEntryCurrencyData] = currencies
+        self.note: str | None = None
+        for currency in self.currencies:
+            for line_item in currency.debit:
+                line_item.journal_entry = self
+            for line_item in currency.credit:
+                line_item.journal_entry = self
+
+    def new_form(self, csrf_token: str, next_uri: str) -> dict[str, str]:
+        """Returns the journal entry as a creation form.
+
+        :param csrf_token: The CSRF token.
+        :param next_uri: The next URI.
+        :return: The journal entry as a creation form.
+        """
+        return self.__form(csrf_token, next_uri, is_update=False)
+
+    def update_form(self, csrf_token: str, next_uri: str) -> dict[str, str]:
+        """Returns the journal entry as an update form.
+
+        :param csrf_token: The CSRF token.
+        :param next_uri: The next URI.
+        :return: The journal entry as an update form.
+        """
+        return self.__form(csrf_token, next_uri, is_update=True)
+
+    def __form(self, csrf_token: str, next_uri: str, is_update: bool = False) \
+            -> dict[str, str]:
+        """Returns the journal entry as a form.
+
+        :param csrf_token: The CSRF token.
+        :param next_uri: The next URI.
+        :param is_update: True for an update operation, or False otherwise
+        :return: The journal entry as a form.
+        """
+        journal_entry_date: date = date.today() - timedelta(days=self.days)
+        form: dict[str, str] = {"csrf_token": csrf_token,
+                                "next": next_uri,
+                                "date": journal_entry_date.isoformat()}
+        for i in range(len(self.currencies)):
+            form.update(self.currencies[i].form(i + 1, is_update))
+        if self.note is not None:
+            form["note"] = self.note
+        return form
+
+
+class BaseTestData(ABC):
+    """The base test data."""
+
+    def __init__(self, app: Flask, username: str):
+        """Constructs the test data.
+
+        :param app: The Flask application.
+        :param username: The username.
+        """
+        self._app: Flask = app
+        with self._app.app_context():
+            current_user: User | None = User.query\
+                .filter(User.username == username).first()
+            assert current_user is not None
+            self.__current_user_id: int = current_user.id
+            self.__journal_entries: list[dict[str, t.Any]] = []
+            self.__line_items: list[dict[str, t.Any]] = []
+            self._init_data()
+
+    @abstractmethod
+    def _init_data(self) -> None:
+        """Initializes the test data.
+
+        :return: None
+        """
+
+    def populate(self) -> None:
+        """Populates the data into the database.
+
+        :return: None
+        """
+        from accounting.models import JournalEntry, JournalEntryLineItem
+        with self._app.app_context():
+            db.session.execute(sa.insert(JournalEntry), self.__journal_entries)
+            db.session.execute(sa.insert(JournalEntryLineItem),
+                               self.__line_items)
+            db.session.commit()
+
+    @staticmethod
+    def _couple(description: str, amount: str, debit: str, credit: str) \
+            -> tuple[JournalEntryLineItemData, JournalEntryLineItemData]:
+        """Returns a couple of debit-credit line items.
+
+        :param description: The description.
+        :param amount: The amount.
+        :param debit: The debit account code.
+        :param credit: The credit account code.
+        :return: The debit line item and credit line item.
+        """
+        return JournalEntryLineItemData(debit, description, amount),\
+            JournalEntryLineItemData(credit, description, amount)
+
+    def _add_journal_entry(self, journal_entry_data: JournalEntryData) -> None:
+        """Adds a journal entry.
+
+        :param journal_entry_data: The journal entry data.
+        :return: None.
+        """
+        from accounting.models import Account
+        existing_j_id: set[int] = {x["id"] for x in self.__journal_entries}
+        existing_l_id: set[int] = {x["id"] for x in self.__line_items}
+        journal_entry_data.id = self.__new_id(existing_j_id)
+        j_date: date = date.today() - timedelta(days=journal_entry_data.days)
+        self.__journal_entries.append(
+            {"id": journal_entry_data.id,
+             "date": j_date,
+             "no": self.__next_j_no(j_date),
+             "note": journal_entry_data.note,
+             "created_by_id": self.__current_user_id,
+             "updated_by_id": self.__current_user_id})
+        debit_no: int = 0
+        credit_no: int = 0
+        for currency in journal_entry_data.currencies:
+            for line_item in currency.debit:
+                account: Account | None \
+                    = Account.find_by_code(line_item.account)
+                assert account is not None
+                debit_no = debit_no + 1
+                line_item.id = self.__new_id(existing_l_id)
+                data: dict[str, t.Any] \
+                    = {"id": line_item.id,
+                       "journal_entry_id": journal_entry_data.id,
+                       "is_debit": True,
+                       "no": debit_no,
+                       "account_id": account.id,
+                       "currency_code": currency.code,
+                       "description": line_item.description,
+                       "amount": line_item.amount}
+                if line_item.original_line_item is not None:
+                    data["original_line_item_id"] \
+                        = line_item.original_line_item.id
+                self.__line_items.append(data)
+            for line_item in currency.credit:
+                account: Account | None \
+                    = Account.find_by_code(line_item.account)
+                assert account is not None
+                credit_no = credit_no + 1
+                line_item.id = self.__new_id(existing_l_id)
+                data: dict[str, t.Any] \
+                    = {"id": line_item.id,
+                       "journal_entry_id": journal_entry_data.id,
+                       "is_debit": False,
+                       "no": credit_no,
+                       "account_id": account.id,
+                       "currency_code": currency.code,
+                       "description": line_item.description,
+                       "amount": line_item.amount}
+                if line_item.original_line_item is not None:
+                    data["original_line_item_id"] \
+                        = line_item.original_line_item.id
+                self.__line_items.append(data)
+
+    @staticmethod
+    def __new_id(existing_id: set[int]) -> int:
+        """Generates and returns a new random unique ID.
+
+        :param existing_id: The existing ID.
+        :return: The newly-generated random unique ID.
+        """
+        while True:
+            obj_id: int = 100000000 + randbelow(900000000)
+            if obj_id not in existing_id:
+                existing_id.add(obj_id)
+                return obj_id
+
+    def __next_j_no(self, j_date: date) -> int:
+        """Returns the next journal entry number in a day.
+
+        :param j_date: The journal entry date.
+        :return: The next journal entry number.
+        """
+        existing: set[int] = {x["no"] for x in self.__journal_entries
+                              if x["date"] == j_date}
+        return 1 if len(existing) == 0 else max(existing) + 1
+
+    def _add_simple_journal_entry(
+            self, days: int, currency: str, description: str, amount: str,
+            debit: str, credit: str) \
+            -> tuple[JournalEntryLineItemData, JournalEntryLineItemData]:
+        """Adds a simple journal entry.
+
+        :param days: The number of days before today.
+        :param currency: The currency code.
+        :param description: The description.
+        :param amount: The amount.
+        :param debit: The debit account code.
+        :param credit: The credit account code.
+        :return: The debit line item and credit line item.
+        """
+        debit_item, credit_item = self._couple(
+            description, amount, debit, credit)
+        self._add_journal_entry(JournalEntryData(
+            days, [JournalEntryCurrencyData(
+                currency, [debit_item], [credit_item])]))
+        return debit_item, credit_item
--- a/tests/test_site/reset.py
+++ b/tests/test_site/reset.py
@ -0,0 +1,370 @@
+# The Mia! Accounting Demonstration Website.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/4/12
+
+#  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 data reset for the Mia! Accounting demonstration website.
+
+"""
+from datetime import date, timedelta
+
+from flask import Flask, Blueprint, url_for, flash, redirect, session, \
+    render_template, current_app
+from flask_babel import lazy_gettext
+
+from . import db
+from .auth import admin_required
+from .lib import Accounts, JournalEntryLineItemData, JournalEntryData, \
+    JournalEntryCurrencyData, BaseTestData
+
+bp: Blueprint = Blueprint("reset", __name__, url_prefix="/")
+
+
+@bp.get("reset", endpoint="reset-page")
+@admin_required
+def reset() -> str:
+    """Resets the sample data.
+
+    :return: Redirection to the accounting application.
+    """
+    return render_template("reset.html")
+
+
+@bp.post("sample", endpoint="sample")
+@admin_required
+def reset_sample() -> redirect:
+    """Resets the sample data.
+
+    :return: Redirection to the accounting application.
+    """
+    from accounting.utils.cast import s
+    __reset_database()
+    SampleData(current_app, "editor").populate()
+    flash(s(lazy_gettext(
+        "The sample data are emptied and reset successfully.")), "success")
+    return redirect(url_for("accounting-report.default"))
+
+
+@bp.post("reset", endpoint="clean-up")
+@admin_required
+def clean_up() -> redirect:
+    """Clean-up the database data.
+
+    :return: Redirection to the accounting application.
+    """
+    from accounting.utils.cast import s
+    __reset_database()
+    flash(s(lazy_gettext("The database is emptied successfully.")), "success")
+    return redirect(url_for("accounting-report.default"))
+
+
+def __reset_database() -> None:
+    """Resets the database.
+
+    :return: None.
+    """
+    from accounting.models import Currency, CurrencyL10n, BaseAccount, \
+        BaseAccountL10n, Account, AccountL10n, JournalEntry, \
+        JournalEntryLineItem
+    from accounting.base_account import init_base_accounts_command
+    from accounting.account import init_accounts_command
+    from accounting.currency import init_currencies_command
+
+    JournalEntryLineItem.query.delete()
+    JournalEntry.query.delete()
+    CurrencyL10n.query.delete()
+    Currency.query.delete()
+    AccountL10n.query.delete()
+    Account.query.delete()
+    BaseAccountL10n.query.delete()
+    BaseAccount.query.delete()
+    init_base_accounts_command()
+    init_accounts_command(session["user"])
+    init_currencies_command(session["user"])
+    db.session.commit()
+
+
+class SampleData(BaseTestData):
+    """The sample data."""
+
+    def _init_data(self) -> None:
+        self.__add_recurring()
+        self.__add_offsets()
+        self.__add_meals()
+
+    def __add_recurring(self) -> None:
+        """Adds the recurring data.
+
+        :return: None.
+        """
+        self.__add_usd_recurring()
+        self.__add_twd_recurring()
+
+    def __add_usd_recurring(self) -> None:
+        """Adds the recurring data in USD.
+
+        :return: None.
+        """
+        today: date = date.today()
+        days: int
+        year: int
+        month: int
+
+        # Recurring in USD
+        j_date: date = date(today.year - 5, today.month, today.day)
+        j_date = j_date + timedelta(days=(4 - j_date.weekday()))
+        days = (today - j_date).days
+        while True:
+            if days < 0:
+                break
+            self.__add_journal_entry(
+                days, "USD", "2600",
+                Accounts.BANK, "Transfer", Accounts.SERVICE, "Payroll")
+
+            days = days - 1
+            if days < 0:
+                break
+            self.__add_journal_entry(
+                days, "USD", "1200",
+                Accounts.CASH, None, Accounts.BANK, "Withdraw")
+            days = days - 13
+
+        year = today.year - 5
+        month = today.month
+        while True:
+            month = month + 1
+            if month > 12:
+                year = year + 1
+                month = 1
+            days = (today - date(year, month, 1)).days
+            if days < 0:
+                break
+            self.__add_journal_entry(
+                days, "USD", "1800",
+                Accounts.RENT_EXPENSE, "Rent", Accounts.BANK, "Transfer")
+
+    def __add_twd_recurring(self) -> None:
+        """Adds the recurring data in TWD.
+
+        :return: None.
+        """
+        today: date = date.today()
+
+        year: int = today.year - 5
+        month: int = today.month
+        while True:
+            days: int = (today - date(year, month, 5)).days
+            if days < 0:
+                break
+            self.__add_journal_entry(
+                days, "TWD", "50000",
+                Accounts.BANK, "薪資轉帳", Accounts.SERVICE, "薪水")
+
+            days = days - 1
+            if days < 0:
+                break
+            self.__add_journal_entry(
+                days, "TWD", "25000",
+                Accounts.CASH, None, Accounts.BANK, "提款")
+
+            days = days - 4
+            if days < 0:
+                break
+            self.__add_journal_entry(
+                days, "TWD", "18000",
+                Accounts.RENT_EXPENSE, "房租", Accounts.BANK, "轉帳")
+
+            month = month + 1
+            if month > 12:
+                year = year + 1
+                month = 1
+
+    def __add_offsets(self) -> None:
+        """Adds the offset data.
+
+        :return: None.
+        """
+        days: int
+        year: int
+        month: int
+        description: str
+        line_item_or: JournalEntryLineItemData
+        line_item_of: JournalEntryLineItemData
+
+        # Full offset and unmatched in USD
+        description = "Speaking—Institute"
+        line_item_or = JournalEntryLineItemData(
+            Accounts.RECEIVABLE, description, "120")
+        self._add_journal_entry(JournalEntryData(
+            40, [JournalEntryCurrencyData(
+                "USD", [line_item_or], [JournalEntryLineItemData(
+                    Accounts.SERVICE, description, "120")])]))
+        line_item_of = JournalEntryLineItemData(
+            Accounts.RECEIVABLE, description, "120",
+            original_line_item=line_item_or)
+        self._add_journal_entry(JournalEntryData(
+            5, [JournalEntryCurrencyData(
+                "USD", [JournalEntryLineItemData(
+                    Accounts.BANK, description, "120")],
+                [line_item_of])]))
+        self.__add_journal_entry(
+            30, "USD", "120",
+            Accounts.BANK, description, Accounts.SERVICE, description)
+
+        # Partial offset in USD
+        line_item_or = JournalEntryLineItemData(
+            Accounts.PAYABLE, "Computer", "1600")
+        self._add_journal_entry(JournalEntryData(
+            60, [JournalEntryCurrencyData(
+                "USD", [JournalEntryLineItemData(
+                    Accounts.MACHINERY, "Computer", "1600")],
+                [line_item_or])]))
+        line_item_of = JournalEntryLineItemData(
+            Accounts.PAYABLE, "Computer", "800",
+            original_line_item=line_item_or)
+        self._add_journal_entry(JournalEntryData(
+            35, [JournalEntryCurrencyData(
+                "USD", [line_item_of], [JournalEntryLineItemData(
+                    Accounts.BANK, "Computer", "800")])]))
+        line_item_of = JournalEntryLineItemData(
+            Accounts.PAYABLE, "Computer", "400",
+            original_line_item=line_item_or)
+        self._add_journal_entry(JournalEntryData(
+            10, [JournalEntryCurrencyData(
+                "USD", [line_item_of], [JournalEntryLineItemData(
+                    Accounts.CASH, "Computer", "400")])]))
+
+        # Full offset and unmatched in TWD
+        description = "演講費—母校"
+        line_item_or = JournalEntryLineItemData(
+            Accounts.RECEIVABLE, description, "3000")
+        self._add_journal_entry(JournalEntryData(
+            45, [JournalEntryCurrencyData(
+                "TWD", [line_item_or], [JournalEntryLineItemData(
+                    Accounts.SERVICE, description, "3000")])]))
+        line_item_of = JournalEntryLineItemData(
+            Accounts.RECEIVABLE, description, "3000",
+            original_line_item=line_item_or)
+        self._add_journal_entry(JournalEntryData(
+            6, [JournalEntryCurrencyData(
+                "TWD", [JournalEntryLineItemData(
+                    Accounts.BANK, description, "3000")],
+                [line_item_of])]))
+        self.__add_journal_entry(
+            25, "TWD", "3000",
+            Accounts.BANK, description, Accounts.SERVICE, description)
+
+        # Partial offset in TWD
+        line_item_or = JournalEntryLineItemData(
+            Accounts.PAYABLE, "手機", "30000")
+        self._add_journal_entry(JournalEntryData(
+            55, [JournalEntryCurrencyData(
+                "TWD", [JournalEntryLineItemData(
+                    Accounts.MACHINERY, "手機", "30000")],
+                [line_item_or])]))
+        line_item_of = JournalEntryLineItemData(
+            Accounts.PAYABLE, "手機", "16000",
+            original_line_item=line_item_or)
+        self._add_journal_entry(JournalEntryData(
+            27, [JournalEntryCurrencyData(
+                "TWD", [line_item_of], [JournalEntryLineItemData(
+                    Accounts.BANK, "手機", "16000")])]))
+        line_item_of = JournalEntryLineItemData(
+            Accounts.PAYABLE, "手機", "6000",
+            original_line_item=line_item_or)
+        self._add_journal_entry(JournalEntryData(
+            8, [JournalEntryCurrencyData(
+                "TWD", [line_item_of], [JournalEntryLineItemData(
+                    Accounts.CASH, "手機", "6000")])]))
+
+    def __add_meals(self) -> None:
+        """Adds the meal data.
+
+        :return: None.
+        """
+        days = 60
+        while days >= 0:
+            # Meals in USD
+            if days % 4 == 2:
+                self.__add_journal_entry(
+                    days, "USD", "2.9",
+                    Accounts.MEAL, "Lunch—Coffee", Accounts.CASH, None)
+            else:
+                self.__add_journal_entry(
+                    days, "USD", "3.9",
+                    Accounts.MEAL, "Lunch—Coffee", Accounts.CASH, None)
+
+            if days % 15 == 3:
+                self.__add_journal_entry(
+                    days, "USD", "5.45",
+                    Accounts.MEAL, "Dinner—Pizza",
+                    Accounts.PAYABLE, "Dinner—Pizza")
+            else:
+                self.__add_journal_entry(
+                    days, "USD", "5.9",
+                    Accounts.MEAL, "Dinner—Pasta", Accounts.CASH, None)
+
+            # Meals in TWD
+            if days % 5 == 3:
+                self.__add_journal_entry(
+                    days, "TWD", "125",
+                    Accounts.MEAL, "午餐—鄰家咖啡", Accounts.CASH, None)
+            else:
+                self.__add_journal_entry(
+                    days, "TWD", "80",
+                    Accounts.MEAL, "午餐—便當", Accounts.CASH, None)
+
+            if days % 15 == 3:
+                self.__add_journal_entry(
+                    days, "TWD", "320",
+                    Accounts.MEAL, "晚餐—牛排", Accounts.PAYABLE, "晚餐—牛排")
+            else:
+                self.__add_journal_entry(
+                    days, "TWD", "100",
+                    Accounts.MEAL, "晚餐—自助餐", Accounts.CASH, None)
+
+            days = days - 1
+
+    def __add_journal_entry(
+            self, days: int, currency: str, amount: str,
+            debit_account: str, debit_description: str | None,
+            credit_account: str, credit_description: str | None) -> None:
+        """Adds a simple journal entry.
+
+        :param days: The number of days before today.
+        :param currency: The currency code.
+        :param amount: The amount.
+        :param debit_account: The debit account code.
+        :param debit_description: The debit description.
+        :param credit_account: The credit account code.
+        :param credit_description: The credit description.
+        :return: None.
+        """
+        self._add_journal_entry(JournalEntryData(
+            days,
+            [JournalEntryCurrencyData(
+                currency,
+                [JournalEntryLineItemData(
+                    debit_account, debit_description, amount)],
+                [JournalEntryLineItemData(
+                    credit_account, credit_description, amount)])]))
+
+
+def init_app(app: Flask) -> None:
+    """Initialize the localization.
+
+    :param app: The Flask application.
+    :return: None.
+    """
+    app.register_blueprint(bp)
--- a/tests/test_site/templates/base.html
+++ b/tests/test_site/templates/base.html
@ -72,6 +72,14 @@ First written: 2023/1/27
                  </button>
                </form>
              </li>
+              {% if current_user().username == "admin" %}
+                <li>
+                  <a class="dropdown-item {% if request.endpoint and request.endpoint.startswith("reset.") %} active {% endif %}" href="{{ url_for("reset.reset-page") }}">
+                    <i class="fa-solid fa-rotate-right"></i>
+                    {{ _("Reset") }}
+                  </a>
+                </li>
+              {% endif %}
            </ul>
          </li>
        {% else %}
--- a/tests/test_site/templates/home.html
+++ b/tests/test_site/templates/home.html
@ -21,4 +21,12 @@ First written: 2023/1/27
 #}
 {% extends "base.html" %}

-{% block header %}{% block title %}{{ _("Home") }}{% endblock %}{% endblock %}
+{% block header %}{% block title %}{{ _("Mia! Accounting Live Demonstration") }}{% endblock %}{% endblock %}
+
+{% block content %}
+
+<p>{{ _("This is the live demonstration of the Mia! Accounting project.  Please <a href=\"/login?next=%%2Faccounting\">log in</a> to continue.") }}</p>
+
+<p>{{ _("You may also want to check the <a href=\"https://mia-accounting.readthedocs.io\">full documentation</a> and the <a href=\"https://github.com/imacat/mia-accounting\">Github repository</a>.") }}</p>
+
+{% endblock %}
--- a/tests/test_site/templates/login.html
+++ b/tests/test_site/templates/login.html
@ -27,6 +27,9 @@ First written: 2023/1/27

 <form action="{{ url_for("auth.login") }}" method="post">
  <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+  {% if request.args.next %}
+    <input type="hidden" name="next" value="{{ request.args.next }}">
+  {% endif %}
  <button class="btn btn-primary" type="submit" name="username" value="viewer">{{ _("Viewer") }}</button>
  <button class="btn btn-primary" type="submit" name="username" value="editor">{{ _("Editor") }}</button>
  <button class="btn btn-primary" type="submit" name="username" value="admin">{{ _("Administrator") }}</button>
--- a/tests/test_site/templates/reset.html
+++ b/tests/test_site/templates/reset.html
@ -0,0 +1,48 @@
+{#
+The Mia! Accounting Demonstration Website
+reset.html: The reset page.
+
+ 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.
+
+Author: imacat@mail.imacat.idv.tw (imacat)
+First written: 2023/4/12
+#}
+{% extends "base.html" %}
+
+{% block header %}{% block title %}{{ _("Reset Database") }}{% endblock %}{% endblock %}
+
+{% block content %}
+
+<p>{{ _("Warning: All the current accounting data will be deleted.  This cannot be undone.  Please backup your database first.") }}</p>
+
+<p>{{ _("Database reset is provided by the live demonstration.  This is not part of the Mia! Accounting project.") }}</p>
+
+<form class="mb-2" action="{{ url_for("reset.clean-up") }}" method="post">
+  <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+  {% if request.args.next %}
+    <input type="hidden" name="next" value="{{ request.args.next }}">
+  {% endif %}
+  <button class="btn btn-primary" type="submit">{{ _("Empty the Database") }}</button>
+</form>
+
+<form class="mb-2" action="{{ url_for("reset.sample") }}" method="post">
+  <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
+  {% if request.args.next %}
+    <input type="hidden" name="next" value="{{ request.args.next }}">
+  {% endif %}
+  <button class="btn btn-primary" type="submit">{{ _("Empty and reset the Sample Data") }}</button>
+</form>
+
+{% endblock %}
--- a/tests/test_site/translations/zh_Hant/LC_MESSAGES/messages.po
+++ b/tests/test_site/translations/zh_Hant/LC_MESSAGES/messages.po
@ -9,8 +9,8 @@ msgid ""
 msgstr ""
 "Project-Id-Version: mia-accounting-test-site 1.0.0\n"
 "Report-Msgid-Bugs-To: imacat@mail.imacat.idv.tw\n"
-"POT-Creation-Date: 2023-04-06 02:34+0800\n"
-"PO-Revision-Date: 2023-04-06 02:34+0800\n"
+"POT-Creation-Date: 2023-04-12 17:59+0800\n"
+"PO-Revision-Date: 2023-04-12 18:00+0800\n"
 "Last-Translator: imacat <imacat@mail.imacat.idv.tw>\n"
 "Language: zh_Hant\n"
 "Language-Team: zh_Hant <imacat@mail.imacat.idv.tw>\n"
@ -20,12 +20,19 @@ msgstr ""
 "Content-Transfer-Encoding: 8bit\n"
 "Generated-By: Babel 2.12.1\n"

+#: tests/test_site/reset.py:55
+msgid "The sample data are emptied and reset successfully."
+msgstr "範例資料已清空重設。"
+
+#: tests/test_site/reset.py:68
+msgid "The database is emptied successfully."
+msgstr "資料庫已清空。"
+
 #: tests/test_site/templates/base.html:23
 msgid "en"
 msgstr "zh-Hant"

 #: tests/test_site/templates/base.html:46
-#: tests/test_site/templates/home.html:24
 msgid "Home"
 msgstr "首頁"

@ -33,28 +40,76 @@ msgstr "首頁"
 msgid "Log Out"
 msgstr "登出"

-#: tests/test_site/templates/base.html:81
+#: tests/test_site/templates/base.html:79
+msgid "Reset"
+msgstr "重設"
+
+#: tests/test_site/templates/base.html:89
 #: tests/test_site/templates/login.html:24
 msgid "Log In"
 msgstr "登入"

-#: tests/test_site/templates/base.html:122
+#: tests/test_site/templates/base.html:130
 msgid "Error:"
 msgstr "錯誤："

-#: tests/test_site/templates/login.html:30
+#: tests/test_site/templates/home.html:24
+msgid "Mia! Accounting Live Demonstration"
+msgstr "Mia! Accounting 示範站"
+
+#: tests/test_site/templates/home.html:28
+#, python-format
+msgid ""
+"This is the live demonstration of the Mia! Accounting project.  Please <a"
+" href=\"/login?next=%%2Faccounting\">log in</a> to continue."
+msgstr "這是 Mia! Accounting 專案的示範站。請先<a href=\"/login?next=%%2Faccounting\">登入</a>。"
+
+#: tests/test_site/templates/home.html:30
+msgid ""
+"You may also want to check the <a href=\"https://mia-"
+"accounting.readthedocs.io\">full documentation</a> and the <a "
+"href=\"https://github.com/imacat/mia-accounting\">Github repository</a>."
+msgstr ""
+"詳情請參閱<a href=\"https://mia-accounting.readthedocs.io\">完整說明文件</a>與<a "
+"href=\"https://github.com/imacat/mia-accounting\">Github 專案庫</a>。"
+
+#: tests/test_site/templates/login.html:33
 msgid "Viewer"
 msgstr "讀報表者"

-#: tests/test_site/templates/login.html:31
+#: tests/test_site/templates/login.html:34
 msgid "Editor"
 msgstr "記帳者"

-#: tests/test_site/templates/login.html:32
+#: tests/test_site/templates/login.html:35
 msgid "Administrator"
 msgstr "管理者"

-#: tests/test_site/templates/login.html:33
+#: tests/test_site/templates/login.html:36
 msgid "Nobody"
 msgstr "沒有權限者"

+#: tests/test_site/templates/reset.html:24
+msgid "Reset Database"
+msgstr "資料庫重設"
+
+#: tests/test_site/templates/reset.html:28
+msgid ""
+"Warning: All the current accounting data will be deleted.  This cannot be"
+" undone.  Please backup your database first."
+msgstr "警告：現有資料會全部刪除，無法復原。請先備份您的資料。"
+
+#: tests/test_site/templates/reset.html:30
+msgid ""
+"Database reset is provided by the live demonstration.  This is not part "
+"of the Mia! Accounting project."
+msgstr "資料庫重設是示範站的功能，不是 Mia! Accounting 的功能。"
+
+#: tests/test_site/templates/reset.html:37
+msgid "Empty the Database"
+msgstr "清空資料庫"
+
+#: tests/test_site/templates/reset.html:45
+msgid "Empty and reset the Sample Data"
+msgstr "清空並重設範例資料"
+
--- a/tests/test_unmatched_offset.py
+++ b/tests/test_unmatched_offset.py
@ -23,8 +23,9 @@ import httpx
 from flask import Flask

 from test_site import db
-from testlib import create_test_app, get_client, Accounts, \
-    JournalEntryCurrencyData, JournalEntryData, BaseTestData
+from test_site.lib import JournalEntryCurrencyData, JournalEntryData, \
+    BaseTestData
+from testlib import create_test_app, get_client, Accounts

 PREFIX: str = "/accounting/unmatched-offsets"
 """The URL prefix for the unmatched offset management."""
@ -54,7 +55,7 @@ class UnmatchedOffsetTestCase(unittest.TestCase):
        :return: None.
        """
        client, csrf_token = get_client(self.app, "nobody")
-        DifferentTestData(self.app, self.client, self.csrf_token)
+        DifferentTestData(self.app, "nobody").populate()
        response: httpx.Response

        response = client.get(PREFIX)
@ -73,7 +74,7 @@ class UnmatchedOffsetTestCase(unittest.TestCase):
        :return: None.
        """
        client, csrf_token = get_client(self.app, "viewer")
-        DifferentTestData(self.app, self.client, self.csrf_token)
+        DifferentTestData(self.app, "viewer").populate()
        response: httpx.Response

        response = client.get(PREFIX)
@ -91,7 +92,7 @@ class UnmatchedOffsetTestCase(unittest.TestCase):

        :return: None.
        """
-        DifferentTestData(self.app, self.client, self.csrf_token)
+        DifferentTestData(self.app, "editor").populate()
        response: httpx.Response

        response = self.client.get(PREFIX)
@ -132,8 +133,8 @@ class UnmatchedOffsetTestCase(unittest.TestCase):
        """
        from accounting.models import Account, JournalEntryLineItem
        from accounting.utils.offset_matcher import OffsetMatcher
-        data: DifferentTestData \
-            = DifferentTestData(self.app, self.client, self.csrf_token)
+        data: DifferentTestData = DifferentTestData(self.app, "editor")
+        data.populate()
        account: Account | None
        line_item: JournalEntryLineItem | None
        matcher: OffsetMatcher
@ -248,8 +249,8 @@ class UnmatchedOffsetTestCase(unittest.TestCase):
        """
        from accounting.models import Account, JournalEntryLineItem
        from accounting.utils.offset_matcher import OffsetMatcher
-        data: SameTestData \
-            = SameTestData(self.app, self.client, self.csrf_token)
+        data: SameTestData = SameTestData(self.app, "editor")
+        data.populate()
        account: Account | None
        line_item: JournalEntryLineItem | None
        matcher: OffsetMatcher
@ -483,14 +484,12 @@ class DifferentTestData(BaseTestData):
            5, [JournalEntryCurrencyData(
                "USD", [self.l_p_of5d], [self.l_p_of5c])])

-        self._set_need_offset({Accounts.RECEIVABLE, Accounts.PAYABLE}, False)
        self._add_journal_entry(self.j_r_of1)
        self._add_journal_entry(self.j_r_of2)
        self._add_journal_entry(self.j_r_of3)
        self._add_journal_entry(self.j_p_of1)
        self._add_journal_entry(self.j_p_of2)
        self._add_journal_entry(self.j_p_of3)
-        self._set_need_offset({Accounts.RECEIVABLE, Accounts.PAYABLE}, True)


 class SameTestData(BaseTestData):
@ -525,8 +524,6 @@ class SameTestData(BaseTestData):
        self.l_p_or6d, self.l_p_or6c = self._add_simple_journal_entry(
            10, "USD", "Steak", "120", Accounts.MEAL, Accounts.PAYABLE)

-        self._set_need_offset({Accounts.RECEIVABLE, Accounts.PAYABLE}, False)
-
        # Receivable offset items
        self.l_r_of1d, self.l_r_of1c = self._add_simple_journal_entry(
            65, "USD", "Noodles", "100", Accounts.CASH, Accounts.RECEIVABLE)
@ -563,6 +560,5 @@ class SameTestData(BaseTestData):
        self.l_p_of6d, self.l_p_of6c = self._add_simple_journal_entry(
            15, "USD", "Steak", "120", Accounts.PAYABLE, Accounts.CASH)

-        self._set_need_offset({Accounts.RECEIVABLE, Accounts.PAYABLE}, True)
        self._add_journal_entry(j_r_of3)
        self._add_journal_entry(j_p_of3)
--- a/tests/testlib.py
+++ b/tests/testlib.py
@ -21,15 +21,11 @@ from __future__ import annotations

 import re
 import typing as t
-from abc import ABC, abstractmethod
-from datetime import date, timedelta
-
-from _decimal import Decimal

 import httpx
 from flask import Flask, render_template_string

-from test_site import create_app, db
+from test_site import create_app

 TEST_SERVER: str = "https://testserver"
 """The test server URI."""
@ -44,6 +40,7 @@ class Accounts:
    BANK: str = "1113-001"
    NOTES_RECEIVABLE: str = "1131-001"
    RECEIVABLE: str = "1141-001"
+    MACHINERY: str = "1441-001"
    PREPAID: str = "1258-001"
    NOTES_PAYABLE: str = "2131-001"
    PAYABLE: str = "2141-001"
@ -103,6 +100,7 @@ def get_client(app: Flask, username: str) -> tuple[httpx.Client, str]:
    csrf_token: str = get_csrf_token(client)
    response: httpx.Response = client.post("/login",
                                           data={"csrf_token": csrf_token,
+                                                 "next": "/",
                                                 "username": username})
    assert response.status_code == 302
    assert response.headers["Location"] == "/"
@ -157,236 +155,3 @@ def match_journal_entry_detail(location: str) -> int:
        r"^/accounting/journal-entries/(\d+)\?next=%2F_next", location)
    assert m is not None
    return int(m.group(1))
-
-
-class JournalEntryLineItemData:
-    """The journal entry line item data."""
-
-    def __init__(self, account: str, description: str, amount: str,
-                 original_line_item: JournalEntryLineItemData | None = None):
-        """Constructs the journal entry line item data.
-
-        :param account: The account code.
-        :param description: The description.
-        :param amount: The amount.
-        :param original_line_item: The original journal entry line item.
-        """
-        self.journal_entry: JournalEntryData | None = None
-        self.id: int = -1
-        self.no: int = -1
-        self.original_line_item: JournalEntryLineItemData | None \
-            = original_line_item
-        self.account: str = account
-        self.description: str = description
-        self.amount: Decimal = Decimal(amount)
-
-    def form(self, prefix: str, debit_credit: str, index: int,
-             is_update: bool) -> dict[str, str]:
-        """Returns the line item as form data.
-
-        :param prefix: The prefix of the form fields.
-        :param debit_credit: Either "debit" or "credit".
-        :param index: The line item index.
-        :param is_update: True for an update operation, or False otherwise
-        :return: The form data.
-        """
-        prefix = f"{prefix}-{debit_credit}-{index}"
-        form: dict[str, str] = {f"{prefix}-account_code": self.account,
-                                f"{prefix}-description": self.description,
-                                f"{prefix}-amount": str(self.amount)}
-        if is_update and self.id != -1:
-            form[f"{prefix}-id"] = str(self.id)
-        form[f"{prefix}-no"] = str(index) if self.no == -1 else str(self.no)
-        if self.original_line_item is not None:
-            assert self.original_line_item.id != -1
-            form[f"{prefix}-original_line_item_id"] \
-                = str(self.original_line_item.id)
-        return form
-
-
-class JournalEntryCurrencyData:
-    """The journal entry currency data."""
-
-    def __init__(self, currency: str, debit: list[JournalEntryLineItemData],
-                 credit: list[JournalEntryLineItemData]):
-        """Constructs the journal entry currency data.
-
-        :param currency: The currency code.
-        :param debit: The debit line items.
-        :param credit: The credit line items.
-        """
-        self.code: str = currency
-        self.debit: list[JournalEntryLineItemData] = debit
-        self.credit: list[JournalEntryLineItemData] = credit
-
-    def form(self, index: int, is_update: bool) -> dict[str, str]:
-        """Returns the currency as form data.
-
-        :param index: The currency index.
-        :param is_update: True for an update operation, or False otherwise
-        :return: The form data.
-        """
-        prefix: str = f"currency-{index}"
-        form: dict[str, str] = {f"{prefix}-code": self.code}
-        for i in range(len(self.debit)):
-            form.update(self.debit[i].form(prefix, "debit", i + 1, is_update))
-        for i in range(len(self.credit)):
-            form.update(self.credit[i].form(prefix, "credit", i + 1,
-                                            is_update))
-        return form
-
-
-class JournalEntryData:
-    """The journal entry data."""
-
-    def __init__(self, days: int, currencies: list[JournalEntryCurrencyData]):
-        """Constructs a journal entry.
-
-        :param days: The number of days before today.
-        :param currencies: The journal entry currency data.
-        """
-        self.id: int = -1
-        self.days: int = days
-        self.currencies: list[JournalEntryCurrencyData] = currencies
-        self.note: str | None = None
-        for currency in self.currencies:
-            for line_item in currency.debit:
-                line_item.journal_entry = self
-            for line_item in currency.credit:
-                line_item.journal_entry = self
-
-    def new_form(self, csrf_token: str) -> dict[str, str]:
-        """Returns the journal entry as a creation form.
-
-        :param csrf_token: The CSRF token.
-        :return: The journal entry as a creation form.
-        """
-        return self.__form(csrf_token, is_update=False)
-
-    def update_form(self, csrf_token: str) -> dict[str, str]:
-        """Returns the journal entry as an update form.
-
-        :param csrf_token: The CSRF token.
-        :return: The journal entry as an update form.
-        """
-        return self.__form(csrf_token, is_update=True)
-
-    def __form(self, csrf_token: str, is_update: bool = False) \
-            -> dict[str, str]:
-        """Returns the journal entry as a form.
-
-        :param csrf_token: The CSRF token.
-        :param is_update: True for an update operation, or False otherwise
-        :return: The journal entry as a form.
-        """
-        journal_entry_date: date = date.today() - timedelta(days=self.days)
-        form: dict[str, str] = {"csrf_token": csrf_token,
-                                "next": NEXT_URI,
-                                "date": journal_entry_date.isoformat()}
-        for i in range(len(self.currencies)):
-            form.update(self.currencies[i].form(i + 1, is_update))
-        if self.note is not None:
-            form["note"] = self.note
-        return form
-
-
-class BaseTestData(ABC):
-    """The base test data."""
-
-    def __init__(self, app: Flask, client: httpx.Client, csrf_token: str):
-        """Constructs the test data.
-
-        :param app: The Flask application.
-        :param client: The client.
-        :param csrf_token: The CSRF token.
-        """
-        self.app: Flask = app
-        self.client: httpx.Client = client
-        self.csrf_token: str = csrf_token
-        self._init_data()
-
-    @abstractmethod
-    def _init_data(self) -> None:
-        """Initializes the test data.
-
-        :return: None
-        """
-
-    @staticmethod
-    def _couple(description: str, amount: str, debit: str, credit: str) \
-            -> tuple[JournalEntryLineItemData, JournalEntryLineItemData]:
-        """Returns a couple of debit-credit line items.
-
-        :param description: The description.
-        :param amount: The amount.
-        :param debit: The debit account code.
-        :param credit: The credit account code.
-        :return: The debit line item and credit line item.
-        """
-        return JournalEntryLineItemData(debit, description, amount),\
-            JournalEntryLineItemData(credit, description, amount)
-
-    def _add_journal_entry(self, journal_entry_data: JournalEntryData) -> None:
-        """Adds a journal entry.
-
-        :param journal_entry_data: The journal entry data.
-        :return: None.
-        """
-        from accounting.models import JournalEntry
-        store_uri: str = "/accounting/journal-entries/store/transfer"
-
-        response: httpx.Response = self.client.post(
-            store_uri, data=journal_entry_data.new_form(self.csrf_token))
-        assert response.status_code == 302
-        journal_entry_id: int \
-            = match_journal_entry_detail(response.headers["Location"])
-        journal_entry_data.id = journal_entry_id
-        with self.app.app_context():
-            journal_entry: JournalEntry | None \
-                = db.session.get(JournalEntry, journal_entry_id)
-            assert journal_entry is not None
-            for i in range(len(journal_entry.currencies)):
-                for j in range(len(journal_entry.currencies[i].debit)):
-                    journal_entry_data.currencies[i].debit[j].id \
-                        = journal_entry.currencies[i].debit[j].id
-                for j in range(len(journal_entry.currencies[i].credit)):
-                    journal_entry_data.currencies[i].credit[j].id \
-                        = journal_entry.currencies[i].credit[j].id
-
-    def _add_simple_journal_entry(
-            self, days: int, currency: str, description: str, amount: str,
-            debit: str, credit: str) \
-            -> tuple[JournalEntryLineItemData, JournalEntryLineItemData]:
-        """Adds a simple journal entry.
-
-        :param days: The number of days before today.
-        :param currency: The currency code.
-        :param description: The description.
-        :param amount: The amount.
-        :param debit: The debit account code.
-        :param credit: The credit account code.
-        :return: The debit line item and credit line item.
-        """
-        debit_item, credit_item = self._couple(
-            description, amount, debit, credit)
-        self._add_journal_entry(JournalEntryData(
-            days, [JournalEntryCurrencyData(
-                currency, [debit_item], [credit_item])]))
-        return debit_item, credit_item
-
-    def _set_need_offset(self, account_codes: set[str],
-                         is_need_offset: bool) -> None:
-        """Sets whether the line items in some accounts need offset.
-
-        :param account_codes: The account codes.
-        :param is_need_offset: True if the line items in the accounts need
-            offset, or False otherwise.
-        :return:
-        """
-        from accounting.models import Account
-        with self.app.app_context():
-            for code in account_codes:
-                account: Account | None = Account.find_by_code(code)
-                assert account is not None
-                account.is_need_offset = is_need_offset
-            db.session.commit()
Author	SHA1	Message	Date
依瑪貓	260e3cbe82	Advanced to version 1.3.3.	2023-04-13 09:56:16 +08:00
依瑪貓	cd039520b6	Added permission checks to the reset routes in the test site.	2023-04-13 09:54:20 +08:00
依瑪貓	05e652aa62	Changed the "_journal_entries" and "_line_items" properties in the BaseTestData class from protected to private, renaming them to "__journal_entries" and "__line_items", respectively. There is no need to access it from the child classes anymore.	2023-04-13 09:28:53 +08:00
依瑪貓	5c9bf0638c	Removed the "csv_data" pseudo property from BaseTestData.	2023-04-13 09:25:50 +08:00
依瑪貓	bbc78433fd	Moved the sample data generation from the make-sample.py script to the test site. The sample data is generated at real time. This avoids the problem with pre-recorded sample data that the beginning of the months and weeks changes with the day resetting the sample data.	2023-04-13 09:23:57 +08:00
依瑪貓	7bcc2b28b2	Moved the JournalEntryLineItemData, JournalEntryCurrencyData, JournalEntryData, and BaseTestData classes from testlib.py to the ".lib" module in the test site.	2023-04-13 08:30:07 +08:00
依瑪貓	c1d9ca284c	Changed the new_form and update_form methods of the JournalEntryData class in testlib.py to receive the next URI as the parameter instead of the constant, so that the JournalEntryData class can move to other places.	2023-04-13 08:23:52 +08:00
依瑪貓	165e28441a	Changed the sample data format from JSON to CSV for the test site live demonstration.	2023-04-12 21:33:34 +08:00
依瑪貓	621020b0f0	Advanced to version 1.3.2.	2023-04-12 18:05:13 +08:00
依瑪貓	6ad36cfaa3	Updated the translation of the test site.	2023-04-12 18:05:13 +08:00
依瑪貓	20b0412091	Added the sample data generation and database reset on the test site for live demonstration.	2023-04-12 18:05:13 +08:00
依瑪貓	3ca246d3e0	Revised the strings in babel-utils.py and babel-utils-test-site.py.	2023-04-12 15:04:32 +08:00
依瑪貓	85d1b13ccd	Added the "populate" method to the BaseTestData class, and changed it so that the tests need to call the "populate" method to populate the data, so that it may return the data with populating the database in the future.	2023-04-12 12:28:34 +08:00
依瑪貓	3bada28b8f	Revised the BaseTestData class in testlib.py to add journal entries directly to the database instead of through the API, in order to allow the data to be reused, and to speed up the test.	2023-04-12 12:12:11 +08:00
依瑪貓	8f2cef8d81	Revised the imports in the accounting.journal_entry.converters module.	2023-04-12 00:41:29 +08:00
依瑪貓	e62316c477	Advanced to version 1.3.1.	2023-04-11 22:32:22 +08:00
依瑪貓	24ddb0c278	Updated the translation of the test site.	2023-04-11 22:27:31 +08:00
依瑪貓	536f3390aa	Revised the home page of the test site.	2023-04-11 22:27:31 +08:00
依瑪貓	fadd8e73b6	Revised the log in process of the test site to return to the previous page after logging in.	2023-04-11 22:27:11 +08:00
依瑪貓	12ccf658bf	Revised the documentation in README.rst and intro.rst.	2023-04-11 21:56:49 +08:00
依瑪貓	e30d1257e5	Revised the navigation bar so that viewers do not see the menu of the unmatched offsets.	2023-04-11 07:50:10 +08:00