5分钟上手Monica：从安装到创建第一个联系人的极速指南
项目地址: https://gitcode.com/gh_mirrors/mo/monica 你是否曾忘记重要朋友的生日？或者在偶遇熟人时想不起对方的职业信息？Monica作为一款开源的个人关系管理系统（PRM），能帮你轻松记录和管理联系人的关键信息。本文将带你在5分钟内完成从安装到创建第一个联系人的全过程，让你从此告别记忆困扰。
关于Monica
Monica是一款开源的联系人管理工具（PRM - Personal Relationship Management），可以帮助你记录联系人信息、重要日期、互动历史等。它不是社交网络，而是你的私人关系数据库，所有数据完全由你掌控。
主要功能包括：
- 管理联系人基本信息和关系图谱
- 设置生日、纪念日等重要日期提醒
- 记录通话、见面等互动历史
- 添加笔记、照片和文档
- 支持多用户和多个数据 vault
- 27种语言界面，包括中文
官方文档：README.md
安装准备
Monica提供多种安装方式，这里我们使用Docker Compose进行快速部署，适合新手用户。
环境要求
- Docker 和 Docker Compose
- 至少1GB内存
- 网络连接（用于拉取镜像）
获取项目代码
git clone https://gitcode.com/gh_mirrors/mo/monica
cd monica
快速启动Monica
- 复制环境变量示例文件并修改必要配置：
cp .env.example .env
- 使用Docker Compose启动服务：
docker-compose up -d
这个命令会启动多个服务容器，包括：
- Web应用服务 (docker-compose.yml)
- MariaDB数据库
- Redis缓存
- Meilisearch搜索引擎
- Mailpit邮件服务
- 初始化数据库：
docker-compose exec laravel.test php artisan migrate
docker-compose exec laravel.test php artisan db:seed
- 创建管理员账户：
docker-compose exec laravel.test php artisan make:user
按照提示输入邮箱和密码，完成管理员账户创建。
- 访问Monica
在浏览器中打开 http://localhost，使用刚才创建的账户登录，你将看到Monica的仪表盘界面：
创建第一个联系人
进入联系人管理页面
登录后，点击左侧导航栏中的"联系人"选项，或直接访问 /contacts 页面。
添加新联系人
- 点击右上角的"添加联系人"按钮
- 填写基本信息：
- 姓名（必填）
- 性别
- 生日
- 联系方式（电话、邮箱等）
-
添加关系信息 在"关系"标签页中，可以设置该联系人与你的关系，如"朋友"、"家人"、"同事"等。
-
设置重要日期 在"重要日期"标签页中，添加生日、纪念日等，并设置是否需要提醒。
-
保存联系人 点击页面底部的"保存"按钮，完成联系人创建。
联系人管理功能
创建联系人后，你可以：
- 添加笔记和文档 (app/Models/Note.php)
- 记录互动历史（通话、见面等）
- 上传照片 (public/img/contact_blank_photo.svg)
- 设置任务提醒 (app/Models/ContactTask.php)
个性化设置
更改界面语言
- 点击右上角头像，选择"设置"
- 在"偏好设置"中，找到"语言"选项
- 选择"简体中文"，保存设置
Monica支持多种语言，语言文件位于 lang/ 目录。
配置提醒
Monica可以通过邮件发送生日、纪念日等提醒，配置方法：
- 在.env文件中设置邮件服务器信息
- 在设置页面启用所需的提醒类型
- 调整提醒提前时间
邮件服务配置：config/mail.php
总结与后续学习
恭喜！你已成功安装并开始使用Monica管理联系人。在短短几分钟内，我们完成了：
- 安装部署Monica服务
- 创建管理员账户
- 添加第一个联系人
- 了解基本功能布局
进阶学习资源：
- 数据导入导出功能：app/Models/Contact.php
- API开发文档：config/api.php
- 自定义字段设置：app/Models/ModuleRowField.php
Monica是一个活跃开发的开源项目，你可以通过贡献指南参与到项目开发中，或在遇到问题时查阅官方文档。
希望Monica能帮助你维护更好的人际关系！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
