Advanced to version 0.6.0.

.gitignore

@@ -38,3 +38,4 @@ excludes
 *.mo
 zh_Hans
 test_temp.py
+dummy.js

MANIFEST.in

@@ -15,6 +15,7 @@
 #  See the License for the specific language governing permissions and
 #  limitations under the License.
 
+exclude src/accounting/static/js/dummy.js
 include src/accounting/translations/*
 include src/accounting/translations/*/LC_MESSAGES/*
 include docs/*
@@ -22,6 +23,7 @@ include docs/source/*
 include docs/source/_static/*
 include docs/source/_templates/*
 include tests/*
+exclude tests/test_temp.py
 include tests/test_site/*
 include tests/test_site/templates/*
 include tests/test_site/translations/*

docs/source/accounting.report.period.rst

@@ -0,0 +1,69 @@
+accounting.report.period package
+================================
+
+Submodules
+----------
+
+accounting.report.period.chooser module
+---------------------------------------
+
+.. automodule:: accounting.report.period.chooser
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.period.description module
+-------------------------------------------
+
+.. automodule:: accounting.report.period.description
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.period.month\_end module
+------------------------------------------
+
+.. automodule:: accounting.report.period.month_end
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.period.parser module
+--------------------------------------
+
+.. automodule:: accounting.report.period.parser
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.period.period module
+--------------------------------------
+
+.. automodule:: accounting.report.period.period
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.period.shortcuts module
+-----------------------------------------
+
+.. automodule:: accounting.report.period.shortcuts
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.period.specification module
+---------------------------------------------
+
+.. automodule:: accounting.report.period.specification
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: accounting.report.period
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/source/accounting.report.reports.rst

@@ -1,14 +1,6 @@
 accounting.report.reports package
 =================================
 
-Subpackages
------------
-
-.. toctree::
-   :maxdepth: 4
-
-   accounting.report.reports.utils
-
 Submodules
 ----------
 

docs/source/accounting.report.reports.utils.rst

@@ -1,77 +0,0 @@
-accounting.report.reports.utils package
-=======================================
-
-Submodules
-----------
-
-accounting.report.reports.utils.base\_page\_params module
----------------------------------------------------------
-
-.. automodule:: accounting.report.reports.utils.base_page_params
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.report.reports.utils.base\_report module
----------------------------------------------------
-
-.. automodule:: accounting.report.reports.utils.base_report
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.report.reports.utils.csv\_export module
---------------------------------------------------
-
-.. automodule:: accounting.report.reports.utils.csv_export
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.report.reports.utils.option\_link module
----------------------------------------------------
-
-.. automodule:: accounting.report.reports.utils.option_link
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.report.reports.utils.period\_choosers module
--------------------------------------------------------
-
-.. automodule:: accounting.report.reports.utils.period_choosers
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.report.reports.utils.report\_chooser module
-------------------------------------------------------
-
-.. automodule:: accounting.report.reports.utils.report_chooser
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.report.reports.utils.report\_type module
----------------------------------------------------
-
-.. automodule:: accounting.report.reports.utils.report_type
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.report.reports.utils.urls module
--------------------------------------------
-
-.. automodule:: accounting.report.reports.utils.urls
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Module contents
----------------
-
-.. automodule:: accounting.report.reports.utils
-   :members:
-   :undoc-members:
-   :show-inheritance:

docs/source/accounting.report.rst

@@ -7,7 +7,9 @@ Subpackages
 .. toctree::
    :maxdepth: 4
 
+   accounting.report.period
    accounting.report.reports
+   accounting.report.utils
 
 Submodules
 ----------
@@ -20,22 +22,6 @@ accounting.report.converters module
    :undoc-members:
    :show-inheritance:
 
-accounting.report.income\_expense\_account module
--------------------------------------------------
-
-.. automodule:: accounting.report.income_expense_account
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.report.period module
--------------------------------
-
-.. automodule:: accounting.report.period
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
 accounting.report.template\_filters module
 ------------------------------------------
 

docs/source/accounting.report.utils.rst

@@ -0,0 +1,77 @@
+accounting.report.utils package
+===============================
+
+Submodules
+----------
+
+accounting.report.utils.base\_page\_params module
+-------------------------------------------------
+
+.. automodule:: accounting.report.utils.base_page_params
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.utils.base\_report module
+-------------------------------------------
+
+.. automodule:: accounting.report.utils.base_report
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.utils.csv\_export module
+------------------------------------------
+
+.. automodule:: accounting.report.utils.csv_export
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.utils.ie\_account module
+------------------------------------------
+
+.. automodule:: accounting.report.utils.ie_account
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.utils.option\_link module
+-------------------------------------------
+
+.. automodule:: accounting.report.utils.option_link
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.utils.report\_chooser module
+----------------------------------------------
+
+.. automodule:: accounting.report.utils.report_chooser
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.utils.report\_type module
+-------------------------------------------
+
+.. automodule:: accounting.report.utils.report_type
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.report.utils.urls module
+-----------------------------------
+
+.. automodule:: accounting.report.utils.urls
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: accounting.report.utils
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/source/accounting.transaction.forms.rst

@@ -0,0 +1,45 @@
+accounting.transaction.forms package
+====================================
+
+Submodules
+----------
+
+accounting.transaction.forms.currency module
+--------------------------------------------
+
+.. automodule:: accounting.transaction.forms.currency
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.transaction.forms.journal\_entry module
+--------------------------------------------------
+
+.. automodule:: accounting.transaction.forms.journal_entry
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.transaction.forms.reorder module
+-------------------------------------------
+
+.. automodule:: accounting.transaction.forms.reorder
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.transaction.forms.transaction module
+-----------------------------------------------
+
+.. automodule:: accounting.transaction.forms.transaction
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: accounting.transaction.forms
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/source/accounting.transaction.rst

@@ -1,6 +1,15 @@
 accounting.transaction package
 ==============================
 
+Subpackages
+-----------
+
+.. toctree::
+   :maxdepth: 4
+
+   accounting.transaction.forms
+   accounting.transaction.utils
+
 Submodules
 ----------
 
@@ -12,30 +21,6 @@ accounting.transaction.converters module
    :undoc-members:
    :show-inheritance:
 
-accounting.transaction.forms module
------------------------------------
-
-.. automodule:: accounting.transaction.forms
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.transaction.operators module
----------------------------------------
-
-.. automodule:: accounting.transaction.operators
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-accounting.transaction.summary\_editor module
----------------------------------------------
-
-.. automodule:: accounting.transaction.summary_editor
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
 accounting.transaction.template\_filters module
 -----------------------------------------------
 

docs/source/accounting.transaction.utils.rst

@@ -0,0 +1,53 @@
+accounting.transaction.utils package
+====================================
+
+Submodules
+----------
+
+accounting.transaction.utils.account\_option module
+---------------------------------------------------
+
+.. automodule:: accounting.transaction.utils.account_option
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.transaction.utils.offset\_alias module
+-------------------------------------------------
+
+.. automodule:: accounting.transaction.utils.offset_alias
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.transaction.utils.operators module
+---------------------------------------------
+
+.. automodule:: accounting.transaction.utils.operators
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.transaction.utils.original\_entries module
+-----------------------------------------------------
+
+.. automodule:: accounting.transaction.utils.original_entries
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+accounting.transaction.utils.summary\_editor module
+---------------------------------------------------
+
+.. automodule:: accounting.transaction.utils.summary_editor
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: accounting.transaction.utils
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/source/accounting.utils.rst

@@ -4,6 +4,14 @@ accounting.utils package
 Submodules
 ----------
 
+accounting.utils.cast module
+----------------------------
+
+.. automodule:: accounting.utils.cast
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
 accounting.utils.flash\_errors module
 -------------------------------------
 

setup.cfg

@@ -17,7 +17,7 @@
 
 [metadata]
 name = mia-accounting-flask
-version = 0.4.0
+version = 0.6.0
 author = imacat
 author_email = imacat@mail.imacat.idv.tw
 description = The Mia! Accounting Flask project.

src/accounting/__init__.py

@@ -17,13 +17,12 @@
 """The accounting application.
 
 """
-import typing as t
 from pathlib import Path
 
 from flask import Flask, Blueprint
 from flask_sqlalchemy import SQLAlchemy
 
-from accounting.utils.user import AbstractUserUtils
+from accounting.utils.user import UserUtilityInterface
 
 db: SQLAlchemy = SQLAlchemy()
 """The database instance."""
@@ -31,19 +30,13 @@ data_dir: Path = Path(__file__).parent / "data"
 """The data directory."""
 
 
-def init_app(app: Flask, user_utils: AbstractUserUtils,
-             url_prefix: str = "/accounting",
-             can_view_func: t.Callable[[], bool] | None = None,
-             can_edit_func: t.Callable[[], bool] | None = None) -> None:
+def init_app(app: Flask, user_utils: UserUtilityInterface,
+             url_prefix: str = "/accounting") -> None:
     """Initialize the application.
 
     :param app: The Flask application.
     :param user_utils: The user utilities.
     :param url_prefix: The URL prefix of the accounting application.
-    :param can_view_func: A callback that returns whether the current user can
-        view the accounting data.
-    :param can_edit_func: A callback that returns whether the current user can
-        edit the accounting data.
     :return: None.
     """
     # The database instance must be set before loading everything
@@ -73,7 +66,7 @@ def init_app(app: Flask, user_utils: AbstractUserUtils,
     locale.init_app(app, bp)
 
     from .utils import permission
-    permission.init_app(bp, can_view_func, can_edit_func)
+    permission.init_app(bp, user_utils)
 
     from .utils import next_uri
     next_uri.init_app(bp)

src/accounting/account/commands.py

@@ -18,7 +18,6 @@
 
 """
 import os
-import re
 from secrets import randbelow
 
 import click
@@ -30,7 +29,7 @@ from accounting.utils.user import has_user, get_user_pk
 
 AccountData = tuple[int, str, int, str, str, str, bool]
 """The format of the account data, as a list of (ID, base account code, number,
-English, Traditional Chinese, Simplified Chinese, is-pay-off-needed) tuples."""
+English, Traditional Chinese, Simplified Chinese, is-need-offset) tuples."""
 
 
 def __validate_username(ctx: click.core.Context, param: click.core.Option,
@@ -93,14 +92,36 @@ def init_accounts_command(username: str) -> None:
     data: list[AccountData] = []
     for base in bases_to_add:
         l10n: dict[str, str] = {x.locale: x.title for x in base.l10n}
-        is_pay_off_needed: bool = True if re.match("^[12]1[34]", base.code) \
-            else False
+        is_need_offset: bool = __is_need_offset(base.code)
         data.append((get_new_id(), base.code, 1, base.title_l10n,
-                     l10n["zh_Hant"], l10n["zh_Hans"], is_pay_off_needed))
+                     l10n["zh_Hant"], l10n["zh_Hans"], is_need_offset))
     __add_accounting_accounts(data, creator_pk)
     click.echo(F"{len(data)} added.  Accounting accounts initialized.")
 
 
+def __is_need_offset(base_code: str) -> bool:
+    """Checks that whether entries in the account need offset.
+
+    :param base_code: The code of the base account.
+    :return: True if entries in the account need offset, or False otherwise.
+    """
+    # Assets
+    if base_code[0] == "1":
+        if base_code[:3] in {"113", "114", "118", "184"}:
+            return True
+        if base_code in {"1411", "1421", "1431", "1441", "1511", "1521",
+                         "1581", "1611", "1851", ""}:
+            return True
+        return False
+    # Liabilities
+    if base_code[0] == "2":
+        if base_code in {"2111", "2114", "2284", "2293"}:
+            return False
+        return True
+    # Only assets and liabilities need offset
+    return False
+
+
 def __add_accounting_accounts(data: list[AccountData], creator_pk: int)\
         -> None:
     """Adds the accounts.
@@ -113,7 +134,7 @@ def __add_accounting_accounts(data: list[AccountData], creator_pk: int)\
                                        base_code=x[1],
                                        no=x[2],
                                        title_l10n=x[3],
-                                       is_pay_off_needed=x[6],
+                                       is_need_offset=x[6],
                                        created_by_id=creator_pk,
                                        updated_by_id=creator_pk)
                                for x in data]

src/accounting/account/forms.py

@@ -53,6 +53,20 @@ class BaseAccountAvailable:
                 "The base account is not available."))
 
 
+class NoOffsetNominalAccount:
+    """The validator to check nominal account is not to be offset."""
+
+    def __call__(self, form: FlaskForm, field: BooleanField) -> None:
+        assert isinstance(form, AccountForm)
+        if not field.data:
+            return
+        if form.base_code.data is None:
+            return
+        if form.base_code.data[0] not in {"1", "2", "3"}:
+            raise ValidationError(lazy_gettext(
+                "A nominal account does not need offset."))
+
+
 class AccountForm(FlaskForm):
     """The form to create or edit an account."""
     base_code = StringField(
@@ -66,8 +80,9 @@ class AccountForm(FlaskForm):
         filters=[strip_text],
         validators=[DataRequired(lazy_gettext("Please fill in the title"))])
     """The title."""
-    is_pay_off_needed = BooleanField()
-    """Whether the the entries of this account need pay-off."""
+    is_need_offset = BooleanField(
+        validators=[NoOffsetNominalAccount()])
+    """Whether the the entries of this account need offset."""
 
     def populate_obj(self, obj: Account) -> None:
         """Populates the form data into an account object.
@@ -87,7 +102,10 @@ class AccountForm(FlaskForm):
             obj.base_code = self.base_code.data
             obj.no = count + 1
         obj.title = self.title.data
-        obj.is_pay_off_needed = self.is_pay_off_needed.data
+        if self.base_code.data[0] in {"1", "2", "3"}:
+            obj.is_need_offset = self.is_need_offset.data
+        else:
+            obj.is_need_offset = False
         if is_new:
             current_user_pk: int = get_current_user_pk()
             obj.created_by_id = current_user_pk

src/accounting/account/queries.py

@@ -47,8 +47,8 @@ def get_account_query() -> list[Account]:
                Account.title_l10n.contains(k),
                code.contains(k),
                Account.id.in_(l10n_matches)]
-        if k in gettext("Pay-off needed"):
-            sub_conditions.append(Account.is_pay_off_needed)
+        if k in gettext("Need offset"):
+            sub_conditions.append(Account.is_need_offset)
         conditions.append(sa.or_(*sub_conditions))
 
     return Account.query.filter(*conditions)\

src/accounting/account/views.py

@@ -27,6 +27,7 @@ from werkzeug.datastructures import ImmutableMultiDict
 from accounting import db
 from accounting.locale import lazy_gettext
 from accounting.models import Account, BaseAccount
+from accounting.utils.cast import s
 from accounting.utils.flash_errors import flash_form_errors
 from accounting.utils.next_uri import inherit_next, or_next
 from accounting.utils.pagination import Pagination
@@ -86,7 +87,7 @@ def add_account() -> redirect:
     form.populate_obj(account)
     db.session.add(account)
     db.session.commit()
-    flash(lazy_gettext("The account is added successfully"), "success")
+    flash(s(lazy_gettext("The account is added successfully")), "success")
     return redirect(inherit_next(__get_detail_uri(account)))
 
 
@@ -138,12 +139,12 @@ def update_account(account: Account) -> redirect:
     with db.session.no_autoflush:
         form.populate_obj(account)
     if not account.is_modified:
-        flash(lazy_gettext("The account was not modified."), "success")
+        flash(s(lazy_gettext("The account was not modified.")), "success")
         return redirect(inherit_next(__get_detail_uri(account)))
     account.updated_by_id = get_current_user_pk()
     account.updated_at = sa.func.now()
     db.session.commit()
-    flash(lazy_gettext("The account is updated successfully."), "success")
+    flash(s(lazy_gettext("The account is updated successfully.")), "success")
     return redirect(inherit_next(__get_detail_uri(account)))
 
 
@@ -159,7 +160,7 @@ def delete_account(account: Account) -> redirect:
     account.delete()
     sort_accounts_in(account.base_code, account.id)
     db.session.commit()
-    flash(lazy_gettext("The account is deleted successfully."), "success")
+    flash(s(lazy_gettext("The account is deleted successfully.")), "success")
     return redirect(or_next(__get_list_uri()))
 
 
@@ -186,10 +187,10 @@ def sort_accounts(base: BaseAccount) -> redirect:
     form: AccountReorderForm = AccountReorderForm(base)
     form.save_order()
     if not form.is_modified:
-        flash(lazy_gettext("The order was not modified."), "success")
+        flash(s(lazy_gettext("The order was not modified.")), "success")
         return redirect(or_next(__get_list_uri()))
     db.session.commit()
-    flash(lazy_gettext("The order is updated successfully."), "success")
+    flash(s(lazy_gettext("The order is updated successfully.")), "success")
     return redirect(or_next(__get_list_uri()))
 
 

src/accounting/currency/forms.py

@@ -17,8 +17,6 @@
 """The forms for the currency management.
 
 """
-from __future__ import annotations
-
 from flask_wtf import FlaskForm
 from wtforms import StringField, ValidationError
 from wtforms.validators import DataRequired, Regexp, NoneOf
@@ -30,14 +28,11 @@ from accounting.utils.strip_text import strip_text
 from accounting.utils.user import get_current_user_pk
 
 
-class CurrencyForm(FlaskForm):
-    """The form to create or edit a currency."""
-    CODE_BLOCKLIST: list[str] = ["create", "store", "exists-code"]
-    """The reserved codes that are not available."""
-
 class CodeUnique:
     """The validator to check if the code is unique."""
-        def __call__(self, form: CurrencyForm, field: StringField) -> None:
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        assert isinstance(form, CurrencyForm)
         if field.data == "":
             return
         if form.obj_code is not None and form.obj_code == field.data:
@@ -46,6 +41,11 @@ class CurrencyForm(FlaskForm):
             raise ValidationError(lazy_gettext(
                 "Code conflicts with another currency."))
 
+
+class CurrencyForm(FlaskForm):
+    """The form to create or edit a currency."""
+    CODE_BLOCKLIST: list[str] = ["create", "store", "exists-code"]
+    """The reserved codes that are not available."""
     code = StringField(
         filters=[strip_text],
         validators=[DataRequired(lazy_gettext("Please fill in the code.")),

src/accounting/currency/views.py

@@ -27,6 +27,7 @@ from werkzeug.datastructures import ImmutableMultiDict
 from accounting import db
 from accounting.locale import lazy_gettext
 from accounting.models import Currency
+from accounting.utils.cast import s
 from accounting.utils.flash_errors import flash_form_errors
 from accounting.utils.next_uri import inherit_next, or_next
 from accounting.utils.pagination import Pagination
@@ -88,7 +89,7 @@ def add_currency() -> redirect:
     form.populate_obj(currency)
     db.session.add(currency)
     db.session.commit()
-    flash(lazy_gettext("The currency is added successfully"), "success")
+    flash(s(lazy_gettext("The currency is added successfully")), "success")
     return redirect(inherit_next(__get_detail_uri(currency)))
 
 
@@ -141,12 +142,12 @@ def update_currency(currency: Currency) -> redirect:
     with db.session.no_autoflush:
         form.populate_obj(currency)
     if not currency.is_modified:
-        flash(lazy_gettext("The currency was not modified."), "success")
+        flash(s(lazy_gettext("The currency was not modified.")), "success")
         return redirect(inherit_next(__get_detail_uri(currency)))
     currency.updated_by_id = get_current_user_pk()
     currency.updated_at = sa.func.now()
     db.session.commit()
-    flash(lazy_gettext("The currency is updated successfully."), "success")
+    flash(s(lazy_gettext("The currency is updated successfully.")), "success")
     return redirect(inherit_next(__get_detail_uri(currency)))
 
 
@@ -161,7 +162,7 @@ def delete_currency(currency: Currency) -> redirect:
     """
     currency.delete()
     db.session.commit()
-    flash(lazy_gettext("The currency is deleted successfully."), "success")
+    flash(s(lazy_gettext("The currency is deleted successfully.")), "success")
     return redirect(or_next(url_for("accounting.currency.list")))
 
 
@@ -182,4 +183,3 @@ def __get_detail_uri(currency: Currency) -> str:
     :return: The detail URI of the currency.
     """
     return url_for("accounting.currency.detail", currency=currency)
-

src/accounting/models.py

@@ -21,6 +21,7 @@ from __future__ import annotations
 
 import re
 import typing as t
+from datetime import date
 from decimal import Decimal
 
 import sqlalchemy as sa
@@ -113,8 +114,8 @@ class Account(db.Model):
     """The account number under the base account."""
     title_l10n = db.Column("title", db.String, nullable=False)
     """The title."""
-    is_pay_off_needed = db.Column(db.Boolean, nullable=False, default=False)
-    """Whether the entries of this account need pay-off."""
+    is_need_offset = db.Column(db.Boolean, nullable=False, default=False)
+    """Whether the entries of this account need offset."""
     created_at = db.Column(db.DateTime(timezone=True), nullable=False,
                            server_default=db.func.now())
     """The time of creation."""
@@ -197,6 +198,52 @@ class Account(db.Model):
                 return
         self.l10n.append(AccountL10n(locale=current_locale, title=value))
 
+    @property
+    def is_real(self) -> bool:
+        """Returns whether the account is a real account.
+
+        :return: True if the account is a real account, or False otherwise.
+        """
+        return self.base_code[0] in {"1", "2", "3"}
+
+    @property
+    def is_nominal(self) -> bool:
+        """Returns whether the account is a nominal account.
+
+        :return: True if the account is a nominal account, or False otherwise.
+        """
+        return not self.is_real
+
+    @property
+    def query_values(self) -> list[str]:
+        """Returns the values to be queried.
+
+        :return: The values to be queried.
+        """
+        return [self.code, self.title_l10n] + [x.title for x in self.l10n]
+
+    @property
+    def is_modified(self) -> bool:
+        """Returns whether a product account was modified.
+
+        :return: True if modified, or False otherwise.
+        """
+        if db.session.is_modified(self):
+            return True
+        for l10n in self.l10n:
+            if db.session.is_modified(l10n):
+                return True
+        return False
+
+    def delete(self) -> None:
+        """Deletes this account.
+
+        :return: None.
+        """
+        AccountL10n.query.filter(AccountL10n.account == self).delete()
+        cls: t.Type[t.Self] = self.__class__
+        cls.query.filter(cls.id == self.id).delete()
+
     @classmethod
     def find_by_code(cls, code: str) -> t.Self | None:
         """Finds an account by its code.
@@ -251,14 +298,6 @@ class Account(db.Model):
                                 cls.base_code != "3353")\
             .order_by(cls.base_code, cls.no).all()
 
-    @property
-    def query_values(self) -> list[str]:
-        """Returns the values to be queried.
-
-        :return: The values to be queried.
-        """
-        return [self.code, self.title_l10n] + [x.title for x in self.l10n]
-
     @classmethod
     def cash(cls) -> t.Self:
         """Returns the cash account.
@@ -275,28 +314,6 @@ class Account(db.Model):
         """
         return cls.find_by_code(cls.ACCUMULATED_CHANGE_CODE)
 
-    @property
-    def is_modified(self) -> bool:
-        """Returns whether a product account was modified.
-
-        :return: True if modified, or False otherwise.
-        """
-        if db.session.is_modified(self):
-            return True
-        for l10n in self.l10n:
-            if db.session.is_modified(l10n):
-                return True
-        return False
-
-    def delete(self) -> None:
-        """Deletes this account.
-
-        :return: None.
-        """
-        AccountL10n.query.filter(AccountL10n.account == self).delete()
-        cls: t.Type[t.Self] = self.__class__
-        cls.query.filter(cls.id == self.id).delete()
-
 
 class AccountL10n(db.Model):
     """A localized account title."""
@@ -568,6 +585,21 @@ class Transaction(db.Model):
                 return False
         return True
 
+    @property
+    def can_delete(self) -> bool:
+        """Returns whether the transaction can be deleted.
+
+        :return: True if the transaction can be deleted, or False otherwise.
+        """
+        if not hasattr(self, "__can_delete"):
+            def has_offset() -> bool:
+                for entry in self.entries:
+                    if len(entry.offsets) > 0:
+                        return True
+                return False
+            setattr(self, "__can_delete", not has_offset())
+        return getattr(self, "__can_delete")
+
     def delete(self) -> None:
         """Deletes the transaction.
 
@@ -597,15 +629,15 @@ class JournalEntry(db.Model):
     """True for a debit entry, or False for a credit entry."""
     no = db.Column(db.Integer, nullable=False)
     """The entry number under the transaction and debit or credit."""
-    pay_off_target_id = db.Column(db.Integer,
+    original_entry_id = db.Column(db.Integer,
                                   db.ForeignKey(id, onupdate="CASCADE"),
                                   nullable=True)
-    """The ID of the pay-off target entry."""
-    pay_off_target = db.relationship("JournalEntry", back_populates="pay_off",
+    """The ID of the original entry."""
+    original_entry = db.relationship("JournalEntry", back_populates="offsets",
                                      remote_side=id, passive_deletes=True)
-    """The pay-off target entry."""
-    pay_off = db.relationship("JournalEntry", back_populates="pay_off_target")
-    """The pay-off entries."""
+    """The original entry."""
+    offsets = db.relationship("JournalEntry", back_populates="original_entry")
+    """The offset entries."""
     currency_code = db.Column(db.String,
                               db.ForeignKey(Currency.code, onupdate="CASCADE"),
                               nullable=False)
@@ -624,6 +656,21 @@ class JournalEntry(db.Model):
     amount = db.Column(db.Numeric(14, 2), nullable=False)
     """The amount."""
 
+    def __str__(self) -> str:
+        """Returns the string representation of the journal entry.
+
+        :return: The string representation of the journal entry.
+        """
+        if not hasattr(self, "__str"):
+            from accounting.template_filters import format_date, format_amount
+            setattr(self, "__str",
+                    gettext("%(date)s %(summary)s %(amount)s",
+                            date=format_date(self.transaction.date),
+                            summary="" if self.summary is None
+                            else self.summary,
+                            amount=format_amount(self.amount)))
+        return getattr(self, "__str")
+
     @property
     def eid(self) -> int | None:
         """Returns the journal entry ID.  This is the alternative name of the
@@ -649,6 +696,20 @@ class JournalEntry(db.Model):
         """
         return self.amount if self.is_debit else None
 
+    @property
+    def is_need_offset(self) -> bool:
+        """Returns whether the entry needs offset.
+
+        :return: True if the entry needs offset, or False otherwise.
+        """
+        if not self.account.is_need_offset:
+            return False
+        if self.account.base_code[0] == "1" and not self.is_debit:
+            return False
+        if self.account.base_code[0] == "2" and self.is_debit:
+            return False
+        return True
+
     @property
     def credit(self) -> Decimal | None:
         """Returns the credit amount.
@@ -656,3 +717,45 @@ class JournalEntry(db.Model):
         :return: The credit amount, or None if this is not a credit entry.
         """
         return None if self.is_debit else self.amount
+
+    @property
+    def net_balance(self) -> Decimal:
+        """Returns the net balance.
+
+        :return: The net balance.
+        """
+        if not hasattr(self, "__net_balance"):
+            setattr(self, "__net_balance", self.amount + sum(
+                [x.amount if x.is_debit == self.is_debit else -x.amount
+                 for x in self.offsets]))
+        return getattr(self, "__net_balance")
+
+    @net_balance.setter
+    def net_balance(self, net_balance: Decimal) -> None:
+        """Sets the net balance.
+
+        :param net_balance: The net balance.
+        :return: None.
+        """
+        setattr(self, "__net_balance", net_balance)
+
+    @property
+    def query_values(self) -> tuple[list[str], list[str]]:
+        """Returns the values to be queried.
+
+        :return: The values to be queried.
+        """
+        def format_amount(value: Decimal) -> str:
+            whole: int = int(value)
+            frac: Decimal = (value - whole).normalize()
+            return str(whole) + str(abs(frac))[1:]
+
+        txn_day: date = self.transaction.date
+        summary: str = "" if self.summary is None else self.summary
+        return ([summary],
+                [str(txn_day.year),
+                 "{}/{}".format(txn_day.year, txn_day.month),
+                 "{}/{}".format(txn_day.month, txn_day.day),
+                 "{}/{}/{}".format(txn_day.year, txn_day.month, txn_day.day),
+                 format_amount(self.amount),
+                 format_amount(self.net_balance)])

src/accounting/report/__init__.py

@@ -29,7 +29,7 @@ def init_app(app: Flask, bp: Blueprint) -> None:
     """
     from .converters import PeriodConverter, IncomeExpensesAccountConverter
     app.url_map.converters["period"] = PeriodConverter
-    app.url_map.converters["ioAccount"] = IncomeExpensesAccountConverter
+    app.url_map.converters["ieAccount"] = IncomeExpensesAccountConverter
 
     from .views import bp as report_bp
     bp.register_blueprint(report_bp, url_prefix="/reports")

src/accounting/report/converters.py

@@ -23,8 +23,8 @@ from flask import abort
 from werkzeug.routing import BaseConverter
 
 from accounting.models import Account
-from .income_expense_account import IncomeExpensesAccount
-from .period import Period
+from .period import Period, get_period
+from .utils.ie_account import IncomeExpensesAccount
 
 
 class PeriodConverter(BaseConverter):
@@ -38,7 +38,7 @@ class PeriodConverter(BaseConverter):
         :return: The corresponding period.
         """
         try:
-            return Period.get_instance(value)
+            return get_period(value)
         except ValueError:
             abort(404)
 

src/accounting/report/period.py

@@ -1,633 +0,0 @@
-# The Mia! Accounting Flask Project.
-# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
-
-#  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 date period.
-
-This file is largely taken from the NanoParma ERP project, first written in
-2021/9/16 by imacat (imacat@nanoparma.com).
-
-"""
-import calendar
-import datetime
-import re
-import typing as t
-
-from accounting.locale import gettext
-
-
-class Period:
-    """A date period."""
-
-    def __init__(self, start: datetime.date | None, end: datetime.date | None):
-        """Constructs a new date period.
-
-        :param start: The start date, or None from the very beginning.
-        :param end: The end date, or None till no end.
-        """
-        self.start: datetime.date | None = start
-        """The start of the period."""
-        self.end: datetime.date | None = end
-        """The end of the period."""
-        self.is_default: bool = False
-        """Whether the is the default period."""
-        self.is_this_month: bool = False
-        """Whether the period is this month."""
-        self.is_last_month: bool = False
-        """Whether the period is last month."""
-        self.is_since_last_month: bool = False
-        """Whether the period is since last month."""
-        self.is_this_year: bool = False
-        """Whether the period is this year."""
-        self.is_last_year: bool = False
-        """Whether the period is last year."""
-        self.is_today: bool = False
-        """Whether the period is today."""
-        self.is_yesterday: bool = False
-        """Whether the period is yesterday."""
-        self.is_all: bool = start is None and end is None
-        """Whether the period is all time."""
-        self.spec: str = ""
-        """The period specification."""
-        self.desc: str = ""
-        """The text description."""
-        self.is_a_month: bool = False
-        """Whether the period is a whole month."""
-        self.is_type_month: bool = False
-        """Whether the period is for the month chooser."""
-        self.is_a_year: bool = False
-        """Whether the period is a whole year."""
-        self.is_a_day: bool = False
-        """Whether the period is a single day."""
-        self._set_properties()
-
-    def _set_properties(self) -> None:
-        """Sets the following properties.
-
-        * self.spec
-        * self.desc
-        * self.is_a_month
-        * self.is_type_month
-        * self.is_a_year
-        * self.is_a_day
-
-        Override this method to set the properties in the subclasses.
-
-        :return: None.
-        """
-        self.spec = PeriodSpecification(self).spec
-        self.desc = PeriodDescription(self).desc
-        if self.start is None or self.end is None:
-            return
-        self.is_a_month = self.start.day == 1 \
-            and self.end == _month_end(self.start)
-        self.is_type_month = self.is_a_month
-        self.is_a_year = self.start == datetime.date(self.start.year, 1, 1) \
-            and self.end == datetime.date(self.start.year, 12, 31)
-        self.is_a_day = self.start == self.end
-
-    @classmethod
-    def get_instance(cls, spec: str | None = None) -> t.Self:
-        """Returns a period instance.
-
-        :param spec: The period specification, or omit for the default.
-        :return: The period instance.
-        :raise ValueError: When the period is invalid.
-        """
-        if spec is None:
-            return ThisMonth()
-        named_periods: dict[str, t.Type[t.Callable[[], Period]]] = {
-            "this-month": lambda: ThisMonth(),
-            "last-month": lambda: LastMonth(),
-            "since-last-month": lambda: SinceLastMonth(),
-            "this-year": lambda: ThisYear(),
-            "last-year": lambda: LastYear(),
-            "today": lambda: Today(),
-            "yesterday": lambda: Yesterday(),
-        }
-        if spec in named_periods:
-            return named_periods[spec]()
-        start: datetime.date
-        end: datetime.date
-        start, end = _parse_period_spec(spec)
-        if start is not None and end is not None and start > end:
-            raise ValueError
-        return cls(start, end)
-
-    def is_year(self, year: int) -> bool:
-        """Returns whether the period is the specific year period.
-
-        :param year: The year.
-        :return: True if the period is the year period, or False otherwise.
-        """
-        if not self.is_a_year:
-            return False
-        return self.start.year == year
-
-    @property
-    def is_type_arbitrary(self) -> bool:
-        """Returns whether this period is an arbitrary period.
-
-        :return: True if this is an arbitrary period, or False otherwise.
-        """
-        return not self.is_type_month and not self.is_a_year \
-            and not self.is_a_day
-
-    @property
-    def before(self) -> t.Self | None:
-        """Returns the period before this period.
-
-        :return: The period before this period.
-        """
-        if self.start is None:
-            return None
-        return Period(None, self.start - datetime.timedelta(days=1))
-
-
-class PeriodSpecification:
-    """The period specification composer."""
-
-    def __init__(self, period: Period):
-        """Constructs the period specification composer.
-
-        :param period: The period.
-        """
-        self.__start: datetime.date = period.start
-        self.__end: datetime.date = period.end
-        self.spec: str = self.__get_spec()
-
-    def __get_spec(self) -> str:
-        """Returns the period specification.
-
-        :return: The period specification.
-        """
-        if self.__start is None and self.__end is None:
-            return "-"
-        if self.__end is None:
-            return self.__get_since_spec()
-        if self.__start is None:
-            return self.__get_until_spec()
-        try:
-            return self.__get_year_spec()
-        except ValueError:
-            pass
-        try:
-            return self.__get_month_spec()
-        except ValueError:
-            pass
-        return self.__get_day_spec()
-
-    def __get_since_spec(self) -> str:
-        """Returns the period specification without the end day.
-
-        :return: The period specification without the end day
-        """
-        if self.__start.month == 1 and self.__start.day == 1:
-            return self.__start.strftime("%Y-")
-        if self.__start.day == 1:
-            return self.__start.strftime("%Y-%m-")
-        return self.__start.strftime("%Y-%m-%d-")
-
-    def __get_until_spec(self) -> str:
-        """Returns the period specification without the start day.
-
-        :return: The period specification without the start day
-        """
-        if self.__end.month == 12 and self.__end.day == 31:
-            return self.__end.strftime("-%Y")
-        if (self.__end + datetime.timedelta(days=1)).day == 1:
-            return self.__end.strftime("-%Y-%m")
-        return self.__end.strftime("-%Y-%m-%d")
-
-    def __get_year_spec(self) -> str:
-        """Returns the period specification as a year range.
-
-        :return: The period specification as a year range.
-        :raise ValueError: The period is not a year range.
-        """
-        if self.__start.month != 1 or self.__start.day != 1 \
-                or self.__end.month != 12 or self.__end.day != 31:
-            raise ValueError
-        if self.__start.year == self.__end.year:
-            return "%04d" % self.__start.year
-        return "%04d-%04d" % (self.__start.year, self.__end.year)
-
-    def __get_month_spec(self) -> str:
-        """Returns the period specification as a month range.
-
-        :return: The period specification as a month range.
-        :raise ValueError: The period is not a month range.
-        """
-        if self.__start.day != 1 or self.__end != _month_end(self.__end):
-            raise ValueError
-        if self.__start.year == self.__end.year \
-                and self.__start.month == self.__end.month:
-            return "%04d-%02d" % (self.__start.year, self.__start.month)
-        return "%04d-%02d-%04d-%02d" % (
-            self.__start.year, self.__start.month,
-            self.__end.year, self.__end.month)
-
-    def __get_day_spec(self) -> str:
-        """Returns the period specification as a day range.
-
-        :return: The period specification as a day range.
-        :raise ValueError: The period is a month or year range.
-        """
-        if self.__start == self.__end:
-            return "%04d-%02d-%02d" % (
-                self.__start.year, self.__start.month, self.__start.day)
-        return "%04d-%02d-%02d-%04d-%02d-%02d" % (
-            self.__start.year, self.__start.month, self.__start.day,
-            self.__end.year, self.__end.month, self.__end.day)
-
-
-class PeriodDescription:
-    """The period description composer."""
-
-    def __init__(self, period: Period):
-        """Constructs the period description composer.
-
-        :param period: The period.
-        """
-        self.__start: datetime.date = period.start
-        self.__end: datetime.date = period.end
-        self.desc: str = self.__get_desc()
-
-    def __get_desc(self) -> str:
-        """Returns the period description.
-
-        :return: The period description.
-        """
-        if self.__start is None and self.__end is None:
-            return gettext("for all time")
-        if self.__start is None:
-            return self.__get_until_desc()
-        if self.__end is None:
-            return self.__get_since_desc()
-        try:
-            return self.__get_year_desc()
-        except ValueError:
-            pass
-        try:
-            return self.__get_month_desc()
-        except ValueError:
-            pass
-        return self.__get_day_desc()
-
-    def __get_since_desc(self) -> str:
-        """Returns the description without the end day.
-
-        :return: The description without the end day.
-        """
-        def get_start_desc() -> str:
-            """Returns the description of the start day.
-
-            :return: The description of the start day.
-            """
-            if self.__start.month == 1 and self.__start.day == 1:
-                return str(self.__start.year)
-            if self.__start.day == 1:
-                return self.__format_month(self.__start)
-            return self.__format_date(self.__start)
-
-        return gettext("since %(start)s", start=get_start_desc())
-
-    def __get_until_desc(self) -> str:
-        """Returns the description without the start day.
-
-        :return: The description without the start day.
-        """
-        def get_end_desc() -> str:
-            """Returns the description of the end day.
-
-            :return: The description of the end day.
-            """
-            if self.__end.month == 12 and self.__end.day == 31:
-                return str(self.__end.year)
-            if (self.__end + datetime.timedelta(days=1)).day == 1:
-                return self.__format_month(self.__end)
-            return self.__format_date(self.__end)
-
-        return gettext("until %(end)s", end=get_end_desc())
-
-    def __get_year_desc(self) -> str:
-        """Returns the description as a year range.
-
-        :return: The description as a year range.
-        :raise ValueError: The period is not a year range.
-        """
-        if self.__start.month != 1 or self.__start.day != 1 \
-                or self.__end.month != 12 or self.__end.day != 31:
-            raise ValueError
-        start: str = str(self.__start.year)
-        if self.__start.year == self.__end.year:
-            return self.__get_in_desc(start)
-        return self.__get_from_to_desc(start, str(self.__end.year))
-
-    def __get_month_desc(self) -> str:
-        """Returns the description as a month range.
-
-        :return: The description as a month range.
-        :raise ValueError: The period is not a month range.
-        """
-        if self.__start.day != 1 or self.__end != _month_end(self.__end):
-            raise ValueError
-        start: str = self.__format_month(self.__start)
-        if self.__start.year == self.__end.year \
-                and self.__start.month == self.__end.month:
-            return self.__get_in_desc(start)
-        if self.__start.year == self.__end.year:
-            return self.__get_from_to_desc(start, str(self.__end.month))
-        return self.__get_from_to_desc(start, self.__format_month(self.__end))
-
-    def __get_day_desc(self) -> str:
-        """Returns the description as a day range.
-
-        :return: The description as a day range.
-        :raise ValueError: The period is a month or year range.
-        """
-        start: str = self.__format_day(self.__start)
-        if self.__start == self.__end:
-            return self.__get_in_desc(start)
-        if self.__start.year == self.__end.year \
-                and self.__start.month == self.__end.month:
-            return self.__get_from_to_desc(start, str(self.__end.day))
-        if self.__start.year == self.__end.year:
-            end_month_day: str = f"{self.__end.month}/{self.__end.day}"
-            return self.__get_from_to_desc(start, end_month_day)
-        return self.__get_from_to_desc(start, self.__format_day(self.__end))
-
-    @staticmethod
-    def __format_date(date: datetime.date) -> str:
-        """Formats a date.
-
-        :param date: The date.
-        :return: The formatted date.
-        """
-        return f"{date.year}/{date.month}/{date.day}"
-
-    @staticmethod
-    def __format_month(month: datetime.date) -> str:
-        """Formats a month.
-
-        :param month: The month.
-        :return: The formatted month.
-        """
-        return f"{month.year}/{month.month}"
-
-    @staticmethod
-    def __format_day(day: datetime.date) -> str:
-        """Formats a day.
-
-        :param day: The day.
-        :return: The formatted day.
-        """
-        return f"{day.year}/{day.month}/{day.day}"
-
-    @staticmethod
-    def __get_in_desc(period: str) -> str:
-        """Returns the description of a whole year, month, or day.
-
-        :param period: The time period.
-        :return: The description of a whole year, month, or day.
-        """
-        return gettext("in %(period)s", period=period)
-
-    @staticmethod
-    def __get_from_to_desc(start: str, end: str) -> str:
-        """Returns the description of a separated start and end.
-
-        :param start: The start.
-        :param end: The end.
-        :return: The description of the separated start and end.
-        """
-        return gettext("in %(start)s-%(end)s", start=start, end=end)
-
-
-class ThisMonth(Period):
-    """The period of this month."""
-    def __init__(self):
-        today: datetime.date = datetime.date.today()
-        this_month_start: datetime.date \
-            = datetime.date(today.year, today.month, 1)
-        super().__init__(this_month_start, _month_end(today))
-        self.is_default = True
-        self.is_this_month = True
-
-    def _set_properties(self) -> None:
-        self.spec = "this-month"
-        self.desc = gettext("This month")
-        self.is_a_month = True
-        self.is_type_month = True
-
-
-class LastMonth(Period):
-    """The period of this month."""
-    def __init__(self):
-        today: datetime.date = datetime.date.today()
-        year: int = today.year
-        month: int = today.month - 1
-        if month < 1:
-            year = year - 1
-            month = 12
-        start: datetime.date = datetime.date(year, month, 1)
-        super().__init__(start, _month_end(start))
-        self.is_last_month = True
-
-    def _set_properties(self) -> None:
-        self.spec = "last-month"
-        self.desc = gettext("Last month")
-        self.is_a_month = True
-        self.is_type_month = True
-
-
-class SinceLastMonth(Period):
-    """The period of this month."""
-    def __init__(self):
-        today: datetime.date = datetime.date.today()
-        year: int = today.year
-        month: int = today.month - 1
-        if month < 1:
-            year = year - 1
-            month = 12
-        start: datetime.date = datetime.date(year, month, 1)
-        super().__init__(start, None)
-        self.is_since_last_month = True
-
-    def _set_properties(self) -> None:
-        self.spec = "since-last-month"
-        self.desc = gettext("Since last month")
-        self.is_type_month = True
-
-
-class ThisYear(Period):
-    """The period of this year."""
-    def __init__(self):
-        year: int = datetime.date.today().year
-        start: datetime.date = datetime.date(year, 1, 1)
-        end: datetime.date = datetime.date(year, 12, 31)
-        super().__init__(start, end)
-        self.is_this_year = True
-
-    def _set_properties(self) -> None:
-        self.spec = "this-year"
-        self.desc = gettext("This year")
-        self.is_a_year = True
-
-
-class LastYear(Period):
-    """The period of last year."""
-    def __init__(self):
-        year: int = datetime.date.today().year
-        start: datetime.date = datetime.date(year - 1, 1, 1)
-        end: datetime.date = datetime.date(year - 1, 12, 31)
-        super().__init__(start, end)
-        self.is_last_year = True
-
-    def _set_properties(self) -> None:
-        self.spec = "last-year"
-        self.desc = gettext("Last year")
-        self.is_a_year = True
-
-
-class Today(Period):
-    """The period of today."""
-    def __init__(self):
-        today: datetime.date = datetime.date.today()
-        super().__init__(today, today)
-        self.is_this_year = True
-
-    def _set_properties(self) -> None:
-        self.spec = "today"
-        self.desc = gettext("Today")
-        self.is_a_day = True
-        self.is_today = True
-
-
-class Yesterday(Period):
-    """The period of yesterday."""
-    def __init__(self):
-        yesterday: datetime.date \
-            = datetime.date.today() - datetime.timedelta(days=1)
-        super().__init__(yesterday, yesterday)
-        self.is_this_year = True
-
-    def _set_properties(self) -> None:
-        self.spec = "yesterday"
-        self.desc = gettext("Yesterday")
-        self.is_a_day = True
-        self.is_yesterday = True
-
-
-class TemplatePeriod(Period):
-    """The period template."""
-    def __init__(self):
-        super().__init__(None, None)
-
-    def _set_properties(self) -> None:
-        self.spec = "PERIOD"
-
-
-class YearPeriod(Period):
-    """A year period."""
-    def __init__(self, year: int):
-        """Constructs a year period.
-
-        :param year: The year.
-        """
-        start: datetime.date = datetime.date(year, 1, 1)
-        end: datetime.date = datetime.date(year, 12, 31)
-        super().__init__(start, end)
-        self.spec = str(year)
-        self.is_a_year = True
-
-
-DATE_SPEC_RE: str = r"(\d{4})(?:-(\d{2})(?:-(\d{2}))?)?"
-"""The regular expression of a date specification."""
-
-
-def _parse_period_spec(text: str) \
-        -> tuple[datetime.date | None, datetime.date | None]:
-    """Parses the period specification.
-
-    :param text: The period specification.
-    :return: The start and end day of the period.  The start and end day
-        may be None.
-    :raise ValueError: When the date is invalid.
-    """
-    if text == "-":
-        return None, None
-    m = re.match(f"^{DATE_SPEC_RE}$", text)
-    if m is not None:
-        return __get_start(m[1], m[2], m[3]), \
-               __get_end(m[1], m[2], m[3])
-    m = re.match(f"^{DATE_SPEC_RE}-$", text)
-    if m is not None:
-        return __get_start(m[1], m[2], m[3]), None
-    m = re.match(f"-{DATE_SPEC_RE}$", text)
-    if m is not None:
-        return None, __get_end(m[1], m[2], m[3])
-    m = re.match(f"^{DATE_SPEC_RE}-{DATE_SPEC_RE}$", text)
-    if m is not None:
-        return __get_start(m[1], m[2], m[3]), \
-               __get_end(m[4], m[5], m[6])
-    raise ValueError
-
-
-def __get_start(year: str, month: str | None, day: str | None)\
-        -> datetime.date:
-    """Returns the start of the period from the date representation.
-
-    :param year: The year.
-    :param month: The month, if any.
-    :param day: The day, if any.
-    :return: The start of the period.
-    :raise ValueError: When the date is invalid.
-    """
-    if day is not None:
-        return datetime.date(int(year), int(month), int(day))
-    if month is not None:
-        return datetime.date(int(year), int(month), 1)
-    return datetime.date(int(year), 1, 1)
-
-
-def __get_end(year: str, month: str | None, day: str | None)\
-        -> datetime.date:
-    """Returns the end of the period from the date representation.
-
-    :param year: The year.
-    :param month: The month, if any.
-    :param day: The day, if any.
-    :return: The end of the period.
-    :raise ValueError: When the date is invalid.
-    """
-    if day is not None:
-        return datetime.date(int(year), int(month), int(day))
-    if month is not None:
-        year_n: int = int(year)
-        month_n: int = int(month)
-        day_n: int = calendar.monthrange(year_n, month_n)[1]
-        return datetime.date(year_n, month_n, day_n)
-    return datetime.date(int(year), 12, 31)
-
-
-def _month_end(date: datetime.date) -> datetime.date:
-    """Returns the end day of month for a date.
-
-    :param date: The date.
-    :return: The end day of the month of that day.
-    """
-    day: int = calendar.monthrange(date.year, date.month)[1]
-    return datetime.date(date.year, date.month, day)

src/accounting/report/period/__init__.py

@@ -0,0 +1,22 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/9
+
+#  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 period utility.
+
+"""
+from .chooser import PeriodChooser
+from .parser import get_period
+from .period import Period

src/accounting/report/period/chooser.py

@@ -0,0 +1,97 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
+
+#  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 period chooser.
+
+This file is largely taken from the NanoParma ERP project, first written in
+2021/9/16 by imacat (imacat@nanoparma.com).
+
+"""
+import typing as t
+from datetime import date
+
+from accounting.models import Transaction
+from .period import Period
+from .shortcuts import ThisMonth, LastMonth, SinceLastMonth, ThisYear, \
+    LastYear, Today, Yesterday, AllTime, TemplatePeriod, YearPeriod
+
+
+class PeriodChooser:
+    """The period chooser."""
+
+    def __init__(self, get_url: t.Callable[[Period], str]):
+        """Constructs a period chooser.
+
+        :param get_url: The callback to return the URL of the current report in
+            a period.
+        """
+        self.__get_url: t.Callable[[Period], str] = get_url
+        """The callback to return the URL of the current report in a period."""
+
+        # Shortcut periods
+        self.this_month_url: str = get_url(ThisMonth())
+        """The URL for this month."""
+        self.last_month_url: str = get_url(LastMonth())
+        """The URL for last month."""
+        self.since_last_month_url: str = get_url(SinceLastMonth())
+        """The URL since last mint."""
+        self.this_year_url: str = get_url(ThisYear())
+        """The URL for this year."""
+        self.last_year_url: str = get_url(LastYear())
+        """The URL for last year."""
+        self.today_url: str = get_url(Today())
+        """The URL for today."""
+        self.yesterday_url: str = get_url(Yesterday())
+        """The URL for yesterday."""
+        self.all_url: str = get_url(AllTime())
+        """The URL for all period."""
+        self.url_template: str = get_url(TemplatePeriod())
+        """The URL template."""
+
+        first: Transaction | None \
+            = Transaction.query.order_by(Transaction.date).first()
+        start: date | None = None if first is None else first.date
+
+        # Attributes
+        self.data_start: date | None = start
+        """The start of the data."""
+        self.has_data: bool = start is not None
+        """Whether there is any data."""
+        self.has_last_month: bool = False
+        """Where there is data in last month."""
+        self.has_last_year: bool = False
+        """Whether there is data in last year."""
+        self.has_yesterday: bool = False
+        """Whether there is data in yesterday."""
+        self.available_years: list[int] = []
+        """The available years."""
+
+        if self.has_data:
+            today: date = date.today()
+            self.has_last_month = start < date(today.year, today.month, 1)
+            self.has_last_year = start.year < today.year
+            self.has_yesterday = start < today
+            if start.year < today.year - 1:
+                self.available_years \
+                    = reversed(range(start.year, today.year - 1))
+
+    def year_url(self, year: int) -> str:
+        """Returns the period URL of a year.
+
+        :param year: The year
+        :return: The period URL of the year.
+        """
+        return self.__get_url(YearPeriod(year))

src/accounting/report/period/description.py

@@ -0,0 +1,179 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
+
+#  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 period description composer.
+
+"""
+from datetime import date, timedelta
+
+from accounting.locale import gettext
+
+
+def get_desc(start: date | None, end: date | None) -> str:
+    """Returns the period description.
+
+    :param start: The start of the period.
+    :param end: The end of the period.
+    :return: The period description.
+    """
+    if start is None and end is None:
+        return gettext("for all time")
+    if start is None:
+        return __get_until_desc(end)
+    if end is None:
+        return __get_since_desc(start)
+    try:
+        return __get_year_desc(start, end)
+    except ValueError:
+        pass
+    try:
+        return __get_month_desc(start, end)
+    except ValueError:
+        pass
+    return __get_day_desc(start, end)
+
+
+def __get_since_desc(start: date) -> str:
+    """Returns the description without the end day.
+
+    :param start: The start of the period.
+    :return: The description without the end day.
+    """
+
+    def get_start_desc() -> str:
+        """Returns the description of the start day.
+
+        :return: The description of the start day.
+        """
+        if start.month == 1 and start.day == 1:
+            return str(start.year)
+        if start.day == 1:
+            return __format_month(start)
+        return __format_day(start)
+
+    return gettext("since %(start)s", start=get_start_desc())
+
+
+def __get_until_desc(end: date) -> str:
+    """Returns the description without the start day.
+
+    :param end: The end of the period.
+    :return: The description without the start day.
+    """
+
+    def get_end_desc() -> str:
+        """Returns the description of the end day.
+
+        :return: The description of the end day.
+        """
+        if end.month == 12 and end.day == 31:
+            return str(end.year)
+        if (end + timedelta(days=1)).day == 1:
+            return __format_month(end)
+        return __format_day(end)
+
+    return gettext("until %(end)s", end=get_end_desc())
+
+
+def __get_year_desc(start: date, end: date) -> str:
+    """Returns the description as a year range.
+
+    :param start: The start of the period.
+    :param end: The end of the period.
+    :return: The description as a year range.
+    :raise ValueError: The period is not a year range.
+    """
+    if start.month != 1 or start.day != 1 \
+            or end.month != 12 or end.day != 31:
+        raise ValueError
+    start_text: str = str(start.year)
+    if start.year == end.year:
+        return __get_in_desc(start_text)
+    return __get_from_to_desc(start_text, str(end.year))
+
+
+def __get_month_desc(start: date, end: date) -> str:
+    """Returns the description as a month range.
+
+    :param start: The start of the period.
+    :param end: The end of the period.
+    :return: The description as a month range.
+    :raise ValueError: The period is not a month range.
+    """
+    if start.day != 1 or (end + timedelta(days=1)).day != 1:
+        raise ValueError
+    start_text: str = __format_month(start)
+    if start.year == end.year and start.month == end.month:
+        return __get_in_desc(start_text)
+    if start.year == end.year:
+        return __get_from_to_desc(start_text, str(end.month))
+    return __get_from_to_desc(start_text, __format_month(end))
+
+
+def __get_day_desc(start: date, end: date) -> str:
+    """Returns the description as a day range.
+
+    :param start: The start of the period.
+    :param end: The end of the period.
+    :return: The description as a day range.
+    :raise ValueError: The period is a month or year range.
+    """
+    start_text: str = __format_day(start)
+    if start == end:
+        return __get_in_desc(start_text)
+    if start.year == end.year and start.month == end.month:
+        return __get_from_to_desc(start_text, str(end.day))
+    if start.year == end.year:
+        end_month_day: str = f"{end.month}/{end.day}"
+        return __get_from_to_desc(start_text, end_month_day)
+    return __get_from_to_desc(start_text, __format_day(end))
+
+
+def __format_month(month: date) -> str:
+    """Formats a month.
+
+    :param month: The month.
+    :return: The formatted month.
+    """
+    return f"{month.year}/{month.month}"
+
+
+def __format_day(day: date) -> str:
+    """Formats a day.
+
+    :param day: The day.
+    :return: The formatted day.
+    """
+    return f"{day.year}/{day.month}/{day.day}"
+
+
+def __get_in_desc(period: str) -> str:
+    """Returns the description of a whole year, month, or day.
+
+    :param period: The time period.
+    :return: The description of a whole year, month, or day.
+    """
+    return gettext("in %(period)s", period=period)
+
+
+def __get_from_to_desc(start: str, end: str) -> str:
+    """Returns the description of a separated start and end.
+
+    :param start: The start.
+    :param end: The end.
+    :return: The description of the separated start and end.
+    """
+    return gettext("in %(start)s-%(end)s", start=start, end=end)

src/accounting/report/period/month_end.py

@@ -0,0 +1,31 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
+
+#  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 utility to return the end of a month.
+
+"""
+import calendar
+from datetime import date
+
+
+def month_end(day: date) -> date:
+    """Returns the end day of month for a date.
+
+    :param day: The date.
+    :return: The end day of the month of that day.
+    """
+    last_day: int = calendar.monthrange(day.year, day.month)[1]
+    return date(day.year, day.month, last_day)

src/accounting/report/period/parser.py

@@ -0,0 +1,119 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
+
+#  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 period specification parser.
+
+"""
+import calendar
+import re
+import typing as t
+from datetime import date
+
+from .period import Period
+from .shortcuts import ThisMonth, LastMonth, SinceLastMonth, ThisYear, \
+    LastYear, Today, Yesterday, AllTime
+
+DATE_SPEC_RE: str = r"(\d{4})(?:-(\d{2})(?:-(\d{2}))?)?"
+"""The regular expression of a date specification."""
+
+
+def get_period(spec: str | None = None) -> Period:
+    """Returns a period instance.
+
+    :param spec: The period specification, or omit for the default.
+    :return: The period instance.
+    :raise ValueError: When the period specification is invalid.
+    """
+    if spec is None:
+        return ThisMonth()
+    named_periods: dict[str, t.Type[t.Callable[[], Period]]] = {
+        "this-month": lambda: ThisMonth(),
+        "last-month": lambda: LastMonth(),
+        "since-last-month": lambda: SinceLastMonth(),
+        "this-year": lambda: ThisYear(),
+        "last-year": lambda: LastYear(),
+        "today": lambda: Today(),
+        "yesterday": lambda: Yesterday(),
+        "all-time": lambda: AllTime(),
+    }
+    if spec in named_periods:
+        return named_periods[spec]()
+    start, end = __parse_spec(spec)
+    if start is not None and end is not None and start > end:
+        raise ValueError
+    return Period(start, end)
+
+
+def __parse_spec(text: str) -> tuple[date | None, date | None]:
+    """Parses the period specification.
+
+    :param text: The period specification.
+    :return: The start and end day of the period.  The start and end day
+        may be None.
+    :raise ValueError: When the date is invalid.
+    """
+    if text == "-":
+        return None, None
+    m = re.match(f"^{DATE_SPEC_RE}$", text)
+    if m is not None:
+        return __get_start(m[1], m[2], m[3]), \
+               __get_end(m[1], m[2], m[3])
+    m = re.match(f"^{DATE_SPEC_RE}-$", text)
+    if m is not None:
+        return __get_start(m[1], m[2], m[3]), None
+    m = re.match(f"-{DATE_SPEC_RE}$", text)
+    if m is not None:
+        return None, __get_end(m[1], m[2], m[3])
+    m = re.match(f"^{DATE_SPEC_RE}-{DATE_SPEC_RE}$", text)
+    if m is not None:
+        return __get_start(m[1], m[2], m[3]), \
+               __get_end(m[4], m[5], m[6])
+    raise ValueError
+
+
+def __get_start(year: str, month: str | None, day: str | None) -> date:
+    """Returns the start of the period from the date representation.
+
+    :param year: The year.
+    :param month: The month, if any.
+    :param day: The day, if any.
+    :return: The start of the period.
+    :raise ValueError: When the date is invalid.
+    """
+    if day is not None:
+        return date(int(year), int(month), int(day))
+    if month is not None:
+        return date(int(year), int(month), 1)
+    return date(int(year), 1, 1)
+
+
+def __get_end(year: str, month: str | None, day: str | None) -> date:
+    """Returns the end of the period from the date representation.
+
+    :param year: The year.
+    :param month: The month, if any.
+    :param day: The day, if any.
+    :return: The end of the period.
+    :raise ValueError: When the date is invalid.
+    """
+    if day is not None:
+        return date(int(year), int(month), int(day))
+    if month is not None:
+        year_n: int = int(year)
+        month_n: int = int(month)
+        day_n: int = calendar.monthrange(year_n, month_n)[1]
+        return date(year_n, month_n, day_n)
+    return date(int(year), 12, 31)

src/accounting/report/period/period.py

@@ -0,0 +1,129 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
+
+#  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 date period.
+
+This file is largely taken from the NanoParma ERP project, first written in
+2021/9/16 by imacat (imacat@nanoparma.com).
+
+"""
+import typing as t
+from datetime import date, timedelta
+
+from .description import get_desc
+from .month_end import month_end
+from .specification import get_spec
+
+
+class Period:
+    """A date period."""
+
+    def __init__(self, start: date | None, end: date | None):
+        """Constructs a new date period.
+
+        :param start: The start date, or None from the very beginning.
+        :param end: The end date, or None till no end.
+        """
+        self.start: date | None = start
+        """The start of the period."""
+        self.end: date | None = end
+        """The end of the period."""
+        self.is_default: bool = False
+        """Whether the is the default period."""
+        self.is_this_month: bool = False
+        """Whether the period is this month."""
+        self.is_last_month: bool = False
+        """Whether the period is last month."""
+        self.is_since_last_month: bool = False
+        """Whether the period is since last month."""
+        self.is_this_year: bool = False
+        """Whether the period is this year."""
+        self.is_last_year: bool = False
+        """Whether the period is last year."""
+        self.is_today: bool = False
+        """Whether the period is today."""
+        self.is_yesterday: bool = False
+        """Whether the period is yesterday."""
+        self.is_all: bool = start is None and end is None
+        """Whether the period is all time."""
+        self.spec: str = ""
+        """The period specification."""
+        self.desc: str = ""
+        """The text description."""
+        self.is_a_month: bool = False
+        """Whether the period is a whole month."""
+        self.is_type_month: bool = False
+        """Whether the period is for the month chooser."""
+        self.is_a_year: bool = False
+        """Whether the period is a whole year."""
+        self.is_a_day: bool = False
+        """Whether the period is a single day."""
+        self._set_properties()
+
+    def _set_properties(self) -> None:
+        """Sets the following properties.
+
+        * self.spec
+        * self.desc
+        * self.is_a_month
+        * self.is_type_month
+        * self.is_a_year
+        * self.is_a_day
+
+        Override this method to set the properties in the subclasses, to skip
+        the calculation.
+
+        :return: None.
+        """
+        self.spec = get_spec(self.start, self.end)
+        self.desc = get_desc(self.start, self.end)
+        if self.start is None or self.end is None:
+            return
+        self.is_a_month = self.start.day == 1 \
+            and self.end == month_end(self.start)
+        self.is_type_month = self.is_a_month
+        self.is_a_year = self.start == date(self.start.year, 1, 1) \
+            and self.end == date(self.start.year, 12, 31)
+        self.is_a_day = self.start == self.end
+
+    def is_year(self, year: int) -> bool:
+        """Returns whether the period is the specific year period.
+
+        :param year: The year.
+        :return: True if the period is the year period, or False otherwise.
+        """
+        if not self.is_a_year:
+            return False
+        return self.start.year == year
+
+    @property
+    def is_type_arbitrary(self) -> bool:
+        """Returns whether this period is an arbitrary period.
+
+        :return: True if this is an arbitrary period, or False otherwise.
+        """
+        return not self.is_type_month and not self.is_a_year \
+            and not self.is_a_day
+
+    @property
+    def before(self) -> t.Self | None:
+        """Returns the period before this period.
+
+        :return: The period before this period.
+        """
+        if self.start is None:
+            return None
+        return Period(None, self.start - timedelta(days=1))

src/accounting/report/period/shortcuts.py

@@ -0,0 +1,168 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
+
+#  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 named shortcut periods.
+
+"""
+from datetime import date, timedelta
+
+from accounting.locale import gettext
+from .month_end import month_end
+from .period import Period
+
+
+class ThisMonth(Period):
+    """The period of this month."""
+    def __init__(self):
+        today: date = date.today()
+        this_month_start: date = date(today.year, today.month, 1)
+        super().__init__(this_month_start, month_end(today))
+        self.is_default = True
+        self.is_this_month = True
+
+    def _set_properties(self) -> None:
+        self.spec = "this-month"
+        self.desc = gettext("This month")
+        self.is_a_month = True
+        self.is_type_month = True
+
+
+class LastMonth(Period):
+    """The period of this month."""
+    def __init__(self):
+        today: date = date.today()
+        year: int = today.year
+        month: int = today.month - 1
+        if month < 1:
+            year = year - 1
+            month = 12
+        start: date = date(year, month, 1)
+        super().__init__(start, month_end(start))
+        self.is_last_month = True
+
+    def _set_properties(self) -> None:
+        self.spec = "last-month"
+        self.desc = gettext("Last month")
+        self.is_a_month = True
+        self.is_type_month = True
+
+
+class SinceLastMonth(Period):
+    """The period of this month."""
+    def __init__(self):
+        today: date = date.today()
+        year: int = today.year
+        month: int = today.month - 1
+        if month < 1:
+            year = year - 1
+            month = 12
+        start: date = date(year, month, 1)
+        super().__init__(start, None)
+        self.is_since_last_month = True
+
+    def _set_properties(self) -> None:
+        self.spec = "since-last-month"
+        self.desc = gettext("Since last month")
+        self.is_type_month = True
+
+
+class ThisYear(Period):
+    """The period of this year."""
+    def __init__(self):
+        year: int = date.today().year
+        start: date = date(year, 1, 1)
+        end: date = date(year, 12, 31)
+        super().__init__(start, end)
+        self.is_this_year = True
+
+    def _set_properties(self) -> None:
+        self.spec = "this-year"
+        self.desc = gettext("This year")
+        self.is_a_year = True
+
+
+class LastYear(Period):
+    """The period of last year."""
+    def __init__(self):
+        year: int = date.today().year
+        start: date = date(year - 1, 1, 1)
+        end: date = date(year - 1, 12, 31)
+        super().__init__(start, end)
+        self.is_last_year = True
+
+    def _set_properties(self) -> None:
+        self.spec = "last-year"
+        self.desc = gettext("Last year")
+        self.is_a_year = True
+
+
+class Today(Period):
+    """The period of today."""
+    def __init__(self):
+        today: date = date.today()
+        super().__init__(today, today)
+        self.is_today = True
+
+    def _set_properties(self) -> None:
+        self.spec = "today"
+        self.desc = gettext("Today")
+        self.is_a_day = True
+
+
+class Yesterday(Period):
+    """The period of yesterday."""
+    def __init__(self):
+        yesterday: date = date.today() - timedelta(days=1)
+        super().__init__(yesterday, yesterday)
+        self.is_yesterday = True
+
+    def _set_properties(self) -> None:
+        self.spec = "yesterday"
+        self.desc = gettext("Yesterday")
+        self.is_a_day = True
+
+
+class AllTime(Period):
+    """The period of all time."""
+    def __init__(self):
+        super().__init__(None, None)
+        self.is_all = True
+
+    def _set_properties(self) -> None:
+        self.spec = "all-time"
+        self.desc = gettext("All")
+
+
+class TemplatePeriod(Period):
+    """The period template."""
+    def __init__(self):
+        super().__init__(None, None)
+
+    def _set_properties(self) -> None:
+        self.spec = "PERIOD"
+
+
+class YearPeriod(Period):
+    """A year period."""
+
+    def __init__(self, year: int):
+        """Constructs a year period.
+
+        :param year: The year.
+        """
+        start: date = date(year, 1, 1)
+        end: date = date(year, 12, 31)
+        super().__init__(start, end)

src/accounting/report/period/specification.py

@@ -0,0 +1,120 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
+
+#  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 period specification composer.
+
+"""
+from datetime import date, timedelta
+
+
+def get_spec(start: date | None, end: date | None) -> str:
+    """Returns the period specification.
+
+    :param start: The start of the period.
+    :param end: The end of the period.
+    :return: The period specification.
+    """
+    if start is None and end is None:
+        return "-"
+    if end is None:
+        return __get_since_spec(start)
+    if start is None:
+        return __get_until_spec(end)
+    try:
+        return __get_year_spec(start, end)
+    except ValueError:
+        pass
+    try:
+        return __get_month_spec(start, end)
+    except ValueError:
+        pass
+    return __get_day_spec(start, end)
+
+
+def __get_since_spec(start: date) -> str:
+    """Returns the period specification without the end day.
+
+    :param start: The start of the period.
+    :return: The period specification without the end day
+    """
+    if start.month == 1 and start.day == 1:
+        return start.strftime("%Y-")
+    if start.day == 1:
+        return start.strftime("%Y-%m-")
+    return start.strftime("%Y-%m-%d-")
+
+
+def __get_until_spec(end: date) -> str:
+    """Returns the period specification without the start day.
+
+    :param end: The end of the period.
+    :return: The period specification without the start day
+    """
+    if end.month == 12 and end.day == 31:
+        return end.strftime("-%Y")
+    if (end + timedelta(days=1)).day == 1:
+        return end.strftime("-%Y-%m")
+    return end.strftime("-%Y-%m-%d")
+
+
+def __get_year_spec(start: date, end: date) -> str:
+    """Returns the period specification as a year range.
+
+    :param start: The start of the period.
+    :param end: The end of the period.
+    :return: The period specification as a year range.
+    :raise ValueError: The period is not a year range.
+    """
+    if start.month != 1 or start.day != 1 \
+            or end.month != 12 or end.day != 31:
+        raise ValueError
+    start_spec: str = start.strftime("%Y")
+    if start.year == end.year:
+        return start_spec
+    end_spec: str = end.strftime("%Y")
+    return f"{start_spec}-{end_spec}"
+
+
+def __get_month_spec(start: date, end: date) -> str:
+    """Returns the period specification as a month range.
+
+    :param start: The start of the period.
+    :param end: The end of the period.
+    :return: The period specification as a month range.
+    :raise ValueError: The period is not a month range.
+    """
+    if start.day != 1 or (end + timedelta(days=1)).day != 1:
+        raise ValueError
+    start_spec: str = start.strftime("%Y-%m")
+    if start.year == end.year and start.month == end.month:
+        return start_spec
+    end_spec: str = end.strftime("%Y-%m")
+    return f"{start_spec}-{end_spec}"
+
+
+def __get_day_spec(start: date, end: date) -> str:
+    """Returns the period specification as a day range.
+
+    :param start: The start of the period.
+    :param end: The end of the period.
+    :return: The period specification as a day range.
+    :raise ValueError: The period is a month or year range.
+    """
+    start_spec: str = start.strftime("%Y-%m-%d")
+    if start == end:
+        return start_spec
+    end_spec: str = end.strftime("%Y-%m-%d")
+    return f"{start_spec}-{end_spec}"

src/accounting/report/reports/balance_sheet.py

@@ -26,15 +26,16 @@ from accounting import db
 from accounting.locale import gettext
 from accounting.models import Currency, BaseAccount, Account, Transaction, \
     JournalEntry
-from accounting.report.period import Period
-from .utils.base_page_params import BasePageParams
-from .utils.base_report import BaseReport
-from .utils.csv_export import BaseCSVRow, csv_download, period_spec
-from .utils.option_link import OptionLink
-from .utils.period_choosers import BalanceSheetPeriodChooser
-from .utils.report_chooser import ReportChooser
-from .utils.report_type import ReportType
-from .utils.urls import ledger_url, balance_sheet_url, income_statement_url
+from accounting.report.period import Period, PeriodChooser
+from accounting.report.utils.base_page_params import BasePageParams
+from accounting.report.utils.base_report import BaseReport
+from accounting.report.utils.csv_export import BaseCSVRow, csv_download, \
+    period_spec
+from accounting.report.utils.option_link import OptionLink
+from accounting.report.utils.report_chooser import ReportChooser
+from accounting.report.utils.report_type import ReportType
+from accounting.report.utils.urls import ledger_url, balance_sheet_url, \
+    income_statement_url
 
 
 class ReportAccount:
@@ -187,10 +188,10 @@ class AccountCollector:
         :return: None.
         """
         self.__add_owner_s_equity(Account.NET_CHANGE_CODE,
-                                  self.__query_currency_period(),
+                                  self.__query_current_period(),
                                   self.__period)
 
-    def __query_currency_period(self) -> Decimal | None:
+    def __query_current_period(self) -> Decimal | None:
         """Queries and returns the net income or loss for current period.
 
         :return: The net income or loss for current period.
@@ -212,7 +213,7 @@ class AccountCollector:
         :return: The balance.
         """
         conditions.extend([sa.not_(Account.base_code.startswith(x))
-                           for x in {"1", "2"}])
+                           for x in {"1", "2", "3"}])
         balance_func: sa.Function = sa.func.sum(sa.case(
             (JournalEntry.is_debit, JournalEntry.amount),
             else_=-JournalEntry.amount))
@@ -317,8 +318,8 @@ class PageParams(BasePageParams):
         """The liabilities."""
         self.owner_s_equity: Section = owner_s_equity
         """The owner's equity."""
-        self.period_chooser: BalanceSheetPeriodChooser \
-            = BalanceSheetPeriodChooser(currency)
+        self.period_chooser: PeriodChooser = PeriodChooser(
+            lambda x: balance_sheet_url(currency, x))
         """The period chooser."""
 
     @property

src/accounting/report/reports/income_expenses.py

@@ -27,17 +27,18 @@ from sqlalchemy.orm import selectinload
 from accounting import db
 from accounting.locale import gettext
 from accounting.models import Currency, Account, Transaction, JournalEntry
-from accounting.report.income_expense_account import IncomeExpensesAccount
-from accounting.report.period import Period
+from accounting.report.period import Period, PeriodChooser
+from accounting.report.utils.base_page_params import BasePageParams
+from accounting.report.utils.base_report import BaseReport
+from accounting.report.utils.csv_export import BaseCSVRow, csv_download, \
+    period_spec
+from accounting.report.utils.ie_account import IncomeExpensesAccount
+from accounting.report.utils.option_link import OptionLink
+from accounting.report.utils.report_chooser import ReportChooser
+from accounting.report.utils.report_type import ReportType
+from accounting.report.utils.urls import income_expenses_url
+from accounting.utils.cast import be
 from accounting.utils.pagination import Pagination
-from .utils.base_page_params import BasePageParams
-from .utils.base_report import BaseReport
-from .utils.csv_export import BaseCSVRow, csv_download, period_spec
-from .utils.urls import income_expenses_url
-from .utils.option_link import OptionLink
-from .utils.period_choosers import IncomeExpensesPeriodChooser
-from .utils.report_chooser import ReportChooser
-from .utils.report_type import ReportType
 
 
 class ReportEntry:
@@ -120,7 +121,7 @@ class EntryCollector:
             else_=-JournalEntry.amount))
         select: sa.Select = sa.Select(balance_func)\
             .join(Transaction).join(Account)\
-            .filter(JournalEntry.currency_code == self.__currency.code,
+            .filter(be(JournalEntry.currency_code == self.__currency.code),
                     self.__account_condition,
                     Transaction.date < self.__period.start)
         balance: int | None = db.session.scalar(select)
@@ -159,6 +160,7 @@ class EntryCollector:
                         JournalEntry.currency_code == self.__currency.code,
                         sa.not_(self.__account_condition))
                 .order_by(Transaction.date,
+                          Transaction.no,
                           JournalEntry.is_debit,
                           JournalEntry.no)
                 .options(selectinload(JournalEntry.account),
@@ -289,8 +291,8 @@ class PageParams(BasePageParams):
         """The report entries."""
         self.total: ReportEntry | None = total
         """The total entry."""
-        self.period_chooser: IncomeExpensesPeriodChooser \
-            = IncomeExpensesPeriodChooser(currency, account)
+        self.period_chooser: PeriodChooser = PeriodChooser(
+            lambda x: income_expenses_url(currency, account, x))
         """The period chooser."""
 
     @property
@@ -342,7 +344,7 @@ class PageParams(BasePageParams):
                           self.account.id == 0)]
         in_use: sa.Select = sa.Select(JournalEntry.account_id)\
             .join(Account)\
-            .filter(JournalEntry.currency_code == self.currency.code,
+            .filter(be(JournalEntry.currency_code == self.currency.code),
                     sa.or_(Account.base_code.startswith("11"),
                            Account.base_code.startswith("12"),
                            Account.base_code.startswith("21"),
@@ -433,7 +435,7 @@ class IncomeExpenses(BaseReport):
         if self.__total is not None:
             all_entries.append(self.__total)
         pagination: Pagination[ReportEntry] \
-            = Pagination[ReportEntry](all_entries)
+            = Pagination[ReportEntry](all_entries, is_reversed=True)
         page_entries: list[ReportEntry] = pagination.list
         has_data: bool = len(page_entries) > 0
         brought_forward: ReportEntry | None = None

src/accounting/report/reports/income_statement.py

@@ -26,15 +26,15 @@ from accounting import db
 from accounting.locale import gettext
 from accounting.models import Currency, BaseAccount, Account, Transaction, \
     JournalEntry
-from accounting.report.period import Period
-from .utils.base_page_params import BasePageParams
-from .utils.base_report import BaseReport
-from .utils.csv_export import BaseCSVRow, csv_download, period_spec
-from .utils.urls import ledger_url, income_statement_url
-from .utils.option_link import OptionLink
-from .utils.period_choosers import IncomeStatementPeriodChooser
-from .utils.report_chooser import ReportChooser
-from .utils.report_type import ReportType
+from accounting.report.period import Period, PeriodChooser
+from accounting.report.utils.base_page_params import BasePageParams
+from accounting.report.utils.base_report import BaseReport
+from accounting.report.utils.csv_export import BaseCSVRow, csv_download, \
+    period_spec
+from accounting.report.utils.option_link import OptionLink
+from accounting.report.utils.report_chooser import ReportChooser
+from accounting.report.utils.report_type import ReportType
+from accounting.report.utils.urls import ledger_url, income_statement_url
 
 
 class ReportAccount:
@@ -159,8 +159,9 @@ class PageParams(BasePageParams):
         self.__has_data: bool = has_data
         """True if there is any data, or False otherwise."""
         self.sections: list[Section] = sections
-        self.period_chooser: IncomeStatementPeriodChooser \
-            = IncomeStatementPeriodChooser(currency)
+        """The sections in the income statement."""
+        self.period_chooser: PeriodChooser = PeriodChooser(
+            lambda x: income_statement_url(currency, x))
         """The period chooser."""
 
     @property

src/accounting/report/reports/journal.py

@@ -26,14 +26,15 @@ from sqlalchemy.orm import selectinload
 
 from accounting.locale import gettext
 from accounting.models import Currency, Account, Transaction, JournalEntry
-from accounting.report.period import Period
+from accounting.report.period import Period, PeriodChooser
+from accounting.report.utils.base_page_params import BasePageParams
+from accounting.report.utils.base_report import BaseReport
+from accounting.report.utils.csv_export import BaseCSVRow, csv_download, \
+    period_spec
+from accounting.report.utils.report_chooser import ReportChooser
+from accounting.report.utils.report_type import ReportType
+from accounting.report.utils.urls import journal_url
 from accounting.utils.pagination import Pagination
-from .utils.base_page_params import BasePageParams
-from .utils.base_report import BaseReport
-from .utils.csv_export import BaseCSVRow, csv_download, period_spec
-from .utils.period_choosers import JournalPeriodChooser
-from .utils.report_chooser import ReportChooser
-from .utils.report_type import ReportType
 
 
 class ReportEntry:
@@ -122,8 +123,8 @@ class PageParams(BasePageParams):
         """The pagination."""
         self.entries: list[JournalEntry] = entries
         """The entries."""
-        self.period_chooser: JournalPeriodChooser \
-            = JournalPeriodChooser()
+        self.period_chooser: PeriodChooser = PeriodChooser(
+            lambda x: journal_url(x))
         """The period chooser."""
 
     @property
@@ -187,6 +188,7 @@ class Journal(BaseReport):
         return JournalEntry.query.join(Transaction)\
             .filter(*conditions)\
             .order_by(Transaction.date,
+                      Transaction.no,
                       JournalEntry.is_debit.desc(),
                       JournalEntry.no)\
             .options(selectinload(JournalEntry.account),
@@ -207,7 +209,7 @@ class Journal(BaseReport):
         :return: The report as HTML.
         """
         pagination: Pagination[JournalEntry] \
-            = Pagination[JournalEntry](self.__entries)
+            = Pagination[JournalEntry](self.__entries, is_reversed=True)
         params: PageParams = PageParams(period=self.__period,
                                         pagination=pagination,
                                         entries=pagination.list)

src/accounting/report/reports/ledger.py

@@ -27,16 +27,17 @@ from sqlalchemy.orm import selectinload
 from accounting import db
 from accounting.locale import gettext
 from accounting.models import Currency, Account, Transaction, JournalEntry
-from accounting.report.period import Period
+from accounting.report.period import Period, PeriodChooser
+from accounting.report.utils.base_page_params import BasePageParams
+from accounting.report.utils.base_report import BaseReport
+from accounting.report.utils.csv_export import BaseCSVRow, csv_download, \
+    period_spec
+from accounting.report.utils.option_link import OptionLink
+from accounting.report.utils.report_chooser import ReportChooser
+from accounting.report.utils.report_type import ReportType
+from accounting.report.utils.urls import ledger_url
+from accounting.utils.cast import be
 from accounting.utils.pagination import Pagination
-from .utils.base_page_params import BasePageParams
-from .utils.base_report import BaseReport
-from .utils.csv_export import BaseCSVRow, csv_download, period_spec
-from .utils.urls import ledger_url
-from .utils.option_link import OptionLink
-from .utils.period_choosers import LedgerPeriodChooser
-from .utils.report_chooser import ReportChooser
-from .utils.report_type import ReportType
 
 
 class ReportEntry:
@@ -110,12 +111,14 @@ class EntryCollector:
         """
         if self.__period.start is None:
             return None
+        if self.__account.is_nominal:
+            return None
         balance_func: sa.Function = sa.func.sum(sa.case(
             (JournalEntry.is_debit, JournalEntry.amount),
             else_=-JournalEntry.amount))
         select: sa.Select = sa.Select(balance_func).join(Transaction)\
-            .filter(JournalEntry.currency_code == self.__currency.code,
-                    JournalEntry.account_id == self.__account.id,
+            .filter(be(JournalEntry.currency_code == self.__currency.code),
+                    be(JournalEntry.account_id == self.__account.id),
                     Transaction.date < self.__period.start)
         balance: int | None = db.session.scalar(select)
         if balance is None:
@@ -146,6 +149,7 @@ class EntryCollector:
         return [ReportEntry(x) for x in JournalEntry.query.join(Transaction)
                 .filter(*conditions)
                 .order_by(Transaction.date,
+                          Transaction.no,
                           JournalEntry.is_debit.desc(),
                           JournalEntry.no)
                 .options(selectinload(JournalEntry.transaction)).all()]
@@ -174,6 +178,8 @@ class EntryCollector:
 
         :return: None.
         """
+        if self.__account.is_nominal:
+            return None
         balance: Decimal = 0 if self.brought_forward is None \
             else self.brought_forward.balance
         for entry in self.entries:
@@ -262,8 +268,8 @@ class PageParams(BasePageParams):
         """The entries."""
         self.total: ReportEntry | None = total
         """The total entry."""
-        self.period_chooser: LedgerPeriodChooser \
-            = LedgerPeriodChooser(currency, account)
+        self.period_chooser: PeriodChooser = PeriodChooser(
+            lambda x: ledger_url(currency, account, x))
         """The period chooser."""
 
     @property
@@ -301,7 +307,7 @@ class PageParams(BasePageParams):
         :return: The account options.
         """
         in_use: sa.Select = sa.Select(JournalEntry.account_id)\
-            .filter(JournalEntry.currency_code == self.currency.code)\
+            .filter(be(JournalEntry.currency_code == self.currency.code))\
             .group_by(JournalEntry.account_id)
         return [OptionLink(str(x), ledger_url(self.currency, x, self.period),
                            x.id == self.account.id)
@@ -380,7 +386,7 @@ class Ledger(BaseReport):
         if self.__total is not None:
             all_entries.append(self.__total)
         pagination: Pagination[ReportEntry] \
-            = Pagination[ReportEntry](all_entries)
+            = Pagination[ReportEntry](all_entries, is_reversed=True)
         page_entries: list[ReportEntry] = pagination.list
         has_data: bool = len(page_entries) > 0
         brought_forward: ReportEntry | None = None

src/accounting/report/reports/search.py

@@ -27,14 +27,15 @@ from sqlalchemy.orm import selectinload
 from accounting.locale import gettext
 from accounting.models import Currency, CurrencyL10n, Account, AccountL10n, \
     Transaction, JournalEntry
+from accounting.report.utils.base_page_params import BasePageParams
+from accounting.report.utils.base_report import BaseReport
+from accounting.report.utils.csv_export import csv_download
+from accounting.report.utils.report_chooser import ReportChooser
+from accounting.report.utils.report_type import ReportType
+from accounting.utils.cast import be
 from accounting.utils.pagination import Pagination
 from accounting.utils.query import parse_query_keywords
 from .journal import get_csv_rows
-from .utils.base_page_params import BasePageParams
-from .utils.base_report import BaseReport
-from .utils.csv_export import csv_download
-from .utils.report_chooser import ReportChooser
-from .utils.report_type import ReportType
 
 
 class EntryCollector:
@@ -68,7 +69,11 @@ class EntryCollector:
             except ArithmeticError:
                 pass
             conditions.append(sa.or_(*sub_conditions))
-        return JournalEntry.query.filter(*conditions)\
+        return JournalEntry.query.join(Transaction).filter(*conditions)\
+            .order_by(Transaction.date,
+                      Transaction.no,
+                      JournalEntry.is_debit,
+                      JournalEntry.no)\
             .options(selectinload(JournalEntry.account),
                      selectinload(JournalEntry.currency),
                      selectinload(JournalEntry.transaction)).all()
@@ -91,8 +96,8 @@ class EntryCollector:
                Account.title_l10n.contains(k),
                code.contains(k),
                Account.id.in_(select_l10n)]
-        if k in gettext("Pay-off needed"):
-            conditions.append(Account.is_pay_off_needed)
+        if k in gettext("Need offset"):
+            conditions.append(Account.is_need_offset)
         return sa.select(Account.id).filter(sa.or_(*conditions))
 
     @staticmethod
@@ -121,7 +126,7 @@ class EntryCollector:
         try:
             txn_date = datetime.strptime(k, "%Y")
             conditions.append(
-                sa.extract("year", Transaction.date) == txn_date.year)
+                be(sa.extract("year", Transaction.date) == txn_date.year))
         except ValueError:
             pass
         try:
@@ -194,7 +199,7 @@ class Search(BaseReport):
         :return: The report as HTML.
         """
         pagination: Pagination[JournalEntry] \
-            = Pagination[JournalEntry](self.__entries)
+            = Pagination[JournalEntry](self.__entries, is_reversed=True)
         params: PageParams = PageParams(pagination=pagination,
                                         entries=pagination.list)
         return render_template("accounting/report/search.html",

src/accounting/report/reports/trial_balance.py

@@ -25,15 +25,15 @@ from flask import Response, render_template
 from accounting import db
 from accounting.locale import gettext
 from accounting.models import Currency, Account, Transaction, JournalEntry
-from accounting.report.period import Period
-from .utils.base_page_params import BasePageParams
-from .utils.base_report import BaseReport
-from .utils.csv_export import BaseCSVRow, csv_download, period_spec
-from .utils.urls import ledger_url, trial_balance_url
-from .utils.option_link import OptionLink
-from .utils.period_choosers import TrialBalancePeriodChooser
-from .utils.report_chooser import ReportChooser
-from .utils.report_type import ReportType
+from accounting.report.period import Period, PeriodChooser
+from accounting.report.utils.base_page_params import BasePageParams
+from accounting.report.utils.base_report import BaseReport
+from accounting.report.utils.csv_export import BaseCSVRow, csv_download, \
+    period_spec
+from accounting.report.utils.option_link import OptionLink
+from accounting.report.utils.report_chooser import ReportChooser
+from accounting.report.utils.report_type import ReportType
+from accounting.report.utils.urls import ledger_url, trial_balance_url
 
 
 class ReportAccount:
@@ -121,8 +121,8 @@ class PageParams(BasePageParams):
         """The accounts in the trial balance."""
         self.total: Total = total
         """The total of the trial balance."""
-        self.period_chooser: TrialBalancePeriodChooser \
-            = TrialBalancePeriodChooser(currency)
+        self.period_chooser: PeriodChooser = PeriodChooser(
+            lambda x: trial_balance_url(currency, x))
         """The period chooser."""
 
     @property

src/accounting/report/reports/utils/period_choosers.py

@@ -1,194 +0,0 @@
-# The Mia! Accounting Flask Project.
-# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/4
-
-#  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 period choosers.
-
-This file is largely taken from the NanoParma ERP project, first written in
-2021/9/16 by imacat (imacat@nanoparma.com).
-
-"""
-from abc import ABC, abstractmethod
-from datetime import date
-
-from accounting.models import Currency, Account, Transaction
-from accounting.report.income_expense_account import IncomeExpensesAccount
-from accounting.report.period import YearPeriod, Period, ThisMonth, \
-    LastMonth, SinceLastMonth, ThisYear, LastYear, Today, Yesterday, \
-    TemplatePeriod
-from .urls import journal_url, ledger_url, income_expenses_url, \
-    trial_balance_url, income_statement_url, balance_sheet_url
-
-
-class PeriodChooser(ABC):
-    """The period chooser."""
-
-    def __init__(self, start: date | None):
-        """Constructs a period chooser.
-
-        :param start: The start of the period.
-        """
-
-        # Shortcut periods
-        self.this_month_url: str = self._url_for(ThisMonth())
-        """The URL for this month."""
-        self.last_month_url: str = self._url_for(LastMonth())
-        """The URL for last month."""
-        self.since_last_month_url: str = self._url_for(SinceLastMonth())
-        """The URL since last mint."""
-        self.this_year_url: str = self._url_for(ThisYear())
-        """The URL for this year."""
-        self.last_year_url: str = self._url_for(LastYear())
-        """The URL for last year."""
-        self.today_url: str = self._url_for(Today())
-        """The URL for today."""
-        self.yesterday_url: str = self._url_for(Yesterday())
-        """The URL for yesterday."""
-        self.all_url: str = self._url_for(Period(None, None))
-        """The URL for all period."""
-        self.url_template: str = self._url_for(TemplatePeriod())
-        """The URL template."""
-
-        # Attributes
-        self.data_start: date | None = start
-        """The start of the data."""
-        self.has_data: bool = start is not None
-        """Whether there is any data."""
-        self.has_last_month: bool = False
-        """Where there is data in last month."""
-        self.has_last_year: bool = False
-        """Whether there is data in last year."""
-        self.has_yesterday: bool = False
-        """Whether there is data in yesterday."""
-        self.available_years: list[int] = []
-        """The available years."""
-
-        if self.has_data is not None:
-            today: date = date.today()
-            self.has_last_month = start < date(today.year, today.month, 1)
-            self.has_last_year = start.year < today.year
-            self.has_yesterday = start < today
-            if start.year < today.year - 1:
-                self.available_years \
-                    = reversed(range(start.year, today.year - 1))
-
-    @abstractmethod
-    def _url_for(self, period: Period) -> str:
-        """Returns the URL for a period.
-
-        :param period: The period.
-        :return: The URL for the period.
-        """
-        pass
-
-    def year_url(self, year: int) -> str:
-        """Returns the period URL of a year.
-
-        :param year: The year
-        :return: The period URL of the year.
-        """
-        return self._url_for(YearPeriod(year))
-
-
-class JournalPeriodChooser(PeriodChooser):
-    """The journal period chooser."""
-
-    def __init__(self):
-        """Constructs the journal period chooser."""
-        first: Transaction | None \
-            = Transaction.query.order_by(Transaction.date).first()
-        super().__init__(None if first is None else first.date)
-
-    def _url_for(self, period: Period) -> str:
-        return journal_url(period)
-
-
-class LedgerPeriodChooser(PeriodChooser):
-    """The ledger period chooser."""
-
-    def __init__(self, currency: Currency, account: Account):
-        """Constructs the ledger period chooser."""
-        self.currency: Currency = currency
-        """The currency."""
-        self.account: Account = account
-        """The account."""
-        first: Transaction | None \
-            = Transaction.query.order_by(Transaction.date).first()
-        super().__init__(None if first is None else first.date)
-
-    def _url_for(self, period: Period) -> str:
-        return ledger_url(self.currency, self.account, period)
-
-
-class IncomeExpensesPeriodChooser(PeriodChooser):
-    """The income and expenses log period chooser."""
-
-    def __init__(self, currency: Currency, account: IncomeExpensesAccount):
-        """Constructs the income and expenses log period chooser."""
-        self.currency: Currency = currency
-        """The currency."""
-        self.account: IncomeExpensesAccount = account
-        """The account."""
-        first: Transaction | None \
-            = Transaction.query.order_by(Transaction.date).first()
-        super().__init__(None if first is None else first.date)
-
-    def _url_for(self, period: Period) -> str:
-        return income_expenses_url(self.currency, self.account, period)
-
-
-class TrialBalancePeriodChooser(PeriodChooser):
-    """The trial balance period chooser."""
-
-    def __init__(self, currency: Currency):
-        """Constructs the trial balance period chooser."""
-        self.currency: Currency = currency
-        """The currency."""
-        first: Transaction | None \
-            = Transaction.query.order_by(Transaction.date).first()
-        super().__init__(None if first is None else first.date)
-
-    def _url_for(self, period: Period) -> str:
-        return trial_balance_url(self.currency, period)
-
-
-class IncomeStatementPeriodChooser(PeriodChooser):
-    """The income statement period chooser."""
-
-    def __init__(self, currency: Currency):
-        """Constructs the income statement period chooser."""
-        self.currency: Currency = currency
-        """The currency."""
-        first: Transaction | None \
-            = Transaction.query.order_by(Transaction.date).first()
-        super().__init__(None if first is None else first.date)
-
-    def _url_for(self, period: Period) -> str:
-        return income_statement_url(self.currency, period)
-
-
-class BalanceSheetPeriodChooser(PeriodChooser):
-    """The balance sheet period chooser."""
-
-    def __init__(self, currency: Currency):
-        """Constructs the balance sheet period chooser."""
-        self.currency: Currency = currency
-        """The currency."""
-        first: Transaction | None \
-            = Transaction.query.order_by(Transaction.date).first()
-        super().__init__(None if first is None else first.date)
-
-    def _url_for(self, period: Period) -> str:
-        return balance_sheet_url(self.currency, period)

src/accounting/report/utils/__init__.py

@@ -14,6 +14,6 @@
 #  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 utilities to generate reports.
+"""The utilities for the reports.
 
 """

src/accounting/report/utils/ie_account.py

@@ -19,6 +19,8 @@
 """
 import typing as t
 
+from flask import current_app
+
 from accounting.locale import gettext
 from accounting.models import Account
 
@@ -62,3 +64,23 @@ class IncomeExpensesAccount:
         account.title = gettext("current assets and liabilities")
         account.str = account.title
         return account
+
+
+def default_ie_account_code() -> str:
+    """Returns the default account code for the income and expenses log.
+
+    :return: The default account code for the income and expenses log.
+    """
+    with current_app.app_context():
+        return current_app.config.get("DEFAULT_IE_ACCOUNT", Account.CASH_CODE)
+
+
+def default_ie_account() -> IncomeExpensesAccount:
+    """Returns the default account for the income and expenses log.
+
+    :return: The default account for the income and expenses log.
+    """
+    code: str = default_ie_account_code()
+    if code == IncomeExpensesAccount.CURRENT_AL_CODE:
+        return IncomeExpensesAccount.current_assets_and_liabilities()
+    return IncomeExpensesAccount(Account.find_by_code(code))

src/accounting/report/utils/option_link.py

@@ -27,10 +27,15 @@ class OptionLink:
         """Constructs an option link.
 
         :param title: The title.
-        :param url: The URI.
+        :param url: The URL.
         :param is_active: True if active, or False otherwise
+        :param fa_icon: The font-awesome icon, if any.
         """
         self.title: str = title
+        """The title."""
         self.url: str = url
+        """The URL."""
         self.is_active: bool = is_active
+        """True if active, or False otherwise."""
         self.fa_icon: str | None = fa_icon
+        """The font-awesome icon, if any."""

src/accounting/report/utils/report_chooser.py

@@ -28,9 +28,9 @@ from flask_babel import LazyString
 from accounting import db
 from accounting.locale import gettext
 from accounting.models import Currency, Account
-from accounting.report.income_expense_account import IncomeExpensesAccount
-from accounting.report.period import Period
+from accounting.report.period import Period, get_period
 from accounting.template_globals import default_currency_code
+from .ie_account import IncomeExpensesAccount
 from .option_link import OptionLink
 from .report_type import ReportType
 from .urls import journal_url, ledger_url, income_expenses_url, \
@@ -53,8 +53,7 @@ class ReportChooser:
         """
         self.__active_report: ReportType = active_report
         """The currently active report."""
-        self.__period: Period = Period.get_instance() if period is None \
-            else period
+        self.__period: Period = get_period() if period is None else period
         """The period."""
         self.__currency: Currency = db.session.get(
             Currency, default_currency_code()) \

src/accounting/report/utils/report_type.py

@@ -35,4 +35,4 @@ class ReportType(Enum):
     BALANCE_SHEET: str = "balance-sheet"
     """The balance sheet."""
     SEARCH: str = "search"
-    """The balance sheet."""
+    """The search."""

src/accounting/report/utils/urls.py

@@ -20,8 +20,9 @@
 from flask import url_for
 
 from accounting.models import Currency, Account
-from accounting.report.income_expense_account import IncomeExpensesAccount
 from accounting.report.period import Period
+from accounting.template_globals import default_currency_code
+from .ie_account import IncomeExpensesAccount, default_ie_account_code
 
 
 def journal_url(period: Period) \
@@ -62,6 +63,10 @@ def income_expenses_url(currency: Currency, account: IncomeExpensesAccount,
     :param period: The period.
     :return: The URL of the income and expenses log.
     """
+    if currency.code == default_currency_code() \
+            and account.code == default_ie_account_code() \
+            and period.is_default:
+        return url_for("accounting.report.default")
     if period.is_default:
         return url_for("accounting.report.income-expenses-default",
                        currency=currency, account=account)

src/accounting/report/views.py

@@ -19,41 +19,56 @@
 """
 from flask import Blueprint, request, Response
 
+from accounting import db
 from accounting.models import Currency, Account
+from accounting.report.period import Period, get_period
+from accounting.template_globals import default_currency_code
 from accounting.utils.permission import has_permission, can_view
-from .income_expense_account import IncomeExpensesAccount
-from .period import Period
 from .reports import Journal, Ledger, IncomeExpenses, TrialBalance, \
     IncomeStatement, BalanceSheet, Search
 from .template_filters import format_amount
+from .utils.ie_account import IncomeExpensesAccount, default_ie_account
 
 bp: Blueprint = Blueprint("report", __name__)
 """The view blueprint for the reports."""
 bp.add_app_template_filter(format_amount, "accounting_report_format_amount")
 
 
+@bp.get("", endpoint="default")
+@has_permission(can_view)
+def get_default_report() -> str | Response:
+    """Returns the income and expenses log in the default period.
+
+    :return: The income and expenses log in the default period.
+    """
+    return __get_income_expenses(
+        db.session.get(Currency, default_currency_code()),
+        default_ie_account(),
+        get_period())
+
+
 @bp.get("journal", endpoint="journal-default")
 @has_permission(can_view)
-def get_default_journal_list() -> str | Response:
+def get_default_journal() -> str | Response:
     """Returns the journal in the default period.
 
     :return: The journal in the default period.
     """
-    return __get_journal_list(Period.get_instance())
+    return __get_journal(get_period())
 
 
 @bp.get("journal/<period:period>", endpoint="journal")
 @has_permission(can_view)
-def get_journal_list(period: Period) -> str | Response:
+def get_journal(period: Period) -> str | Response:
     """Returns the journal.
 
     :param period: The period.
     :return: The journal in the period.
     """
-    return __get_journal_list(period)
+    return __get_journal(period)
 
 
-def __get_journal_list(period: Period) -> str | Response:
+def __get_journal(period: Period) -> str | Response:
     """Returns the journal.
 
     :param period: The period.
@@ -68,21 +83,20 @@ def __get_journal_list(period: Period) -> str | Response:
 @bp.get("ledger/<currency:currency>/<account:account>",
         endpoint="ledger-default")
 @has_permission(can_view)
-def get_default_ledger_list(currency: Currency, account: Account) \
-        -> str | Response:
+def get_default_ledger(currency: Currency, account: Account) -> str | Response:
     """Returns the ledger in the default period.
 
     :param currency: The currency.
     :param account: The account.
     :return: The ledger in the default period.
     """
-    return __get_ledger_list(currency, account, Period.get_instance())
+    return __get_ledger(currency, account, get_period())
 
 
 @bp.get("ledger/<currency:currency>/<account:account>/<period:period>",
         endpoint="ledger")
 @has_permission(can_view)
-def get_ledger_list(currency: Currency, account: Account, period: Period) \
+def get_ledger(currency: Currency, account: Account, period: Period) \
         -> str | Response:
     """Returns the ledger.
 
@@ -91,10 +105,10 @@ def get_ledger_list(currency: Currency, account: Account, period: Period) \
     :param period: The period.
     :return: The ledger in the period.
     """
-    return __get_ledger_list(currency, account, period)
+    return __get_ledger(currency, account, period)
 
 
-def __get_ledger_list(currency: Currency, account: Account, period: Period) \
+def __get_ledger(currency: Currency, account: Account, period: Period) \
         -> str | Response:
     """Returns the ledger.
 
@@ -109,10 +123,10 @@ def __get_ledger_list(currency: Currency, account: Account, period: Period) \
     return report.html()
 
 
-@bp.get("income-expenses/<currency:currency>/<ioAccount:account>",
+@bp.get("income-expenses/<currency:currency>/<ieAccount:account>",
         endpoint="income-expenses-default")
 @has_permission(can_view)
-def get_default_income_expenses_list(currency: Currency,
+def get_default_income_expenses(currency: Currency,
                                 account: IncomeExpensesAccount) \
         -> str | Response:
     """Returns the income and expenses log in the default period.
@@ -121,15 +135,14 @@ def get_default_income_expenses_list(currency: Currency,
     :param account: The account.
     :return: The income and expenses log in the default period.
     """
-    return __get_income_expenses_list(currency, account, Period.get_instance())
+    return __get_income_expenses(currency, account, get_period())
 
 
 @bp.get(
-    "income-expenses/<currency:currency>/<ioAccount:account>/<period:period>",
+    "income-expenses/<currency:currency>/<ieAccount:account>/<period:period>",
     endpoint="income-expenses")
 @has_permission(can_view)
-def get_income_expenses_list(currency: Currency,
-                             account: IncomeExpensesAccount,
+def get_income_expenses(currency: Currency, account: IncomeExpensesAccount,
                         period: Period) -> str | Response:
     """Returns the income and expenses log.
 
@@ -138,11 +151,10 @@ def get_income_expenses_list(currency: Currency,
     :param period: The period.
     :return: The income and expenses log in the period.
     """
-    return __get_income_expenses_list(currency, account, period)
+    return __get_income_expenses(currency, account, period)
 
 
-def __get_income_expenses_list(currency: Currency,
-                               account: IncomeExpensesAccount,
+def __get_income_expenses(currency: Currency, account: IncomeExpensesAccount,
                           period: Period) -> str | Response:
     """Returns the income and expenses log.
 
@@ -160,31 +172,29 @@ def __get_income_expenses_list(currency: Currency,
 @bp.get("trial-balance/<currency:currency>",
         endpoint="trial-balance-default")
 @has_permission(can_view)
-def get_default_trial_balance_list(currency: Currency) -> str | Response:
+def get_default_trial_balance(currency: Currency) -> str | Response:
     """Returns the trial balance in the default period.
 
     :param currency: The currency.
     :return: The trial balance in the default period.
     """
-    return __get_trial_balance_list(currency, Period.get_instance())
+    return __get_trial_balance(currency, get_period())
 
 
 @bp.get("trial-balance/<currency:currency>/<period:period>",
         endpoint="trial-balance")
 @has_permission(can_view)
-def get_trial_balance_list(currency: Currency, period: Period) \
-        -> str | Response:
+def get_trial_balance(currency: Currency, period: Period) -> str | Response:
     """Returns the trial balance.
 
     :param currency: The currency.
     :param period: The period.
     :return: The trial balance in the period.
     """
-    return __get_trial_balance_list(currency, period)
+    return __get_trial_balance(currency, period)
 
 
-def __get_trial_balance_list(currency: Currency, period: Period) \
-        -> str | Response:
+def __get_trial_balance(currency: Currency, period: Period) -> str | Response:
     """Returns the trial balance.
 
     :param currency: The currency.
@@ -200,30 +210,29 @@ def __get_trial_balance_list(currency: Currency, period: Period) \
 @bp.get("income-statement/<currency:currency>",
         endpoint="income-statement-default")
 @has_permission(can_view)
-def get_default_income_statement_list(currency: Currency) -> str | Response:
+def get_default_income_statement(currency: Currency) -> str | Response:
     """Returns the income statement in the default period.
 
     :param currency: The currency.
     :return: The income statement in the default period.
     """
-    return __get_income_statement_list(currency, Period.get_instance())
+    return __get_income_statement(currency, get_period())
 
 
 @bp.get("income-statement/<currency:currency>/<period:period>",
         endpoint="income-statement")
 @has_permission(can_view)
-def get_income_statement_list(currency: Currency, period: Period) \
-        -> str | Response:
+def get_income_statement(currency: Currency, period: Period) -> str | Response:
     """Returns the income statement.
 
     :param currency: The currency.
     :param period: The period.
     :return: The income statement in the period.
     """
-    return __get_income_statement_list(currency, period)
+    return __get_income_statement(currency, period)
 
 
-def __get_income_statement_list(currency: Currency, period: Period) \
+def __get_income_statement(currency: Currency, period: Period) \
         -> str | Response:
     """Returns the income statement.
 
@@ -240,19 +249,19 @@ def __get_income_statement_list(currency: Currency, period: Period) \
 @bp.get("balance-sheet/<currency:currency>",
         endpoint="balance-sheet-default")
 @has_permission(can_view)
-def get_default_balance_sheet_list(currency: Currency) -> str | Response:
+def get_default_balance_sheet(currency: Currency) -> str | Response:
     """Returns the balance sheet in the default period.
 
     :param currency: The currency.
     :return: The balance sheet in the default period.
     """
-    return __get_balance_sheet_list(currency, Period.get_instance())
+    return __get_balance_sheet(currency, get_period())
 
 
 @bp.get("balance-sheet/<currency:currency>/<period:period>",
         endpoint="balance-sheet")
 @has_permission(can_view)
-def get_balance_sheet_list(currency: Currency, period: Period) \
+def get_balance_sheet(currency: Currency, period: Period) \
         -> str | Response:
     """Returns the balance sheet.
 
@@ -260,10 +269,10 @@ def get_balance_sheet_list(currency: Currency, period: Period) \
     :param period: The period.
     :return: The balance sheet in the period.
     """
-    return __get_balance_sheet_list(currency, period)
+    return __get_balance_sheet(currency, period)
 
 
-def __get_balance_sheet_list(currency: Currency, period: Period) \
+def __get_balance_sheet(currency: Currency, period: Period) \
         -> str | Response:
     """Returns the balance sheet.
 
@@ -288,4 +297,3 @@ def search() -> str | Response:
     if "as" in request.args and request.args["as"] == "csv":
         return report.csv()
     return report.html()
-

src/accounting/static/css/style.css

@@ -31,6 +31,9 @@
     color: #141619;
     background-color: #D3D3D4;
 }
+.form-control.accounting-disabled {
+    background-color: #e9ecef;
+}
 
 /** The toolbar */
 .accounting-toolbar {
@@ -113,6 +116,33 @@
     border-bottom: thick double slategray;
 }
 
