morelitea/initiative

Initiative - 现代项目管理应用

一个基于FastAPI和React构建的全栈项目管理应用，具备基于公会的多租户隔离、实时更新和灵活的任务组织功能。

核心功能与特性

• 多租户支持：基于公会的组织架构，实现团队隔离
• 灵活项目结构：包含计划、项目、任务，并支持自定义状态
• 富文档编辑：带Markdown支持的Lexical编辑器
• 任务管理：看板、任务依赖、重复任务、检查清单
• 实时更新：基于WebSocket的实时协作功能
• 身份验证：内置认证系统，可选OIDC/SSO支持
• 活动跟踪：全面的审计日志和活动动态
• 深色模式：完整的主题自定义
• 移动响应式：适配所有设备

使用场景与适用范围

适用于需要协作管理项目的团队，包括软件开发、市场营销、产品管理等领域。特别适合需要隔离不同团队数据、实时协作以及灵活任务跟踪的组织。

快速开始

bash
# 创建docker-compose.yml文件
cat > docker-compose.yml << 'EOF'
services:
  db:
    image: postgres:17
    container_name: initiative-db
    restart: unless-stopped
    environment:
      POSTGRES_USER: initiative
      POSTGRES_PASSWORD: initiative
      POSTGRES_DB: initiative
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U initiative"]
      interval: 5s
      timeout: 5s
      retries: 5

  initiative:
    image: morelitea/initiative:latest
    container_name: initiative
    restart: unless-stopped
    volumes:
      - ./uploads:/app/uploads
    environment:
      DATABASE_URL: postgresql+asyncpg://initiative:initiative@db:5432/initiative
      SECRET_KEY: change-this-to-a-random-secret-key
      ACCESS_TOKEN_EXPIRE_MINUTES: 10080
      APP_URL: http://localhost:8173
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8173:8173"

volumes:
  postgres_data:
    driver: local
EOF

# 启动应用
docker-compose up -d

# 查看日志
docker-compose logs -f initiative

然后在浏览器中打开 http://localhost:8173。

配置说明

必填环境变量

• DATABASE_URL - PostgreSQL连接字符串
• SECRET_KEY - JWT令牌的密钥（生产环境中必须更改！）
• APP_URL - 应用的基础URL

可选环境变量

• ACCESS_TOKEN_EXPIRE_MINUTES - JWT令牌过期时间（默认：*** = 7天）
• FIRST_SUPERUSER_EMAIL - 初始超级用户的***
• FIRST_SUPERUSER_PASSWORD - 初始超级用户的密码
• OIDC_ENABLED - 启用OIDC认证（true/false）
• OIDC_DISCOVERY_URL - OIDC发现端点URL
• OIDC_CLIENT_ID - OIDC客户端ID
• OIDC_CLIENT_SECRET - OIDC客户端密钥
• OIDC_PROVIDER_NAME - OIDC提供者的显示名称
• OIDC_SCOPES - OIDC作用域（默认：openid,profile,email）
• DISABLE_GUILD_CREATION - 禁用新公会创建（true/false）

可用标签

• latest - 最新发布版本
• 0.1, 0.1.2 - 特定版本
• 0 - 最新的0.x主版本

数据卷

• /app/uploads - 用户上传文件（附件、头像）
• /app/static - 前端资源（内置，无需挂载）

端口

• 8173 - 主应用端口（同时提供API和前端服务）

架构

这是一个单容器应用，包含：

• /api/v1 路径下的FastAPI后端
• / 路径下的React前端（SPA）
• 启动时自动执行数据库迁移

前端已预构建并由后端提供服务，简化部署流程。

多架构支持

支持以下架构：

• linux/amd64 (x86_64)
• linux/arm64 (ARM，Apple Silicon)

健康检查

应用提供健康检查端点：

• /api/v1/docs - API文档
• /api/v1/version - 当前版本

生产环境部署

重要安全步骤：

1. 更改SECRET_KEY：生成安全随机密钥

   bash
   python -c "import secrets; print(secrets.token_urlsafe(32))"
   

2. 使用强数据库密码：不要使用默认密码

3. 配置HTTPS：使用反向代理（nginx、Caddy、Traefik）

4. 设置APP_URL：使用实际域名

5. 配置备份：定期备份PostgreSQL数据库

升级方法

bash
# 拉取新版本
docker-compose pull initiative

# 重启容器
docker-compose up -d initiative

应用启动时会自动运行数据库迁移。

相关链接

• GitHub：https://github.com/Morelitea/initiative
• 文档：参见仓库README
• 问题反馈：https://github.com/Morelitea/initiative/issues

许可证

参见仓库中的LICENSE文件。

支持

如有问题、错误报告或功能请求，请在GitHub上提交issue。