Genealogy 项目使用教程

1. 项目介绍

Genealogy 是一个免费且开源的家族树 PHP 应用程序，用于记录家庭成员及其关系。该项目基于 Laravel 11 构建，旨在帮助用户轻松创建和管理家族树。Genealogy 支持多语言、多时区、多租户等功能，并提供了丰富的用户权限管理和安全特性。

2. 项目快速启动

2.1 环境要求

• PHP 8.3 或更高版本
• MySQL 8.0.1 或 MariaDB 10.2.2 或等效数据库
• Node.js 和 npm

2.2 安装步骤

1. 克隆项目

   git clone https://github.com/MGeurts/genealogy.git
   cd genealogy
   

2. 配置环境文件

   cp .env.example .env
   

   编辑 .env 文件，配置数据库连接和其他必要设置。

3. 安装依赖

   composer install
   npm install
   

4. 生成应用密钥

   php artisan key:generate
   

5. 创建存储链接

   php artisan storage:link
   

6. 运行数据库迁移和种子

   php artisan migrate:fresh --seed
   

7. 构建前端资源

   npm run build
   

8. 启动开发服务器

   php artisan serve
   

   或者使用 Vite 进行开发：

   npm run dev
   

2.3 测试

php artisan test

3. 应用案例和最佳实践

3.1 应用案例

Genealogy 项目提供了一个在线的家族树管理平台，用户可以通过该平台记录和管理家族成员的信息。例如，用户可以创建多个家族树，每个家族树可以包含多个家庭成员及其关系。Genealogy 还支持多语言和多时区，方便全球用户使用。

3.2 最佳实践

• 数据备份：定期备份数据库，以防数据丢失。
• 用户权限管理：根据用户角色分配不同的权限，确保数据安全。
• 多语言支持：根据用户需求，添加更多语言支持。

4. 典型生态项目

4.1 Laravel

Laravel 是一个流行的 PHP 框架，提供了丰富的功能和工具，帮助开发者快速构建现代 Web 应用程序。Genealogy 项目基于 Laravel 11 构建，充分利用了 Laravel 的强大功能。

4.2 Livewire

Livewire 是一个用于 Laravel 的全栈框架，允许开发者使用 PHP 编写动态前端组件。Genealogy 项目使用了 Livewire 3，提供了更好的用户体验。

4.3 Tailwind CSS

Tailwind CSS 是一个实用优先的 CSS 框架，提供了丰富的工具类，帮助开发者快速构建现代化的用户界面。Genealogy 项目使用了 Tailwind CSS，确保了应用的响应式设计和美观性。

4.4 Alpine.js

Alpine.js 是一个轻量级的 JavaScript 框架，提供了类似 Vue.js 的响应式编程体验。Genealogy 项目使用了 Alpine.js 3，增强了前端交互性。

通过以上模块的介绍，您可以快速了解并启动 Genealogy 项目，并了解其典型生态项目和最佳实践。