Add seed script with 7 trees, markdown rendering, and dark mode docs

- Add comprehensive seed script with 7 troubleshooting decision trees
  - Tier 1: Password Reset, Outlook/Email, VPN, Printer Problems
  - Tier 2: Slow Computer, Network Connectivity
  - Tier 3: File Share Access Problems
- Add markdown rendering with react-markdown package
  - MarkdownContent component for session player and node editor
  - Preview toggle in description fields
- Update documentation to reflect dark mode is complete
- Update all progress tracking docs with recent changes

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
chihlasm
2026-01-29 02:25:03 -05:00
parent 0fe2ca850f
commit adcaf2f4fe
12 changed files with 5051 additions and 80 deletions

View File

@@ -1,6 +1,6 @@
# Project Apoklisis - Development Progress
**Last Updated**: January 28, 2026
**Last Updated**: January 29, 2026
**Current Phase**: Phase 2 Frontend - COMPLETE & TESTED
---
@@ -427,6 +427,7 @@ frontend/
| `NodePicker.tsx` | Type-grouped dropdown for selecting next_node_id |
| `TreePreviewPanel.tsx` | Visual tree preview with SharedLinksMap |
| `TreePreviewNode.tsx` | Node cards with solution indicators |
| `MarkdownContent.tsx` | Reusable markdown renderer (react-markdown) |
**Routes Added**:
- `/trees/new` - Create new tree
@@ -438,27 +439,45 @@ frontend/
- Solution connection indicators (green checkmark badges)
- Shared node detection (shows when multiple nodes link to same target)
- Modal with scrollable content, fixed header/footer
- **Markdown preview toggle** in description fields
- **Markdown rendering** in session player (decision/action/solution descriptions)
---
## What's Next
### Phase 1b: Pre-built Trees (Partial)
### Phase 1b: Pre-built Trees (COMPLETE)
**Seed Data Script**: `backend/scripts/seed_data.py`
**Seed Data Scripts**:
- `backend/scripts/seed_data.py` - Original script
- `backend/scripts/seed_trees.py` - Comprehensive 7-tree seed script (NEW)
**Trees Implemented**:
1. ✅ **Password Reset/Account Lockout** - Full implementation (~15 decision nodes)
2. 🔲 **File Share Access Problems** - Stub created (placeholder nodes)
3. 🔲 FSLogix Profile Issues - Not started
4. 🔲 Citrix VDA Registration - Not started
5. 🔲 AD Replication Issues - Not started
**Trees Implemented** (via `seed_trees.py`):
**Tier 1 - Help Desk:**
1. ✅ **Password Reset/Account Lockout** - Full implementation (~20 nodes)
2. ✅ **Outlook/Email Problems** - Complete with MAPI profile, OST, and connectivity checks
3. ✅ **VPN Connection Failures** - GlobalProtect, Cisco AnyConnect troubleshooting
4. ✅ **Printer Problems** - Print queue, driver, spooler, network printer diagnostics
**Tier 2 - Desktop Support:**
5. ✅ **Slow Computer Troubleshooting** - Startup, disk, RAM, malware diagnostics
6. ✅ **Network Connectivity Issues** - IP config, DNS, gateway, firewall checks
**Tier 3 - Systems:**
7. ✅ **File Share Access Problems** - Full implementation with NTFS, share permissions, DFS checks
**Each tree features:**
- 10-20+ nodes with realistic branching
- Real PowerShell commands in action nodes
- Professional ticket documentation guidance in solution nodes
- Markdown-formatted descriptions
### Remaining Work
1. **Tree Editor Polish**: Validation, required fields, orphan detection
2. **User Preferences**: Dark mode, export format defaults
3. **More Trees**: Add remaining 4 trees from `TS-EXAMPLES.md`
2. ~~**User Preferences**: Dark mode, export format defaults~~ Dark mode **COMPLETE**, export format pending
3. ~~**More Trees**: Add remaining 4 trees from `TS-EXAMPLES.md`~~ **COMPLETE** - 7 comprehensive trees seeded
4. **Deployment**: Set up CI/CD pipeline and deploy to Render/Railway
---
@@ -481,12 +500,21 @@ frontend/
- ✅ **Integration tests** - 40+ tests with full coverage (all passing)
- ✅ **Frontend COMPLETE** - Full React app with all core pages
- ✅ **Tree Editor IMPLEMENTED** - Form-based editing with visual preview
- ✅ **Markdown Rendering** - Session player and node editor support markdown
- ✅ **7 Seed Trees** - Comprehensive troubleshooting trees across Tier 1/2/3
- ✅ **Full workflow tested** - Register → Login → Browse → Navigate → Complete → Export all working
- 📝 **Single-user focus** for MVP (team features are in schema but low priority)
### Recommended Next Steps
1. **Tree Editor Validation**: Required fields, orphan node detection, save validation
2. **User Preferences**: Dark mode toggle, export format defaults
3. **Add more trees**: Implement remaining 4 trees from `TS-EXAMPLES.md`
4. **Deploy**: Set up CI/CD pipeline and deploy to Render/Railway
1. ~~**User Preferences**: Dark mode toggle~~ **COMPLETE**
2. **Tree Editor Validation**: Required fields, orphan node detection, save validation
3. **Deploy**: Set up CI/CD pipeline and deploy to Render/Railway
4. **Real-world Testing**: Use on actual support tickets
### Recent Additions (Jan 29, 2026)
1. **Seed Script** (`backend/scripts/seed_trees.py`) - 7 comprehensive troubleshooting trees
2. **Markdown Rendering** - `react-markdown` package + `MarkdownContent` component
3. **Preview Toggle** - Description fields in node editor can toggle between edit/preview
4. **LESSONS-LEARNED.md** updated with httpx and email validation fixes