README
¶
devpulse
Multi-tenant SaaS for GitHub project health analytics. Users sign in with GitHub OAuth, install a GitHub App on their repos, and get a hosted dashboard at devpulse.thingz.io.
Two binaries: devpulse-site (HTTP server + integrated admin dashboard), devpulse-import (batch worker). PostgreSQL with Row-Level Security for tenant isolation.
Development
git clone https://github.com/thingzio/devpulse.git && cd devpulse
make test # unit tests with race detector
make lint # go vet + golangci-lint + yamllint + tfsec
make qualify # test-coverage + lint + govulncheck + e2e
Documentation
| Doc | Purpose |
|---|---|
| DEVELOPMENT.md | Local setup, make targets, debugging |
| ARCHITECTURE.md | System design, data model, tenant isolation |
| ADMIN.md | Day-2 operations, monitoring, CI/CD, tenant management |
| INFRASTRUCTURE.md | GCP tiers, scaling, costs, API throughput |
| BOOTSTRAP.md | One-time GCP deployment guide |
| PLANS.md | Plan feature gating (Free, Starter, Pro, Enterprise) |
| VIEWS.md | Dashboard tabs and chart guide |
| GITLAB.md | GitLab support feasibility assessment |
Contributing
See CONTRIBUTING.md for guidelines and docs/DEVELOPMENT.md for setup.
- Fork and clone
- Create a feature branch
- Run
make qualify - Submit a pull request
License
Directories
Click to show internal directories.
Click to hide internal directories.