endi-payment 2.5.1

模块激活

公共API可以通过enDI中的.ini配置文件进行配置。

请确保endi_payment库已正确包含在endi.includes中

endi.includes = ...
                   ...
                   endi_payment

配置endi.interfaces.IPaymentRecordService服务

endi.interfaces.IPaymentRecordService = endi_payment.public.PaymentService

配置endi_payment的日志。有关详细信息，请参阅Python logging模块的文档：https://docs.pythonlang.cn/2/library/logging.html 以及development.ini.sample文件中的示例。

配置要使用的endi_payment.interfaces.IPaymentRecordHistoryService日志服务。

endi_payment提供两种日志服务

HistoryLogService：默认服务，用于开发模式，仅记录操作而不记录详细信息。

HistoryDBService：将执行的操作记录在特定的数据库中（不一定在同一个mysql服务器上）

HistoryDBService

要在特定数据库中启用详细日志记录，请将以下行添加到.ini文件的[app:endi]部分：

endi_payment.interfaces.IPaymentRecordHistoryService = endi_payment.history.endi_payment.history.HistoryDBService

创建一个新的数据库，您可以使用endi仓库中提供的工具./tools/add_payment_database.sh。

cd endi/
./tools/add_payment_database.sh
# Suivez les instructions

然后，在.ini文件的[app:endi]部分输入新数据库的连接信息。

endi_payment_db.url = mysql://endi_payment:endi_payment@localhost/endi_payment?charset=utf8

归档

为了确保对收款的操作历史有记录，endi_payment允许使用归档服务。

本地版本，请将以下行添加到endi服务的.ini配置文件中的[app:endi]部分：

endi_payment.interfaces.IPaymentArchiveService=endi_payment.archive.FileArchiveService
endi_payment_archive_storage_path=<chemin sur disque pour le stockage des journaux>

本地版本提供了可接受的收款日志认证解决方案。

为了获得更稳定的解决方案，我们建议使用由第三方认证的远程服务。

完整的配置应包含以下信息：

endi.includes =
            ....
            endi_payment

# Accès à la bdd de traitement des paiements
endi_payment_db.url = mysql://endi_payment:endi_payment@localhost/endi_payment?charset=utf8

# Le service qui sera utilisé depuis endi pour agir sur les encaissements
endi.interfaces.IPaymentRecordService = endi_payment.public.PaymentService

# Le service qui sera utilisé par endi_payment pour stocker l'historique des actions d'encaissement
endi_payment.interfaces.IPaymentRecordHistoryService = endi_payment.history.HistoryDBService

# Le service en charge de la génération d'une archive avec un peu de certification d'intégrité des journaux
endi_payment.interfaces.IPaymentArchiveService = endi_payment.archive.FileArchiveService

# Le chemin utilisé par le service d'archivage pour le stockage sur disque
endi_payment_archive_storage_path = /var/endi/files/treasury/payment_storage

查看日志

如果使用HistoryDBService服务，endi_payment将自动在enDI的会计菜单中添加一个条目，允许查看对收款所做的更改日志。