nomadcode/agent-ops/rules/project/domain/mobile/rules.md

mobile

목적 / 책임

NomadCode의 Flutter 모바일/데스크톱 클라이언트 도메인이다. 앱 entrypoint, Mattermost auth, push notification, platform integration을 담당한다.

포함 경로

• apps/mobile/lib/ — Flutter application code.
• apps/mobile/lib/services/ — auth, notification, background handlers.
• apps/mobile/test/ — Flutter widget/service tests.
• apps/mobile/android/, apps/mobile/ios/, apps/mobile/macos/, apps/mobile/linux/, apps/mobile/windows/, apps/mobile/web/ — platform-specific runner/config.
• apps/mobile/pubspec.yaml, apps/mobile/analysis_options.yaml — Dart/Flutter dependencies and analysis.

제외 경로

• services/core/ — backend orchestration/API implementation.
• apps/web/ — browser console implementation.
• packages/contracts/ — shared API/schema contracts.

주요 구성 요소

• lib/main.dart — Flutter app entrypoint.
• lib/services/mattermost_auth_service.dart — Mattermost auth flow.
• lib/services/push_notification_service.dart — foreground/background notification setup.
• lib/services/push_notification_background.dart — background message handler.
• test/widget_test.dart — baseline widget test.

유지할 패턴

• platform-specific permission/capability 변경은 해당 platform 디렉터리와 Dart service 변경을 같이 확인한다.
• Firebase Messaging 변경은 foreground, background, permission flow를 함께 검토한다.
• public API 호출을 추가하면 contracts/core 영향 여부를 확인한다.
• flutter test를 기본 검증으로 사용한다.
• 현재 baseline의 avoid_print info는 별도 cleanup 작업으로 다루고, 기능 변경과 섞지 않는다.

다른 도메인과의 경계

• core: mobile은 core API/notification 계약에 의존하되 core 내부 구현을 알지 않는다.
• contracts: mobile이 사용하는 API/event shape는 contracts 후보로 올린다.
• web: 사용자 경험 방향은 맞출 수 있지만 UI 구현은 공유하지 않는다.
• workspace-ops: root scripts와 agent rules는 mobile 내부에 복제하지 않는다.

금지 사항

• Android/iOS/macOS 권한 변경을 Dart service 변경 없이 단독으로 넣지 않는다.
• Firebase 초기화/handler 변경을 테스트나 수동 검증 메모 없이 마무리하지 않는다.
• generated/platform build output을 의도 없이 커밋하지 않는다.
• mobile 내부에 별도 agent-ops scaffold를 다시 만들지 않는다.