sarman/tftsr-devops_investigation
1
1
Fork 0
Code Issues 4 Pull Requests Actions 34 Packages Projects 3 Releases 6 Wiki Activity
2b82c28809
tftsr-devops_investigation/docs/wiki/Home.md
Shaun Arman 40b6882cab
Some checks failed
Test / rust-fmt-check (pull_request) Failing after 14s
Details
Test / rust-clippy (pull_request) Failing after 16s
Details
Test / rust-tests (pull_request) Failing after 18s
Details
Test / frontend-typecheck (pull_request) Successful in 1m27s
Details
Test / frontend-tests (pull_request) Successful in 1m28s
Details
PR Review Automation / review (pull_request) Successful in 3m4s
Details
fix: comprehensive trcaa→tftsr conversion and URL corrections 
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>
2026-06-05 15:38:29 -05:00

4.0 KiB
Raw Blame History

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: build — 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 Gitea Actions setup, multi-platform builds, act_runner config
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 — 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