PlaneBot 🤖

Integration service for synchronizing tasks between Gitea and Plane.

📁 Project Structure

planebot/
├── app/                    # Main application
│   ├── models/            # Data models
│   ├── routers/           # API routes
│   ├── services/          # Business logic
│   └── utils/             # Utilities
├── config/                # Configuration files
├── docker/                # Docker files
├── docs/                  # Documentation
├── logs/                  # Logs and diagnostics
├── scripts/               # Scripts and utilities
└── tests/                 # Tests

🚀 Quick Start

For detailed installation and setup information, see the documentation.

📚 Documentation

• Main documentation
• Integration
• Deployment

🛠️ Development

# Install dependencies
pip install -r requirements.txt

# Run tests
python -m pytest tests/

# Webhook diagnostics
python scripts/diagnose_webhooks.py

🐳 Docker

# Build and run
docker-compose -f docker/docker-compose.yml up -d

---

🔍 Keywords

Primary Keywords: PlaneBot, Gitea integration, Plane integration, webhook synchronization, bidirectional sync, task automation

Technical Keywords: API integration, webhook handler, commit parser, project mapping, HMAC verification, REST API client, FastAPI application

Integration Keywords: Gitea webhook, Plane webhook, issue synchronization, commit reference, task closure, polling fallback, external ID mapping

Development Keywords: Python FastAPI, Docker containerization, asynchronous processing, structured logging, Pydantic validation, systemd service

Use Case Keywords: DevOps automation, project management sync, git workflow integration, issue tracking automation, CI/CD pipeline integration, development team collaboration

Platform Keywords: Gitea server, Plane.so, self-hosted Git, open source project management, Git service integration, issue management platform