Add desktop UI navigation instructions for CRM testing
This commit is contained in:
parent
6297018124
commit
2fe4586be5
1 changed files with 73 additions and 0 deletions
73
AGENTS.md
73
AGENTS.md
|
|
@ -28,6 +28,27 @@ See botserver/src/drive/local_file_monitor.rs to see how to load from /opt/gbo/d
|
|||
|
||||
---
|
||||
|
||||
## 📁 WORKSPACE STRUCTURE
|
||||
|
||||
| Crate | Purpose | Port | Tech Stack |
|
||||
|-------|---------|------|------------|
|
||||
| **botserver** | Main API server, business logic | 8080 | Axum, Diesel, Rhai BASIC |
|
||||
| **botui** | Web UI server (dev) + proxy | 3000 | Axum, HTML/HTMX/CSS |
|
||||
| **botapp** | Desktop app wrapper | - | Tauri 2 |
|
||||
| **botlib** | Shared library | - | Core types, errors |
|
||||
| **botbook** | Documentation | - | mdBook |
|
||||
| **bottest** | Integration tests | - | tokio-test |
|
||||
| **botdevice** | IoT/Device support | - | Rust |
|
||||
| **botplugin** | Browser extension | - | JS |
|
||||
|
||||
### Key Paths
|
||||
- **Binary:** `target/debug/botserver`
|
||||
- **Run from:** `botserver/` directory
|
||||
- **Env file:** `botserver/.env`
|
||||
- **UI Files:** `botui/ui/suite/`
|
||||
|
||||
---
|
||||
|
||||
## 🧭 LLM Navigation Guide
|
||||
|
||||
### Reading This Workspace
|
||||
|
|
@ -298,6 +319,17 @@ END LOOP
|
|||
|
||||
---
|
||||
|
||||
## 🧠 Memory Management
|
||||
|
||||
When compilation fails due to memory issues (process "Killed"):
|
||||
|
||||
```bash
|
||||
pkill -9 cargo; pkill -9 rustc; pkill -9 botserver
|
||||
CARGO_BUILD_JOBS=1 cargo check -p botserver 2>&1 | tail -200
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎭 Playwright Browser Testing - YOLO Mode
|
||||
|
||||
**When user requests to start YOLO mode with Playwright:**
|
||||
|
|
@ -309,6 +341,11 @@ END LOOP
|
|||
5. **Validate backend** - Check database and services to confirm process completion
|
||||
6. **Report findings** - Always include screenshot evidence with `browser_take_screenshot`
|
||||
|
||||
**⚠️ IMPORTANT - Desktop UI Navigation:**
|
||||
- The desktop may have a maximized chat window covering other apps
|
||||
- To access CRM/sidebar icons, click the **middle button** (restore/down arrow) in the chat window header to minimize it
|
||||
- Or navigate directly via URL: http://localhost:3000/suite/crm (after login)
|
||||
|
||||
**Bot-Specific Testing URL Pattern:**
|
||||
`http://localhost:3000/<botname>`
|
||||
|
||||
|
|
@ -413,6 +450,42 @@ When ANY error appears in logs during startup or operation:
|
|||
|
||||
---
|
||||
|
||||
## 🔧 Technical Debt
|
||||
|
||||
### Critical Issues to Address
|
||||
- Error handling debt: instances of `unwrap()`/`expect()` in production code
|
||||
- Performance debt: excessive `clone()`/`to_string()` calls
|
||||
- File size debt: files exceeding 450 lines
|
||||
|
||||
### Weekly Maintenance Tasks
|
||||
```bash
|
||||
cargo tree --duplicates # Find duplicate dependencies
|
||||
cargo machete # Remove unused dependencies
|
||||
cargo build --release && ls -lh target/release/botserver # Check binary size
|
||||
cargo audit # Security audit
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 Continuation Prompt
|
||||
|
||||
When starting a new session or continuing work:
|
||||
|
||||
```
|
||||
Continue on gb/ workspace. Follow AGENTS.md strictly:
|
||||
|
||||
1. Check current state with build/diagnostics
|
||||
2. Fix ALL warnings and errors - NO #[allow()] attributes
|
||||
3. Delete unused code, don't suppress warnings
|
||||
4. Remove unused parameters, don't prefix with _
|
||||
5. Replace ALL unwrap()/expect() with proper error handling
|
||||
6. Verify after each fix batch
|
||||
7. Loop until 0 warnings, 0 errors
|
||||
8. Refactor files >450 lines
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔑 Memory & Main Directives
|
||||
|
||||
**LOOP AND COMPACT UNTIL 0 WARNINGS - MAXIMUM PRECISION**
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue