Acabamento desktop: aprendizados do Atlas (lista de dispositivos, ação no alvo, permissões com risco, cartão de pareamento, vazio que ensina)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- typescript
調査の方向性
Start with the linked issues #1329, #912, #1136, and #1125, then review the Svelte components and recipes they cover. The issue proposes recipes for device rows, permissions, pairing, and empty states, plus documentation and test support, but does not name implementation files or tests. Done means the first five patterns have tested recipes, the linked issues close, and the recipes documentation includes an Atlas device settings example.
索引モデルが issue の本文から書いたものです。
説明
Contexto
Revisão de produto do Atlas Desktop, tela Settings → Mobile (codeatlasdev/atlas#437). A tela usa a lib (Svelte), e os defeitos que o dono viu vieram em parte de padrões que a lib não tem e em parte de componentes da lib. Cada item diz o que quebrou, a regra que resolveu, o que a lib deveria oferecer e as issues ligadas. As falhas pontuais já têm issue própria: #1329, #912, #1136 e #1125. Esta junta o padrão.
O critério do dono: nada pode parecer "vibecodado". A tela precisa explicar a si mesma, e um botão sempre pertence à coisa que ele muda.
1. Lista de dispositivos: cada item identificável e com estado
Quebrou: dois celulares apareciam como "Atlas Mobile · Paired 21/10/2026", sem como saber qual era qual nem qual estava conectado.
Regra: uma linha por dispositivo:
- nome (dado pelo usuário, ou modelo e sistema enviados pelo aparelho, ou um prefixo da chave);
- estado ao vivo ("Connected now" com ponto verde no ícone, "Last seen 3 min ago", "Not connected yet") mais a data no locale;
- ordenação conectado primeiro, depois visto por último.
Para a lib: DeviceRow/EntityRow com slots de ícone + status, título, linha de estado e ações, e um formatador de tempo relativo com tick compartilhado. Ligadas: #1161, #1117.
2. A ação mora na coisa que ela muda
Quebrou (print do dono): "Revoke" flutuava no meio da linha, alinhado com o 3º switch ("Answer agent permission prompts"), parecendo uma ação daquela permissão.
Regra: ações do item (Renomear, Atividade, Desparear) ficam no cabeçalho do item, alinhadas à direita. A destrutiva pede confirmação com o nome do item. Ação de um campo fica no campo.
Para a lib: o padrão de cabeçalho de item com ações, e um lint ou detector de "botão alinhado com a linha errada" (o ponto de ancoragem de uma ação precisa estar no container do alvo). Ligadas: #1290, #1085.
3. Permissões: resumo em palavras, edição agrupada com risco
Quebrou: cinco switches grandes empilhados por dispositivo viravam uma parede.
Regra:
- Um resumo em uma palavra (Full access, View only, Custom: 3 of 5, No access).
- A edição fica recolhida em "Edit permissions", agrupada por intenção (View: projetos/logs/agentes, terminais; Control: reiniciar/ações/prompts, digitar, responder permissões).
- Cada item tem uma linha de risco em linguagem simples.
- O toggle aplica na hora.
Para a lib: receita PermissionGroup sobre SettingItem, com variante de resumo. Ligadas: #750, #525.
4. Pareamento por código: o cartão explica o fluxo inteiro
Quebrou: QR mais código de 6 dígitos sem passos, sem dizer onde baixar o app, sem estado de expirado e sem retorno quando o celular pareia.
Regra:
- Três passos numerados (baixar, abrir, escanear) com o texto que o app realmente mostra.
- Código agrupado
012 345. - "Expires in m:ss" com barra.
- "Waiting for your phone…".
- Estado expirado com "New code".
- Erro com a causa.
- Ao parear, o item aparece na lista ao vivo, e o cartão diz "Phone X is paired".
- Um "Isso não funcionou?" recolhido (relay, manter acordado, VPN).
- Links de loja numa constante só.
Para a lib: componentes QrCode (#1136) e Countdown (#1125), e a receita PairingCard com os estados acima.
5. Estado vazio que ensina
Quebrou: "No paired phones" e nada mais.
Regra: o vazio diz o que o recurso dá e aponta para a ação que está na mesma tela (aqui, "Show pairing code"). Vazio, não configurado, erro e carregando são estados distintos. Ligadas: #992, #1060.
6. Disclosure plano dentro de painel
Quebrou: Collapsible dentro de um card gerava caixa dentro de caixa.
Regra no Atlas: um wrapper único (FlatDisclosure.svelte), que vira passthrough quando a variante flush sair. Ligadas: #912 e o PR #964.
7. Dialog sem filhos
Quebrou: com descrição e ações, mas sem conteúdo, o texto encosta no divisor do rodapé. Ligada: #1329.
8. Padrões que valem para desktop e mobile (o app mobile do Atlas chegou nos mesmos)
- Painel de status: o estado em palavras, a única ação dele e os números num bloco. Parado não é alarme (0/N neutro, "—" em vez de "0 MB"). Números nunca rolam de lado. Ligada: #1157.
- Erro para pessoas: título, frase, passos e detalhes crus recolhidos e copiáveis.
- Sem salto de layout enquanto dados chegam: a linha de status ao vivo tem uma linha só, e o placeholder tem a mesma forma do conteúdo. Ligada: #1068.
- Título da tela com os controles na mesma linha. Ligada: #1044.
9. Como foi verificado
- Screenshots de cada estado (vazio, código, expirado, dois celulares, permissões, atividade, desparear), tirados de um hostd real com dados semeados, sem tocar no app do usuário.
- Testes de componente com fixtures geradas pelo serializer real do backend.
- O mock de kit em
test/uiKit.tsprecisou de stubs paraAlert,Collapsible,EmptyState,Progress,SettingItemeTextField: quando a suíte de outro teste carregava primeiro, o teste deste componente quebrava. Para a lib: um mock oficial e completo para testes de consumidores, ou um@codeatlasdev/ui/testing(#1290).
Aceite sugerido: os itens 1 a 5 viram receitas com teste, e os itens 6 e 7 fecham pelas issues ligadas. A doc de receitas ganha uma seção "telas de configuração de dispositivos" com o exemplo do Atlas.
- 主要言語
- TypeScript
- スター
- 6
- フォーク
- 3
- 平均マージ
- 5時間 21分
- マージ済み PR(30日)
- 378
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
codeatlasdev/ui のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
codeatlasdev/ui#1340 ·
メンテナーはふだん 1 日以内に返信
-
area:a11y area:components bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
codeatlasdev/ui#1336 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 77/100
codeatlasdev/ui#1329 ·
メンテナーはふだん 1 日以内に返信
-
good first issue
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
codeatlasdev/ui#1292 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
area:components enhancement good first issue
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
codeatlasdev/ui#1198 ·
メンテナーはふだん 1 日以内に返信
codeatlasdev/ui の issue をすべて見る
似ている issue
-
Console writes URL credentials to the local log, though AGENTS.md says secrets never reach diskオープン
難易度 1/5 1時間未満 初心者へのやさしさ 86/100
sandbox-quantum/switch#2163 ·
メンテナーはふだん 1 日以内に返信
-
automated issue report
難易度 1/5 1時間未満 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
area/dashboard kind/bug QA/dev-automation
難易度 1/5 1時間未満 初心者へのやさしさ 75/100
メンテナーはふだん 1 日以内に返信
-
bug pydanty:is-working
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
pydantic/pydantic-ai#13939 ·
メンテナーはふだん 1 日以内に返信
-
self-host
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
funmusicplace/mirlo#2625 ·
メンテナーはふだん 1 日以内に返信