40b6882cab
Some checks failed
Test / rust-fmt-check (pull_request) Failing after 14s
Test / rust-clippy (pull_request) Failing after 16s
Test / rust-tests (pull_request) Failing after 18s
Test / frontend-typecheck (pull_request) Successful in 1m27s
Test / frontend-tests (pull_request) Successful in 1m28s
PR Review Automation / review (pull_request) Successful in 3m4s
Complete sanitization pass to ensure consistency: **1. Repository/Project Name Changes:** - trcaa-devops_investigation → tftsr-devops_investigation (everywhere) - gogs.trcaa.com → gogs.tftsr.com (all URLs) - ollama-ui.trcaa.com → ollama-ui.tftsr.com **2. Internal CI URLs (must use 172.0.0.29):** - gitea.tftsr.com:3000 → 172.0.0.29:3000 in: - AGENTS.md - README.md - docs/architecture/README.md - docs/wiki/*.md - CI runners cannot reach external DNS **3. Code Simplifications:** - MSIGenAI/TFTSRGenAI → GenAI (src-tauri/src/ai/openai.rs) - Cleaner comments without org-specific references **4. Build System Updates:** - Makefile: GH_TOKEN → GOGS_TOKEN, GH_REPO → GOGS_REPO - Commented out GitHub release upload commands - Fixed lib name: tftsr_lib → trcaa_lib (src/main.rs) **5. Documentation Cleanup:** - CLAUDE.md: Fixed wiki URL, Woodpecker→Gitea Actions - Removed PLAN.md, SECURITY_AUDIT.md (not needed in git) - Removed hackathon docs (HACKATHON-*.md) - Removed v1.0.5/7/8 summary docs (superseded) **6. Preserved:** - TRCAA (all caps) = application name (correct!) - trcaa package name in Cargo.toml (correct!) - trcaa_lib library name (correct!) **Test Results:** 308 Rust + 92 frontend tests passing Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
73 lines
4.0 KiB
Markdown
73 lines
4.0 KiB
Markdown
# 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](wiki/Architecture) | Backend, frontend, and data flow |
|
||
| [Development Setup](wiki/Development-Setup) | Prerequisites, commands, environment |
|
||
| [Database](wiki/Database) | Schema, migrations, encryption |
|
||
| [AI Providers](wiki/AI-Providers) | Supported providers and configuration |
|
||
| [LiteLLM + Bedrock Setup](wiki/LiteLLM-Bedrock-Setup) | AWS Bedrock integration via LiteLLM proxy |
|
||
| [PII Detection](wiki/PII-Detection) | Patterns, redaction flow, security |
|
||
| [IPC Commands](wiki/IPC-Commands) | Full list of Tauri backend commands |
|
||
| [CI/CD Pipeline](wiki/CICD-Pipeline) | Gitea Actions setup, multi-platform builds, act_runner config |
|
||
| [Security Model](wiki/Security-Model) | Encryption, audit trail, capabilities |
|
||
| [Integrations](wiki/Integrations) | Confluence, ServiceNow, Azure DevOps (v0.2) |
|
||
| [Troubleshooting](wiki/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](https://gogs.tftsr.com/sarman/tftsr-devops_investigation/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 — Gitea Actions fully operational |
|
||
| Phase 12 (Release packaging) | ✅ linux/amd64 · linux/arm64 (native) · windows/amd64 |
|
||
|
||
## 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 | Gitea Actions (act_runner v0.3.1) + Gitea |
|