README

Leiebasen是一个在线管理程序，用于管理和租赁房屋。该程序主要面向合作社和较小的住房组织，旨在促进居民参与和管理透明度。

• 管理租赁协议和租赁对象，租金和其他与租赁关系相关的费用，付款等。
• 损害登记册记录损害和修复，并在房东和承租人之间传递更新。
• “我的页面”，承租人可以自行查看账单和欠款，报告损害等。
• 可以按照指定的分配密钥将三部分服务（如公共设施等）分配给居民。
• 发布申请表并处理收到的申请。
• 基于租赁对象、建筑物、地理位置或行政区域进行报告。

• 在住宅类型（如公寓、住宅区）方面具有灵活性，不同的租赁计算、合同模板等。

• 欢迎来自小型和大型面向居民的住房组织的反馈和建议。

使用

Leiebasen免费下载和使用，也可用作自定义程序的基础。该程序不附带任何保证；所有使用和进一步开发均由用户自行负责。然而，我会持续关注报告的错误，并努力尽快修复。

请参阅附带的GPL许可证以获取详细信息。

安装

Leiebasen可以安装在自建的Web服务器上。

服务器环境要求

• PHP版本7.4或更高
• 以下PHP扩展
  • ext-bcmath
  • ext-calendar
  • ext-curl
  • ext-fileinfo
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-mailparse
  • ext-mbstring
  • ext-mysqli
  • ext-simplexml
  • ext-zip
• MySQL或MariaDB数据库。您必须具有连接到数据库的用户名和密码。
• git
• composer

1. 从https://gitlab.com/kyegil/leiebasen下载源代码，并在您希望安装程序的服务器上解压缩。
2. 根据服务器环境设置config.php
   1. 在您安装源代码的位置找到config.sample.php。将其复制为config.php。
   2. 使用纯文本编辑器（例如Mac的TextEdit或Windows的Notepad）打开config.php。
   3. 在config.php中更改以下字段的值（保留引号）
      • 在'leiebasen' => 'db'下，您可以找到数据库设置'host'、'name'、'user'和'password'
      • 对于name，您应输入实际的数据库名称，而不是'leiebasen'。
      • 对于user，您应输入数据库的用户名（而不是'root'）。此用户必须具有数据库的所有权限。
      • 对于password，您应输入上述用户的密码（而不是'root'）。
      • host：如果数据库位于您安装文件的服务器之外的另一台服务器上，请在此处指定名称。否则，保留'localhost'。
      • prefix：如果数据库与其他程序共享，您应在此处指定一个前缀以区分表格。前缀应简短（2-4个字符，后面跟下划线。例如'lbs_'作为'leiebasen'的缩写）。
      • 在'leiebasen' => 'server'下，您应提供服务器和域名等信息
      • installation_url：指定安装的URL，例如https://leiebasen.min-org.no）。
      • root: 在服务器上提供完整文件路径，即您解压文件的目录（例如：'~/public_html/'）
      • file_storage: 提供一个外部不可公开区域的完整文件路径，在那里您可以安全地存储敏感文档（例如：'~/leiebasen_filer'）
      • 这是最重要的设置。有关其他设置的文档，请参阅配置参考文档。
      • 保存 config.php，并确保其文件权限设置为 0640。
   4. 更新子模块和依赖项。此步骤需要您在服务器上已安装 git 和 composer。使用 ssh 终端登录到服务器，然后导航到您安装租赁库的位置。
   5. 运行命令 git submodule update --init
   6. 运行命令 composer install
   7. 创建数据库内容。使用浏览器，访问安装地址（您在 config.php 中指定的 'installation_url'。如果您已完成了上述所有安装步骤，则数据库现在将安装。安装完成后，您将被重定向到管理员登录页面。

config.php 配置参考

config.php 设置的完整参考

• additional_configs: (数组) 可能的额外配置文件，这些文件将与此文件一起读取和合并。例如，可以使用这些文件来定义和启用插件。
• listeners: (数组) 可能的插件，用于在租赁库中插入以实现自定义功能。

• class_preferences: (对象) 可能覆盖租赁库中的类。例如，可以通过这种方式覆盖特定的视图

  "Kyegil\\Leiebasen\\Visning\\sentral\\html\\shared\\Html": "MinSpesialtilpasning\\Visning\\sentral\\html\\shared\\Html"
  

  覆盖的类必须是原始类的扩展。

• psr4_roots: (对象) 用于自动加载自定义类的 PSR4 根映射。例如，用于上述覆盖

  "MinSpesialtilpasning\\Visning": "~/min_plugin/code/Visning"
  

• leiebasen（属于租赁库的设置）
  • db:
    • host: 数据库的主机名
    • name: 数据库名
    • user: 数据库用户
    • password: 数据库用户的密码
    • port: 数据库端口，如果需要
    • driver: 数据库驱动程序。必须是 'mysqli'。
    • prefix: 数据库表的可能的表前缀
  • server:
    • installation_url: 安装的 URL
    • root: 服务器上安装的文件路径
    • file_storage: 数据/文档存储的文件路径
    • production: 设置为 TRUE 以将租赁库设置为生产模式
    • db_backup: SQL 格式数据库备份的文件路径。备份必须定期使用例如 mysqldump 通过 cron 创建，并存储在指定的位置。
    • template_folders: (数组) 视图文件文件夹的文件路径。将按提供的顺序搜索这些文件路径（优先级最高先），可以用于通过覆盖标准视图模板来自定义外观。
    • debug:
    • developer_email: 开发者的电子邮件，用于接收测试电子邮件和问题报告。
      • email_dev_copy: (数组) 开发者应该盲拷贝的电子邮件列表
  • session:
    • name: 保存登录会话的 cookies 的名称
    • timeout: 不活跃用户保持登录的时间（秒）
  • config:
    • default_url: 成功登录后发送到的默认地址，如果没有指定特定地址。
    • post_logout_url: 从租赁库注销后发送到的地址。
    • extjs_version: 安装的 ExtJs 版本（文件夹名称必须与版本号匹配，并放置在 pub/lib/ 中）。
  • google:
    • recaptcha3:
      • site_key: 如果使用 recaptcha，则提供 recaptcha3 Site Key。
      • secret_key: 如果使用 recaptcha，则提供 recaptcha3 Secret Key。
  • logger:
    • level: PSR 日志级别。通常为 'Informational' 日志的 200。更改为 100 以进行调试。
  • nets（Nets OCR、AvtaleGiro 和 eFaktura 的设置）
    • avtale_id: 与 NETS 的协议 ID。
    • kundeenhet_id: 客户单位 ID。
    • host: NETS 服务器的 IP 地址或主机名。
    • port: NETS 服务器的端口号。
    • rsa_key：用于SFTP连接Nets的RSA密钥的Filbane。
    • key_pw：RSA密钥的密码。
    • 用户:
      • ocr：用于OCR/AvtaleGiro登录的用户名。
      • einvoice：用于eFaktura登录的用户名。