nomadcode/agent-ops/roadmap/phase/project-workspace-management-ux/milestones/project-workspace-management-ux.md
toki 217c17dfef refactor: rename apps/mobile to apps/client and update project structure
- Rename mobile app directory to client throughout the project
- Restructure client app code into feature-based organization
  - Move code to src/features/workspaces/domain/presentation
  - Move services to src/integrations/ (mattermost, workspace, proto_socket)
  - Add app bootstrap and main entry point
- Add push notification integration (Mattermost push client/host/plugin)
- Add proto socket integration for real-time communication
- Add integration tests for push and socket components
- Archive old milestone: client-integration-standardization.md
- Add new workflow core milestone: roadmap-driven-agent-ops-automation.md
- Update agent-ops rules (project, core, mobile, contracts, workspace-ops)
- Update roadmap files (ROADMAP.md, current.md, phase PHASE.md files)
- Update bin scripts (build, dev, lint, test)
- Add test environments documentation
- Update contracts notes for Flutter Core API
2026-05-25 22:10:43 +09:00

3.9 KiB

Milestone: Project Workspace Management UX

위치

  • Roadmap: agent-ops/roadmap/ROADMAP.md
  • Phase: agent-ops/roadmap/phase/project-workspace-management-ux/PHASE.md

목표

Flutter-first 클라이언트 구조 위에서 기존 Project/Session/Workspace 방향을 유지하면서 프로젝트 단위 제어 UX를 앱 기반 desktop과 mobile layout으로 정리한다. Mobile에서 가능한 프로젝트 관리 기능은 desktop에도 포함하고, desktop은 프로젝트 단위 확장 표면을 code-server와 Agent Chat을 다루는 앱 shell로 정리한다.

상태

[계획]

구현 잠금

  • 상태: 잠금
  • 결정 필요:
    • 프로젝트 단위 제어 화면의 공통 기능 목록과 우선순위를 결정한다.
    • Flutter 앱의 desktop layout, desktop project window, mobile top-tab의 역할 경계를 결정한다.
    • IOP OpenAI API Responses-compatible 호출 결과, task 상태, 파일 변경 결과를 UX에 투영하는 최소 기준을 결정한다.

범위

  • 프로젝트 단위 제어 UX의 공통 기능 정리
  • Flutter 앱 desktop 프로젝트 탭 구조 정리
  • Flutter 앱 desktop 프로젝트 단위 새창 구조 정리
  • mobile 프로젝트 관리 상단탭 구조 정리
  • code-server, Agent Chat, task/execution state, 파일 변경 결과, diff/branch/commit/PR 흐름을 프로젝트 제어 화면에 배치하는 기준 정리
  • NomadCode Project/Session/Workspace 상태와 IOP 호출 결과를 사용자에게 보여주는 경계 정리

필수 기능

Epic: [workspace-ux] Project workspace UX definition

Flutter-first 앱에서 project/session/workspace 제어 표면과 desktop/mobile 역할 경계를 정의한다.

  • [common-capability] 프로젝트 단위 제어 화면의 공통 capability를 정의한다.
  • [mobile-tabs] mobile 상단탭 기반 프로젝트 관리 구조를 정의한다.
  • [desktop-tabs] Flutter 앱 desktop 탭 기반 프로젝트 관리 구조를 정의한다.
  • [desktop-window] Flutter 앱 desktop 프로젝트 단위 새창을 code-server와 Agent Chat을 포함한 프로젝트 제어 확장 표면으로 정의한다.
  • [parity] desktop은 mobile에서 가능한 프로젝트 관리 기능을 모두 포함한다는 parity 기준을 정한다.
  • [iop-result-ux] IOP OpenAI API Responses-compatible 호출 결과, task 상태, 파일 변경 결과를 UX에 표시하는 기준을 정한다.

완료 기준

  • 프로젝트 관리 UX에서 Flutter 앱 desktop layout, desktop project window, mobile top-tab의 역할이 충돌 없이 설명된다.
  • mobile에서 가능한 프로젝트 관리 기능이 desktop에도 포함된다는 기준이 문서화되어 있다.
  • 프로젝트 단위 새창이 단순 code-server 링크가 아니라 프로젝트 제어 확장 표면임이 문서화되어 있다.
  • IOP 실행 결과, task 상태, 파일 변경 결과가 NomadCode UX에서 어떻게 보이는지 최소 기준이 정리되어 있다.
  • 기존 Project/Session/Workspace 방향을 대체하지 않고 보강하는 Milestone으로 읽힌다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 없음
  • 리뷰 필요:
    • 사용자가 완료 결과를 확인했다
    • archive 이동을 승인했다
  • 리뷰 코멘트: 없음

범위 제외

  • IOP 내부 모델 라우팅, 모델 프로파일, RAG, MCP, output validation 구현
  • IOP A2A 기반 외부 agent 추가 흐름
  • OpenCode, Aider, Claude Code, Gemini CLI, Codex CLI 직접 대체 구현
  • 상세 화면 컴포넌트, API, DB schema, 파일 구조 확정

작업 컨텍스트

  • 관련 경로: apps/client/, packages/contracts/, services/core/
  • 전환 참고 경로: [Legacy/Retired] apps/web/ (제거됨)
  • 선행 작업: Flutter-first Client Consolidation, Client Integration Standardization
  • 후속 작업: 확인 필요
  • 확인 필요: 구현 잠금의 결정 필요 항목 참고.