====== Fluid Ardule UI Design (v1.1 Draft) ======

===== 1. Design Philosophy =====
Fluid Ardule UI는 전통적인 메뉴 기반 UI가 아니라 다음 원칙을 따른다.

  * Flat UI (무계층 구조)
  * 즉시 반영 (Immediate Response)
  * 연주 중심 (Performance-oriented)

핵심 원칙:
  * ↑↓ : 무엇을 바꿀지 선택
  * ←→ : 값을 바꾼다
  * 대부분은 즉시 적용된다

또한 표시 기호의 의미를 다음과 같이 고정한다.

  * **왼쪽 끝의 ''>''** : 현재 선택된 항목(커서)
  * **오른쪽 끝의 ''>''** : 하위 메뉴 또는 상세 화면으로 진입 가능
  * **''<>''** : 좌우로 값 변경 가능

===== 2. Display Layout (16x2 LCD) =====
<code>
[Line 1] Status / Category
[Line 2] Value / Selection
</code>

부팅 후 첫 화면 예시:
<code>
READY
>SF:SalC5 
</code>

설명:
  * ''READY'' : 연주 가능 상태
  * 왼쪽 ''>'' : 현재 포커스가 SF 항목에 있음
    * → 버튼 : 선택된 항목의 하위 메뉴로 진입
  * 볼륨은 하드웨어 포텐셔미터로 조절하며, 홈 화면에서 참고값으로만 표시할 수 있다

===== 3. Top-Level Categories =====
<code>
0  SF
1  MIDI IN
2  MIDI OUT
3  SYSTEM
</code>

첫 화면은 별도의 HOME이 아니라 **카테고리 0 (SF)의 축약 화면**으로 간주한다.

===== 4. Navigation Model =====
^ 버튼 ^ 기능 ^
| ↑ / ↓ | 카테고리 이동 |
| ← / → | 값 변경 또는 하위 진입 |
| Select | 일부 기능 확정 |
| Select (long) | 전원 관리 |
| Down (long) | MIDI Panic |

보조 규칙:
  * 첫 화면에서 **Down**을 누르면 ''MIDI IN''으로 이동한다.
  * 첫 화면에서 **Right**를 누르면 ''SF MENU''로 진입한다.
  * SYSTEM이나 SF MENU 같은 depth UI에서는 **Right = 진입**, **Left = 상위로 복귀**로 사용한다.

===== 5. Category Definitions =====

==== 5.1 SoundFont (SF) ====
첫 화면(축약형):
<code>
READY
>SF:SalC5
</code>

정식 카테고리 표시 예:
<code>
SOUNDFONT      0
>SalC5       <>
</code>

→ 진입 (Right)
<code>
SF MENU
>SoundFont
 Program
</code>

=== 5.1.1 SoundFont 선택 ===
<code>
Select SF
[2/3] FlR3 <>
</code>

  * Left / Right : 항목 이동
  * Select : 확정

=== 5.1.2 Program (Placeholder) ===
<code>
PROGRAM
Not Ready
</code>

Program Change는 SF-specific 기능이므로, 별도 최상위 카테고리가 아니라 **SF 내부 메뉴**에 둔다.

==== 5.2 MIDI IN ====
<code>
MIDI IN        1
>USB        <>
</code>

옵션:
  * USB
  * ONYX

→ 즉시 적용

<>가 표시된 것은 인코더 노브 또는 좌우 화살표로 변경할 수 있음을 의미한다.
==== 5.3 MIDI OUT ====
<code>
MIDI OUT       2
>FS         <>
</code>

옵션:
  * FLUIDSYNTH
  * YOSHIMI
  * ONYX

→ 즉시 적용

==== 5.4 SYSTEM ====
상위 카테고리:
<code>
SYSTEM         3
>Enter
</code>

→ 진입 (Right)

<code>
SYS MENU
>Transpose
 Channel
</code>

<code>
SYS MENU
>Reset
</code>

SYSTEM은 예외적으로 depth를 허용하는 카테고리이다.

=== Transpose ===
<code>
TRANSPOSE
>+0        <>
</code>

  * 범위: -12 ~ +12 권장
  * 즉시 적용

=== Channel ===
<code>
CHANNEL
>1→1      <>
</code>

  * 모든 입력을 특정 채널로 강제하는 단순 remap
  * 즉시 적용

=== Reset ===
<code>
RESET
>GM        <>
</code>

옵션:
  * GM
  * GS
  * XG

  * Select로 실행

===== 6. Interaction Model =====
Flat UI:
  * SF
  * MIDI IN
  * MIDI OUT

Depth UI:
  * SYSTEM
  * SF submenu

규칙:
  * Flat UI에서는 카테고리 간 이동과 값 변경이 중심이다.
  * Depth UI에서는 리스트 탐색과 진입/복귀가 중심이다.

===== 7. Value Application Rules =====
^ 항목 ^ 적용 방식 ^
| Volume | 하드웨어 포텐셔미터 |
| MIDI IN | 즉시 적용 |
| MIDI OUT | 즉시 적용 |
| Transpose | 즉시 적용 |
| Channel | 즉시 적용 |
| SoundFont | Select 확정 |
| Reset | Select 실행 |

===== 8. Excluded Features =====
  * Volume UI 제거 (표시만 가능)
  * Audio Out 제거
  * Panic 제거 (Down long)
  * Power 제거 (Select long)

===== 9. System Behavior =====
<code>
Boot → READY
     ↓
Down = next category
Right on SF = SF MENU
Right on SYSTEM = SYS MENU
     ↓
Change Value / Enter Submenu
     ↓
Apply / Confirm
</code>

===== 10. Future Extensions =====
  * Program Change
  * Velocity Curve
  * MIDI Routing

===== 11. Key Insight =====
Fluid Ardule UI는 메뉴가 아니라 악기 패널이다.