+/* Links between objects */
+.accounting-original-entry {
+    border-top: thin solid darkslategray;
+    padding: 0.2rem 0.5rem;
+}
+.accounting-original-entry a {
+    color: inherit;
+    text-decoration: none;
+}
+.accounting-original-entry a:hover {
+    color: inherit;
+}
+.accounting-offset-entries {
+    border-top: thin solid darkslategray;
+    padding: 0.2rem 0.5rem;
+}
+.accounting-offset-entries ul li {
+    list-style: none;
+}
+.accounting-offset-entries ul li a {
+    color: inherit;
+    text-decoration: none;
+}
+.accounting-offset-entries ul li a:hover {
+    color: inherit;
+}
+
 /** The option selector */
 .accounting-selector-list {
     height: 20rem;
@@ -136,9 +166,6 @@
 .accounting-list-group-stripped .list-group-item:nth-child(2n+1) {
     background-color: #f2f2f2;
 }
-.accounting-list-group-stripped .list-group-item-success:nth-child(2n+1) {
-    background-color: #c7dbd2;
-}
 .accounting-list-group-hover .list-group-item:hover {
     background-color: #ececec;
 }
@@ -153,6 +180,9 @@
     font-weight: bolder;
     border-top: thick double slategray;
 }
+.accounting-entry-editor-original-entry-content {
+    width: calc(100% - 3rem);
+}
 
 /* The report table */
 .accounting-report-table-header, .accounting-report-table-footer {
@@ -191,12 +221,18 @@ a.accounting-report-table-row {
 .accounting-journal-table .accounting-report-table-row {
     grid-template-columns: 1fr 1fr 2fr 4fr 1fr 1fr;
 }
-.accounting-ledger-table .accounting-report-table-row {
+.accounting-ledger-real-table .accounting-report-table-row {
     grid-template-columns: 1fr 4fr 1fr 1fr 1fr;
 }
-.accounting-ledger-table .accounting-report-table-footer .accounting-report-table-row {
+.accounting-ledger-real-table .accounting-report-table-footer .accounting-report-table-row {
     grid-template-columns: 5fr 1fr 1fr 1fr;
 }
+.accounting-ledger-nominal-table .accounting-report-table-row {
+    grid-template-columns: 1fr 4fr 1fr 1fr;
+}
+.accounting-ledger-nominal-table .accounting-report-table-footer .accounting-report-table-row {
+    grid-template-columns: 5fr 1fr 1fr;
+}
 .accounting-income-expenses-table .accounting-report-table-row {
     grid-template-columns: 1fr 2fr 4fr 1fr 1fr 1fr;
 }

src/accounting/static/js/account-form.js

@@ -24,90 +24,293 @@
 
 // Initializes the page JavaScript.
 document.addEventListener("DOMContentLoaded", () => {
-    initializeBaseAccountSelector();
-    document.getElementById("accounting-base-code")
-        .onchange = validateBase;
-    document.getElementById("accounting-title")
-        .onchange = validateTitle;
-    document.getElementById("accounting-form")
-        .onsubmit = validateForm;
+    AccountForm.initialize();
 });
 
 /**
- * Initializes the base account selector.
+ * The account form.
  *
  * @private
  */
-function initializeBaseAccountSelector() {
-    const selector = document.getElementById("accounting-base-selector-modal");
-    const base = document.getElementById("accounting-base");
-    const baseCode = document.getElementById("accounting-base-code");
-    const baseContent = document.getElementById("accounting-base-content");
-    const options = Array.from(document.getElementsByClassName("accounting-base-option"));
-    const btnClear = document.getElementById("accounting-btn-clear-base");
-    selector.addEventListener("show.bs.modal", () => {
-        base.classList.add("accounting-not-empty");
-        for (const option of options) {
-            option.classList.remove("active");
-        }
-        const selected = document.getElementById("accounting-base-option-" + baseCode.value);
-        if (selected !== null) {
-            selected.classList.add("active");
-        }
-    });
-    selector.addEventListener("hidden.bs.modal", () => {
-        if (baseCode.value === "") {
-            base.classList.remove("accounting-not-empty");
-        }
-    });
-    for (const option of options) {
-        option.onclick = () => {
-            baseCode.value = option.dataset.code;
-            baseContent.innerText = option.dataset.content;
-            btnClear.classList.add("btn-danger");
-            btnClear.classList.remove("btn-secondary")
-            btnClear.disabled = false;
-            validateBase();
-            bootstrap.Modal.getInstance(selector).hide();
+class AccountForm {
+
+    /**
+     * The base account selector
+     * @type {BaseAccountSelector}
+     */
+    #baseAccountSelector;
+
+    /**
+     * The form element
+     * @type {HTMLFormElement}
+     */
+    #formElement;
+
+    /**
+     * The control of the base account
+     * @type {HTMLDivElement}
+     */
+    #baseControl;
+
+    /**
+     * The input of the base account
+     * @type {HTMLInputElement}
+     */
+    #baseCode;
+
+    /**
+     * The base account
+     * @type {HTMLDivElement}
+     */
+    #base;
+
+    /**
+     * The error message for the base account
+     * @type {HTMLDivElement}
+     */
+    #baseError;
+
+    /**
+     * The title
+     * @type {HTMLInputElement}
+     */
+    #title;
+
+    /**
+     * The error message of the title
+     * @type {HTMLDivElement}
+     */
+    #titleError;
+
+    /**
+     * The control of the is-need-offset option
+     * @type {HTMLDivElement}
+     */
+    #isNeedOffsetControl;
+
+    /**
+     * The is-need-offset option
+     * @type {HTMLInputElement}
+     */
+    #isNeedOffset;
+
+    /**
+     * Constructs the account form.
+     *
+     */
+    constructor() {
+        this.#baseAccountSelector = new BaseAccountSelector(this);
+        this.#formElement = document.getElementById("accounting-form");
+        this.#baseControl = document.getElementById("accounting-base-control");
+        this.#baseCode = document.getElementById("accounting-base-code");
+        this.#base = document.getElementById("accounting-base");
+        this.#baseError = document.getElementById("accounting-base-error");
+        this.#title = document.getElementById("accounting-title");
+        this.#titleError = document.getElementById("accounting-title-error");
+        this.#isNeedOffsetControl = document.getElementById("accounting-is-need-offset-control");
+        this.#isNeedOffset = document.getElementById("accounting-is-need-offset");
+        this.#formElement.onsubmit = () => {
+            return this.#validateForm();
+        };
+        this.#baseControl.onclick = () => {
+            this.#baseControl.classList.add("accounting-not-empty");
+            this.#baseAccountSelector.onOpen(this.#baseCode.value);
         };
     }
-    btnClear.onclick = () => {
-        baseCode.value = "";
-        baseContent.innerText = "";
-        btnClear.classList.add("btn-secondary")
-        btnClear.classList.remove("btn-danger");
-        btnClear.disabled = true;
-        validateBase();
-        bootstrap.Modal.getInstance(selector).hide();
+
+    /**
+     * The callback when the base account selector is closed.
+     *
+     */
+    onBaseAccountSelectorClosed() {
+        if (this.#baseCode.value === "") {
+            this.#baseControl.classList.remove("accounting-not-empty");
         }
-    initializeBaseAccountQuery();
     }
 
     /**
- * Initializes the query on the base account options.
+     * Sets the base account.
+     *
+     * @param code {string} the base account code
+     * @param text {string} the text for the base account
+     */
+    setBaseAccount(code, text) {
+        this.#baseCode.value = code;
+        this.#base.innerText = text;
+        if (["1", "2", "3"].includes(code.substring(0, 1))) {
+            this.#isNeedOffsetControl.classList.remove("d-none");
+            this.#isNeedOffset.disabled = false;
+        } else {
+            this.#isNeedOffsetControl.classList.add("d-none");
+            this.#isNeedOffset.disabled = true;
+            this.#isNeedOffset.checked = false;
+        }
+        this.#validateBase();
+    }
+
+    /**
+     * Clears the base account.
+     *
+     */
+    clearBaseAccount() {
+        this.#baseCode.value = "";
+        this.#base.innerText = "";
+        this.#validateBase();
+    }
+
+    /**
+     * Validates the form.
+     *
+     * @returns {boolean} true if valid, or false otherwise
+     */
+    #validateForm() {
+        let isValid = true;
+        isValid = this.#validateBase() && isValid;
+        isValid = this.#validateTitle() && isValid;
+        return isValid;
+    }
+
+    /**
+     * Validates the base account.
+     *
+     * @returns {boolean} true if valid, or false otherwise
+     */
+    #validateBase() {
+        if (this.#baseCode.value === "") {
+            this.#baseControl.classList.add("is-invalid");
+            this.#baseError.innerText = A_("Please select the base account.");
+            return false;
+        }
+        this.#baseControl.classList.remove("is-invalid");
+        this.#baseError.innerText = "";
+        return true;
+    }
+
+    /**
+     * Validates the title.
+     *
+     * @returns {boolean} true if valid, or false otherwise
+     */
+    #validateTitle() {
+        this.#title.value = this.#title.value.trim();
+        if (this.#title.value === "") {
+            this.#title.classList.add("is-invalid");
+            this.#titleError.innerText = A_("Please fill in the title.");
+            return false;
+        }
+        this.#title.classList.remove("is-invalid");
+        this.#titleError.innerText = "";
+        return true;
+    }
+
+    /**
+     * The account form
+     * @type {AccountForm} the form
+     */
+    static #form;
+
+    static initialize() {
+        this.#form = new AccountForm();
+    }
+}
+
+/**
+ * The base account selector.
  *
  * @private
  */
-function initializeBaseAccountQuery() {
-    const query = document.getElementById("accounting-base-selector-query");
-    const optionList = document.getElementById("accounting-base-option-list");
-    const options = Array.from(document.getElementsByClassName("accounting-base-option"));
-    const queryNoResult = document.getElementById("accounting-base-option-no-result");
-    query.addEventListener("input", () => {
-        if (query.value === "") {
-            for (const option of options) {
+class BaseAccountSelector {
+
+    /**
+     * The account form
+     * @type {AccountForm}
+     */
+    #form;
+
+    /**
+     * The selector modal
+     * @type {HTMLDivElement}
+     */
+    #modal;
+
+    /**
+     * The query input
+     * @type {HTMLInputElement}
+     */
+    #query;
+
+    /**
+     * The error message when the query has no result
+     * @type {HTMLParagraphElement}
+     */
+    #queryNoResult;
+
+    /**
+     * The option list
+     * @type {HTMLUListElement}
+     */
+    #optionList;
+
+    /**
+     * The options
+     * @type {HTMLLIElement[]}
+     */
+    #options;
+
+    /**
+     * The button to clear the base account value
+     * @type {HTMLButtonElement}
+     */
+    #clearButton;
+
+    /**
+     * Constructs the base account selector.
+     *
+     * @param form {AccountForm} the form
+     */
+    constructor(form) {
+        this.#form = form;
+        this.#modal = document.getElementById("accounting-base-selector-modal");
+        this.#query = document.getElementById("accounting-base-selector-query");
+        this.#optionList = document.getElementById("accounting-base-selector-option-list");
+        // noinspection JSValidateTypes
+        this.#options = Array.from(document.getElementsByClassName("accounting-base-selector-option"));
+        this.#clearButton = document.getElementById("accounting-base-selector-clear");
+        this.#queryNoResult = document.getElementById("accounting-base-selector-option-no-result");
+        this.#modal.addEventListener("hidden.bs.modal", () => {
+            this.#form.onBaseAccountSelectorClosed();
+        });
+        for (const option of this.#options) {
+            option.onclick = () => {
+                this.#form.setBaseAccount(option.dataset.code, option.dataset.content);
+            };
+        }
+        this.#clearButton.onclick = () => {
+            this.#form.clearBaseAccount();
+        };
+        this.#initializeBaseAccountQuery();
+    }
+
+    /**
+     * Initializes the query.
+     *
+     */
+    #initializeBaseAccountQuery() {
+        this.#query.addEventListener("input", () => {
+            if (this.#query.value === "") {
+                for (const option of this.#options) {
                     option.classList.remove("d-none");
                 }
-            optionList.classList.remove("d-none");
-            queryNoResult.classList.add("d-none");
+                this.#optionList.classList.remove("d-none");
+                this.#queryNoResult.classList.add("d-none");
                 return
             }
             let hasAnyMatched = false;
-        for (const option of options) {
+            for (const option of this.#options) {
                 const queryValues = JSON.parse(option.dataset.queryValues);
                 let isMatched = false;
                 for (const queryValue of queryValues) {
-                if (queryValue.includes(query.value)) {
+                    if (queryValue.includes(this.#query.value)) {
                         isMatched = true;
                         break;
                     }
@@ -120,65 +323,36 @@ function initializeBaseAccountQuery() {
                 }
             }
             if (!hasAnyMatched) {
-            optionList.classList.add("d-none");
-            queryNoResult.classList.remove("d-none");
+                this.#optionList.classList.add("d-none");
+                this.#queryNoResult.classList.remove("d-none");
             } else {
-            optionList.classList.remove("d-none");
-            queryNoResult.classList.add("d-none");
+                this.#optionList.classList.remove("d-none");
+                this.#queryNoResult.classList.add("d-none");
             }
         });
     }
 
     /**
- * Validates the form.
+     * The callback when the base account selector is shown.
      *
- * @returns {boolean} true if valid, or false otherwise
- * @private
+     * @param baseCode {string} the active base code
      */
-function validateForm() {
-    let isValid = true;
-    isValid = validateBase() && isValid;
-    isValid = validateTitle() && isValid;
-    return isValid;
+    onOpen(baseCode) {
+        for (const option of this.#options) {
+            if (option.dataset.code === baseCode) {
+                option.classList.add("active");
+            } else {
+                option.classList.remove("active");
             }
-
-/**
- * Validates the base account.
- *
- * @returns {boolean} true if valid, or false otherwise
- * @private
- */
-function validateBase() {
-    const field = document.getElementById("accounting-base-code");
-    const error = document.getElementById("accounting-base-code-error");
-    const displayField = document.getElementById("accounting-base");
-    field.value = field.value.trim();
-    if (field.value === "") {
-        displayField.classList.add("is-invalid");
-        error.innerText = A_("Please select the base account.");
-        return false;
         }
-    displayField.classList.remove("is-invalid");
-    error.innerText = "";
-    return true;
+        if (baseCode === "") {
+            this.#clearButton.classList.add("btn-secondary")
+            this.#clearButton.classList.remove("btn-danger");
+            this.#clearButton.disabled = true;
+        } else {
+            this.#clearButton.classList.add("btn-danger");
+            this.#clearButton.classList.remove("btn-secondary")
+            this.#clearButton.disabled = false;
         }
-
-/**
- * Validates the title.
- *
- * @returns {boolean} true if valid, or false otherwise
- * @private
- */
-function validateTitle() {
-    const field = document.getElementById("accounting-title");
-    const error = document.getElementById("accounting-title-error");
-    field.value = field.value.trim();
-    if (field.value === "") {
-        field.classList.add("is-invalid");
-        error.innerText = A_("Please fill in the title.");
-        return false;
     }
-    field.classList.remove("is-invalid");
-    error.innerText = "";
-    return true;
 }

src/accounting/static/js/account-selector.js

@@ -22,22 +22,23 @@
  */
 "use strict";
 
-// Initializes the page JavaScript.
-document.addEventListener("DOMContentLoaded", () => {
-    AccountSelector.initialize();
-});
-
 /**
  * The account selector.
  *
  */
 class AccountSelector {
 
+    /**
+     * The journal entry editor
+     * @type {JournalEntryEditor}
+     */
+    #entryEditor;
+
     /**
      * The entry type
      * @type {string}
      */
-    #entryType;
+    entryType;
 
     /**
      * The prefix of the HTML ID and class
@@ -45,78 +46,81 @@ class AccountSelector {
      */
     #prefix;
 
+    /**
+     * The button to clear the account
+     * @type {HTMLButtonElement}
+     */
+    #clearButton
+
+    /**
+     * The query input
+     * @type {HTMLInputElement}
+     */
+    #query;
+
+    /**
+     * The error message when the query has no result
+     * @type {HTMLParagraphElement}
+     */
+    #queryNoResult;
+
+    /**
+     * The option list
+     * @type {HTMLUListElement}
+     */
+    #optionList;
+
+    /**
+     * The options
+     * @type {HTMLLIElement[]}
+     */
+    #options;
+
+    /**
+     * The more item to show all accounts
+     * @type {HTMLLIElement}
+     */
+    #more;
+
     /**
      * Constructs an account selector.
      *
-     * @param modal {HTMLFormElement} the account selector modal
+     * @param entryEditor {JournalEntryEditor} the journal entry editor
+     * @param entryType {string} the entry type, either "debit" or "credit"
      */
-    constructor(modal) {
-        this.#entryType = modal.dataset.entryType;
-        this.#prefix = "accounting-account-selector-" + modal.dataset.entryType;
-        this.#init();
-    }
-
-    /**
-     * Initializes the account selector.
-     *
-     */
-    #init() {
-        const formAccountControl = document.getElementById("accounting-entry-form-account-control");
-        const formAccount = document.getElementById("accounting-entry-form-account");
-        const more = document.getElementById(this.#prefix + "-more");
-        const btnClear = document.getElementById(this.#prefix + "-btn-clear");
-        const options = Array.from(document.getElementsByClassName(this.#prefix + "-option"));
-        more.onclick = () => {
-            more.classList.add("d-none");
-            this.#filterAccountOptions();
-        };
-        this.#initializeAccountQuery();
-        btnClear.onclick = () => {
-            formAccountControl.classList.remove("accounting-not-empty");
-            formAccount.innerText = "";
-            formAccount.dataset.code = "";
-            formAccount.dataset.text = "";
-            validateJournalEntryAccount();
-        };
-        for (const option of options) {
-            option.onclick = () => {
-                formAccountControl.classList.add("accounting-not-empty");
-                formAccount.innerText = option.dataset.content;
-                formAccount.dataset.code = option.dataset.code;
-                formAccount.dataset.text = option.dataset.content;
-                validateJournalEntryAccount();
+    constructor(entryEditor, entryType) {
+        this.#entryEditor = entryEditor
+        this.entryType = entryType;
+        this.#prefix = "accounting-account-selector-" + entryType;
+        this.#query = document.getElementById(this.#prefix + "-query");
+        this.#queryNoResult = document.getElementById(this.#prefix + "-option-no-result");
+        this.#optionList = document.getElementById(this.#prefix + "-option-list");
+        // noinspection JSValidateTypes
+        this.#options = Array.from(document.getElementsByClassName(this.#prefix + "-option"));
+        this.#more = document.getElementById(this.#prefix + "-more");
+        this.#clearButton = document.getElementById(this.#prefix + "-btn-clear");
+        this.#more.onclick = () => {
+            this.#more.classList.add("d-none");
+            this.#filterOptions();
         };
+        this.#clearButton.onclick = () => this.#entryEditor.clearAccount();
+        for (const option of this.#options) {
+            option.onclick = () => this.#entryEditor.saveAccount(option.dataset.code, option.dataset.content, option.classList.contains("accounting-account-is-need-offset"));
         }
-    }
-
-    /**
-     * Initializes the query on the account options.
-     *
-     */
-    #initializeAccountQuery() {
-        const query = document.getElementById(this.#prefix + "-query");
-        query.addEventListener("input", () => {
-            this.#filterAccountOptions();
+        this.#query.addEventListener("input", () => {
+            this.#filterOptions();
         });
     }
 
     /**
-     * Filters the account options.
+     * Filters the options.
      *
      */
-    #filterAccountOptions() {
-        const query = document.getElementById(this.#prefix + "-query");
-        const optionList = document.getElementById(this.#prefix + "-option-list");
-        if (optionList === null) {
-            console.log(this.#prefix + "-option-list");
-        }
-        const options = Array.from(document.getElementsByClassName(this.#prefix + "-option"));
-        const more = document.getElementById(this.#prefix + "-more");
-        const queryNoResult = document.getElementById(this.#prefix + "-option-no-result");
-        const codesInUse = this.#getAccountCodeUsedInForm();
+    #filterOptions() {
+        const codesInUse = this.#getCodesUsedInForm();
         let shouldAnyShow = false;
-        for (const option of options) {
-            const shouldShow = this.#shouldAccountOptionShow(option, more, codesInUse, query);
+        for (const option of this.#options) {
+            const shouldShow = this.#shouldOptionShow(option, this.#more, codesInUse, this.#query);
             if (shouldShow) {
                 option.classList.remove("d-none");
                 shouldAnyShow = true;
@@ -124,12 +128,12 @@ class AccountSelector {
                 option.classList.add("d-none");
             }
         }
-        if (!shouldAnyShow && more.classList.contains("d-none")) {
-            optionList.classList.add("d-none");
-            queryNoResult.classList.remove("d-none");
+        if (!shouldAnyShow && this.#more.classList.contains("d-none")) {
+            this.#optionList.classList.add("d-none");
+            this.#queryNoResult.classList.remove("d-none");
         } else {
-            optionList.classList.remove("d-none");
-            queryNoResult.classList.add("d-none");
+            this.#optionList.classList.remove("d-none");
+            this.#queryNoResult.classList.add("d-none");
         }
     }
 
@@ -138,26 +142,24 @@ class AccountSelector {
      *
      * @return {string[]} the account codes that are used in the form
      */
-    #getAccountCodeUsedInForm() {
-        const accountCodes = Array.from(document.getElementsByClassName("accounting-" + this.#prefix + "-account-code"));
-        const formAccount = document.getElementById("accounting-entry-form-account");
-        const inUse = [formAccount.dataset.code];
-        for (const accountCode of accountCodes) {
-            inUse.push(accountCode.value);
+    #getCodesUsedInForm() {
+        const inUse = this.#entryEditor.form.getAccountCodesUsed(this.entryType);
+        if (this.#entryEditor.accountCode !== null) {
+            inUse.push(this.#entryEditor.accountCode);
         }
         return inUse
     }
 
     /**
-     * Returns whether an account option should show.
+     * Returns whether an option should show.
      *
-     * @param option {HTMLLIElement} the account option
-     * @param more {HTMLLIElement} the more account element
+     * @param option {HTMLLIElement} the option
+     * @param more {HTMLLIElement} the more element
      * @param inUse {string[]} the account codes that are used in the form
      * @param query {HTMLInputElement} the query element, if any
-     * @return {boolean} true if the account option should show, or false otherwise
+     * @return {boolean} true if the option should show, or false otherwise
      */
-    #shouldAccountOptionShow(option, more, inUse, query) {
+    #shouldOptionShow(option, more, inUse, query) {
         const isQueryMatched = () => {
             if (query.value === "") {
                 return true;
@@ -180,71 +182,43 @@ class AccountSelector {
     }
 
     /**
-     * Initializes the account selector when it is shown.
+     * The callback when the account selector is shown.
      *
      */
-    initShow() {
-        const formAccount = document.getElementById("accounting-entry-form-account");
-        const query = document.getElementById(this.#prefix + "-query")
-        const more = document.getElementById(this.#prefix + "-more");
-        const options = Array.from(document.getElementsByClassName(this.#prefix + "-option"));
-        const btnClear = document.getElementById(this.#prefix + "-btn-clear");
-        query.value = "";
-        more.classList.remove("d-none");
-        this.#filterAccountOptions();
-        for (const option of options) {
-            if (option.dataset.code === formAccount.dataset.code) {
+    onOpen() {
+        this.#query.value = "";
+        this.#more.classList.remove("d-none");
+        this.#filterOptions();
+        for (const option of this.#options) {
+            if (option.dataset.code === this.#entryEditor.accountCode) {
                 option.classList.add("active");
             } else {
                 option.classList.remove("active");
             }
         }
-        if (formAccount.dataset.code === "") {
-            btnClear.classList.add("btn-secondary");
-            btnClear.classList.remove("btn-danger");
-            btnClear.disabled = true;
+        if (this.#entryEditor.accountCode === null) {
+            this.#clearButton.classList.add("btn-secondary");
+            this.#clearButton.classList.remove("btn-danger");
+            this.#clearButton.disabled = true;
         } else {
-            btnClear.classList.add("btn-danger");
-            btnClear.classList.remove("btn-secondary");
-            btnClear.disabled = false;
+            this.#clearButton.classList.add("btn-danger");
+            this.#clearButton.classList.remove("btn-secondary");
+            this.#clearButton.disabled = false;
         }
     }
 
     /**
-     * The account selectors.
-     * @type {{debit: AccountSelector, credit: AccountSelector}}
-     */
-    static #selectors = {}
-
-    /**
-     * Initializes the account selectors.
+     * Returns the account selector instances.
      *
+     * @param entryEditor {JournalEntryEditor} the journal entry editor
+     * @return {{debit: AccountSelector, credit: AccountSelector}}
      */
-    static initialize() {
-        const modals = Array.from(document.getElementsByClassName("accounting-account-selector-modal"));
+    static getInstances(entryEditor) {
+        const selectors = {}
+        const modals = Array.from(document.getElementsByClassName("accounting-account-selector"));
         for (const modal of modals) {
-            const selector = new AccountSelector(modal);
-            this.#selectors[selector.#entryType] = selector;
+            selectors[modal.dataset.entryType] = new AccountSelector(entryEditor, modal.dataset.entryType);
         }
-        this.#initializeTransactionForm();
-    }
-
-    /**
-     * Initializes the transaction form.
-     *
-     */
-    static #initializeTransactionForm() {
-        const entryForm = document.getElementById("accounting-entry-form");
-        const formAccountControl = document.getElementById("accounting-entry-form-account-control");
-        formAccountControl.onclick = () => this.#selectors[entryForm.dataset.entryType].initShow();
-    }
-    /**
-     * Initializes the account selector for the journal entry form.
-     *x
-     */
-    static initializeJournalEntryForm() {
-        const entryForm = document.getElementById("accounting-entry-form");
-        const formAccountControl = document.getElementById("accounting-entry-form-account-control");
-        formAccountControl.dataset.bsTarget = "#accounting-account-selector-" + entryForm.dataset.entryType + "-modal";
+        return selectors;
     }
 }

src/accounting/static/js/currency-form.js

@@ -24,152 +24,151 @@
 
 // Initializes the page JavaScript.
 document.addEventListener("DOMContentLoaded", () => {
-    document.getElementById("accounting-code")
-        .onchange = validateCode;
-    document.getElementById("accounting-name")
-        .onchange = validateName;
-    document.getElementById("accounting-form")
-        .onsubmit = validateForm;
+    CurrencyForm.initialize();
 });
 
 /**
- * The asynchronous validation result
- * @type {object}
+ * The currency form.
+ *
  * @private
  */
-let isAsyncValid = {};
+class CurrencyForm {
+
+    /**
+     * The form.
+     * @type {HTMLFormElement}
+     */
+    #formElement;
+
+    /**
+     * The code
+     * @type {HTMLInputElement}
+     */
+    #code;
+
+    /**
+     * The error message of the code
+     * @type {HTMLDivElement}
+     */
+    #codeError;
+
+    /**
+     * The name
+     * @type {HTMLInputElement}
+     */
+    #name;
+
+    /**
+     * The error message of the name
+     * @type {HTMLDivElement}
+     */
+    #nameError;
+
+    /**
+     * Constructs the currency form.
+     *
+     */
+    constructor() {
+        this.#formElement = document.getElementById("accounting-form");
+        this.#code = document.getElementById("accounting-code");
+        this.#codeError = document.getElementById("accounting-code-error");
+        this.#name = document.getElementById("accounting-name");
+        this.#nameError = document.getElementById("accounting-name-error");
+        this.#code.onchange = () => {
+            this.#validateCode().then();
+        };
+        this.#name.onchange = () => {
+            this.#validateName();
+        };
+        this.#formElement.onsubmit = () => {
+            this.#validateForm().then((isValid) => {
+                if (isValid) {
+                    this.#formElement.submit();
+                }
+            });
+            return false;
+        };
+    }
 
     /**
      * Validates the form.
      *
- * @returns {boolean} true if valid, or false otherwise
- * @private
+     * @returns {Promise<boolean>} true if valid, or false otherwise
      */
-function validateForm() {
-    isAsyncValid = {
-        "code": false,
-        "_sync": false,
-    };
+    async #validateForm() {
         let isValid = true;
-    isValid = validateCode() && isValid;
-    isValid = validateName() && isValid;
-    isAsyncValid["_sync"] = isValid;
-    submitFormIfAllAsyncValid();
-    return false;
-}
-
-/**
- * Submits the form if the whole form passed the asynchronous
- * validations.
- *
- * @private
- */
-function submitFormIfAllAsyncValid() {
-    let isValid = true;
-    for (const key of Object.keys(isAsyncValid)) {
-        isValid = isAsyncValid[key] && isValid;
-    }
-    if (isValid) {
-        document.getElementById("accounting-form").submit()
-    }
+        isValid = await this.#validateCode() && isValid;
+        isValid = this.#validateName() && isValid;
+        return isValid;
     }
 
     /**
      * Validates the code.
      *
      * @param changeEvent {Event} the change event, if invoked from onchange
- * @returns {boolean} true if valid, or false otherwise
- * @private
+     * @returns {Promise<boolean>} true if valid, or false otherwise
      */
-function validateCode(changeEvent = null) {
-    const key = "code";
-    const isSubmission = changeEvent === null;
-    let hasAsyncValidation = false;
-    const field = document.getElementById("accounting-code");
-    const error = document.getElementById("accounting-code-error");
-    field.value = field.value.trim();
-    if (field.value === "") {
-        field.classList.add("is-invalid");
-        error.innerText = A_("Please fill in the code.");
+    async #validateCode(changeEvent = null) {
+        this.#code.value = this.#code.value.trim();
+        if (this.#code.value === "") {
+            this.#code.classList.add("is-invalid");
+            this.#codeError.innerText = A_("Please fill in the code.");
             return false;
         }
-    const blocklist = JSON.parse(field.dataset.blocklist);
-    if (blocklist.includes(field.value)) {
-        field.classList.add("is-invalid");
-        error.innerText = A_("This code is not available.");
+        const blocklist = JSON.parse(this.#code.dataset.blocklist);
+        if (blocklist.includes(this.#code.value)) {
+            this.#code.classList.add("is-invalid");
+            this.#codeError.innerText = A_("This code is not available.");
             return false;
         }
-    if (!field.value.match(/^[A-Z]{3}$/)) {
-        field.classList.add("is-invalid");
-        error.innerText = A_("Code can only be composed of 3 upper-cased letters.");
+        if (!this.#code.value.match(/^[A-Z]{3}$/)) {
+            this.#code.classList.add("is-invalid");
+            this.#codeError.innerText = A_("Code can only be composed of 3 upper-cased letters.");
             return false;
         }
-    const original = field.dataset.original;
-    if (original === "" || field.value !== original) {
-        hasAsyncValidation = true;
-        validateAsyncCodeIsDuplicated(isSubmission, key);
+        const original = this.#code.dataset.original;
+        if (original === "" || this.#code.value !== original) {
+            const response = await fetch(this.#code.dataset.existsUrl + "?q=" + encodeURIComponent(this.#code.value));
+            const data = await response.json();
+            if (data["exists"]) {
+                this.#code.classList.add("is-invalid");
+                this.#codeError.innerText = A_("Code conflicts with another currency.");
+                return false;
             }
-    if (!hasAsyncValidation) {
-        isAsyncValid[key] = true;
-        field.classList.remove("is-invalid");
-        error.innerText = "";
         }
+        this.#code.classList.remove("is-invalid");
+        this.#codeError.innerText = "";
         return true;
     }
 
-/**
- * Validates asynchronously whether the code is duplicated.
- * The boolean validation result is stored in isAsyncValid[key].
- *
- * @param isSubmission {boolean} whether this is invoked from a form submission
- * @param key {string} the key to store the result in isAsyncValid
- * @private
- */
-function validateAsyncCodeIsDuplicated(isSubmission, key) {
-    const field = document.getElementById("accounting-code");
-    const error = document.getElementById("accounting-code-error");
-    const url = field.dataset.existsUrl;
-    const onLoad = function () {
-        if (this.status === 200) {
-            const result = JSON.parse(this.responseText);
-            if (result["exists"]) {
-                field.classList.add("is-invalid");
-                error.innerText = A_("Code conflicts with another currency.");
-                if (isSubmission) {
-                    isAsyncValid[key] = false;
-                }
-                return;
-            }
-            field.classList.remove("is-invalid");
-            error.innerText = "";
-            if (isSubmission) {
-                isAsyncValid[key] = true;
-                submitFormIfAllAsyncValid();
-            }
-        }
-    };
-    const request = new XMLHttpRequest();
-    request.onload = onLoad;
-    request.open("GET", url + "?q=" + encodeURIComponent(field.value));
-    request.send();
-}
-
     /**
      * Validates the name.
      *
      * @returns {boolean} true if valid, or false otherwise
- * @private
      */
-function validateName() {
-    const field = document.getElementById("accounting-name");
-    const error = document.getElementById("accounting-name-error");
-    field.value = field.value.trim();
-    if (field.value === "") {
-        field.classList.add("is-invalid");
-        error.innerText = A_("Please fill in the name.");
+    #validateName() {
+        this.#name.value = this.#name.value.trim();
+        if (this.#name.value === "") {
+            this.#name.classList.add("is-invalid");
+            this.#nameError.innerText = A_("Please fill in the name.");
             return false;
         }
-    field.classList.remove("is-invalid");
-    error.innerText = "";
+        this.#name.classList.remove("is-invalid");
+        this.#nameError.innerText = "";
         return true;
     }
+
+    /**
+     * The form
+     * @type {CurrencyForm}
+     */
+    static #form;
+
+    /**
+     * Initializes the currency form.
+     *
+     */
+    static initialize() {
+        this.#form = new CurrencyForm();
+    }
+}

src/accounting/static/js/journal-entry-editor.js

@@ -0,0 +1,596 @@
+/* The Mia! Accounting Flask Project
+ * journal-entry-editor.js: The JavaScript for the journal entry editor
+ */
+
+/*  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/2/25
+ */
+"use strict";
+
+/**
+ * The journal entry editor.
+ *
+ */
+class JournalEntryEditor {
+
+    /**
+     * The transaction form
+     * @type {TransactionForm}
+     */
+    form;
+
+    /**
+     * The journal entry editor
+     * @type {HTMLFormElement}
+     */
+    #element;
+
+    /**
+     * The bootstrap modal
+     * @type {HTMLDivElement}
+     */
+    #modal;
+
+    /**
+     * The entry type, either "debit" or "credit"
+     * @type {string}
+     */
+    entryType;
+
+    /**
+     * The prefix of the HTML ID and class
+     * @type {string}
+     */
+    #prefix = "accounting-entry-editor"
+
+    /**
+     * The container of the original entry
+     * @type {HTMLDivElement}
+     */
+    #originalEntryContainer;
+
+    /**
+     * The control of the original entry
+     * @type {HTMLDivElement}
+     */
+    #originalEntryControl;
+
+    /**
+     * The original entry
+     * @type {HTMLDivElement}
+     */
+    #originalEntry;
+
+    /**
+     * The error message of the original entry
+     * @type {HTMLDivElement}
+     */
+    #originalEntryError;
+
+    /**
+     * The delete button of the original entry
+     * @type {HTMLButtonElement}
+     */
+    #originalEntryDelete;
+
+    /**
+     * The control of the summary
+     * @type {HTMLDivElement}
+     */
+    #summaryControl;
+
+    /**
+     * The summary
+     * @type {HTMLDivElement}
+     */
+    #summary;
+
+    /**
+     * The error message of the summary
+     * @type {HTMLDivElement}
+     */
+    #summaryError;
+
+    /**
+     * The control of the account
+     * @type {HTMLDivElement}
+     */
+    #accountControl;
+
+    /**
+     * The account
+     * @type {HTMLDivElement}
+     */
+    #account;
+
+    /**
+     * The error message of the account
+     * @type {HTMLDivElement}
+     */
+    #accountError;
+
+    /**
+     * The amount
+     * @type {HTMLInputElement}
+     */
+    #amount;
+
+    /**
+     * The error message of the amount
+     * @type {HTMLDivElement}
+     */
+    #amountError;
+
+    /**
+     * The journal entry to edit
+     * @type {JournalEntrySubForm|null}
+     */
+    entry;
+
+    /**
+     * The debit or credit entry side sub-form
+     * @type {DebitCreditSideSubForm}
+     */
+    #side;
+
+    /**
+     * Whether the journal entry needs offset
+     * @type {boolean}
+     */
+    isNeedOffset = false;
+
+    /**
+     * The ID of the original entry
+     * @type {string|null}
+     */
+    originalEntryId = null;
+
+    /**
+     * The date of the original entry
+     * @type {string|null}
+     */
+    originalEntryDate = null;
+
+    /**
+     * The text of the original entry
+     * @type {string|null}
+     */
+    originalEntryText = null;
+
+    /**
+     * The account code
+     * @type {string|null}
+     */
+    accountCode = null;
+
+    /**
+     * The account text
+     * @type {string|null}
+     */
+    accountText = null;
+
+    /**
+     * The summary
+     * @type {string|null}
+     */
+    summary = null;
+
+    /**
+     * The amount
+     * @type {string}
+     */
+    amount = "";
+
+    /**
+     * The summary editors
+     * @type {{debit: SummaryEditor, credit: SummaryEditor}}
+     */
+    #summaryEditors;
+
+    /**
+     * The account selectors
+     * @type {{debit: AccountSelector, credit: AccountSelector}}
+     */
+    #accountSelectors;
+
+    /**
+     * The original entry selector
+     * @type {OriginalEntrySelector}
+     */
+    originalEntrySelector;
+
+    /**
+     * Constructs a new journal entry editor.
+     *
+     * @param form {TransactionForm} the transaction form
+     */
+    constructor(form) {
+        this.form = form;
+        this.#element = document.getElementById(this.#prefix);
+        this.#modal = document.getElementById(this.#prefix + "-modal");
+        this.#originalEntryContainer = document.getElementById(this.#prefix + "-original-entry-container");
+        this.#originalEntryControl = document.getElementById(this.#prefix + "-original-entry-control");
+        this.#originalEntry = document.getElementById(this.#prefix + "-original-entry");
+        this.#originalEntryError = document.getElementById(this.#prefix + "-original-entry-error");
+        this.#originalEntryDelete = document.getElementById(this.#prefix + "-original-entry-delete");
+        this.#summaryControl = document.getElementById(this.#prefix + "-summary-control");
+        this.#summary = document.getElementById(this.#prefix + "-summary");
+        this.#summaryError = document.getElementById(this.#prefix + "-summary-error");
+        this.#accountControl = document.getElementById(this.#prefix + "-account-control");
+        this.#account = document.getElementById(this.#prefix + "-account");
+        this.#accountError = document.getElementById(this.#prefix + "-account-error")
+        this.#amount = document.getElementById(this.#prefix + "-amount");
+        this.#amountError = document.getElementById(this.#prefix + "-amount-error");
+        this.#summaryEditors = SummaryEditor.getInstances(this);
+        this.#accountSelectors = AccountSelector.getInstances(this);
+        this.originalEntrySelector = new OriginalEntrySelector();
+        this.#originalEntryControl.onclick = () => this.originalEntrySelector.onOpen(this, this.originalEntryId)
+        this.#originalEntryDelete.onclick = () => this.clearOriginalEntry();
+        this.#summaryControl.onclick = () => this.#summaryEditors[this.entryType].onOpen();
+        this.#accountControl.onclick = () => this.#accountSelectors[this.entryType].onOpen();
+        this.#amount.onchange = () => this.#validateAmount();
+        this.#element.onsubmit = () => {
+            if (this.#validate()) {
+                if (this.entry === null) {
+                    this.entry = this.#side.addJournalEntry();
+                }
+                this.amount = this.#amount.value;
+                this.entry.save(this);
+                bootstrap.Modal.getInstance(this.#modal).hide();
+            }
+            return false;
+        };
+    }
+
+    /**
+     * Saves the original entry from the original entry selector.
+     *
+     * @param originalEntry {OriginalEntry} the original entry
+     */
+    saveOriginalEntry(originalEntry) {
+        this.isNeedOffset = false;
+        this.#originalEntryContainer.classList.remove("d-none");
+        this.#originalEntryControl.classList.add("accounting-not-empty");
+        this.originalEntryId = originalEntry.id;
+        this.originalEntryDate = originalEntry.date;
+        this.originalEntryText = originalEntry.text;
+        this.#originalEntry.innerText = originalEntry.text;
+        this.#setEnableSummaryAccount(false);
+        if (originalEntry.summary === "") {
+            this.#summaryControl.classList.remove("accounting-not-empty");
+        } else {
+            this.#summaryControl.classList.add("accounting-not-empty");
+        }
+        this.summary = originalEntry.summary === ""? null: originalEntry.summary;
+        this.#summary.innerText = originalEntry.summary;
+        this.#accountControl.classList.add("accounting-not-empty");
+        this.accountCode = originalEntry.accountCode;
+        this.accountText = originalEntry.accountText;
+        this.#account.innerText = originalEntry.accountText;
+        this.#amount.value = String(originalEntry.netBalance);
+        this.#amount.max = String(originalEntry.netBalance);
+        this.#amount.min = "0";
+        this.#validate();
+    }
+
+    /**
+     * Clears the original entry.
+     *
+     */
+    clearOriginalEntry() {
+        this.isNeedOffset = false;
+        this.#originalEntryContainer.classList.add("d-none");
+        this.#originalEntryControl.classList.remove("accounting-not-empty");
+        this.originalEntryId = null;
+        this.originalEntryDate = null;
+        this.originalEntryText = null;
+        this.#originalEntry.innerText = "";
+        this.#setEnableSummaryAccount(true);
+        this.#accountControl.classList.remove("accounting-not-empty");
+        this.accountCode = null;
+        this.accountText = null;
+        this.#account.innerText = "";
+        this.#amount.max = "";
+    }
+
+    /**
+     * Returns the currency code.
+     *
+     * @return {string} the currency code
+     */
+    getCurrencyCode() {
+        return this.#side.currency.getCurrencyCode();
+    }
+
+    /**
+     * Saves the summary from the summary editor.
+     *
+     * @param summary {string} the summary
+     */
+    saveSummary(summary) {
+        if (summary === "") {
+            this.#summaryControl.classList.remove("accounting-not-empty");
+        } else {
+            this.#summaryControl.classList.add("accounting-not-empty");
+        }
+        this.summary = summary === ""? null: summary;
+        this.#summary.innerText = summary;
+        this.#validateSummary();
+        bootstrap.Modal.getOrCreateInstance(this.#modal).show();
+    }
+
+    /**
+     * Saves the summary with the suggested account from the summary editor.
+     *
+     * @param summary {string} the summary
+     * @param accountCode {string} the account code
+     * @param accountText {string} the account text
+     * @param isAccountNeedOffset {boolean} true if the journal entries in the account need offset, or false otherwise
+     */
+    saveSummaryWithAccount(summary, accountCode, accountText, isAccountNeedOffset) {
+        this.isNeedOffset = isAccountNeedOffset;
+        this.#accountControl.classList.add("accounting-not-empty");
+        this.accountCode = accountCode;
+        this.accountText = accountText;
+        this.#account.innerText = accountText;
+        this.#validateAccount();
+        this.saveSummary(summary)
+    }
+
+    /**
+     * Clears the account.
+     *
+     */
+    clearAccount() {
+        this.isNeedOffset = false;
+        this.#accountControl.classList.remove("accounting-not-empty");
+        this.accountCode = null;
+        this.accountText = null;
+        this.#account.innerText = "";
+        this.#validateAccount();
+    }
+
+    /**
+     * Sets the account.
+     *
+     * @param code {string} the account code
+     * @param text {string} the account text
+     * @param isNeedOffset {boolean} true if the journal entries in the account need offset or false otherwise
+     */
+    saveAccount(code, text, isNeedOffset) {
+        this.isNeedOffset = isNeedOffset;
+        this.#accountControl.classList.add("accounting-not-empty");
+        this.accountCode = code;
+        this.accountText = text;
+        this.#account.innerText = text;
+        this.#validateAccount();
+    }
+
+    /**
+     * Validates the form.
+     *
+     * @returns {boolean} true if valid, or false otherwise
+     */
+    #validate() {
+        let isValid = true;
+        isValid = this.#validateOriginalEntry() && isValid;
+        isValid = this.#validateSummary() && isValid;
+        isValid = this.#validateAccount() && isValid;
+        isValid = this.#validateAmount() && isValid
+        return isValid;
+    }
+
+    /**
+     * Validates the original entry.
+     *
+     * @return {boolean} true if valid, or false otherwise
+     * @private
+     */
+    #validateOriginalEntry() {
+        this.#originalEntryControl.classList.remove("is-invalid");
+        this.#originalEntryError.innerText = "";
+        return true;
+    }
+
+    /**
+     * Validates the summary.
+     *
+     * @return {boolean} true if valid, or false otherwise
+     * @private
+     */
+    #validateSummary() {
+        this.#summary.classList.remove("is-invalid");
+        this.#summaryError.innerText = "";
+        return true;
+    }
+
+    /**
+     * Validates the account.
+     *
+     * @return {boolean} true if valid, or false otherwise
+     */
+    #validateAccount() {
+        if (this.accountCode === null) {
+            this.#accountControl.classList.add("is-invalid");
+            this.#accountError.innerText = A_("Please select the account.");
+            return false;
+        }
+        this.#accountControl.classList.remove("is-invalid");
+        this.#accountError.innerText = "";
+        return true;
+    }
+
+    /**
+     * Validates the amount.
+     *
+     * @return {boolean} true if valid, or false otherwise
+     * @private
+     */
+    #validateAmount() {
+        this.#amount.value = this.#amount.value.trim();
+        this.#amount.classList.remove("is-invalid");
+        if (this.#amount.value === "") {
+            this.#amount.classList.add("is-invalid");
+            this.#amountError.innerText = A_("Please fill in the amount.");
+            return false;
+        }
+        const amount =new Decimal(this.#amount.value);
+        if (amount.lessThanOrEqualTo(0)) {
+            this.#amount.classList.add("is-invalid");
+            this.#amountError.innerText = A_("Please fill in a positive amount.");
+            return false;
+        }
+        if (this.#amount.max !== "") {
+            if (amount.greaterThan(new Decimal(this.#amount.max))) {
+                this.#amount.classList.add("is-invalid");
+                this.#amountError.innerText = A_("The amount must not exceed the net balance %(balance)s of the original entry.", {balance: new Decimal(this.#amount.max)});
+                return false;
+            }
+        }
+        if (this.#amount.min !== "") {
+            const min = new Decimal(this.#amount.min);
+            if (amount.lessThan(min)) {
+                this.#amount.classList.add("is-invalid");
+                this.#amountError.innerText = A_("The amount must not be less than the offset total %(total)s.", {total: formatDecimal(min)});
+                return false;
+            }
+        }
+        this.#amount.classList.remove("is-invalid");
+        this.#amountError.innerText = "";
+        return true;
+    }
+
+    /**
+     * The callback when adding a new journal entry.
+     *
+     * @param side {DebitCreditSideSubForm} the debit or credit side sub-form
+     */
+    onAddNew(side) {
+        this.entry = null;
+        this.#side = side;
+        this.entryType = this.#side.entryType;
+        this.isNeedOffset = false;
+        this.#originalEntryContainer.classList.add("d-none");
+        this.#originalEntryControl.classList.remove("accounting-not-empty");
+        this.#originalEntryControl.classList.remove("is-invalid");
+        this.originalEntryId = null;
+        this.originalEntryDate = null;
+        this.originalEntryText = null;
+        this.#originalEntry.innerText = "";
+        this.#setEnableSummaryAccount(true);
+        this.#summaryControl.classList.remove("accounting-not-empty");
+        this.#summaryControl.classList.remove("is-invalid");
+        this.summary = null;
+        this.#summary.innerText = ""
+        this.#summaryError.innerText = ""
+        this.#accountControl.classList.remove("accounting-not-empty");
+        this.#accountControl.classList.remove("is-invalid");
+        this.accountCode = null;
+        this.accountText = null;
+        this.#account.innerText = "";
+        this.#accountError.innerText = "";
+        this.#amount.value = "";
+        this.#amount.max = "";
+        this.#amount.min = "0";
+        this.#amount.classList.remove("is-invalid");
+        this.#amountError.innerText = "";
+    }
+
+    /**
+     * The callback when editing a journal entry.
+     *
+     * @param entry {JournalEntrySubForm} the journal entry sub-form
+     */
+    onEdit(entry) {
+        this.entry = entry;
+        this.#side = entry.side;
+        this.entryType = this.#side.entryType;
+        this.isNeedOffset = entry.isNeedOffset();
+        this.originalEntryId = entry.getOriginalEntryId();
+        this.originalEntryDate = entry.getOriginalEntryDate();
+        this.originalEntryText = entry.getOriginalEntryText();
+        this.#originalEntry.innerText = this.originalEntryText;
+        if (this.originalEntryId === null) {
+            this.#originalEntryContainer.classList.add("d-none");
+            this.#originalEntryControl.classList.remove("accounting-not-empty");
+        } else {
+            this.#originalEntryContainer.classList.remove("d-none");
+            this.#originalEntryControl.classList.add("accounting-not-empty");
+        }
+        this.#setEnableSummaryAccount(!entry.isMatched && this.originalEntryId === null);
+        this.summary = entry.getSummary();
+        if (this.summary === null) {
+            this.#summaryControl.classList.remove("accounting-not-empty");
+        } else {
+            this.#summaryControl.classList.add("accounting-not-empty");
+        }
+        this.#summary.innerText = this.summary === null? "": this.summary;
+        if (entry.getAccountCode() === null) {
+            this.#accountControl.classList.remove("accounting-not-empty");
+        } else {
+            this.#accountControl.classList.add("accounting-not-empty");
+        }
+        this.accountCode = entry.getAccountCode();
+        this.accountText = entry.getAccountText();
+        this.#account.innerText = this.accountText;
+        this.#amount.value = entry.getAmount() === null? "": String(entry.getAmount());
+        const maxAmount = this.#getMaxAmount();
+        this.#amount.max = maxAmount === null? "": maxAmount;
+        this.#amount.min = entry.getAmountMin() === null? "": String(entry.getAmountMin());
+        this.#validate();
+    }
+
+    /**
+     * Finds out the max amount.
+     *
+     * @return {Decimal|null} the max amount
+     */
+    #getMaxAmount() {
+        if (this.originalEntryId === null) {
+            return null;
+        }
+        return this.originalEntrySelector.getNetBalance(this.entry, this.form, this.originalEntryId);
+    }
+
+    /**
+     * Sets the enable status of the summary and account.
+     *
+     * @param isEnabled {boolean} true to enable, or false otherwise
+     */
+    #setEnableSummaryAccount(isEnabled) {
+        if (isEnabled) {
+            this.#summaryControl.dataset.bsToggle = "modal";
+            this.#summaryControl.dataset.bsTarget = "#accounting-summary-editor-" + this.#side.entryType + "-modal";
+            this.#summaryControl.classList.remove("accounting-disabled");
+            this.#summaryControl.classList.add("accounting-clickable");
+            this.#accountControl.dataset.bsToggle = "modal";
+            this.#accountControl.dataset.bsTarget = "#accounting-account-selector-" + this.#side.entryType + "-modal";
+            this.#accountControl.classList.remove("accounting-disabled");
+            this.#accountControl.classList.add("accounting-clickable");
+        } else {
+            this.#summaryControl.dataset.bsToggle = "";
+            this.#summaryControl.dataset.bsTarget = "";
+            this.#summaryControl.classList.add("accounting-disabled");
+            this.#summaryControl.classList.remove("accounting-clickable");
+            this.#accountControl.dataset.bsToggle = "";
+            this.#accountControl.dataset.bsTarget = "";
+            this.#accountControl.classList.add("accounting-disabled");
+            this.#accountControl.classList.remove("accounting-clickable");
+        }
+    }
+}

src/accounting/static/js/original-entry-selector.js

@@ -0,0 +1,417 @@
+/* The Mia! Accounting Flask Project
+ * original-entry-selector.js: The JavaScript for the original entry selector
+ */
+
+/*  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/3/10
+ */
+"use strict";
+
+/**
+ * The original entry selector.
+ *
+ */
+class OriginalEntrySelector {
+
+    /**
+     * The prefix of the HTML ID and class
+     * @type {string}
+     */
+    #prefix = "accounting-original-entry-selector";
+
+    /**
+     * The modal of the original entry editor
+     * @type {HTMLDivElement}
+     */
+    #modal;
+
+    /**
+     * The query input
+     * @type {HTMLInputElement}
+     */
+    #query;
+
+    /**
+     * The error message when the query has no result
+     * @type {HTMLParagraphElement}
+     */
+    #queryNoResult;
+
+    /**
+     * The option list
+     * @type {HTMLUListElement}
+     */
+    #optionList;
+
+    /**
+     * The options
+     * @type {OriginalEntry[]}
+     */
+    #options;
+
+    /**
+     * The options by their ID
+     * @type {Object.<string, OriginalEntry>}
+     */
+    #optionById;
+
+    /**
+     * The journal entry editor
+     * @type {JournalEntryEditor}
+     */
+    entryEditor;
+
+    /**
+     * The currency code
+     * @type {string}
+     */
+    #currencyCode;
+
+    /**
+     * The entry
+     */
+    #entryType;
+
+    /**
+     * Constructs an original entry selector.
+     *
+     */
+    constructor() {
+        this.#modal = document.getElementById(this.#prefix + "-modal");
+        this.#query = document.getElementById(this.#prefix + "-query");
+        this.#queryNoResult = document.getElementById(this.#prefix + "-option-no-result");
+        this.#optionList = document.getElementById(this.#prefix + "-option-list");
+        this.#options = Array.from(document.getElementsByClassName(this.#prefix + "-option")).map((element) => new OriginalEntry(this, element));
+        this.#optionById = {};
+        for (const option of this.#options) {
+            this.#optionById[option.id] = option;
+        }
+        this.#query.addEventListener("input", () => {
+            this.#filterOptions();
+        });
+    }
+
+    /**
+     * Returns the net balance for an original entry.
+     *
+     * @param currentEntry {JournalEntrySubForm} the journal entry sub-form that is currently editing
+     * @param form {TransactionForm} the transaction form
+     * @param originalEntryId {string} the ID of the original entry
+     * @return {Decimal} the net balance of the original entry
+     */
+    getNetBalance(currentEntry, form, originalEntryId) {
+        const otherEntries = form.getEntries().filter((entry) => entry !== currentEntry);
+        let otherOffset = new Decimal(0);
+        for (const otherEntry of otherEntries) {
+            if (otherEntry.getOriginalEntryId() === originalEntryId) {
+                const amount = otherEntry.getAmount();
+                if (amount !== null) {
+                    otherOffset = otherOffset.plus(amount);
+                }
+            }
+        }
+        return this.#optionById[originalEntryId].bareNetBalance.minus(otherOffset);
+    }
+
+    /**
+     * Updates the net balances, subtracting the offset amounts on the form but the currently editing journal entry
+     *
+     */
+    #updateNetBalances() {
+        const otherEntries = this.entryEditor.form.getEntries().filter((entry) => entry !== this.entryEditor.entry);
+        const otherOffsets = {}
+        for (const otherEntry of otherEntries) {
+            const otherOriginalEntryId = otherEntry.getOriginalEntryId();
+            const amount = otherEntry.getAmount();
+            if (otherOriginalEntryId === null || amount === null) {
+                continue;
+            }
+            if (!(otherOriginalEntryId in otherOffsets)) {
+                otherOffsets[otherOriginalEntryId] = new Decimal("0");
+            }
+            otherOffsets[otherOriginalEntryId] = otherOffsets[otherOriginalEntryId].plus(amount);
+        }
+        for (const option of this.#options) {
+            if (option.id in otherOffsets) {
+                option.updateNetBalance(otherOffsets[option.id]);
+            } else {
+                option.resetNetBalance();
+            }
+        }
+    }
+
+    /**
+     * Filters the options.
+     *
+     */
+    #filterOptions() {
+        let hasAnyMatched = false;
+        for (const option of this.#options) {
+            if (option.isMatched(this.#entryType, this.#currencyCode, this.#query.value)) {
+                option.setShown(true);
+                hasAnyMatched = true;
+            } else {
+                option.setShown(false);
+            }
+        }
+        if (!hasAnyMatched) {
+            this.#optionList.classList.add("d-none");
+            this.#queryNoResult.classList.remove("d-none");
+        } else {
+            this.#optionList.classList.remove("d-none");
+            this.#queryNoResult.classList.add("d-none");
+        }
+    }
+
+    /**
+     * The callback when the original entry selector is shown.
+     *
+     * @param entryEditor {JournalEntryEditor} the journal entry editor
+     * @param originalEntryId {string|null} the ID of the original entry
+     */
+    onOpen(entryEditor, originalEntryId = null) {
+        this.entryEditor = entryEditor
+        this.#currencyCode = entryEditor.getCurrencyCode();
+        this.#entryType = entryEditor.entryType;
+        for (const option of this.#options) {
+            option.setActive(option.id === originalEntryId);
+        }
+        this.#query.value = "";
+        this.#updateNetBalances();
+        this.#filterOptions();
+    }
+}
+
+/**
+ * An original entry.
+ *
+ */
+class OriginalEntry {
+
+    /**
+     * The original entry selector
+     * @type {OriginalEntrySelector}
+     */
+    #selector;
+
+    /**
+     * The element
+     * @type {HTMLLIElement}
+     */
+    #element;
+
+    /**
+     * The ID
+     * @type {string}
+     */
+    id;
+
+    /**
+     * The date
+     * @type {string}
+     */
+    date;
+
+    /**
+     * The entry type, either "debit" or "credit"
+     * @type {string}
+     */
+    #entryType;
+
+    /**
+     * The currency code
+     * @type {string}
+     */
+    #currencyCode;
+
+    /**
+     * The account code
+     * @type {string}
+     */
+    accountCode;
+
+    /**
+     * The account text
+     * @type {string}
+     */
+    accountText;
+
+    /**
+     * The summary
+     * @type {string}
+     */
+    summary;
+
+    /**
+     * The net balance, without the offset amounts on the form
+     * @type {Decimal}
+     */
+    bareNetBalance;
+
+    /**
+     * The net balance
+     * @type {Decimal}
+     */
+    netBalance;
+
+    /**
+     * The text of the net balance
+     * @type {HTMLSpanElement}
+     */
+    netBalanceText;
+
+    /**
+     * The text representation of the original entry
+     * @type {string}
+     */
+    text;
+
+    /**
+     * The values to query against
+     * @type {string[][]}
+     */
+    #queryValues;
+
+    /**
+     * Constructs an original entry.
+     *
+     * @param selector {OriginalEntrySelector} the original entry selector
+     * @param element {HTMLLIElement} the element
+     */
+    constructor(selector, element) {
+        this.#selector = selector;
+        this.#element = element;
+        this.id = element.dataset.id;
+        this.date = element.dataset.date;
+        this.#entryType = element.dataset.entryType;
+        this.#currencyCode = element.dataset.currencyCode;
+        this.accountCode = element.dataset.accountCode;
+        this.accountText = element.dataset.accountText;
+        this.summary = element.dataset.summary;
+        this.bareNetBalance = new Decimal(element.dataset.netBalance);
+        this.netBalance = this.bareNetBalance;
+        this.netBalanceText = document.getElementById("accounting-original-entry-selector-option-" + this.id + "-net-balance");
+        this.text = element.dataset.text;
+        this.#queryValues = JSON.parse(element.dataset.queryValues);
+        this.#element.onclick = () => this.#selector.entryEditor.saveOriginalEntry(this);
+    }
+
+    /**
+     * Resets the net balance to its initial value, without the offset amounts on the form.
+     *
+     */
+    resetNetBalance() {
+        if (this.netBalance !== this.bareNetBalance) {
+            this.netBalance = this.bareNetBalance;
+            this.#updateNetBalanceText();
+        }
+    }
+
+    /**
+     * Updates the net balance with an offset.
+     *
+     * @param offset {Decimal} the offset to be added to the net balance
+     */
+    updateNetBalance(offset) {
+        this.netBalance = this.bareNetBalance.minus(offset);
+        this.#updateNetBalanceText();
+    }
+
+    /**
+     * Updates the text display of the net balance.
+     *
+     */
+    #updateNetBalanceText() {
+        this.netBalanceText.innerText = formatDecimal(this.netBalance);
+    }
+
+    /**
+     * Returns whether the original matches.
+     *
+     * @param entryType {string} the entry type, either "debit" or "credit"
+     * @param currencyCode {string} the currency code
+     * @param query {string|null} the query term
+     */
+    isMatched(entryType, currencyCode, query = null) {
+        return this.netBalance.greaterThan(0)
+            && this.date <= this.#selector.entryEditor.form.getDate()
+            && this.#isEntryTypeMatches(entryType)
+            && this.#currencyCode === currencyCode
+            && this.#isQueryMatches(query);
+    }
+
+    /**
+     * Returns whether the original entry matches the entry type.
+     *
+     * @param entryType {string} the entry type, either "debit" or credit
+     * @return {boolean} true if the option matches, or false otherwise
+     */
+    #isEntryTypeMatches(entryType) {
+        return (entryType === "debit" && this.#entryType === "credit")
+            || (entryType === "credit" && this.#entryType === "debit");
+    }
+
+    /**
+     * Returns whether the original entry matches the query.
+     *
+     * @param query {string|null} the query term
+     * @return {boolean} true if the option matches, or false otherwise
+     */
+    #isQueryMatches(query) {
+        if (query === "") {
+            return true;
+        }
+        for (const queryValue of this.#queryValues[0]) {
+            if (queryValue.toLowerCase().includes(query.toLowerCase())) {
+                return true;
+            }
+        }
+        for (const queryValue of this.#queryValues[1]) {
+            if (queryValue === query) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * Sets whether the option is shown.
+     *
+     * @param isShown {boolean} true to show, or false otherwise
+     */
+    setShown(isShown) {
+        if (isShown) {
+            this.#element.classList.remove("d-none");
+        } else {
+            this.#element.classList.add("d-none");
+        }
+    }
+
+    /**
+     * Sets whether the option is active.
+     *
+     * @param isActive {boolean} true if active, or false otherwise
+     */
+    setActive(isActive) {
+        if (isActive) {
+            this.#element.classList.add("active");
+        } else {
+            this.#element.classList.remove("active");
+        }
+    }
+}

src/accounting/static/js/period-chooser.js

@@ -171,6 +171,7 @@ class MonthTab extends TabPlane {
     constructor(chooser) {
         super(chooser);
         const monthChooser = document.getElementById(this.prefix + "-chooser");
+        if (monthChooser !== null) {
             let start = monthChooser.dataset.start;
             this.#monthChooser = new tempusDominus.TempusDominus(monthChooser, {
                 restrictions: {
@@ -194,6 +195,7 @@ class MonthTab extends TabPlane {
                     .replaceAll("PERIOD", period);
             });
         }
+    }
 
     /**
      * The tab ID
@@ -250,6 +252,7 @@ class DayTab extends TabPlane {
         super(chooser);
         this.#date = document.getElementById(this.prefix + "-date");
         this.#dateError = document.getElementById(this.prefix + "-date-error");
+        if (this.#date !== null) {
             this.#date.onchange = () => {
                 if (this.#validateDate()) {
                     window.location = chooser.modal.dataset.urlTemplate
@@ -257,6 +260,7 @@ class DayTab extends TabPlane {
                 }
             };
         }
+    }
 
     /**
      * Validates the date.
@@ -338,6 +342,7 @@ class CustomTab extends TabPlane {
         this.#end = document.getElementById(this.prefix + "-end");
         this.#endError = document.getElementById(this.prefix + "-end-error");
         this.#conform = document.getElementById(this.prefix + "-confirm");
+        if (this.#start !== null) {
             this.#start.onchange = () => {
                 if (this.#validateStart()) {
                     this.#end.min = this.#start.value;
@@ -358,6 +363,7 @@ class CustomTab extends TabPlane {
                 }
             };
         }
+    }
 
     /**
      * Validates the start of the period.

src/accounting/static/js/summary-editor.js

@@ -22,17 +22,18 @@
  */
 "use strict";
 
-// Initializes the page JavaScript.
-document.addEventListener("DOMContentLoaded", () => {
-    SummaryEditor.initialize();
-});
-
 /**
  * A summary editor.
  *
  */
 class SummaryEditor {
 
+    /**
+     * The journal entry editor
+     * @type {JournalEntryEditor}
+     */
+    #entryEditor;
+
     /**
      * The summary editor form
      * @type {HTMLFormElement}
@@ -55,28 +56,34 @@ class SummaryEditor {
      * The entry type, either "debit" or "credit"
      * @type {string}
      */
-    #entryType;
+    entryType;
 
     /**
-     * The current tab.
+     * The current tab
      * @type {TabPlane}
      */
     currentTab;
 
     /**
-     * The summary input.
+     * The summary input
      * @type {HTMLInputElement}
      */
     summary;
 
     /**
-     * The number input.
+     * The button to the original entry selector
+     * @type {HTMLButtonElement}
+     */
+    #offsetButton;
+
+    /**
+     * The number input
      * @type {HTMLInputElement}
      */
     number;
 
     /**
-     * The note.
+     * The note
      * @type {HTMLInputElement}
      */
     note;
@@ -93,36 +100,6 @@ class SummaryEditor {
      */
     #selectedAccount = null;
 
-    /**
-     * The modal of the journal entry form
-     * @type {HTMLDivElement}
-     */
-    #entryFormModal;
-
-    /**
-     * The control of the account on the journal entry form
-     * @type {HTMLDivElement}
-     */
-    #formAccountControl;
-
-    /**
-     * The account on the journal entry form
-     * @type {HTMLDivElement}
-     */
-    #formAccount;
-
-    /**
-     * The control of the summary on the journal entry form
-     * @type {HTMLDivElement}
-     */
-    #formSummaryControl;
-
-    /**
-     * The summary on the journal entry form
-     * @type {HTMLDivElement}
-     */
-    #formSummary;
-
     /**
      * The tab planes
      * @type {{general: GeneralTagTab, travel: GeneralTripTab, bus: BusTripTab, regular: RegularPaymentTab, annotation: AnnotationTab}}
@@ -132,26 +109,22 @@ class SummaryEditor {
     /**
      * Constructs a summary editor.
      *
-     * @param form {HTMLFormElement} the summary editor form
+     * @param entryEditor {JournalEntryEditor} the journal entry editor
+     * @param entryType {string} the entry type, either "debit" or "credit"
      */
-    constructor(form) {
-        this.#form = form;
-        this.#entryType = form.dataset.entryType;
-        this.prefix = "accounting-summary-editor-" + form.dataset.entryType;
+    constructor(entryEditor, entryType) {
+        this.#entryEditor = entryEditor;
+        this.entryType = entryType;
+        this.prefix = "accounting-summary-editor-" + entryType;
+        this.#form = document.getElementById(this.prefix);
         this.#modal = document.getElementById(this.prefix + "-modal");
         this.summary = document.getElementById(this.prefix + "-summary");
+        this.#offsetButton = document.getElementById(this.prefix + "-offset");
         this.number = document.getElementById(this.prefix + "-annotation-number");
         this.note = document.getElementById(this.prefix + "-annotation-note");
         // noinspection JSValidateTypes
         this.#accountButtons = Array.from(document.getElementsByClassName(this.prefix + "-account"));
 
-        // Things from the entry form
-        this.#entryFormModal = document.getElementById("accounting-entry-form-modal");
-        this.#formAccountControl = document.getElementById("accounting-entry-form-account-control");
-        this.#formAccount = document.getElementById("accounting-entry-form-account");
-        this.#formSummaryControl = document.getElementById("accounting-entry-form-summary-control");
-        this.#formSummary = document.getElementById("accounting-entry-form-summary");
-
         for (const cls of [GeneralTagTab, GeneralTripTab, BusTripTab, RegularPaymentTab, AnnotationTab]) {
             const tab = new cls(this);
             this.tabPlanes[tab.tabId()] = tab;
@@ -159,6 +132,7 @@ class SummaryEditor {
         this.currentTab = this.tabPlanes.general;
         this.#initializeSuggestedAccounts();
         this.summary.onchange = () => this.#onSummaryChange();
+        this.#offsetButton.onclick = () => this.#entryEditor.originalEntrySelector.onOpen(this.#entryEditor);
         this.#form.onsubmit = () => {
             if (this.currentTab.validate()) {
                 this.#submit();
@@ -239,30 +213,21 @@ class SummaryEditor {
      *
      */
     #submit() {
-        if (this.summary.value === "") {
-            this.#formSummaryControl.classList.remove("accounting-not-empty");
-        } else {
-            this.#formSummaryControl.classList.add("accounting-not-empty");
-        }
-        if (this.#selectedAccount !== null) {
-            this.#formAccountControl.classList.add("accounting-not-empty");
-            this.#formAccount.dataset.code = this.#selectedAccount.dataset.code;
-            this.#formAccount.dataset.text = this.#selectedAccount.dataset.text;
-            this.#formAccount.innerText = this.#selectedAccount.dataset.text;
-        }
-        this.#formSummary.dataset.value = this.summary.value;
-        this.#formSummary.innerText = this.summary.value;
         bootstrap.Modal.getOrCreateInstance(this.#modal).hide();
-        bootstrap.Modal.getOrCreateInstance(this.#entryFormModal).show();
+        if (this.#selectedAccount !== null) {
+            this.#entryEditor.saveSummaryWithAccount(this.summary.value, this.#selectedAccount.dataset.code, this.#selectedAccount.dataset.text, this.#selectedAccount.classList.contains("accounting-account-is-need-offset"));
+        } else {
+            this.#entryEditor.saveSummary(this.summary.value);
+        }
     }
 
     /**
      * The callback when the summary editor is shown.
      *
      */
-    #onOpen() {
+    onOpen() {
         this.#reset();
-        this.summary.value = this.#formSummary.dataset.value;
+        this.summary.value = this.#entryEditor.summary === null? "": this.#entryEditor.summary;
         this.#onSummaryChange();
     }
 
@@ -279,33 +244,18 @@ class SummaryEditor {
     }
 
     /**
-     * The summary editors.
-     * @type {{debit: SummaryEditor, credit: SummaryEditor}}
-     */
-    static #editors = {}
-
-    /**
-     * Initializes the summary editors.
+     * Returns the summary editor instances.
      *
+     * @param entryEditor {JournalEntryEditor} the journal entry editor
+     * @return {{debit: SummaryEditor, credit: SummaryEditor}}
      */
-    static initialize() {
+    static getInstances(entryEditor) {
+        const editors = {}
         const forms = Array.from(document.getElementsByClassName("accounting-summary-editor"));
-        const entryForm = document.getElementById("accounting-entry-form");
-        const formSummaryControl = document.getElementById("accounting-entry-form-summary-control");
         for (const form of forms) {
-            const editor = new SummaryEditor(form);
-            this.#editors[editor.#entryType] = editor;
+            editors[form.dataset.entryType] = new SummaryEditor(entryEditor, form.dataset.entryType);
         }
-        formSummaryControl.onclick = () => this.#editors[entryForm.dataset.entryType].#onOpen()
-    }
-
-    /**
-     * Initializes the summary editor for a new journal entry.
-     *
-     * @param entryType {string} the entry type, either "debit" or "credit"
-     */
-    static initializeNewJournalEntry(entryType) {
-        this.#editors[entryType].#onOpen();
+        return editors;
     }
 }
 

src/accounting/templates/accounting/account/detail.html

@@ -85,9 +85,9 @@ First written: 2023/1/31
 <div class="accounting-card col-sm-6">
   <div class="accounting-card-title">{{ obj.title }}</div>
   <div class="accounting-card-code">{{ obj.code }}</div>
-  {% if obj.is_pay_off_needed %}
+  {% if obj.is_need_offset %}
     <div>
-      <span class="badge rounded-pill bg-info">{{ A_("Pay-off needed") }}</span>
+      <span class="badge rounded-pill bg-info">{{ A_("Need offset") }}</span>
     </div>
   {% endif %}
   <div class="small text-secondary fst-italic">

src/accounting/templates/accounting/account/include/form.html

@@ -41,9 +41,9 @@ First written: 2023/2/1
   {% endif %}
   <div class="form-floating mb-3">
     <input id="accounting-base-code" type="hidden" name="base_code" value="{{ form.base_code.data|accounting_default }}">
-    <div id="accounting-base" class="form-control accounting-clickable accounting-material-text-field {% if form.base_code.data %} accounting-not-empty {% endif %} {% if form.base_code.errors %} is-invalid {% endif %}" data-bs-toggle="modal" data-bs-target="#accounting-base-selector-modal">
+    <div id="accounting-base-control" class="form-control accounting-clickable accounting-material-text-field {% if form.base_code.data %} accounting-not-empty {% endif %} {% if form.base_code.errors %} is-invalid {% endif %}" data-bs-toggle="modal" data-bs-target="#accounting-base-selector-modal">
       <label class="form-label" for="accounting-base">{{ A_("Base account") }}</label>
-      <div id="accounting-base-content">
+      <div id="accounting-base">
         {% if form.base_code.data %}
           {% if form.base_code.errors %}
             {{ A_("(Unknown)") }}
@@ -53,7 +53,7 @@ First written: 2023/2/1
         {% endif %}
       </div>
     </div>
-    <div id="accounting-base-code-error" class="invalid-feedback">{% if form.base_code.errors %}{{ form.base_code.errors[0] }}{% endif %}</div>
+    <div id="accounting-base-error" class="invalid-feedback">{% if form.base_code.errors %}{{ form.base_code.errors[0] }}{% endif %}</div>
   </div>
 
   <div class="form-floating mb-3">
@@ -62,10 +62,10 @@ First written: 2023/2/1
     <div id="accounting-title-error" class="invalid-feedback">{% if form.title.errors %}{{ form.title.errors[0] }}{% endif %}</div>
   </div>
 
-  <div class="form-check form-switch mb-3">
-    <input id="accounting-is-pay-off-needed" class="form-check-input" type="checkbox" name="is_pay_off_needed" value="1" {% if form.is_pay_off_needed.data %} checked="checked" {% endif %}>
-    <label class="form-check-label" for="accounting-is-pay-off-needed">
-      {{ A_("The entries in the account need pay-off.") }}
+  <div id="accounting-is-need-offset-control" class="form-check form-switch mb-3 {% if form.base_code.data[0] not in ["1", "2", "3"] %} d-none {% endif %}">
+    <input id="accounting-is-need-offset" class="form-check-input" type="checkbox" name="is_need_offset" value="1" {% if form.is_need_offset.data %} checked="checked" {% endif %}>
+    <label class="form-check-label" for="accounting-is-need-offset">
+      {{ A_("The entries in the account need offset.") }}
     </label>
   </div>
 
@@ -99,21 +99,21 @@ First written: 2023/2/1
           </label>
         </div>
 
-        <ul id="accounting-base-option-list" class="list-group accounting-selector-list">
+        <ul id="accounting-base-selector-option-list" class="list-group accounting-selector-list">
           {% for base in form.base_options %}
-          <li id="accounting-base-option-{{ base.code }}" class="list-group-item accounting-base-option accounting-clickable" data-code="{{ base.code }}" data-content="{{ base }}" data-query-values="{{ base.query_values|tojson|forceescape }}">
+            <li class="list-group-item accounting-clickable accounting-base-selector-option" data-code="{{ base.code }}" data-content="{{ base }}" data-query-values="{{ base.query_values|tojson|forceescape }}" data-bs-dismiss="modal">
               {{ base }}
             </li>
           {% endfor %}
         </ul>
-        <p id="accounting-base-option-no-result" class="d-none">{{ A_("There is no data.") }}</p>
+        <p id="accounting-base-selector-option-no-result" class="d-none">{{ A_("There is no data.") }}</p>
       </div>
       <div class="modal-footer">
         <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">{{ A_("Cancel") }}</button>
         {% if form.base_code.data %}
-          <button id="accounting-btn-clear-base" type="button" class="btn btn-danger">{{ A_("Clear") }}</button>
+          <button id="accounting-base-selector-clear" type="button" class="btn btn-danger" data-bs-dismiss="modal">{{ A_("Clear") }}</button>
         {% else %}
-          <button id="accounting-btn-clear-base" type="button" class="btn btn-secondary" disabled="disabled">{{ A_("Clear") }}</button>
+          <button id="accounting-base-selector-clear" type="button" class="btn btn-secondary" disabled="disabled" data-bs-dismiss="modal">{{ A_("Clear") }}</button>
         {% endif %}
       </div>
     </div>

src/accounting/templates/accounting/account/list.html

@@ -58,8 +58,8 @@ First written: 2023/1/30
   {% for item in list %}
     <a class="list-group-item list-group-item-action" href="{{ url_for("accounting.account.detail", account=item)|accounting_append_next }}">
       {{ item }}
-      {% if item.is_pay_off_needed %}
-        <span class="badge rounded-pill bg-info">{{ A_("Pay-off needed") }}</span>
+      {% if item.is_need_offset %}
+        <span class="badge rounded-pill bg-info">{{ A_("Need offset") }}</span>
       {% endif %}
     </a>
   {% endfor %}

src/accounting/templates/accounting/include/nav.html

@@ -28,7 +28,7 @@ First written: 2023/1/26
     </span>
     <ul class="dropdown-menu">
       <li>
-        <a class="dropdown-item {% if request.endpoint.startswith("accounting.report.") %} active {% endif %}" href="{{ url_for("accounting.report.journal-default") }}">
+        <a class="dropdown-item {% if request.endpoint.startswith("accounting.report.") %} active {% endif %}" href="{{ url_for("accounting.report.default") }}">
           <i class="fa-solid fa-book"></i>
           {{ A_("Reports") }}
         </a>

src/accounting/templates/accounting/report/include/ledger-row-desktop.html

@@ -23,4 +23,6 @@ First written: 2023/3/8
 <div>{{ entry.summary|accounting_default }}</div>
 <div class="accounting-amount">{{ entry.debit|accounting_format_amount|accounting_default }}</div>
 <div class="accounting-amount">{{ entry.credit|accounting_format_amount|accounting_default }}</div>
+{% if report.account.is_real %}
   <div class="accounting-amount {% if entry.balance < 0 %} text-danger {% endif %}">{{ entry.balance|accounting_report_format_amount }}</div>
+{% endif %}

src/accounting/templates/accounting/report/include/ledger-row-mobile.html

@@ -37,5 +37,7 @@ First written: 2023/3/5
   {% if entry.credit %}
     <span class="badge rounded-pill bg-warning">-{{ entry.credit|accounting_format_amount }}</span>
   {% endif %}
+  {% if report.account.is_real %}
     <span class="badge rounded-pill bg-primary">{{ entry.balance|accounting_format_amount }}</span>
+  {% endif %}
 </div>

src/accounting/templates/accounting/report/include/search-modal.html

@@ -19,7 +19,7 @@ search-modal.html: The search modal
 Author: imacat@mail.imacat.idv.tw (imacat)
 First written: 2023/3/8
 #}
-<form action="{{ url_for("accounting.report.search") }}" method="get" role="search" aria-label="{{ A_("Search the Accounting Data") }}">
+<form action="{{ url_for("accounting.report.search") }}" method="get" role="search" aria-labelledby="accounting-search-modal-label">
   <div class="modal fade" id="accounting-search-modal" tabindex="-1" aria-labelledby="accounting-search-modal-label" aria-hidden="true">
     <div class="modal-dialog">
       <div class="modal-content">

src/accounting/templates/accounting/report/include/toolbar-buttons.html

@@ -106,10 +106,17 @@ First written: 2023/3/8
     <span class="d-none d-md-inline">{{ report.period.desc|title }}</span>
   </button>
 {% endif %}
+{% if report.has_data %}
   <a class="btn btn-primary" role="button" href="{{ report.csv_uri }}">
     <i class="fa-solid fa-download"></i>
     <span class="d-none d-md-inline">{{ A_("Download") }}</span>
   </a>
+{% else %}
+  <button class="btn btn-secondary" type="button" disabled="disabled">
+    <i class="fa-solid fa-download"></i>
+    <span class="d-none d-md-inline">{{ A_("Download") }}</span>
+  </button>
+{% endif %}
 {% if use_search %}
   <form class="btn btn-primary d-flex input-group" action="{{ url_for("accounting.report.search") }}" method="get" role="search" aria-labelledby="accounting-toolbar-search-label">
     <input id="accounting-toolbar-search" class="form-control form-control-sm" type="search" name="q" value="{{ request.args.q }}" placeholder=" " required="required">

src/accounting/templates/accounting/report/ledger.html

@@ -49,14 +49,16 @@ First written: 2023/3/5
     {% include "accounting/include/pagination.html" %}
   {% endwith %}
 
-  <div class="d-none d-md-block accounting-report-table accounting-ledger-table">
+  <div class="d-none d-md-block accounting-report-table {% if report.account.is_real %} accounting-ledger-real-table {% else %} accounting-ledger-nominal-table {% endif %}">
     <div class="accounting-report-table-header">
       <div class="accounting-report-table-row">
         <div>{{ A_("Date") }}</div>
         <div>{{ A_("Summary") }}</div>
         <div class="accounting-amount">{{ A_("Debit") }}</div>
         <div class="accounting-amount">{{ A_("Credit") }}</div>
+        {% if report.account.is_real %}
           <div class="accounting-amount">{{ A_("Balance") }}</div>
+        {% endif %}
       </div>
     </div>
     <div class="accounting-report-table-body">
@@ -80,7 +82,9 @@ First written: 2023/3/5
             <div>{{ A_("Total") }}</div>
             <div class="accounting-amount">{{ entry.debit|accounting_format_amount|accounting_default }}</div>
             <div class="accounting-amount">{{ entry.credit|accounting_format_amount|accounting_default }}</div>
+            {% if report.account.is_real %}
               <div class="accounting-amount {% if entry.balance < 0 %} text-danger {% endif %}">{{ entry.balance|accounting_report_format_amount }}</div>
+            {% endif %}
           </div>
         </div>
       {% endwith %}

src/accounting/templates/accounting/transaction/expense/create.html

@@ -23,6 +23,6 @@ First written: 2023/2/25
 
 {% block header %}{% block title %}{{ A_("Add a New Cash Expense Transaction") }}{% endblock %}{% endblock %}
 
-{% block back_url %}{{ request.args.get("next") or url_for("accounting.report.journal-default") }}{% endblock %}
+{% block back_url %}{{ request.args.get("next") or url_for("accounting.report.default") }}{% endblock %}
 
 {% block action_url %}{{ url_for("accounting.transaction.store", txn_type=txn_type) }}{% endblock %}

src/accounting/templates/accounting/transaction/expense/detail.html

@@ -35,19 +35,9 @@ First written: 2023/2/26
 
       <ul class="list-group accounting-list-group-stripped accounting-list-group-hover">
         <li class="list-group-item accounting-transaction-entry accounting-transaction-entry-header">{{ A_("Content") }}</li>
-        {% for entry in currency.debit %}
-          <li class="list-group-item accounting-transaction-entry">
-            <div class="d-flex justify-content-between">
-              <div>
-                <div class="small">{{ entry.account }}</div>
-                {% if entry.summary is not none %}
-                  <div>{{ entry.summary }}</div>
-                {% endif %}
-              </div>
-              <div>{{ entry.amount|accounting_format_amount }}</div>
-            </div>
-          </li>
-        {% endfor %}
+        {% with entries = currency.debit %}
+          {% include "accounting/transaction/include/detail-entries.html" %}
+        {% endwith %}
         <li class="list-group-item accounting-transaction-entry accounting-transaction-entry-total">
           <div class="d-flex justify-content-between">
             <div>{{ A_("Total") }}</div>

src/accounting/templates/accounting/transaction/expense/include/form-currency-item.html

@@ -19,22 +19,23 @@ currency-sub-form.html: The currency sub-form in the cash expense transaction fo
 Author: imacat@mail.imacat.idv.tw (imacat)
 First written: 2023/2/25
 #}
-<div id="accounting-currency-{{ currency_index }}" class="mb-3 accounting-currency" data-index="{{ currency_index }}" data-prefix="accounting-currency-{{ currency_index }}">
+<div id="accounting-currency-{{ currency_index }}" class="mb-3 accounting-currency" data-index="{{ currency_index }}">
   <input id="accounting-currency-{{ currency_index }}-no" type="hidden" name="currency-{{ currency_index }}-no" value="{{ currency_index }}">
+  <input id="accounting-currency-{{ currency_index }}-code" type="hidden" name="currency-{{ currency_index }}-code" value="{{ currency_code_data }}">
   <div id="accounting-currency-{{ currency_index }}-control" class="form-control accounting-currency-control {% if currency_errors %} is-invalid {% endif %}">
     <div class="d-flex justify-content-between mt-2 mb-3">
       <div class="form-floating accounting-currency-content">
-        <select id="accounting-currency-{{ currency_index }}-code" class="form-select" name="currency-{{ currency_index }}-code">
+        <select id="accounting-currency-{{ currency_index }}-code-select" class="form-select {% if currency_code_errors %} is-invalid {% endif %}" name="currency-{{ currency_index }}-code" {% if currency_code_is_locked %} disabled="disabled" {% endif %}>
           {% for currency in accounting_currency_options() %}
             <option value="{{ currency.code }}" {% if currency.code == currency_code_data %} selected="selected" {% endif %}>{{ currency }}</option>
           {% endfor %}
         </select>
-        <label class="form-label" for="accounting-currency-{{ currency_index }}-code">{{ A_("Currency") }}</label>
+        <label class="form-label" for="accounting-currency-{{ currency_index }}-code-select">{{ A_("Currency") }}</label>
         <div id="accounting-currency-{{ currency_index }}-code-error" class="invalid-feedback">{% if currency_code_errors %}{{ currency_code_errors[0] }}{% endif %}</div>
       </div>
 
       <div>
-        <button id="accounting-btn-delete-currency-{{ currency_index }}" class="btn btn-danger rounded-circle accounting-btn-delete-currency {% if only_one_currency_form %} d-none {% endif %}" type="button" data-target="accounting-currency-{{ currency_index }}">
+        <button id="accounting-currency-{{ currency_index }}-delete" class="btn btn-danger rounded-circle {% if only_one_currency_form %} d-none {% endif %}" type="button" data-target="accounting-currency-{{ currency_index }}">
           <i class="fas fa-minus"></i>
         </button>
       </div>
@@ -55,9 +56,17 @@ First written: 2023/2/25
                     account_text = entry_form.account_text,
                     summary_data = entry_form.summary.data|accounting_default,
                     summary_errors = entry_form.summary.errors,
+                    original_entry_id_data = entry_form.original_entry_id.data|accounting_default,
+                    original_entry_date = entry_form.original_entry_date|accounting_default,
+                    original_entry_text = entry_form.original_entry_text|accounting_default,
+                    is_need_offset = entry_form.is_need_offset,
+                    offset_entries = entry_form.offsets,
+                    offset_total = entry_form.offset_total|accounting_default("0"),
+                    net_balance_data = entry_form.net_balance,
+                    net_balance_text = entry_form.net_balance|accounting_format_amount,
                     amount_data = entry_form.amount.data|accounting_txn_format_amount_input,
                     amount_errors = entry_form.amount.errors,
-                    amount_text = entry_form.amount.data|accounting_format_amount|accounting_default("-"),
+                    amount_text = entry_form.amount.data|accounting_format_amount,
                     entry_errors = entry_form.all_errors %}
               {% include "accounting/transaction/include/form-entry-item.html" %}
             {% endwith %}
@@ -70,7 +79,7 @@ First written: 2023/2/25
         </div>
 
         <div>
-          <button class="btn btn-primary accounting-btn-new-entry accounting-currency-{{ currency_index }}-btn-new-entry" type="button" data-currency-index="{{ currency_index }}" data-entry-type="debit" data-entry-index="new" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">
+          <button id="accounting-currency-{{ currency_index }}-debit-add-entry" class="btn btn-primary" type="button" data-currency-index="{{ currency_index }}" data-entry-type="debit" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">
             <i class="fas fa-plus"></i>
             {{ A_("New") }}
           </button>

src/accounting/templates/accounting/transaction/expense/include/form.html

@@ -29,6 +29,7 @@ First written: 2023/2/25
               currency_errors = currency_form.whole_form.errors,
               currency_code_data = currency_form.code.data,
               currency_code_errors = currency_form.code.errors,
+              currency_code_is_locked = currency_form.is_code_locked,
               debit_forms = currency_form.debit,
               debit_errors = currency_form.debit_errors,
               debit_total = currency_form.form.debit_total|accounting_format_amount %}

src/accounting/templates/accounting/transaction/include/account-selector-modal.html

@@ -19,12 +19,12 @@ account-selector-modal.html: The modal for the account selector
 Author: imacat@mail.imacat.idv.tw (imacat)
 First written: 2023/2/25
 #}
-<div id="accounting-account-selector-{{ entry_type }}-modal" class="modal fade accounting-account-selector-modal" data-entry-type="{{ entry_type }}" tabindex="-1" aria-labelledby="accounting-account-selector-{{ entry_type }}-modal-label" aria-hidden="true">
+<div id="accounting-account-selector-{{ entry_type }}-modal" class="modal fade accounting-account-selector" data-entry-type="{{ entry_type }}" tabindex="-1" aria-labelledby="accounting-account-selector-{{ entry_type }}-modal-label" aria-hidden="true">
   <div class="modal-dialog">
     <div class="modal-content">
       <div class="modal-header">
         <h1 class="modal-title fs-5" id="accounting-account-selector-{{ entry_type }}-modal-label">{{ A_("Select Account") }}</h1>
-        <button type="button" class="btn-close" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal" aria-label="{{ A_("Close") }}"></button>
+        <button type="button" class="btn-close" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal" aria-label="{{ A_("Close") }}"></button>
       </div>
       <div class="modal-body">
         <div class="input-group mb-2">
@@ -37,7 +37,7 @@ First written: 2023/2/25
 
         <ul id="accounting-account-selector-{{ entry_type }}-option-list" class="list-group accounting-selector-list">
           {% for account in account_options %}
-          <li id="accounting-account-selector-{{ entry_type }}-option-{{ account.code }}" class="list-group-item accounting-clickable accounting-account-selector-{{ entry_type }}-option {% if account.is_in_use %} accounting-account-in-use {% endif %}" data-code="{{ account.code }}" data-content="{{ account }}" data-query-values="{{ account.query_values|tojson|forceescape }}" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">
+            <li id="accounting-account-selector-{{ entry_type }}-option-{{ account.code }}" class="list-group-item accounting-clickable accounting-account-selector-{{ entry_type }}-option {% if account.is_in_use %} accounting-account-in-use {% endif %} {% if account.is_need_offset %} accounting-account-is-need-offset {% endif %}" data-code="{{ account.code }}" data-content="{{ account }}" data-query-values="{{ account.query_values|tojson|forceescape }}" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">
               {{ account }}
             </li>
           {% endfor %}
@@ -46,8 +46,8 @@ First written: 2023/2/25
         <p id="accounting-account-selector-{{ entry_type }}-option-no-result" class="d-none">{{ A_("There is no data.") }}</p>
       </div>
       <div class="modal-footer">
-        <button type="button" class="btn btn-secondary" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">{{ A_("Cancel") }}</button>
-        <button id="accounting-account-selector-{{ entry_type }}-btn-clear" type="button" class="btn btn-danger" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">{{ A_("Clear") }}</button>
+        <button type="button" class="btn btn-secondary" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">{{ A_("Cancel") }}</button>
+        <button id="accounting-account-selector-{{ entry_type }}-btn-clear" type="button" class="btn btn-danger" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">{{ A_("Clear") }}</button>
       </div>
     </div>
   </div>

src/accounting/templates/accounting/transaction/include/detail-entries.html

@@ -0,0 +1,75 @@
+{#
+The Mia! Accounting Flask Project
+detail-entries-item: The journal entries in the transaction detail
+
+ 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/3/14
+#}
+{# <ul> For SonarQube not to complain about incorrect HTML #}
+{% for entry in entries %}
+  <li class="list-group-item accounting-transaction-entry">
+    <div class="d-flex justify-content-between">
+      <div>
+        <div class="small">{{ entry.account }}</div>
+        {% if entry.summary is not none %}
+          <div>{{ entry.summary }}</div>
+        {% endif %}
+        {% if entry.original_entry %}
+          <div class="fst-italic small accounting-original-entry">
+            <a href="{{ url_for("accounting.transaction.detail", txn=entry.original_entry.transaction)|accounting_append_next }}">
+              {{ A_("Offset %(entry)s", entry=entry.original_entry) }}
+            </a>
+          </div>
+        {% endif %}
+        {% if entry.is_need_offset %}
+          <div class="fst-italic small accounting-offset-entries">
+            {% if entry.offsets %}
+              <div class="d-flex justify-content-between">
+                <div>{{ A_("Offsets") }}</div>
+                <ul class="ms-2 ps-0">
+                  {% for offset in entry.offsets %}
+                    <li>
+                      <a href="{{ url_for("accounting.transaction.detail", txn=offset.transaction)|accounting_append_next }}">
+                        {{ offset.transaction.date|accounting_format_date }} {{ offset.amount|accounting_format_amount }}
+                      </a>
+                    </li>
+                  {% endfor %}
+                </ul>
+              </div>
+              {% if entry.balance %}
+                <div class="d-flex justify-content-between">
+                  <div>{{ A_("Net balance") }}</div>
+                  <div>{{ entry.balance|accounting_format_amount }}</div>
+                </div>
+              {% else %}
+                <div class="d-flex justify-content-between">
+                  <div>{{ A_("Fully offset") }}</div>
+                </div>
+              {% endif %}
+            {% else %}
+              <div class="d-flex justify-content-between">
+                {{ A_("Unmatched") }}
+              </div>
+            {% endif %}
+          </div>
+        {% endif %}
+      </div>
+      <div>{{ entry.amount|accounting_format_amount }}</div>
+    </div>
+  </li>
+{% endfor %}
+{# </ul> For SonarQube not to complain about incorrect HTML #}

src/accounting/templates/accounting/transaction/include/detail.html

@@ -26,7 +26,7 @@ First written: 2023/2/26
 {% block content %}
 
 <div class="btn-group mb-3">
-  <a class="btn btn-primary" href="{{ url_for("accounting.report.journal-default")|accounting_or_next }}">
+  <a class="btn btn-primary" href="{{ url_for("accounting.report.default")|accounting_or_next }}">
     <i class="fa-solid fa-circle-chevron-left"></i>
     {{ A_("Back") }}
   </a>
@@ -42,10 +42,17 @@ First written: 2023/2/26
   </a>
   {% if accounting_can_edit() %}
     {% block to_transfer %}{% endblock %}
+    {% if obj.can_delete %}
       <button class="btn btn-danger" type="button" data-bs-toggle="modal" data-bs-target="#accounting-delete-modal">
         <i class="fa-solid fa-trash"></i>
         {{ A_("Delete") }}
       </button>
+    {% else %}
+      <button class="btn btn-secondary" type="button" disabled="disabled">
+        <i class="fa-solid fa-trash"></i>
+        {{ A_("Delete") }}
+      </button>
+    {% endif %}
   {% endif %}
 </div>
 
@@ -57,7 +64,7 @@ First written: 2023/2/26
   </div>
 {% endif %}
 
-{% if accounting_can_edit() %}
+{% if accounting_can_edit() and obj.can_delete %}
   <form action="{{ url_for("accounting.transaction.delete", txn=obj) }}" method="post">
     <input type="hidden" name="csrf_token" value="{{ csrf_token() }}">
     {% if request.args.next %}

src/accounting/templates/accounting/transaction/include/entry-form-modal.html

@@ -1,60 +0,0 @@
-{#
-The Mia! Accounting Flask Project
-entry-form-modal.html: The modal of the journal entry sub-form
-
- 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/2/25
-#}
-<form id="accounting-entry-form" data-currency-index="" data-entry-type="" data-entry-index="">
-  <div id="accounting-entry-form-modal" class="modal fade" tabindex="-1" aria-labelledby="accounting-entry-form-modal-label" aria-hidden="true">
-    <div class="modal-dialog">
-      <div class="modal-content">
-        <div class="modal-header">
-          <h1 class="modal-title fs-5" id="accounting-entry-form-modal-label">{{ A_("Journal Entry Content") }}</h1>
-          <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="{{ A_("Close") }}"></button>
-        </div>
-        <div class="modal-body">
-          <div class="mb-3">
-            <div id="accounting-entry-form-account-control" class="form-control accounting-clickable accounting-material-text-field" data-bs-toggle="modal" data-bs-target="">
-              <label class="form-label" for="accounting-entry-form-account">{{ A_("Account") }}</label>
-              <div id="accounting-entry-form-account" data-code="" data-text=""></div>
-            </div>
-            <div id="accounting-entry-form-account-error" class="invalid-feedback"></div>
-          </div>
-
-          <div class="mb-3">
-            <div id="accounting-entry-form-summary-control" class="form-control accounting-clickable accounting-material-text-field" data-bs-toggle="modal" data-bs-target="">
-              <label class="form-label" for="accounting-entry-form-summary">{{ A_("Summary") }}</label>
-              <div id="accounting-entry-form-summary" data-value=""></div>
-            </div>
-            <div id="accounting-entry-form-summary-error" class="invalid-feedback"></div>
-          </div>
-
-          <div class="form-floating mb-3">
-            <input id="accounting-entry-form-amount" class="form-control" type="number" value="" min="0.01" max="" step="0.01" placeholder=" " required="required">
-            <label for="accounting-entry-form-amount">{{ A_("Amount") }}</label>
-            <div id="accounting-entry-form-amount-error" class="invalid-feedback"></div>
-          </div>
-        </div>
-        <div class="modal-footer">
-          <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">{{ A_("Cancel") }}</button>
-          <button id="accounting-entry-form-btn-save" type="submit" class="btn btn-primary">{{ A_("Save") }}</button>
-        </div>
-      </div>
-    </div>
-  </div>
-</form>

src/accounting/templates/accounting/transaction/include/form-entry-item.html

@@ -20,19 +20,45 @@ Author: imacat@mail.imacat.idv.tw (imacat)
 First written: 2023/2/25
 #}
 {# <ul> For SonarQube not to complain about incorrect HTML #}
-<li id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}" class="list-group-item list-group-item-action d-flex justify-content-between accounting-entry accounting-currency-{{ currency_index }}-{{ entry_type }}" data-currency-index="{{ currency_index }}" data-entry-type="{{ entry_type }}" data-entry-index="{{ entry_index }}" data-prefix="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}">
+<li id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}" class="list-group-item list-group-item-action d-flex justify-content-between accounting-currency-{{ currency_index }}-{{ entry_type }} {% if offset_entries %} accounting-matched-entry {% endif %}" data-currency-index="{{ currency_index }}" data-entry-type="{{ entry_type }}" data-entry-index="{{ entry_index }}" {% if is_need_offset %} data-is-need-offset="true" {% endif %}>
   {% if entry_id %}
     <input type="hidden" name="currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-eid" value="{{ entry_id }}">
   {% endif %}
   <input id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-no" type="hidden" name="currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-no" value="{{ entry_index }}">
-  <input id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-account-code" class="accounting-{{ entry_type }}-account-code" type="hidden" name="currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-account_code" value="{{ account_code_data }}" data-text="{{ account_text }}">
+  <input id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-original-entry-id" class="accounting-original-entry-id" type="hidden" name="currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-original_entry_id" value="{{ original_entry_id_data }}" data-date="{{ original_entry_date }}" data-text="{{ original_entry_text }}">
+  <input id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-account-code" type="hidden" name="currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-account_code" value="{{ account_code_data }}" data-text="{{ account_text }}">
   <input id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-summary" type="hidden" name="currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-summary" value="{{ summary_data }}">
-  <input id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-amount" class="accounting-currency-{{ currency_index }}-{{ entry_type }}-amount" type="hidden" name="currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-amount" value="{{ amount_data }}">
+  <input id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-amount" type="hidden" name="currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-amount" value="{{ amount_data }}" data-min="{{ offset_total }}">
   <div class="accounting-entry-content">
-    <div id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-control" class="form-control clickable d-flex justify-content-between accounting-entry-control {% if entry_errors %} is-invalid {% endif %}" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">
+    <div id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-control" class="form-control clickable d-flex justify-content-between {% if entry_errors %} is-invalid {% endif %}" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">
       <div>
         <div id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-account-text" class="small">{{ account_text }}</div>
         <div id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-summary-text">{{ summary_data }}</div>
+        <div id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-original-entry-text" class="fst-italic small accounting-original-entry {% if not original_entry_text %} d-none {% endif %}">
+          {% if original_entry_text %}{{ A_("Offset %(entry)s", entry=original_entry_text) }}{% endif %}
+        </div>
+        <div id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-offsets" class="fst-italic small accounting-offset-entries {% if not is_need_offset %} d-none {% endif %}">
+          {% if offset_entries %}
+            <div class="d-flex justify-content-between {% if not offset_entries %} d-none {% endif %}">
+              <div>{{ A_("Offsets") }}</div>
+              <ul class="ms-2 ps-0">
+                {% for offset in offset_entries %}
+                  <li>{{ offset.transaction.date|accounting_format_date }} {{ offset.amount|accounting_format_amount }}</li>
+                {% endfor %}
+              </ul>
+            </div>
+            {% if net_balance_data == 0 %}
+              <div>{{ A_("Fully offset") }}</div>
+            {% else %}
+              <div class="d-flex justify-content-between">
+                <div>{{ A_("Net balance") }}</div>
+                <div>{{ net_balance_text }}</div>
+              </div>
+            {% endif %}
+          {% else %}
+            {{ A_("Unmatched") }}
+          {% endif %}
+        </div>
       </div>
       <div><span id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-amount-text" class="badge rounded-pill bg-primary">{{ amount_text }}</span></div>
     </div>
@@ -40,7 +66,7 @@ First written: 2023/2/25
   </div>
 
   <div>
-    <button id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-btn-delete" class="btn btn-danger rounded-circle accounting-btn-delete-entry accounting-currency-{{ currency_index }}-{{ entry_type }}-btn-delete-entry {% if only_one_entry_form %} d-none {% endif %}" type="button" data-target="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}" data-same-class="accounting-currency-{{ currency_index }}-{{ entry_type }}-btn-delete-entry">
+    <button id="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}-delete" class="btn btn-danger rounded-circle {% if only_one_entry_form or offset_entries %} d-none {% endif %}" type="button" data-target="accounting-currency-{{ currency_index }}-{{ entry_type }}-{{ entry_index }}">
       <i class="fas fa-minus"></i>
     </button>
   </div>

src/accounting/templates/accounting/transaction/include/form.html

@@ -24,7 +24,9 @@ First written: 2023/2/26
 {% block accounting_scripts %}
   <script src="{{ url_for("accounting.static", filename="js/drag-and-drop-reorder.js") }}"></script>
   <script src="{{ url_for("accounting.static", filename="js/transaction-form.js") }}"></script>
+  <script src="{{ url_for("accounting.static", filename="js/journal-entry-editor.js") }}"></script>
   <script src="{{ url_for("accounting.static", filename="js/account-selector.js") }}"></script>
+  <script src="{{ url_for("accounting.static", filename="js/original-entry-selector.js") }}"></script>
   <script src="{{ url_for("accounting.static", filename="js/summary-editor.js") }}"></script>
 {% endblock %}
 
@@ -44,7 +46,7 @@ First written: 2023/2/26
   {% endif %}
 
   <div class="form-floating mb-3">
-    <input id="accounting-date" class="form-control {% if form.date.errors %} is-invalid {% endif %}" type="date" name="date" value="{{ form.date.data|accounting_default }}" placeholder=" " required="required">
+    <input id="accounting-date" class="form-control {% if form.date.errors %} is-invalid {% endif %}" type="date" name="date" value="{{ form.date.data|accounting_default }}" max="{{ form.max_date|accounting_default }}" min="{{ form.min_date|accounting_default }}" placeholder=" " required="required">
     <label class="form-label" for="accounting-date">{{ A_("Date") }}</label>
     <div id="accounting-date-error" class="invalid-feedback">{% if form.date.errors %}{{ form.date.errors[0] }}{% endif %}</div>
   </div>
@@ -57,7 +59,7 @@ First written: 2023/2/26
       </div>
 
       <div>
-        <button id="accounting-btn-new-currency" class="btn btn-primary" type="button">
+        <button id="accounting-add-currency" class="btn btn-primary" type="button">
           <i class="fas fa-plus"></i>
           {{ A_("New") }}
         </button>
@@ -86,7 +88,8 @@ First written: 2023/2/26
   </div>
 </form>
 
-{% include "accounting/transaction/include/entry-form-modal.html" %}
+{% include "accounting/transaction/include/journal-entry-editor-modal.html" %}
 {% block form_modals %}{% endblock %}
+{% include "accounting/transaction/include/original-entry-selector-modal.html" %}
 
 {% endblock %}

src/accounting/templates/accounting/transaction/include/journal-entry-editor-modal.html

@@ -0,0 +1,76 @@
+{#
+The Mia! Accounting Flask Project
+journal-entry-editor-modal.html: The modal of the journal entry editor
+
+ 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/2/25
+#}
+<form id="accounting-entry-editor">
+  <div id="accounting-entry-editor-modal" class="modal fade" tabindex="-1" aria-labelledby="accounting-entry-editor-modal-label" aria-hidden="true">
+    <div class="modal-dialog">
+      <div class="modal-content">
+        <div class="modal-header">
+          <h1 class="modal-title fs-5" id="accounting-entry-editor-modal-label">{{ A_("Journal Entry Content") }}</h1>
+          <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="{{ A_("Close") }}"></button>
+        </div>
+        <div class="modal-body">
+          <div id="accounting-entry-editor-original-entry-container" class="d-flex justify-content-between mb-3">
+            <div class="accounting-entry-editor-original-entry-content">
+              <div id="accounting-entry-editor-original-entry-control" class="form-control accounting-clickable accounting-material-text-field" data-bs-toggle="modal" data-bs-target="#accounting-original-entry-selector-modal">
+                <label class="form-label" for="accounting-entry-editor-original-entry">{{ A_("Original Entry") }}</label>
+                <div id="accounting-entry-editor-original-entry"></div>
+              </div>
+              <div id="accounting-entry-editor-original-entry-error" class="invalid-feedback"></div>
+            </div>
+
+            <div>
+              <button id="accounting-entry-editor-original-entry-delete" class="btn btn-danger rounded-circle" type="button">
+                <i class="fas fa-minus"></i>
+              </button>
+            </div>
+          </div>
+
+          <div class="mb-3">
+            <div id="accounting-entry-editor-summary-control" class="form-control accounting-clickable accounting-material-text-field" data-bs-toggle="modal" data-bs-target="">
+              <label class="form-label" for="accounting-entry-editor-summary">{{ A_("Summary") }}</label>
+              <div id="accounting-entry-editor-summary"></div>
+            </div>
+            <div id="accounting-entry-editor-summary-error" class="invalid-feedback"></div>
+          </div>
+
+          <div class="mb-3">
+            <div id="accounting-entry-editor-account-control" class="form-control accounting-clickable accounting-material-text-field" data-bs-toggle="modal" data-bs-target="">
+              <label class="form-label" for="accounting-entry-editor-account">{{ A_("Account") }}</label>
+              <div id="accounting-entry-editor-account"></div>
+            </div>
+            <div id="accounting-entry-editor-account-error" class="invalid-feedback"></div>
+          </div>
+
+          <div class="form-floating mb-3">
+            <input id="accounting-entry-editor-amount" class="form-control" type="number" value="" min="0" max="" step="0.01" placeholder=" " required="required">
+            <label for="accounting-entry-editor-amount">{{ A_("Amount") }}</label>
+            <div id="accounting-entry-editor-amount-error" class="invalid-feedback"></div>
+          </div>
+        </div>
+        <div class="modal-footer">
+          <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">{{ A_("Cancel") }}</button>
+          <button type="submit" class="btn btn-primary">{{ A_("Save") }}</button>
+        </div>
+      </div>
+    </div>
+  </div>
+</form>

src/accounting/templates/accounting/transaction/include/original-entry-selector-modal.html

@@ -0,0 +1,56 @@
+{#
+The Mia! Accounting Flask Project
+original-entry-selector-modal.html: The modal of the original entry selector
+
+ 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/2/25
+#}
+<div id="accounting-original-entry-selector-modal" class="modal fade" tabindex="-1" aria-labelledby="accounting-original-entry-selector-modal-label" aria-hidden="true">
+  <div class="modal-dialog">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h1 class="modal-title fs-5" id="accounting-original-entry-selector-modal-label">{{ A_("Select Original Entry") }}</h1>
+        <button type="button" class="btn-close" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal" aria-label="{{ A_("Close") }}"></button>
+      </div>
+      <div class="modal-body">
+        <div class="input-group mb-2">
+          <input id="accounting-original-entry-selector-query" class="form-control form-control-sm" type="search" placeholder=" " required="required">
+          <label class="input-group-text" for="accounting-original-entry-selector-query">
+            <i class="fa-solid fa-magnifying-glass"></i>
+            {{ A_("Search") }}
+          </label>
+        </div>
+
+        <ul id="accounting-original-entry-selector-option-list" class="list-group accounting-selector-list">
+          {% for entry in form.original_entry_options %}
+            <li id="accounting-original-entry-selector-option-{{ entry.id }}" class="list-group-item d-flex justify-content-between accounting-clickable accounting-original-entry-selector-option" data-id="{{ entry.id }}" data-date="{{ entry.transaction.date }}" data-entry-type="{{ "debit" if entry.is_debit else "credit" }}" data-currency-code="{{ entry.currency.code }}" data-account-code="{{ entry.account_code }}" data-account-text="{{ entry.account }}" data-summary="{{ entry.summary|accounting_default }}" data-net-balance="{{ entry.net_balance|accounting_txn_format_amount_input }}" data-text="{{ entry }}" data-query-values="{{ entry.query_values|tojson|forceescape }}" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">
+              <div>{{ entry.transaction.date|accounting_format_date }} {{ entry.summary|accounting_default }}</div>
+              <div>
+                <span class="badge bg-primary rounded-pill">
+                  <span id="accounting-original-entry-selector-option-{{ entry.id }}-net-balance">{{ entry.net_balance|accounting_format_amount }}</span>
+                  / {{ entry.amount|accounting_format_amount }}
+                </span>
+              </div>
+            </li>
+          {% endfor %}
+        </ul>
+        <p id="accounting-original-entry-selector-option-no-result" class="d-none">{{ A_("There is no data.") }}</p>
+      </div>
+    </div>
+  </div>
+</div>
+

src/accounting/templates/accounting/transaction/include/summary-editor-modal.html

@@ -27,11 +27,14 @@ First written: 2023/2/28
           <h1 class="modal-title fs-5" id="accounting-summary-editor-{{ summary_editor.type }}-modal-label">
             <label for="accounting-summary-editor-{{ summary_editor.type }}-summary">{{ A_("Summary") }}</label>
           </h1>
-          <button class="btn-close" type="button" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal" aria-label="{{ A_("Close") }}"></button>
+          <button class="btn-close" type="button" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal" aria-label="{{ A_("Close") }}"></button>
         </div>
         <div class="modal-body">
-          <div class="mb-3">
+          <div class="d-flex justify-content-between mb-3">
             <input id="accounting-summary-editor-{{ summary_editor.type }}-summary" class="form-control" type="text" aria-labelledby="accounting-summary-editor-{{ summary_editor.type }}-modal-label">
+            <button id="accounting-summary-editor-{{ summary_editor.type }}-offset" class="btn btn-primary text-nowrap ms-2" type="button" data-bs-toggle="modal" data-bs-target="#accounting-original-entry-selector-modal">
+              {{ A_("Offset...") }}
+            </button>
           </div>
 
           {# Tab navigation #}
@@ -174,14 +177,14 @@ First written: 2023/2/28
           {# The suggested accounts #}
           <div class="mt-3">
             {% for account in summary_editor.accounts %}
-              <button class="btn btn-outline-primary d-none accounting-summary-editor-{{ summary_editor.type }}-account" type="button" data-code="{{ account.code }}" data-text="{{ account }}">
+              <button class="btn btn-outline-primary d-none accounting-summary-editor-{{ summary_editor.type }}-account {% if account.is_need_offset %} accounting-account-is-need-offset {% endif %}" type="button" data-code="{{ account.code }}" data-text="{{ account }}">
                 {{ account }}
               </button>
             {% endfor %}
           </div>
         </div>
         <div class="modal-footer">
-          <button class="btn btn-secondary" type="button" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">{{ A_("Cancel") }}</button>
+          <button class="btn btn-secondary" type="button" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">{{ A_("Cancel") }}</button>
           <button id="accounting-summary-editor-{{ summary_editor.type }}-btn-save" type="submit" class="btn btn-primary">{{ A_("Save") }}</button>
         </div>
       </div>

src/accounting/templates/accounting/transaction/income/create.html

@@ -23,6 +23,6 @@ First written: 2023/2/25
 
 {% block header %}{% block title %}{{ A_("Add a New Cash Income Transaction") }}{% endblock %}{% endblock %}
 
-{% block back_url %}{{ request.args.get("next") or url_for("accounting.report.journal-default") }}{% endblock %}
+{% block back_url %}{{ request.args.get("next") or url_for("accounting.report.default") }}{% endblock %}
 
 {% block action_url %}{{ url_for("accounting.transaction.store", txn_type=txn_type) }}{% endblock %}

src/accounting/templates/accounting/transaction/income/detail.html

@@ -35,19 +35,9 @@ First written: 2023/2/26
 
       <ul class="list-group accounting-list-group-stripped accounting-list-group-hover">
         <li class="list-group-item accounting-transaction-entry accounting-transaction-entry-header">{{ A_("Content") }}</li>
-        {% for entry in currency.credit %}
-          <li class="list-group-item accounting-transaction-entry">
-            <div class="d-flex justify-content-between">
-              <div>
-                <div class="small">{{ entry.account }}</div>
-                {% if entry.summary is not none %}
-                  <div>{{ entry.summary }}</div>
-                {% endif %}
-              </div>
-              <div>{{ entry.amount|accounting_format_amount }}</div>
-            </div>
-          </li>
-        {% endfor %}
+        {% with entries = currency.credit %}
+          {% include "accounting/transaction/include/detail-entries.html" %}
+        {% endwith %}
         <li class="list-group-item accounting-transaction-entry accounting-transaction-entry-total">
           <div class="d-flex justify-content-between">
             <div>{{ A_("Total") }}</div>

src/accounting/templates/accounting/transaction/income/include/form-currency-item.html

@@ -19,22 +19,23 @@ currency-sub-form.html: The currency sub-form in the cash income transaction for
 Author: imacat@mail.imacat.idv.tw (imacat)
 First written: 2023/2/25
 #}
-<div id="accounting-currency-{{ currency_index }}" class="mb-3 accounting-currency" data-index="{{ currency_index }}" data-prefix="accounting-currency-{{ currency_index }}">
+<div id="accounting-currency-{{ currency_index }}" class="mb-3 accounting-currency" data-index="{{ currency_index }}">
   <input id="accounting-currency-{{ currency_index }}-no" type="hidden" name="currency-{{ currency_index }}-no" value="{{ currency_index }}">
+  <input id="accounting-currency-{{ currency_index }}-code" type="hidden" name="currency-{{ currency_index }}-code" value="{{ currency_code_data }}">
   <div id="accounting-currency-{{ currency_index }}-control" class="form-control accounting-currency-control {% if currency_errors %} is-invalid {% endif %}">
     <div class="d-flex justify-content-between mt-2 mb-3">
       <div class="form-floating accounting-currency-content">
-        <select id="accounting-currency-{{ currency_index }}-code" class="form-select" name="currency-{{ currency_index }}-code">
+        <select id="accounting-currency-{{ currency_index }}-code-select" class="form-select {% if currency_code_errors %} is-invalid {% endif %}" name="currency-{{ currency_index }}-code" {% if currency_code_is_locked %} disabled="disabled" {% endif %}>
           {% for currency in accounting_currency_options() %}
             <option value="{{ currency.code }}" {% if currency.code == currency_code_data %} selected="selected" {% endif %}>{{ currency }}</option>
           {% endfor %}
         </select>
-        <label class="form-label" for="accounting-currency-{{ currency_index }}-code">{{ A_("Currency") }}</label>
+        <label class="form-label" for="accounting-currency-{{ currency_index }}-code-select">{{ A_("Currency") }}</label>
         <div id="accounting-currency-{{ currency_index }}-code-error" class="invalid-feedback">{% if currency_code_errors %}{{ currency_code_errors[0] }}{% endif %}</div>
       </div>
 
       <div>
-        <button id="accounting-btn-delete-currency-{{ currency_index }}" class="btn btn-danger rounded-circle accounting-btn-delete-currency {% if only_one_currency_form %} d-none {% endif %}" type="button" data-target="accounting-currency-{{ currency_index }}">
+        <button id="accounting-currency-{{ currency_index }}-delete" class="btn btn-danger rounded-circle {% if only_one_currency_form %} d-none {% endif %}" type="button" data-target="accounting-currency-{{ currency_index }}">
           <i class="fas fa-minus"></i>
         </button>
       </div>
@@ -55,9 +56,17 @@ First written: 2023/2/25
                     account_text = entry_form.account_text,
                     summary_data = entry_form.summary.data|accounting_default,
                     summary_errors = entry_form.summary.errors,
+                    original_entry_id_data = entry_form.original_entry_id.data|accounting_default,
+                    original_entry_date = entry_form.original_entry_date|accounting_default,
+                    original_entry_text = entry_form.original_entry_text|accounting_default,
+                    is_need_offset = entry_form.is_need_offset,
+                    offset_entries = entry_form.offsets,
+                    offset_total = entry_form.offset_total|accounting_default("0"),
+                    net_balance_data = entry_form.net_balance,
+                    net_balance_text = entry_form.net_balance|accounting_format_amount,
                     amount_data = entry_form.amount.data|accounting_txn_format_amount_input,
                     amount_errors = entry_form.amount.errors,
-                    amount_text = entry_form.amount.data|accounting_format_amount|accounting_default("-"),
+                    amount_text = entry_form.amount.data|accounting_format_amount,
                     entry_errors = entry_form.all_errors %}
               {% include "accounting/transaction/include/form-entry-item.html" %}
             {% endwith %}
@@ -70,7 +79,7 @@ First written: 2023/2/25
         </div>
 
         <div>
-          <button class="btn btn-primary accounting-btn-new-entry accounting-currency-{{ currency_index }}-btn-new-entry" type="button" data-currency-index="{{ currency_index }}" data-entry-type="credit" data-entry-index="new" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">
+          <button id="accounting-currency-{{ currency_index }}-credit-add-entry" class="btn btn-primary" type="button" data-currency-index="{{ currency_index }}" data-entry-type="credit" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">
             <i class="fas fa-plus"></i>
             {{ A_("New") }}
           </button>

src/accounting/templates/accounting/transaction/income/include/form.html

@@ -29,6 +29,7 @@ First written: 2023/2/25
               currency_errors = currency_form.whole_form.errors,
               currency_code_data = currency_form.code.data,
               currency_code_errors = currency_form.code.errors,
+              currency_code_is_locked = currency_form.is_code_locked,
               credit_forms = currency_form.credit,
               credit_errors = currency_form.credit_errors,
               credit_total = currency_form.form.credit_total|accounting_format_amount %}

src/accounting/templates/accounting/transaction/order.html

@@ -31,7 +31,7 @@ First written: 2023/2/26
 {% block content %}
 
 <div class="btn-group mb-3">
-  <a class="btn btn-primary" href="{{ url_for("accounting.report.journal-default")|accounting_or_next }}">
+  <a class="btn btn-primary" href="{{ url_for("accounting.report.default")|accounting_or_next }}">
     <i class="fa-solid fa-circle-chevron-left"></i>
     {{ A_("Back") }}
   </a>

src/accounting/templates/accounting/transaction/transfer/create.html

@@ -23,6 +23,6 @@ First written: 2023/2/25
 
 {% block header %}{% block title %}{{ A_("Add a New Transfer Transaction") }}{% endblock %}{% endblock %}
 
-{% block back_url %}{{ request.args.get("next") or url_for("accounting.report.journal-default") }}{% endblock %}
+{% block back_url %}{{ request.args.get("next") or url_for("accounting.report.default") }}{% endblock %}
 
 {% block action_url %}{{ url_for("accounting.transaction.store", txn_type=txn_type) }}{% endblock %}

src/accounting/templates/accounting/transaction/transfer/detail.html

@@ -31,19 +31,9 @@ First written: 2023/2/26
         <div class="col-sm-6 mb-2">
           <ul class="list-group accounting-list-group-stripped accounting-list-group-hover">
             <li class="list-group-item accounting-transaction-entry accounting-transaction-entry-header">{{ A_("Debit") }}</li>
-            {% for entry in currency.debit %}
-              <li class="list-group-item accounting-transaction-entry">
-                <div class="d-flex justify-content-between">
-                  <div>
-                    <div class="small">{{ entry.account }}</div>
-                    {% if entry.summary is not none %}
-                      <div>{{ entry.summary }}</div>
-                    {% endif %}
-                  </div>
-                  <div>{{ entry.amount|accounting_format_amount }}</div>
-                </div>
-              </li>
-            {% endfor %}
+            {% with entries = currency.debit %}
+              {% include "accounting/transaction/include/detail-entries.html" %}
+            {% endwith %}
             <li class="list-group-item accounting-transaction-entry accounting-transaction-entry-total">
               <div class="d-flex justify-content-between">
                 <div>{{ A_("Total") }}</div>
@@ -57,19 +47,9 @@ First written: 2023/2/26
         <div class="col-sm-6 mb-2">
           <ul class="list-group accounting-list-group-stripped accounting-list-group-hover">
             <li class="list-group-item accounting-transaction-entry accounting-transaction-entry-header">{{ A_("Credit") }}</li>
-            {% for entry in currency.credit %}
-              <li class="list-group-item accounting-transaction-entry">
-                <div class="d-flex justify-content-between">
-                  <div>
-                    <div class="small">{{ entry.account }}</div>
-                    {% if entry.summary is not none %}
-                      <div>{{ entry.summary }}</div>
-                    {% endif %}
-                  </div>
-                  <div>{{ entry.amount|accounting_format_amount }}</div>
-                </div>
-              </li>
-            {% endfor %}
+            {% with entries = currency.credit %}
+              {% include "accounting/transaction/include/detail-entries.html" %}
+            {% endwith %}
             <li class="list-group-item accounting-transaction-entry accounting-transaction-entry-total">
               <div class="d-flex justify-content-between">
                 <div>{{ A_("Total") }}</div>

src/accounting/templates/accounting/transaction/transfer/include/form-currency-item.html

@@ -19,22 +19,23 @@ currency-sub-form.html: The currency sub-form in the transfer transaction form
 Author: imacat@mail.imacat.idv.tw (imacat)
 First written: 2023/2/25
 #}
-<div id="accounting-currency-{{ currency_index }}" class="mb-3 accounting-currency" data-index="{{ currency_index }}" data-prefix="accounting-currency-{{ currency_index }}">
+<div id="accounting-currency-{{ currency_index }}" class="mb-3 accounting-currency" data-index="{{ currency_index }}">
   <input id="accounting-currency-{{ currency_index }}-no" type="hidden" name="currency-{{ currency_index }}-no" value="{{ currency_index }}">
+  <input id="accounting-currency-{{ currency_index }}-code" type="hidden" name="currency-{{ currency_index }}-code" value="{{ currency_code_data }}">
   <div id="accounting-currency-{{ currency_index }}-control" class="form-control accounting-currency-control {% if currency_errors %} is-invalid {% endif %}">
     <div class="d-flex justify-content-between mt-2 mb-3">
       <div class="form-floating accounting-currency-content">
-        <select id="accounting-currency-{{ currency_index }}-code" class="form-select" name="currency-{{ currency_index }}-code">
+        <select id="accounting-currency-{{ currency_index }}-code-select" class="form-select {% if currency_code_errors %} is-invalid {% endif %}" {% if currency_code_is_locked %} disabled="disabled" {% endif %}>
           {% for currency in accounting_currency_options() %}
             <option value="{{ currency.code }}" {% if currency.code == currency_code_data %} selected="selected" {% endif %}>{{ currency }}</option>
           {% endfor %}
         </select>
-        <label class="form-label" for="accounting-currency-{{ currency_index }}-code">{{ A_("Currency") }}</label>
+        <label class="form-label" for="accounting-currency-{{ currency_index }}-code-select">{{ A_("Currency") }}</label>
         <div id="accounting-currency-{{ currency_index }}-code-error" class="invalid-feedback">{% if currency_code_errors %}{{ currency_code_errors[0] }}{% endif %}</div>
       </div>
 
       <div>
-        <button id="accounting-btn-delete-currency-{{ currency_index }}" class="btn btn-danger rounded-circle accounting-btn-delete-currency {% if only_one_currency_form %} d-none {% endif %}" type="button" data-target="accounting-currency-{{ currency_index }}">
+        <button id="accounting-currency-{{ currency_index }}-delete" class="btn btn-danger rounded-circle {% if only_one_currency_form %} d-none {% endif %}" type="button" data-target="accounting-currency-{{ currency_index }}">
           <i class="fas fa-minus"></i>
         </button>
       </div>
@@ -57,9 +58,17 @@ First written: 2023/2/25
                       account_text = entry_form.account_text,
                       summary_data = entry_form.summary.data|accounting_default,
                       summary_errors = entry_form.summary.errors,
+                      original_entry_id_data = entry_form.original_entry_id.data|accounting_default,
+                      original_entry_date = entry_form.original_entry_date|accounting_default,
+                      original_entry_text = entry_form.original_entry_text|accounting_default,
+                      is_need_offset = entry_form.is_need_offset,
+                      offset_entries = entry_form.offsets,
+                      offset_total = entry_form.offset_total|accounting_default,
+                      net_balance_data = entry_form.net_balance,
+                      net_balance_text = entry_form.net_balance|accounting_format_amount,
                       amount_data = entry_form.amount.data|accounting_txn_format_amount_input,
                       amount_errors = entry_form.amount.errors,
-                      amount_text = entry_form.amount.data|accounting_format_amount|accounting_default("-"),
+                      amount_text = entry_form.amount.data|accounting_format_amount,
                       entry_errors = entry_form.all_errors %}
                 {% include "accounting/transaction/include/form-entry-item.html" %}
               {% endwith %}
@@ -72,7 +81,7 @@ First written: 2023/2/25
           </div>
 
           <div>
-            <button class="btn btn-primary accounting-btn-new-entry accounting-currency-{{ currency_index }}-btn-new-entry" type="button" data-currency-index="{{ currency_index }}" data-entry-type="debit" data-entry-index="new" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">
+            <button id="accounting-currency-{{ currency_index }}-debit-add-entry" class="btn btn-primary" type="button" data-currency-index="{{ currency_index }}" data-entry-type="debit" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">
               <i class="fas fa-plus"></i>
               {{ A_("New") }}
             </button>
@@ -88,18 +97,26 @@ First written: 2023/2/25
           <ul id="accounting-currency-{{ currency_index }}-credit-list" class="list-group accounting-entry-list">
             {% for entry_form in credit_forms %}
               {% with currency_index = currency_index,
-                      entry_id = entry_form.eid.data,
                       entry_type = "credit",
                       entry_index = loop.index,
                       only_one_entry_form = debit_forms|length == 1,
+                      entry_id = entry_form.eid.data,
                       account_code_data = entry_form.account_code.data|accounting_default,
                       account_code_error = entry_form.account_code.errors,
                       account_text = entry_form.account_text,
                       summary_data = entry_form.summary.data|accounting_default,
                       summary_errors = entry_form.summary.errors,
+                      original_entry_id_data = entry_form.original_entry_id.data|accounting_default,
+                      original_entry_date = entry_form.original_entry_date|accounting_default,
+                      original_entry_text = entry_form.original_entry_text|accounting_default,
+                      is_need_offset = entry_form.is_need_offset,
+                      offset_entries = entry_form.offsets,
+                      offset_total = entry_form.offset_total|accounting_default("0"),
+                      net_balance_data = entry_form.net_balance,
+                      net_balance_text = entry_form.net_balance|accounting_format_amount,
                       amount_data = entry_form.amount.data|accounting_txn_format_amount_input,
                       amount_errors = entry_form.amount.errors,
-                      amount_text = entry_form.amount.data|accounting_format_amount|accounting_default("-"),
+                      amount_text = entry_form.amount.data|accounting_format_amount,
                       entry_errors = entry_form.all_errors %}
                 {% include "accounting/transaction/include/form-entry-item.html" %}
               {% endwith %}
@@ -112,7 +129,7 @@ First written: 2023/2/25
           </div>
 
           <div>
-            <button class="btn btn-primary accounting-btn-new-entry accounting-currency-{{ currency_index }}-btn-new-entry" type="button" data-currency-index="{{ currency_index }}" data-entry-type="credit" data-entry-index="new" data-bs-toggle="modal" data-bs-target="#accounting-entry-form-modal">
+            <button id="accounting-currency-{{ currency_index }}-credit-add-entry" class="btn btn-primary" type="button" data-currency-index="{{ currency_index }}" data-entry-type="credit" data-bs-toggle="modal" data-bs-target="#accounting-entry-editor-modal">
               <i class="fas fa-plus"></i>
               {{ A_("New") }}
             </button>

src/accounting/templates/accounting/transaction/transfer/include/form.html

@@ -29,6 +29,7 @@ First written: 2023/2/25
               currency_errors = currency_form.whole_form.errors,
               currency_code_data = currency_form.code.data,
               currency_code_errors = currency_form.code.errors,
+              currency_code_is_locked = currency_form.is_code_locked,
               debit_forms = currency_form.debit,
               debit_errors = currency_form.debit_errors,
               debit_total = currency_form.form.debit_total|accounting_format_amount,

src/accounting/transaction/converters.py

@@ -20,10 +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 Transaction
+from accounting.models import Transaction, JournalEntry
 from accounting.utils.txn_types import TransactionType
 
 
@@ -37,7 +37,13 @@ class TransactionConverter(BaseConverter):
         :param value: The transaction ID.
         :return: The corresponding transaction.
         """
-        transaction: Transaction | None = db.session.get(Transaction, value)
+        transaction: Transaction | None = Transaction.query\
+            .join(JournalEntry)\
+            .filter(Transaction.id == value)\
+            .options(selectinload(Transaction.entries)
+                     .selectinload(JournalEntry.offsets)
+                     .selectinload(JournalEntry.transaction))\
+            .first()
         if transaction is None:
             abort(404)
         return transaction

src/accounting/transaction/forms/__init__.py

@@ -0,0 +1,22 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/10
+
+#  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 forms for the transaction management.
+
+"""
+from .reorder import sort_transactions_in, TransactionReorderForm
+from .transaction import TransactionForm, IncomeTransactionForm, \
+    ExpenseTransactionForm, TransferTransactionForm

src/accounting/transaction/forms/currency.py

@@ -0,0 +1,294 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/10
+
+#  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 currency sub-forms for the transaction management.
+
+"""
+from decimal import Decimal
+
+import sqlalchemy as sa
+from flask_babel import LazyString
+from flask_wtf import FlaskForm
+from wtforms import StringField, ValidationError, FieldList, IntegerField, \
+    BooleanField, FormField
+from wtforms.validators import DataRequired
+
+from accounting import db
+from accounting.locale import lazy_gettext
+from accounting.models import Currency, JournalEntry
+from accounting.transaction.utils.offset_alias import offset_alias
+from accounting.utils.cast import be
+from accounting.utils.strip_text import strip_text
+from .journal_entry import JournalEntryForm, CreditEntryForm, DebitEntryForm
+
+CURRENCY_REQUIRED: DataRequired = DataRequired(
+    lazy_gettext("Please select the currency."))
+"""The validator to check if the currency code is empty."""
+
+
+class CurrencyExists:
+    """The validator to check if the account exists."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        if field.data is None:
+            return
+        if db.session.get(Currency, field.data) is None:
+            raise ValidationError(lazy_gettext(
+                "The currency does not exist."))
+
+
+class SameCurrencyAsOriginalEntries:
+    """The validator to check if the currency is the same as the original
+    entries."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        assert isinstance(form, CurrencyForm)
+        if field.data is None:
+            return
+        original_entry_id: set[int] = {x.original_entry_id.data
+                                       for x in form.entries
+                                       if x.original_entry_id.data is not None}
+        if len(original_entry_id) == 0:
+            return
+        original_entry_currency_codes: set[str] = set(db.session.scalars(
+            sa.select(JournalEntry.currency_code)
+            .filter(JournalEntry.id.in_(original_entry_id))).all())
+        for currency_code in original_entry_currency_codes:
+            if field.data != currency_code:
+                raise ValidationError(lazy_gettext(
+                    "The currency must be the same as the original entry."))
+
+
+class KeepCurrencyWhenHavingOffset:
+    """The validator to check if the currency is the same when there is
+    offset."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        assert isinstance(form, CurrencyForm)
+        if field.data is None:
+            return
+        offset: sa.Alias = offset_alias()
+        original_entries: list[JournalEntry] = JournalEntry.query\
+            .join(offset, be(JournalEntry.id == offset.c.original_entry_id),
+                  isouter=True)\
+            .filter(JournalEntry.id.in_({x.eid.data for x in form.entries
+                                         if x.eid.data is not None}))\
+            .group_by(JournalEntry.id, JournalEntry.currency_code)\
+            .having(sa.func.count(offset.c.id) > 0).all()
+        for original_entry in original_entries:
+            if original_entry.currency_code != field.data:
+                raise ValidationError(lazy_gettext(
+                    "The currency must not be changed when there is offset."))
+
+
+class NeedSomeJournalEntries:
+    """The validator to check if there is any journal entry sub-form."""
+
+    def __call__(self, form: FlaskForm, field: FieldList) -> None:
+        if len(field) == 0:
+            raise ValidationError(lazy_gettext(
+                "Please add some journal entries."))
+
+
+class IsBalanced:
+    """The validator to check that the total amount of the debit and credit
+    entries are equal."""
+
+    def __call__(self, form: FlaskForm, field: BooleanField) -> None:
+        assert isinstance(form, TransferCurrencyForm)
+        if len(form.debit) == 0 or len(form.credit) == 0:
+            return
+        if form.debit_total != form.credit_total:
+            raise ValidationError(lazy_gettext(
+                "The totals of the debit and credit amounts do not match."))
+
+
+class CurrencyForm(FlaskForm):
+    """The form to create or edit a currency in a transaction."""
+    no = IntegerField()
+    """The order in the transaction."""
+    code = StringField()
+    """The currency code."""
+    whole_form = BooleanField()
+    """The pseudo field for the whole form validators."""
+
+    @property
+    def entries(self) -> list[JournalEntryForm]:
+        """Returns the journal entry sub-forms.
+
+        :return: The journal entry sub-forms.
+        """
+        entry_forms: list[JournalEntryForm] = []
+        if isinstance(self, IncomeCurrencyForm):
+            entry_forms.extend([x.form for x in self.credit])
+        elif isinstance(self, ExpenseCurrencyForm):
+            entry_forms.extend([x.form for x in self.debit])
+        elif isinstance(self, TransferCurrencyForm):
+            entry_forms.extend([x.form for x in self.debit])
+            entry_forms.extend([x.form for x in self.credit])
+        return entry_forms
+
+    @property
+    def is_code_locked(self) -> bool:
+        """Returns whether the currency code should not be changed.
+
+        :return: True if the currency code should not be changed, or False
+            otherwise
+        """
+        entry_forms: list[JournalEntryForm] = self.entries
+        original_entry_id: set[int] \
+            = {x.original_entry_id.data for x in entry_forms
+               if x.original_entry_id.data is not None}
+        if len(original_entry_id) > 0:
+            return True
+        entry_id: set[int] = {x.eid.data for x in entry_forms
+                              if x.eid.data is not None}
+        select: sa.Select = sa.select(sa.func.count(JournalEntry.id))\
+            .filter(JournalEntry.original_entry_id.in_(entry_id))
+        return db.session.scalar(select) > 0
+
+
+class IncomeCurrencyForm(CurrencyForm):
+    """The form to create or edit a currency in a cash income transaction."""
+    no = IntegerField()
+    """The order in the transaction."""
+    code = StringField(
+        filters=[strip_text],
+        validators=[CURRENCY_REQUIRED,
+                    CurrencyExists(),
+                    SameCurrencyAsOriginalEntries(),
+                    KeepCurrencyWhenHavingOffset()])
+    """The currency code."""
+    credit = FieldList(FormField(CreditEntryForm),
+                       validators=[NeedSomeJournalEntries()])
+    """The credit entries."""
+    whole_form = BooleanField()
+    """The pseudo field for the whole form validators."""
+
+    @property
+    def credit_total(self) -> Decimal:
+        """Returns the total amount of the credit journal entries.
+
+        :return: The total amount of the credit journal entries.
+        """
+        return sum([x.amount.data for x in self.credit
+                    if x.amount.data is not None])
+
+    @property
+    def credit_errors(self) -> list[str | LazyString]:
+        """Returns the credit journal entry errors, without the errors in their
+        sub-forms.
+
+        :return:
+        """
+        return [x for x in self.credit.errors
+                if isinstance(x, str) or isinstance(x, LazyString)]
+
+
+class ExpenseCurrencyForm(CurrencyForm):
+    """The form to create or edit a currency in a cash expense transaction."""
+    no = IntegerField()
+    """The order in the transaction."""
+    code = StringField(
+        filters=[strip_text],
+        validators=[CURRENCY_REQUIRED,
+                    CurrencyExists(),
+                    SameCurrencyAsOriginalEntries(),
+                    KeepCurrencyWhenHavingOffset()])
+    """The currency code."""
+    debit = FieldList(FormField(DebitEntryForm),
+                      validators=[NeedSomeJournalEntries()])
+    """The debit entries."""
+    whole_form = BooleanField()
+    """The pseudo field for the whole form validators."""
+
+    @property
+    def debit_total(self) -> Decimal:
+        """Returns the total amount of the debit journal entries.
+
+        :return: The total amount of the debit journal entries.
+        """
+        return sum([x.amount.data for x in self.debit
+                    if x.amount.data is not None])
+
+    @property
+    def debit_errors(self) -> list[str | LazyString]:
+        """Returns the debit journal entry errors, without the errors in their
+        sub-forms.
+
+        :return:
+        """
+        return [x for x in self.debit.errors
+                if isinstance(x, str) or isinstance(x, LazyString)]
+
+
+class TransferCurrencyForm(CurrencyForm):
+    """The form to create or edit a currency in a transfer transaction."""
+    no = IntegerField()
+    """The order in the transaction."""
+    code = StringField(
+        filters=[strip_text],
+        validators=[CURRENCY_REQUIRED,
+                    CurrencyExists(),
+                    SameCurrencyAsOriginalEntries(),
+                    KeepCurrencyWhenHavingOffset()])
+    """The currency code."""
+    debit = FieldList(FormField(DebitEntryForm),
+                      validators=[NeedSomeJournalEntries()])
+    """The debit entries."""
+    credit = FieldList(FormField(CreditEntryForm),
+                       validators=[NeedSomeJournalEntries()])
+    """The credit entries."""
+    whole_form = BooleanField(validators=[IsBalanced()])
+    """The pseudo field for the whole form validators."""
+
+    @property
+    def debit_total(self) -> Decimal:
+        """Returns the total amount of the debit journal entries.
+
+        :return: The total amount of the debit journal entries.
+        """
+        return sum([x.amount.data for x in self.debit
+                    if x.amount.data is not None])
+
+    @property
+    def credit_total(self) -> Decimal:
+        """Returns the total amount of the credit journal entries.
+
+        :return: The total amount of the credit journal entries.
+        """
+        return sum([x.amount.data for x in self.credit
+                    if x.amount.data is not None])
+
+    @property
+    def debit_errors(self) -> list[str | LazyString]:
+        """Returns the debit journal entry errors, without the errors in their
+        sub-forms.
+
+        :return:
+        """
+        return [x for x in self.debit.errors
+                if isinstance(x, str) or isinstance(x, LazyString)]
+
+    @property
+    def credit_errors(self) -> list[str | LazyString]:
+        """Returns the credit journal entry errors, without the errors in their
+        sub-forms.
+
+        :return:
+        """
+        return [x for x in self.credit.errors
+                if isinstance(x, str) or isinstance(x, LazyString)]

src/accounting/transaction/forms/journal_entry.py

@@ -0,0 +1,524 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/10
+
+#  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 journal entry sub-forms for the transaction management.
+
+"""
+import re
+from datetime import date
+from decimal import Decimal
+
+import sqlalchemy as sa
+from flask_babel import LazyString
+from flask_wtf import FlaskForm
+from sqlalchemy.orm import selectinload
+from wtforms import StringField, ValidationError, DecimalField, IntegerField
+from wtforms.validators import DataRequired, Optional
+
+from accounting import db
+from accounting.locale import lazy_gettext
+from accounting.models import Account, JournalEntry
+from accounting.template_filters import format_amount
+from accounting.utils.cast import be
+from accounting.utils.random_id import new_id
+from accounting.utils.strip_text import strip_text
+from accounting.utils.user import get_current_user_pk
+
+ACCOUNT_REQUIRED: DataRequired = DataRequired(
+    lazy_gettext("Please select the account."))
+"""The validator to check if the account code is empty."""
+
+
+class OriginalEntryExists:
+    """The validator to check if the original entry exists."""
+
+    def __call__(self, form: FlaskForm, field: IntegerField) -> None:
+        if field.data is None:
+            return
+        if db.session.get(JournalEntry, field.data) is None:
+            raise ValidationError(lazy_gettext(
+                "The original entry does not exist."))
+
+
+class OriginalEntryOppositeSide:
+    """The validator to check if the original entry is on the opposite side."""
+
+    def __call__(self, form: FlaskForm, field: IntegerField) -> None:
+        if field.data is None:
+            return
+        original_entry: JournalEntry | None \
+            = db.session.get(JournalEntry, field.data)
+        if original_entry is None:
+            return
+        if isinstance(form, CreditEntryForm) and original_entry.is_debit:
+            return
+        if isinstance(form, DebitEntryForm) and not original_entry.is_debit:
+            return
+        raise ValidationError(lazy_gettext(
+            "The original entry is on the same side."))
+
+
+class OriginalEntryNeedOffset:
+    """The validator to check if the original entry needs offset."""
+
+    def __call__(self, form: FlaskForm, field: IntegerField) -> None:
+        if field.data is None:
+            return
+        original_entry: JournalEntry | None \
+            = db.session.get(JournalEntry, field.data)
+        if original_entry is None:
+            return
+        if not original_entry.account.is_need_offset:
+            raise ValidationError(lazy_gettext(
+                "The original entry does not need offset."))
+
+
+class OriginalEntryNotOffset:
+    """The validator to check if the original entry is not itself an offset
+    entry."""
+
+    def __call__(self, form: FlaskForm, field: IntegerField) -> None:
+        if field.data is None:
+            return
+        original_entry: JournalEntry | None \
+            = db.session.get(JournalEntry, field.data)
+        if original_entry is None:
+            return
+        if original_entry.original_entry_id is not None:
+            raise ValidationError(lazy_gettext(
+                "The original entry cannot be an offset entry."))
+
+
+class AccountExists:
+    """The validator to check if the account exists."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        if field.data is None:
+            return
+        if Account.find_by_code(field.data) is None:
+            raise ValidationError(lazy_gettext(
+                "The account does not exist."))
+
+
+class IsDebitAccount:
+    """The validator to check if the account is for debit journal entries."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        if field.data is None:
+            return
+        if re.match(r"^(?:[1235689]|7[5678])", field.data) \
+                and not field.data.startswith("3351-") \
+                and not field.data.startswith("3353-"):
+            return
+        raise ValidationError(lazy_gettext(
+            "This account is not for debit entries."))
+
+
+class IsCreditAccount:
+    """The validator to check if the account is for credit journal entries."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        if field.data is None:
+            return
+        if re.match(r"^(?:[123489]|7[1234])", field.data) \
+                and not field.data.startswith("3351-") \
+                and not field.data.startswith("3353-"):
+            return
+        raise ValidationError(lazy_gettext(
+            "This account is not for credit entries."))
+
+
+class SameAccountAsOriginalEntry:
+    """The validator to check if the account is the same as the original
+    entry."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        assert isinstance(form, JournalEntryForm)
+        if field.data is None or form.original_entry_id.data is None:
+            return
+        original_entry: JournalEntry | None \
+            = db.session.get(JournalEntry, form.original_entry_id.data)
+        if original_entry is None:
+            return
+        if field.data != original_entry.account_code:
+            raise ValidationError(lazy_gettext(
+                "The account must be the same as the original entry."))
+
+
+class KeepAccountWhenHavingOffset:
+    """The validator to check if the account is the same when having offset."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        assert isinstance(form, JournalEntryForm)
+        if field.data is None or form.eid.data is None:
+            return
+        entry: JournalEntry | None = db.session.query(JournalEntry)\
+            .filter(JournalEntry.id == form.eid.data)\
+            .options(selectinload(JournalEntry.offsets)).first()
+        if entry is None or len(entry.offsets) == 0:
+            return
+        if field.data != entry.account_code:
+            raise ValidationError(lazy_gettext(
+                "The account must not be changed when there is offset."))
+
+
+class NotStartPayableFromDebit:
+    """The validator to check that a payable journal entry does not start from
+    the debit side."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        assert isinstance(form, DebitEntryForm)
+        if field.data is None \
+                or field.data[0] != "2" \
+                or form.original_entry_id.data is not None:
+            return
+        account: Account | None = Account.find_by_code(field.data)
+        if account is not None and account.is_need_offset:
+            raise ValidationError(lazy_gettext(
+                "A payable entry cannot start from the debit side."))
+
+
+class NotStartReceivableFromCredit:
+    """The validator to check that a receivable journal entry does not start
+    from the credit side."""
+
+    def __call__(self, form: FlaskForm, field: StringField) -> None:
+        assert isinstance(form, CreditEntryForm)
+        if field.data is None \
+                or field.data[0] != "1" \
+                or form.original_entry_id.data is not None:
+            return
+        account: Account | None = Account.find_by_code(field.data)
+        if account is not None and account.is_need_offset:
+            raise ValidationError(lazy_gettext(
+                "A receivable entry cannot start from the credit side."))
+
+
+class PositiveAmount:
+    """The validator to check if the amount is positive."""
+
+    def __call__(self, form: FlaskForm, field: DecimalField) -> None:
+        if field.data is None:
+            return
+        if field.data <= 0:
+            raise ValidationError(lazy_gettext(
+                "Please fill in a positive amount."))
+
+
+class NotExceedingOriginalEntryNetBalance:
+    """The validator to check if the amount exceeds the net balance of the
+    original entry."""
+
+    def __call__(self, form: FlaskForm, field: DecimalField) -> None:
+        assert isinstance(form, JournalEntryForm)
+        if field.data is None or form.original_entry_id.data is None:
+            return
+        original_entry: JournalEntry | None \
+            = db.session.get(JournalEntry, form.original_entry_id.data)
+        if original_entry is None:
+            return
+        is_debit: bool = isinstance(form, DebitEntryForm)
+        existing_entry_id: set[int] = set()
+        if form.txn_form.obj is not None:
+            existing_entry_id = {x.id for x in form.txn_form.obj.entries}
+        offset_total_func: sa.Function = sa.func.sum(sa.case(
+            (be(JournalEntry.is_debit == is_debit), JournalEntry.amount),
+            else_=-JournalEntry.amount))
+        offset_total_but_form: Decimal | None = db.session.scalar(
+            sa.select(offset_total_func)
+            .filter(be(JournalEntry.original_entry_id == original_entry.id),
+                    JournalEntry.id.not_in(existing_entry_id)))
+        if offset_total_but_form is None:
+            offset_total_but_form = Decimal("0")
+        offset_total_on_form: Decimal = sum(
+            [x.amount.data for x in form.txn_form.entries
+             if x.original_entry_id.data == original_entry.id
+             and x.amount != field and x.amount.data is not None])
+        net_balance: Decimal = original_entry.amount - offset_total_but_form \
+            - offset_total_on_form
+        if field.data > net_balance:
+            raise ValidationError(lazy_gettext(
+                "The amount must not exceed the net balance %(balance)s of the"
+                " original entry.", balance=format_amount(net_balance)))
+
+
+class NotLessThanOffsetTotal:
+    """The validator to check if the amount is less than the offset total."""
+
+    def __call__(self, form: FlaskForm, field: DecimalField) -> None:
+        assert isinstance(form, JournalEntryForm)
+        if field.data is None or form.eid.data is None:
+            return
+        is_debit: bool = isinstance(form, DebitEntryForm)
+        select_offset_total: sa.Select = sa.select(sa.func.sum(sa.case(
+            (JournalEntry.is_debit != is_debit, JournalEntry.amount),
+            else_=-JournalEntry.amount)))\
+            .filter(be(JournalEntry.original_entry_id == form.eid.data))
+        offset_total: Decimal | None = db.session.scalar(select_offset_total)
+        if offset_total is not None and field.data < offset_total:
+            raise ValidationError(lazy_gettext(
+                "The amount must not be less than the offset total %(total)s.",
+                total=format_amount(offset_total)))
+
+
+class JournalEntryForm(FlaskForm):
+    """The base form to create or edit a journal entry."""
+    eid = IntegerField()
+    """The existing journal entry ID."""
+    no = IntegerField()
+    """The order in the currency."""
+    original_entry_id = IntegerField()
+    """The Id of the original entry."""
+    account_code = StringField()
+    """The account code."""
+    amount = DecimalField()
+    """The amount."""
+
+    def __init__(self, *args, **kwargs):
+        """Constructs a base transaction form.
+
+        :param args: The arguments.
+        :param kwargs: The keyword arguments.
+        """
+        super().__init__(*args, **kwargs)
+        from .transaction import TransactionForm
+        self.txn_form: TransactionForm | None = None
+        """The source transaction form."""
+
+    @property
+    def account_text(self) -> str:
+        """Returns the text representation of the account.
+
+        :return: The text representation of the account.
+        """
+        if self.account_code.data is None:
+            return ""
+        account: Account | None = Account.find_by_code(self.account_code.data)
+        if account is None:
+            return ""
+        return str(account)
+
+    @property
+    def __original_entry(self) -> JournalEntry | None:
+        """Returns the original entry.
+
+        :return: The original entry.
+        """
+        if not hasattr(self, "____original_entry"):
+            def get_entry() -> JournalEntry | None:
+                if self.original_entry_id.data is None:
+                    return None
+                return db.session.get(JournalEntry,
+                                      self.original_entry_id.data)
+            setattr(self, "____original_entry", get_entry())
+        return getattr(self, "____original_entry")
+
+    @property
+    def original_entry_date(self) -> date | None:
+        """Returns the text representation of the original entry.
+
+        :return: The text representation of the original entry.
+        """
+        return None if self.__original_entry is None \
+            else self.__original_entry.transaction.date
+
+    @property
+    def original_entry_text(self) -> str | None:
+        """Returns the text representation of the original entry.
+
+        :return: The text representation of the original entry.
+        """
+        return None if self.__original_entry is None \
+            else str(self.__original_entry)
+
+    @property
+    def is_need_offset(self) -> bool:
+        """Returns whether the entry needs offset.
+
+        :return: True if the entry needs offset, or False otherwise.
+        """
+        if self.account_code.data is None:
+            return False
+        if self.account_code.data[0] == "1":
+            if isinstance(self, CreditEntryForm):
+                return False
+        elif self.account_code.data[0] == "2":
+            if isinstance(self, DebitEntryForm):
+                return False
+        else:
+            return False
+        account: Account | None = Account.find_by_code(self.account_code.data)
+        return account is not None and account.is_need_offset
+
+    @property
+    def offsets(self) -> list[JournalEntry]:
+        """Returns the offsets.
+
+        :return: The offsets.
+        """
+        if not hasattr(self, "__offsets"):
+            def get_offsets() -> list[JournalEntry]:
+                if not self.is_need_offset or self.eid.data is None:
+                    return []
+                return JournalEntry.query\
+                    .filter(JournalEntry.original_entry_id == self.eid.data)\
+                    .options(selectinload(JournalEntry.transaction),
+                             selectinload(JournalEntry.account),
+                             selectinload(JournalEntry.offsets)
+                             .selectinload(JournalEntry.transaction)).all()
+            setattr(self, "__offsets", get_offsets())
+        return getattr(self, "__offsets")
+
+    @property
+    def offset_total(self) -> Decimal | None:
+        """Returns the total amount of the offsets.
+
+        :return: The total amount of the offsets.
+        """
+        if not hasattr(self, "__offset_total"):
+            def get_offset_total():
+                if not self.is_need_offset or self.eid.data is None:
+                    return None
+                is_debit: bool = isinstance(self, DebitEntryForm)
+                return sum([x.amount if x.is_debit != is_debit else -x.amount
+                            for x in self.offsets])
+            setattr(self, "__offset_total", get_offset_total())
+        return getattr(self, "__offset_total")
+
+    @property
+    def net_balance(self) -> Decimal | None:
+        """Returns the net balance.
+
+        :return: The net balance.
+        """
+        if not self.is_need_offset or self.eid.data is None \
+                or self.amount.data is None:
+            return None
+        return self.amount.data - self.offset_total
+
+    @property
+    def all_errors(self) -> list[str | LazyString]:
+        """Returns all the errors of the form.
+
+        :return: All the errors of the form.
+        """
+        all_errors: list[str | LazyString] = []
+        for key in self.errors:
+            if key != "csrf_token":
+                all_errors.extend(self.errors[key])
+        return all_errors
+
+
+class DebitEntryForm(JournalEntryForm):
+    """The form to create or edit a debit journal entry."""
+    eid = IntegerField()
+    """The existing journal entry ID."""
+    no = IntegerField()
+    """The order in the currency."""
+    original_entry_id = IntegerField(
+        validators=[Optional(),
+                    OriginalEntryExists(),
+                    OriginalEntryOppositeSide(),
+                    OriginalEntryNeedOffset(),
+                    OriginalEntryNotOffset()])
+    """The Id of the original entry."""
+    account_code = StringField(
+        filters=[strip_text],
+        validators=[ACCOUNT_REQUIRED,
+                    AccountExists(),
+                    IsDebitAccount(),
+                    SameAccountAsOriginalEntry(),
+                    KeepAccountWhenHavingOffset(),
+                    NotStartPayableFromDebit()])
+    """The account code."""
+    offset_original_entry_id = IntegerField()
+    """The Id of the original entry."""
+    summary = StringField(filters=[strip_text])
+    """The summary."""
+    amount = DecimalField(
+        validators=[PositiveAmount(),
+                    NotExceedingOriginalEntryNetBalance(),
+                    NotLessThanOffsetTotal()])
+    """The amount."""
+
+    def populate_obj(self, obj: JournalEntry) -> None:
+        """Populates the form data into a journal entry object.
+
+        :param obj: The journal entry object.
+        :return: None.
+        """
+        is_new: bool = obj.id is None
+        if is_new:
+            obj.id = new_id(JournalEntry)
+        obj.original_entry_id = self.original_entry_id.data
+        obj.account_id = Account.find_by_code(self.account_code.data).id
+        obj.summary = self.summary.data
+        obj.is_debit = True
+        obj.amount = self.amount.data
+        if is_new:
+            current_user_pk: int = get_current_user_pk()
+            obj.created_by_id = current_user_pk
+            obj.updated_by_id = current_user_pk
+
+
+class CreditEntryForm(JournalEntryForm):
+    """The form to create or edit a credit journal entry."""
+    eid = IntegerField()
+    """The existing journal entry ID."""
+    no = IntegerField()
+    """The order in the currency."""
+    original_entry_id = IntegerField(
+        validators=[Optional(),
+                    OriginalEntryExists(),
+                    OriginalEntryOppositeSide(),
+                    OriginalEntryNeedOffset(),
+                    OriginalEntryNotOffset()])
+    """The Id of the original entry."""
+    account_code = StringField(
+        filters=[strip_text],
+        validators=[ACCOUNT_REQUIRED,
+                    AccountExists(),
+                    IsCreditAccount(),
+                    SameAccountAsOriginalEntry(),
+                    KeepAccountWhenHavingOffset(),
+                    NotStartReceivableFromCredit()])
+    """The account code."""
+    summary = StringField(filters=[strip_text])
+    """The summary."""
+    amount = DecimalField(
+        validators=[PositiveAmount(),
+                    NotExceedingOriginalEntryNetBalance(),
+                    NotLessThanOffsetTotal()])
+    """The amount."""
+
+    def populate_obj(self, obj: JournalEntry) -> None:
+        """Populates the form data into a journal entry object.
+
+        :param obj: The journal entry object.
+        :return: None.
+        """
+        is_new: bool = obj.id is None
+        if is_new:
+            obj.id = new_id(JournalEntry)
+        obj.original_entry_id = self.original_entry_id.data
+        obj.account_id = Account.find_by_code(self.account_code.data).id
+        obj.summary = self.summary.data
+        obj.is_debit = False
+        obj.amount = self.amount.data
+        if is_new:
+            current_user_pk: int = get_current_user_pk()
+            obj.created_by_id = current_user_pk
+            obj.updated_by_id = current_user_pk

src/accounting/transaction/forms/reorder.py

@@ -0,0 +1,92 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/10
+
+#  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 reorder forms for the transaction management.
+
+"""
+from datetime import date
+
+import sqlalchemy as sa
+from flask import request
+
+from accounting import db
+from accounting.models import Transaction
+
+
+def sort_transactions_in(txn_date: date, exclude: int | None = None) -> None:
+    """Sorts the transactions under a date after changing the date or deleting
+    a transaction.
+
+    :param txn_date: The date of the transaction.
+    :param exclude: The transaction ID to exclude.
+    :return: None.
+    """
+    conditions: list[sa.BinaryExpression] = [Transaction.date == txn_date]
+    if exclude is not None:
+        conditions.append(Transaction.id != exclude)
+    transactions: list[Transaction] = Transaction.query\
+        .filter(*conditions)\
+        .order_by(Transaction.no).all()
+    for i in range(len(transactions)):
+        if transactions[i].no != i + 1:
+            transactions[i].no = i + 1
+
+
+class TransactionReorderForm:
+    """The form to reorder the transactions."""
+
+    def __init__(self, txn_date: date):
+        """Constructs the form to reorder the transactions in a day.
+
+        :param txn_date: The date.
+        """
+        self.date: date = txn_date
+        self.is_modified: bool = False
+
+    def save_order(self) -> None:
+        """Saves the order of the account.
+
+        :return:
+        """
+        transactions: list[Transaction] = Transaction.query\
+            .filter(Transaction.date == self.date).all()
+
+        # Collects the specified order.
+        orders: dict[Transaction, int] = {}
+        for txn in transactions:
+            if f"{txn.id}-no" in request.form:
+                try:
+                    orders[txn] = int(request.form[f"{txn.id}-no"])
+                except ValueError:
+                    pass
+
+        # Missing and invalid orders are appended to the end.
+        missing: list[Transaction] \
+            = [x for x in transactions if x not in orders]
+        if len(missing) > 0:
+            next_no: int = 1 if len(orders) == 0 else max(orders.values()) + 1
+            for txn in missing:
+                orders[txn] = next_no
+
+        # Sort by the specified order first, and their original order.
+        transactions.sort(key=lambda x: (orders[x], x.no))
+
+        # Update the orders.
+        with db.session.no_autoflush:
+            for i in range(len(transactions)):
+                if transactions[i].no != i + 1:
+                    transactions[i].no = i + 1
+                    self.is_modified = True

src/accounting/transaction/forms/transaction.py

@@ -14,270 +14,95 @@
 #  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 forms for the transaction management.
+"""The transaction forms for the transaction management.
 
 """
-from __future__ import annotations
-
-import re
+import datetime as dt
 import typing as t
 from abc import ABC, abstractmethod
-from datetime import date
-from decimal import Decimal
 
 import sqlalchemy as sa
-from flask import request
 from flask_babel import LazyString
 from flask_wtf import FlaskForm
-from wtforms import DateField, StringField, FieldList, FormField, \
-    IntegerField, TextAreaField, DecimalField, BooleanField
+from wtforms import DateField, FieldList, FormField, TextAreaField, \
+    BooleanField
 from wtforms.validators import DataRequired, ValidationError
 
 from accounting import db
 from accounting.locale import lazy_gettext
 from accounting.models import Transaction, Account, JournalEntry, \
-    TransactionCurrency, Currency
-from accounting.transaction.summary_editor import SummaryEditor
+    TransactionCurrency
+from accounting.transaction.utils.account_option import AccountOption
+from accounting.transaction.utils.original_entries import \
+    get_selectable_original_entries
+from accounting.transaction.utils.summary_editor import SummaryEditor
 from accounting.utils.random_id import new_id
-from accounting.utils.strip_text import strip_text, strip_multiline_text
+from accounting.utils.strip_text import strip_multiline_text
 from accounting.utils.user import get_current_user_pk
+from .currency import CurrencyForm, IncomeCurrencyForm, ExpenseCurrencyForm, \
+    TransferCurrencyForm
+from .journal_entry import JournalEntryForm, DebitEntryForm, CreditEntryForm
+from .reorder import sort_transactions_in
 
-MISSING_CURRENCY: LazyString = lazy_gettext("Please select the currency.")
-"""The error message when the currency code is empty."""
-MISSING_ACCOUNT: LazyString = lazy_gettext("Please select the account.")
-"""The error message when the account code is empty."""
 DATE_REQUIRED: DataRequired = DataRequired(
     lazy_gettext("Please fill in the date."))
 """The validator to check if the date is empty."""
 
 
+class NotBeforeOriginalEntries:
+    """The validator to check if the date is not before the original
+    entries."""
+
+    def __call__(self, form: FlaskForm, field: DateField) -> None:
+        assert isinstance(form, TransactionForm)
+        if field.data is None:
+            return
+        min_date: dt.date | None = form.min_date
+        if min_date is None:
+            return
+        if field.data < min_date:
+            raise ValidationError(lazy_gettext(
+                "The date cannot be earlier than the original entries."))
+
+
+class NotAfterOffsetEntries:
+    """The validator to check if the date is not after the offset entries."""
+
+    def __call__(self, form: FlaskForm, field: DateField) -> None:
+        assert isinstance(form, TransactionForm)
+        if field.data is None:
+            return
+        max_date: dt.date | None = form.max_date
+        if max_date is None:
+            return
+        if field.data > max_date:
+            raise ValidationError(lazy_gettext(
+                "The date cannot be later than the offset entries."))
+
+
 class NeedSomeCurrencies:
     """The validator to check if there is any currency sub-form."""
 
-    def __call__(self, form: CurrencyForm, field: FieldList) \
-            -> None:
+    def __call__(self, form: FlaskForm, field: FieldList) -> None:
         if len(field) == 0:
-            raise ValidationError(lazy_gettext(
-                "Please add some currencies."))
+            raise ValidationError(lazy_gettext("Please add some currencies."))
 
 
-class CurrencyExists:
-    """The validator to check if the account exists."""
+class CannotDeleteOriginalEntriesWithOffset:
+    """The validator to check the original entries with offset."""
 
-    def __call__(self, form: FlaskForm, field: StringField) -> None:
-        if field.data is None:
+    def __call__(self, form: FlaskForm, field: FieldList) -> None:
+        assert isinstance(form, TransactionForm)
+        if form.obj is None:
             return
-        if db.session.get(Currency, field.data) is None:
+        existing_matched_original_entry_id: set[int] \
+            = {x.id for x in form.obj.entries if len(x.offsets) > 0}
+        entry_id_in_form: set[int] \
+            = {x.eid.data for x in form.entries if x.eid.data is not None}
+        for entry_id in existing_matched_original_entry_id:
+            if entry_id not in entry_id_in_form:
                 raise ValidationError(lazy_gettext(
-                "The currency does not exist."))
-
-
-class NeedSomeJournalEntries:
-    """The validator to check if there is any journal entry sub-form."""
-
-    def __call__(self, form: TransferCurrencyForm, field: FieldList) \
-            -> None:
-        if len(field) == 0:
-            raise ValidationError(lazy_gettext(
-                "Please add some journal entries."))
-
-
-class AccountExists:
-    """The validator to check if the account exists."""
-
-    def __call__(self, form: FlaskForm, field: StringField) -> None:
-        if field.data is None:
-            return
-        if Account.find_by_code(field.data) is None:
-            raise ValidationError(lazy_gettext(
-                "The account does not exist."))
-
-
-class PositiveAmount:
-    """The validator to check if the amount is positive."""
-
-    def __call__(self, form: FlaskForm, field: DecimalField) -> None:
-        if field.data is None:
-            return
-        if field.data <= 0:
-            raise ValidationError(lazy_gettext(
-                "Please fill in a positive amount."))
-
-
-class IsDebitAccount:
-    """The validator to check if the account is for debit journal entries."""
-
-    def __call__(self, form: FlaskForm, field: StringField) -> None:
-        if field.data is None:
-            return
-        if re.match(r"^(?:[1235689]|7[5678])", field.data) \
-                and not field.data.startswith("3351-") \
-                and not field.data.startswith("3353-"):
-            return
-        raise ValidationError(lazy_gettext(
-            "This account is not for debit entries."))
-
-
-class AccountOption:
-    """An account option."""
-
-    def __init__(self, account: Account):
-        """Constructs an account option.
-
-        :param account: The account.
-        """
-        self.__account: Account = account
-        self.id: str = account.id
-        self.code: str = account.code
-        self.is_in_use: bool = False
-
-    def __str__(self) -> str:
-        """Returns the string representation of the account option.
-
-        :return: The string representation of the account option.
-        """
-        return str(self.__account)
-
-    @property
-    def query_values(self) -> list[str]:
-        """Returns the values to be queried.
-
-        :return: The values to be queried.
-        """
-        return self.__account.query_values
-
-
-class JournalEntryForm(FlaskForm):
-    """The base form to create or edit a journal entry."""
-    eid = IntegerField()
-    """The existing journal entry ID."""
-    no = IntegerField()
-    """The order in the currency."""
-    account_code = StringField()
-    """The account code."""
-    amount = DecimalField()
-    """The amount."""
-
-    @property
-    def account_text(self) -> str:
-        """Returns the text representation of the account.
-
-        :return: The text representation of the account.
-        """
-        if self.account_code.data is None:
-            return ""
-        account: Account | None = Account.find_by_code(self.account_code.data)
-        if account is None:
-            return ""
-        return str(account)
-
-    @property
-    def all_errors(self) -> list[str | LazyString]:
-        """Returns all the errors of the form.
-
-        :return: All the errors of the form.
-        """
-        all_errors: list[str | LazyString] = []
-        for key in self.errors:
-            if key != "csrf_token":
-                all_errors.extend(self.errors[key])
-        return all_errors
-
-
-class DebitEntryForm(JournalEntryForm):
-    """The form to create or edit a debit journal entry."""
-    eid = IntegerField()
-    """The existing journal entry ID."""
-    no = IntegerField()
-    """The order in the currency."""
-    account_code = StringField(
-        filters=[strip_text],
-        validators=[DataRequired(MISSING_ACCOUNT),
-                    AccountExists(),
-                    IsDebitAccount()])
-    """The account code."""
-    summary = StringField(filters=[strip_text])
-    """The summary."""
-    amount = DecimalField(validators=[PositiveAmount()])
-    """The amount."""
-
-    def populate_obj(self, obj: JournalEntry) -> None:
-        """Populates the form data into a journal entry object.
-
-        :param obj: The journal entry object.
-        :return: None.
-        """
-        is_new: bool = obj.id is None
-        if is_new:
-            obj.id = new_id(JournalEntry)
-        obj.account_id = Account.find_by_code(self.account_code.data).id
-        obj.summary = self.summary.data
-        obj.is_debit = True
-        obj.amount = self.amount.data
-        if is_new:
-            current_user_pk: int = get_current_user_pk()
-            obj.created_by_id = current_user_pk
-            obj.updated_by_id = current_user_pk
-
-
-class IsCreditAccount:
-    """The validator to check if the account is for credit journal entries."""
-
-    def __call__(self, form: FlaskForm, field: StringField) -> None:
-        if field.data is None:
-            return
-        if re.match(r"^(?:[123489]|7[1234])", field.data) \
-                and not field.data.startswith("3351-") \
-                and not field.data.startswith("3353-"):
-            return
-        raise ValidationError(lazy_gettext(
-            "This account is not for credit entries."))
-
-
-class CreditEntryForm(JournalEntryForm):
-    """The form to create or edit a credit journal entry."""
-    eid = IntegerField()
-    """The existing journal entry ID."""
-    no = IntegerField()
-    """The order in the currency."""
-    account_code = StringField(
-        filters=[strip_text],
-        validators=[DataRequired(MISSING_ACCOUNT),
-                    AccountExists(),
-                    IsCreditAccount()])
-    """The account code."""
-    summary = StringField(filters=[strip_text])
-    """The summary."""
-    amount = DecimalField(validators=[PositiveAmount()])
-    """The amount."""
-
-    def populate_obj(self, obj: JournalEntry) -> None:
-        """Populates the form data into a journal entry object.
-
-        :param obj: The journal entry object.
-        :return: None.
-        """
-        is_new: bool = obj.id is None
-        if is_new:
-            obj.id = new_id(JournalEntry)
-        obj.account_id = Account.find_by_code(self.account_code.data).id
-        obj.summary = self.summary.data
-        obj.is_debit = False
-        obj.amount = self.amount.data
-        if is_new:
-            current_user_pk: int = get_current_user_pk()
-            obj.created_by_id = current_user_pk
-            obj.updated_by_id = current_user_pk
-
-
-class CurrencyForm(FlaskForm):
-    """The form to create or edit a currency in a transaction."""
-    no = IntegerField()
-    """The order in the transaction."""
-    code = StringField()
-    """The currency code."""
-    whole_form = BooleanField()
-    """The pseudo field for the whole form validators."""
+                    "Journal entries with offset cannot be deleted."))
 
 
 class TransactionForm(FlaskForm):
@@ -302,8 +127,19 @@ class TransactionForm(FlaskForm):
         """The journal entry collector.  The default is the base abstract
         collector only to provide the correct type.  The subclass forms should
         provide their own collectors."""
-        self.__in_use_account_id: set[int] | None = None
-        """The ID of the accounts that are in use."""
+        self.obj: Transaction | None = kwargs.get("obj")
+        """The transaction, when editing an existing one."""
+        self._is_need_payable: bool = False
+        """Whether we need the payable original entries."""
+        self._is_need_receivable: bool = False
+        """Whether we need the receivable original entries."""
+        self.__original_entry_options: list[JournalEntry] | None = None
+        """The options of the original entries."""
+        self.__net_balance_exceeded: dict[int, LazyString] | None = None
+        """The original entries whose net balances were exceeded by the
+        amounts in the journal entry sub-forms."""
+        for entry in self.entries:
+            entry.txn_form = self
 
     def populate_obj(self, obj: Transaction) -> None:
         """Populates the form data into a transaction object.
@@ -314,6 +150,7 @@ class TransactionForm(FlaskForm):
         is_new: bool = obj.id is None
         if is_new:
             obj.id = new_id(Transaction)
+        self.date: DateField
         self.__set_date(obj, self.date.data)
         obj.note = self.note.data
 
@@ -335,8 +172,18 @@ class TransactionForm(FlaskForm):
             obj.created_by_id = current_user_pk
             obj.updated_by_id = current_user_pk
 
-    @staticmethod
-    def __set_date(obj: Transaction, new_date: date) -> None:
+    @property
+    def entries(self) -> list[JournalEntryForm]:
+        """Collects and returns the journal entry sub-forms.
+
+        :return: The journal entry sub-forms.
+        """
+        entries: list[JournalEntryForm] = []
+        for currency in self.currencies:
+            entries.extend(currency.entries)
+        return entries
+
+    def __set_date(self, obj: Transaction, new_date: dt.date) -> None:
         """Sets the transaction date and number.
 
         :param obj: The transaction object.
@@ -346,6 +193,18 @@ class TransactionForm(FlaskForm):
         if obj.date is None or obj.date != new_date:
             if obj.date is not None:
                 sort_transactions_in(obj.date, obj.id)
+            if self.max_date is not None and new_date == self.max_date:
+                db_min_no: int | None = db.session.scalar(
+                    sa.select(sa.func.min(Transaction.no))
+                    .filter(Transaction.date == new_date))
+                if db_min_no is None:
+                    obj.date = new_date
+                    obj.no = 1
+                else:
+                    obj.date = new_date
+                    obj.no = db_min_no - 1
+                    sort_transactions_in(new_date)
+            else:
                 sort_transactions_in(new_date, obj.id)
                 count: int = Transaction.query\
                     .filter(Transaction.date == new_date).count()
@@ -359,7 +218,8 @@ class TransactionForm(FlaskForm):
         :return: The selectable debit accounts.
         """
         accounts: list[AccountOption] \
-            = [AccountOption(x) for x in Account.debit()]
+            = [AccountOption(x) for x in Account.debit()
+               if not (x.code[0] == "2" and x.is_need_offset)]
         in_use: set[int] = set(db.session.scalars(
             sa.select(JournalEntry.account_id)
             .filter(JournalEntry.is_debit)
@@ -375,7 +235,8 @@ class TransactionForm(FlaskForm):
         :return: The selectable credit accounts.
         """
         accounts: list[AccountOption] \
-            = [AccountOption(x) for x in Account.credit()]
+            = [AccountOption(x) for x in Account.credit()
+               if not (x.code[0] == "1" and x.is_need_offset)]
         in_use: set[int] = set(db.session.scalars(
             sa.select(JournalEntry.account_id)
             .filter(sa.not_(JournalEntry.is_debit))
@@ -401,6 +262,46 @@ class TransactionForm(FlaskForm):
         """
         return SummaryEditor()
 
+    @property
+    def original_entry_options(self) -> list[JournalEntry]:
+        """Returns the selectable original entries.
+
+        :return: The selectable original entries.
+        """
+        if self.__original_entry_options is None:
+            self.__original_entry_options = get_selectable_original_entries(
+                {x.eid.data for x in self.entries if x.eid.data is not None},
+                self._is_need_payable, self._is_need_receivable)
+        return self.__original_entry_options
+
+    @property
+    def min_date(self) -> dt.date | None:
+        """Returns the minimal available date.
+
+        :return: The minimal available date.
+        """
+        original_entry_id: set[int] \
+            = {x.original_entry_id.data for x in self.entries
+               if x.original_entry_id.data is not None}
+        if len(original_entry_id) == 0:
+            return None
+        select: sa.Select = sa.select(sa.func.max(Transaction.date))\
+            .join(JournalEntry).filter(JournalEntry.id.in_(original_entry_id))
+        return db.session.scalar(select)
+
+    @property
+    def max_date(self) -> dt.date | None:
+        """Returns the maximum available date.
+
+        :return: The maximum available date.
+        """
+        entry_id: set[int] = {x.eid.data for x in self.entries
+                              if x.eid.data is not None}
+        select: sa.Select = sa.select(sa.func.min(Transaction.date))\
+            .join(JournalEntry)\
+            .filter(JournalEntry.original_entry_id.in_(entry_id))
+        return db.session.scalar(select)
+
 
 T = t.TypeVar("T", bound=TransactionForm)
 """A transaction form variant."""
@@ -540,53 +441,25 @@ class JournalEntryCollector(t.Generic[T], ABC):
                                   ord_by_form.get(x)))
 
 
-class IncomeCurrencyForm(CurrencyForm):
-    """The form to create or edit a currency in a cash income transaction."""
-    no = IntegerField()
-    """The order in the transaction."""
-    code = StringField(
-        filters=[strip_text],
-        validators=[DataRequired(MISSING_CURRENCY),
-                    CurrencyExists()])
-    """The currency code."""
-    credit = FieldList(FormField(CreditEntryForm),
-                       validators=[NeedSomeJournalEntries()])
-    """The credit entries."""
-    whole_form = BooleanField()
-    """The pseudo field for the whole form validators."""
-
-    @property
-    def credit_total(self) -> Decimal:
-        """Returns the total amount of the credit journal entries.
-
-        :return: The total amount of the credit journal entries.
-        """
-        return sum([x.amount.data for x in self.credit
-                    if x.amount.data is not None])
-
-    @property
-    def credit_errors(self) -> list[str | LazyString]:
-        """Returns the credit journal entry errors, without the errors in their
-        sub-forms.
-
-        :return:
-        """
-        return [x for x in self.credit.errors
-                if isinstance(x, str) or isinstance(x, LazyString)]
-
-
 class IncomeTransactionForm(TransactionForm):
     """The form to create or edit a cash income transaction."""
-    date = DateField(validators=[DATE_REQUIRED])
+    date = DateField(
+        validators=[DATE_REQUIRED,
+                    NotBeforeOriginalEntries(),
+                    NotAfterOffsetEntries()])
     """The date."""
     currencies = FieldList(FormField(IncomeCurrencyForm), name="currency",
                            validators=[NeedSomeCurrencies()])
     """The journal entries categorized by their currencies."""
     note = TextAreaField(filters=[strip_multiline_text])
     """The note."""
+    whole_form = BooleanField(
+        validators=[CannotDeleteOriginalEntriesWithOffset()])
+    """The pseudo field for the whole form validators."""
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
+        self._is_need_receivable = True
 
         class Collector(JournalEntryCollector[IncomeTransactionForm]):
             """The journal entry collector for the cash income transactions."""
@@ -613,53 +486,25 @@ class IncomeTransactionForm(TransactionForm):
         self.collector = Collector
 
 
-class ExpenseCurrencyForm(CurrencyForm):
-    """The form to create or edit a currency in a cash expense transaction."""
-    no = IntegerField()
-    """The order in the transaction."""
-    code = StringField(
-        filters=[strip_text],
-        validators=[DataRequired(MISSING_CURRENCY),
-                    CurrencyExists()])
-    """The currency code."""
-    debit = FieldList(FormField(DebitEntryForm),
-                      validators=[NeedSomeJournalEntries()])
-    """The debit entries."""
-    whole_form = BooleanField()
-    """The pseudo field for the whole form validators."""
-
-    @property
-    def debit_total(self) -> Decimal:
-        """Returns the total amount of the debit journal entries.
-
-        :return: The total amount of the debit journal entries.
-        """
-        return sum([x.amount.data for x in self.debit
-                    if x.amount.data is not None])
-
-    @property
-    def debit_errors(self) -> list[str | LazyString]:
-        """Returns the debit journal entry errors, without the errors in their
-        sub-forms.
-
-        :return:
-        """
-        return [x for x in self.debit.errors
-                if isinstance(x, str) or isinstance(x, LazyString)]
-
-
 class ExpenseTransactionForm(TransactionForm):
     """The form to create or edit a cash expense transaction."""
-    date = DateField(validators=[DATE_REQUIRED])
+    date = DateField(
+        validators=[DATE_REQUIRED,
+                    NotBeforeOriginalEntries(),
+                    NotAfterOffsetEntries()])
     """The date."""
     currencies = FieldList(FormField(ExpenseCurrencyForm), name="currency",
                            validators=[NeedSomeCurrencies()])
     """The journal entries categorized by their currencies."""
     note = TextAreaField(filters=[strip_multiline_text])
     """The note."""
+    whole_form = BooleanField(
+        validators=[CannotDeleteOriginalEntriesWithOffset()])
+    """The pseudo field for the whole form validators."""
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
+        self._is_need_payable = True
 
         class Collector(JournalEntryCollector[ExpenseTransactionForm]):
             """The journal entry collector for the cash expense
@@ -687,88 +532,26 @@ class ExpenseTransactionForm(TransactionForm):
         self.collector = Collector
 
 
-class TransferCurrencyForm(CurrencyForm):
-    """The form to create or edit a currency in a transfer transaction."""
-
-    class IsBalanced:
-        """The validator to check that the total amount of the debit and credit
-        entries are equal."""
-        def __call__(self, form: TransferCurrencyForm, field: BooleanField)\
-                -> None:
-            if len(form.debit) == 0 or len(form.credit) == 0:
-                return
-            if form.debit_total != form.credit_total:
-                raise ValidationError(lazy_gettext(
-                    "The totals of the debit and credit amounts do not"
-                    " match."))
-
-    no = IntegerField()
-    """The order in the transaction."""
-    code = StringField(
-        filters=[strip_text],
-        validators=[DataRequired(MISSING_CURRENCY),
-                    CurrencyExists()])
-    """The currency code."""
-    debit = FieldList(FormField(DebitEntryForm),
-                      validators=[NeedSomeJournalEntries()])
-    """The debit entries."""
-    credit = FieldList(FormField(CreditEntryForm),
-                       validators=[NeedSomeJournalEntries()])
-    """The credit entries."""
-    whole_form = BooleanField(validators=[IsBalanced()])
-    """The pseudo field for the whole form validators."""
-
-    @property
-    def debit_total(self) -> Decimal:
-        """Returns the total amount of the debit journal entries.
-
-        :return: The total amount of the debit journal entries.
-        """
-        return sum([x.amount.data for x in self.debit
-                    if x.amount.data is not None])
-
-    @property
-    def credit_total(self) -> Decimal:
-        """Returns the total amount of the credit journal entries.
-
-        :return: The total amount of the credit journal entries.
-        """
-        return sum([x.amount.data for x in self.credit
-                    if x.amount.data is not None])
-
-    @property
-    def debit_errors(self) -> list[str | LazyString]:
-        """Returns the debit journal entry errors, without the errors in their
-        sub-forms.
-
-        :return:
-        """
-        return [x for x in self.debit.errors
-                if isinstance(x, str) or isinstance(x, LazyString)]
-
-    @property
-    def credit_errors(self) -> list[str | LazyString]:
-        """Returns the credit journal entry errors, without the errors in their
-        sub-forms.
-
-        :return:
-        """
-        return [x for x in self.credit.errors
-                if isinstance(x, str) or isinstance(x, LazyString)]
-
-
 class TransferTransactionForm(TransactionForm):
     """The form to create or edit a transfer transaction."""
-    date = DateField(validators=[DATE_REQUIRED])
+    date = DateField(
+        validators=[DATE_REQUIRED,
+                    NotBeforeOriginalEntries(),
+                    NotAfterOffsetEntries()])
     """The date."""
     currencies = FieldList(FormField(TransferCurrencyForm), name="currency",
                            validators=[NeedSomeCurrencies()])
     """The journal entries categorized by their currencies."""
     note = TextAreaField(filters=[strip_multiline_text])
     """The note."""
+    whole_form = BooleanField(
+        validators=[CannotDeleteOriginalEntriesWithOffset()])
+    """The pseudo field for the whole form validators."""
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
+        self._is_need_payable = True
+        self._is_need_receivable = True
 
         class Collector(JournalEntryCollector[TransferTransactionForm]):
             """The journal entry collector for the transfer transactions."""
@@ -797,67 +580,3 @@ class TransferTransactionForm(TransactionForm):
                         self._credit_no = self._credit_no + 1
 
         self.collector = Collector
-
-
-def sort_transactions_in(txn_date: date, exclude: int) -> None:
-    """Sorts the transactions under a date after changing the date or deleting
-    a transaction.
-
-    :param txn_date: The date of the transaction.
-    :param exclude: The transaction ID to exclude.
-    :return: None.
-    """
-    transactions: list[Transaction] = Transaction.query\
-        .filter(Transaction.date == txn_date,
-                Transaction.id != exclude)\
-        .order_by(Transaction.no).all()
-    for i in range(len(transactions)):
-        if transactions[i].no != i + 1:
-            transactions[i].no = i + 1
-
-
-class TransactionReorderForm:
-    """The form to reorder the transactions."""
-
-    def __init__(self, txn_date: date):
-        """Constructs the form to reorder the transactions in a day.
-
-        :param txn_date: The date.
-        """
-        self.date: date = txn_date
-        self.is_modified: bool = False
-
-    def save_order(self) -> None:
-        """Saves the order of the account.
-
-        :return:
-        """
-        transactions: list[Transaction] = Transaction.query\
-            .filter(Transaction.date == self.date).all()
-
-        # Collects the specified order.
-        orders: dict[Transaction, int] = {}
-        for txn in transactions:
-            if f"{txn.id}-no" in request.form:
-                try:
-                    orders[txn] = int(request.form[f"{txn.id}-no"])
-                except ValueError:
-                    pass
-
-        # Missing and invalid orders are appended to the end.
-        missing: list[Transaction] \
-            = [x for x in transactions if x not in orders]
-        if len(missing) > 0:
-            next_no: int = 1 if len(orders) == 0 else max(orders.values()) + 1
-            for txn in missing:
-                orders[txn] = next_no
-
-        # Sort by the specified order first, and their original order.
-        transactions.sort(key=lambda x: (orders[x], x.no))
-
-        # Update the orders.
-        with db.session.no_autoflush:
-            for i in range(len(transactions)):
-                if transactions[i].no != i + 1:
-                    transactions[i].no = i + 1
-                    self.is_modified = True

src/accounting/transaction/utils/__init__.py

@@ -0,0 +1,19 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/10
+
+#  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 utilities for the transaction management.
+
+"""

src/accounting/transaction/utils/account_option.py

@@ -0,0 +1,49 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/10
+
+#  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 account option for the transaction management.
+
+"""
+from accounting.models import Account
+
+
+class AccountOption:
+    """An account option."""
+
+    def __init__(self, account: Account):
+        """Constructs an account option.
+
+        :param account: The account.
+        """
+        self.id: str = account.id
+        """The account ID."""
+        self.code: str = account.code
+        """The account code."""
+        self.query_values: list[str] = account.query_values
+        """The values to be queried."""
+        self.__str: str = str(account)
+        """The string representation of the account option."""
+        self.is_in_use: bool = False
+        """True if this account is in use, or False otherwise."""
+        self.is_need_offset: bool = account.is_need_offset
+        """True if this account needs offset, or False otherwise."""
+
+    def __str__(self) -> str:
+        """Returns the string representation of the account option.
+
+        :return: The string representation of the account option.
+        """
+        return self.__str

src/accounting/transaction/utils/offset_alias.py

@@ -0,0 +1,39 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/15
+
+#  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 SQLAlchemy alias for the offset entries.
+
+"""
+import typing as t
+
+import sqlalchemy as sa
+
+from accounting.models import JournalEntry
+
+
+def offset_alias() -> sa.Alias:
+    """Returns the SQLAlchemy alias for the offset entries.
+
+    :return: The SQLAlchemy alias for the offset entries.
+    """
+
+    def as_from(model_cls: t.Any) -> sa.FromClause:
+        return model_cls
+
+    def as_alias(alias: t.Any) -> sa.Alias:
+        return alias
+
+    return as_alias(sa.alias(as_from(JournalEntry), name="offset"))

src/accounting/transaction/utils/operators.py

@@ -26,8 +26,8 @@ from flask_wtf import FlaskForm
 from accounting.models import Transaction
 from accounting.template_globals import default_currency_code
 from accounting.utils.txn_types import TransactionType
-from .forms import TransactionForm, IncomeTransactionForm, \
-    ExpenseTransactionForm, TransferTransactionForm
+from accounting.transaction.forms import TransactionForm, \
+    IncomeTransactionForm, ExpenseTransactionForm, TransferTransactionForm
 
 
 class TransactionOperator(ABC):
@@ -304,15 +304,17 @@ TXN_TYPE_TO_OP: dict[TransactionType, TransactionOperator] \
 """The map from the transaction types to their operators."""
 
 
-def get_txn_op(txn: Transaction) -> TransactionOperator:
+def get_txn_op(txn: Transaction, is_check_as: bool = False) \
+        -> TransactionOperator:
     """Returns the transaction operator that may be specified in the "as" query
     parameter.  If it is not specified, check the transaction type from the
     transaction.
 
     :param txn: The transaction.
+    :param is_check_as: True to check the "as" parameter, or False otherwise.
     :return: None.
     """
-    if "as" in request.args:
+    if is_check_as and "as" in request.args:
         type_dict: dict[str, TransactionType] \
             = {x.value: x for x in TransactionType}
         if request.args["as"] not in type_dict:

src/accounting/transaction/utils/original_entries.py

@@ -0,0 +1,82 @@
+# The Mia! Accounting Flask Project.
+# Author: imacat@mail.imacat.idv.tw (imacat), 2023/3/10
+
+#  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 selectable original entries.
+
+"""
+from decimal import Decimal
+
+import sqlalchemy as sa
+from flask_babel import LazyString
+from sqlalchemy.orm import selectinload
+
+from accounting import db
+from accounting.locale import lazy_gettext
+from accounting.models import Account, Transaction, JournalEntry
+from accounting.transaction.forms.journal_entry import JournalEntryForm
+from accounting.utils.cast import be
+from .offset_alias import offset_alias
+
+
+def get_selectable_original_entries(
+        entry_id_on_form: set[int], is_payable: bool, is_receivable: bool) \
+        -> list[JournalEntry]:
+    """Queries and returns the selectable original entries, with their net
+    balances.  The offset amounts of the form is excluded.
+
+    :param entry_id_on_form: The ID of the journal entries on the form.
+    :param is_payable: True to check the payable original entries, or False
+        otherwise.
+    :param is_receivable: True to check the receivable original entries, or
+        False otherwise.
+    :return: The selectable original entries, with their net balances.
+    """
+    assert is_payable or is_receivable
+    offset: sa.Alias = offset_alias()
+    net_balance: sa.Label = (JournalEntry.amount + sa.func.sum(sa.case(
+        (offset.c.id.in_(entry_id_on_form), 0),
+        (be(offset.c.is_debit == JournalEntry.is_debit), offset.c.amount),
+        else_=-offset.c.amount))).label("net_balance")
+    conditions: list[sa.BinaryExpression] = [Account.is_need_offset]
+    sub_conditions: list[sa.BinaryExpression] = []
+    if is_payable:
+        sub_conditions.append(sa.and_(Account.base_code.startswith("2"),
+                                      sa.not_(JournalEntry.is_debit)))
+    if is_receivable:
+        sub_conditions.append(sa.and_(Account.base_code.startswith("1"),
+                                      JournalEntry.is_debit))
+    conditions.append(sa.or_(*sub_conditions))
+    select_net_balances: sa.Select = sa.select(JournalEntry.id, net_balance)\
+        .join(Account)\
+        .join(offset, be(JournalEntry.id == offset.c.original_entry_id),
+              isouter=True)\
+        .filter(*conditions)\
+        .group_by(JournalEntry.id)\
+        .having(sa.or_(sa.func.count(offset.c.id) == 0, net_balance != 0))
+    net_balances: dict[int, Decimal] \
+        = {x.id: x.net_balance
+           for x in db.session.execute(select_net_balances).all()}
+    entries: list[JournalEntry] = JournalEntry.query\
+        .filter(JournalEntry.id.in_({x for x in net_balances}))\
+        .join(Transaction)\
+        .order_by(Transaction.date, JournalEntry.is_debit, JournalEntry.no)\
+        .options(selectinload(JournalEntry.currency),
+                 selectinload(JournalEntry.account),
+                 selectinload(JournalEntry.transaction)).all()
+    for entry in entries:
+        entry.net_balance = entry.amount if net_balances[entry.id] is None \
+            else net_balances[entry.id]
+    return entries