e0b09bc5c0
Plan to expose both OpenCode IDE (port 8080) and raw ttyd terminal (port 7681) for direct TUI access in browser.
118 lines
3.7 KiB
Markdown
118 lines
3.7 KiB
Markdown
# Roadmap
|
|
|
|
## Done
|
|
|
|
- [x] Multi-language UI (NL, AR, EN)
|
|
- [x] RTL support
|
|
- [x] Real-time name validation
|
|
- [x] SSE deployment progress
|
|
- [x] Dokploy orchestration
|
|
- [x] SSL certificate provisioning wait
|
|
- [x] Stack cleanup API
|
|
- [x] Auto-rollback on failure
|
|
- [x] Persistent storage volumes
|
|
- [x] Logging infrastructure (log-ingest → Loki → Grafana)
|
|
- [x] AI Stack monitoring dashboard at logs.intra.flexinit.nl
|
|
- [x] Repository consolidation (3 repos → flexinit/agent-stack)
|
|
- [x] Unified CI/CD pipeline (stack + portal images)
|
|
|
|
## Next (Priority)
|
|
|
|
### Automated Cleanup System (HIGH)
|
|
**Issue**: Disk space exhaustion on Dokploy server causes CI failures
|
|
|
|
**Components**:
|
|
- [ ] CI workflow cleanup step - prune build cache after each build
|
|
- [ ] Server-side cron job - daily Docker system prune
|
|
- [ ] Disk monitoring - alert at 80% usage via Grafana
|
|
- [ ] Post-deployment cleanup - remove unused resources after stack deploy
|
|
|
|
**Implementation**:
|
|
```yaml
|
|
# CI workflows (.gitea/workflows/*.yaml)
|
|
- name: Cleanup build artifacts
|
|
if: always()
|
|
run: |
|
|
docker builder prune -f --keep-storage=2GB
|
|
docker image prune -f --filter "until=24h"
|
|
```
|
|
|
|
```bash
|
|
# Server cron (/etc/cron.d/docker-cleanup on 10.100.0.20)
|
|
0 4 * * * root docker system prune -f --volumes --filter "until=72h"
|
|
0 4 * * * root docker exec flexinit-runner docker builder prune -f --keep-storage=5GB
|
|
```
|
|
|
|
### Web-based TUI Support (HIGH) - IN PROGRESS
|
|
**Feature**: Full TUI (Terminal User Interface) support inside the web browser
|
|
|
|
**Goal**: Enable rich terminal UI applications (like htop, lazygit, OpenCode TUI mode) to render correctly in the browser-based terminal.
|
|
|
|
**Completed** (Terminal Environment):
|
|
- [x] TERM=xterm-256color environment variable
|
|
- [x] COLORTERM=truecolor for 24-bit color support
|
|
- [x] ncurses-base and ncurses-term packages for terminfo database
|
|
- [x] Locale configuration (en_US.UTF-8) for Unicode support
|
|
- [x] Environment variables passed to deployed stacks
|
|
|
|
**Remaining** (Direct Web Terminal):
|
|
- [ ] Add ttyd for raw terminal access in browser
|
|
- [ ] Configure dual-port exposure (OpenCode IDE + ttyd terminal)
|
|
- [ ] Update Traefik routing for terminal port
|
|
- [ ] Test TUI applications (htop, lazygit, vim)
|
|
- [ ] Document TUI capabilities for users
|
|
|
|
**Architecture** (Dual Interface):
|
|
```
|
|
https://name.ai.flexinit.nl/ → Port 8080 → OpenCode Web IDE
|
|
https://name.ai.flexinit.nl:7681/ → Port 7681 → ttyd Raw Terminal
|
|
```
|
|
|
|
**Implementation Plan**:
|
|
```dockerfile
|
|
# Add ttyd to Dockerfile
|
|
RUN curl -sL https://github.com/tsl0922/ttyd/releases/latest/download/ttyd.x86_64 \
|
|
-o /usr/local/bin/ttyd && chmod +x /usr/local/bin/ttyd
|
|
|
|
# Startup script runs both services
|
|
ttyd -p 7681 -W bash &
|
|
opencode serve --hostname 0.0.0.0 --port 8080
|
|
```
|
|
|
|
**Use Cases**:
|
|
- OpenCode TUI mode in browser
|
|
- lazygit, lazydocker
|
|
- htop, btop system monitoring
|
|
- vim/neovim with full features
|
|
- Any ncurses-based application
|
|
|
|
### Other Next Items
|
|
- [ ] User authentication (protect deployments)
|
|
- [ ] Rate limiting (prevent abuse)
|
|
- [ ] Stack management UI (list/delete stacks)
|
|
|
|
## Later
|
|
|
|
- [ ] Unit tests for validation
|
|
- [ ] Integration tests
|
|
- [ ] Resource limits configuration
|
|
- [ ] Custom domain support
|
|
- [ ] Image versioning (semantic versions + rollback)
|
|
- [ ] Auto-cleanup of abandoned stacks (inactive > 30 days)
|
|
|
|
## Technical Notes
|
|
|
|
### Disk Space Management
|
|
Server: 10.100.0.20 (97GB total)
|
|
- Docker images: ~10GB
|
|
- Containers: ~1.5GB
|
|
- Volumes: ~30GB
|
|
- Build cache: Up to 6GB between cleanups
|
|
- **Safe threshold**: Keep 15GB+ free (85% max usage)
|
|
|
|
### Key Infrastructure
|
|
- Gitea: git.app.flexinit.nl (repo: flexinit/agent-stack)
|
|
- Runner: flexinit-runner container on 10.100.0.20
|
|
- Registry: git.app.flexinit.nl/flexinit/agent-stack:latest
|
|
- Monitoring: logs.intra.flexinit.nl (dashboard: /d/ai-stack-overview)
|