Condo物业酒店管理

第一步：环境准备

你需要一台 Linux 服务器（Ubuntu 22.04/24.04 推荐），安装以下工具：

• Node.js 16.x：Condo 严格要求 Node 16，不能用更高版本。推荐用 nvm 管理版本。
• Python 3.x：用于数据库迁移脚本。
• PostgreSQL 16.4 和 Redis 6.2：数据库和缓存。
• Yarn：Node.js 包管理器。

安装 Node 16 的方法（用 nvm）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 16
nvm use 16
node -v  # 应该显示 v16.x

第二步：克隆项目并安装依赖

git clone https://github.com/open-condo-software/condo.git
cd condo
yarn install

如果提示 turbo: command not found，全局安装 turbo：

npm i -g turbo@^2

安装 Python 依赖：

pip install Django psycopg2-binary

第三步：启动数据库

Condo 提供了 Docker Compose 配置，直接启动 PostgreSQL 和 Redis：

docker compose up -d postgresdb redis

如果你没有 Docker，也可以手动安装 PostgreSQL 16 和 Redis 6.2，并创建对应数据库。

第四步：构建内部依赖并准备环境

Condo 是 monorepo 结构，需要先构建内部包：

yarn workspace @app/condo build:deps

然后运行准备脚本，它会自动创建 .env 文件、初始化数据库、生成测试管理员账号：

node bin/prepare -f condo

这一步完成后，apps/condo/.env 文件中会包含测试登录凭据（DEFAULT_TEST_ADMIN_IDENTITY 和 DEFAULT_TEST_ADMIN_SECRET）。

第五步：启动应用

开发模式：

yarn workspace @app/condo dev

生产模式：

yarn workspace @app/condo build
yarn workspace @app/condo start

应用默认运行在 http://localhost:4006。浏览器打开后，使用准备脚本生成的测试账号登录（入口是 /admin/signin）。

第六步：启动 Worker 进程

Condo 的异步任务（发送通知、导入导出等）由独立的 Worker 进程处理，需要单独启动：

yarn workspace @app/condo worker

第七步：生产环境注意事项

上面的流程适合本地开发和测试。正式部署时：

• 修改 .env 中的数据库密码和密钥，不要用默认值。
• 用 Nginx 反向代理并配置 HTTPS。
• 将 yarn workspace @app/condo build 的产物部署到服务器，用 PM2 或 systemd 管理进程。
• 定期备份 PostgreSQL 数据库。