d5e180740e
Replace every remaining reference to the old Gitea infrastructure with the new GitHub-hosted equivalents across all documentation, wiki pages, test files, and historical ticket summaries. - README.md: CI badge, clone URL, releases link, CI/CD section, project structure - docs/wiki/CICD-Pipeline.md: full rewrite for GitHub Actions + ghcr.io - docs/wiki/Home.md: CI badge, releases link, phase status, tech stack - docs/wiki/Troubleshooting.md: rewrite CI troubleshooting for GitHub Actions - docs/architecture/README.md: update CI/CD pipeline diagram - AGENTS.md: CI/CD section, environment references - PLAN.md: directory structure, pipeline table - SECURITY_AUDIT.md: mark C3 and L4 findings as resolved - ticket-git-cliff-changelog.md: workflow path updated - tickets/ci-runner-speed-optimization.md: image registry updated - 2026-hackathon_AgenticFeature.md: workflow path updated - tests: workflow path assertions updated in all three test files
4.0 KiB
4.0 KiB
Troubleshooting and RCA Assistant
Troubleshooting and RCA Assistant is a secure desktop application for guided IT incident triage, root cause analysis (RCA), and post-mortem documentation. Built with Tauri 2.x (Rust + WebView) and React 18.
CI: 
— rustfmt · clippy · 64 Rust tests · tsc · vitest — all green
Quick Navigation
| Topic | Description |
|---|---|
| Architecture | Backend, frontend, and data flow |
| Development Setup | Prerequisites, commands, environment |
| Database | Schema, migrations, encryption |
| AI Providers | Supported providers and configuration |
| LiteLLM + Bedrock Setup | AWS Bedrock integration via LiteLLM proxy |
| PII Detection | Patterns, redaction flow, security |
| IPC Commands | Full list of Tauri backend commands |
| CI/CD Pipeline | GitHub Actions setup, multi-platform builds, pre-baked ghcr.io images |
| Security Model | Encryption, audit trail, capabilities |
| Integrations | Confluence, ServiceNow, Azure DevOps (v0.2) |
| Troubleshooting | Known issues and fixes |
Key Features
- 5-Whys AI Triage — Interactive guided root cause analysis via multi-turn AI chat
- PII Auto-Redaction — Detects and redacts sensitive data before any AI send
- Multi-Provider AI — OpenAI, Anthropic Claude, Google Gemini, Mistral, AWS Bedrock (via LiteLLM), Custom REST gateways, local Ollama (fully offline)
- Custom Provider Support — Flexible authentication (Bearer, custom headers) and API formats (OpenAI-compatible, Custom REST)
- External Integrations — Confluence, ServiceNow, Azure DevOps with OAuth2 PKCE flows
- SQLCipher AES-256 — All issue history and credentials encrypted at rest
- RCA + Post-Mortem Generation — Auto-populated Markdown templates, exportable as MD/PDF
- Ollama Management — Hardware detection, model recommendations, in-app model management
- Audit Trail — Every external data send logged with SHA-256 hash
- Domain-Specific Prompts — 8 IT domains: Linux, Windows, Network, Kubernetes, Databases, Virtualization, Hardware, Observability
- Image Attachments — Upload and manage image files with PII detection and mandatory user approval
Releases
| Version | Status | Highlights |
|---|---|---|
| v0.2.6 | 🚀 Latest | Custom REST AI gateway support, OAuth2 shell permissions, user ID tracking |
| v0.2.5 | Released | Image attachments with PII detection and approval workflow |
| v0.2.3 | Released | Confluence/ServiceNow/ADO REST API clients (19 TDD tests) |
| v0.1.1 | Released | Core application with PII detection, RCA generation |
Platforms: linux/amd64 · linux/arm64 · windows/amd64 (.deb, .rpm, .AppImage, .exe, .msi)
Download from Releases. All builds are produced natively (no QEMU emulation).
Project Status
| Phase | Status |
|---|---|
| Phases 1–8 (Core application) | ✅ Complete |
| Phase 9 (History/Search) | 🔲 Pending |
| Phase 10 (Integrations) | ✅ Complete — Confluence, ServiceNow, Azure DevOps fully implemented with OAuth2 |
| Phase 11 (CI/CD) | ✅ Complete — GitHub Actions fully operational |
| Phase 12 (Release packaging) | ✅ linux/amd64 · linux/arm64 · windows/amd64 · macOS ARM64 · macOS Intel |
Tech Stack
| Layer | Technology |
|---|---|
| Desktop framework | Tauri 2.x |
| Backend | Rust (async/await, tokio) |
| Frontend | React 18 + TypeScript + Vite |
| Styling | Tailwind CSS + custom components |
| Database | rusqlite + SQLCipher (AES-256) |
| Secret storage | tauri-plugin-stronghold |
| State | Zustand |
| Testing | Vitest (13 frontend) + #[cfg(test)] (64 Rust tests) |
| CI/CD | GitHub Actions + ghcr.io |