Conceitos centrais

Um breve mapa mental do Subaya antes de você se aprofundar.

CLI-first

A CLI suya é a interface primária — para humanos, agentes de IA e CI. O console web em subaya-dev.com é para resultados: waveforms, relatórios, gerenciamento de projetos e revisão. O pensamento — design, simulação, validação — acontece pela CLI e pelos agentes que a conduzem.

suya está para subaya-dev.com assim como gh está para github.com.

Tenancy: org → workspace → projeto

• Organização — o tenant de nível mais alto da sua conta. Cobrança, membros e licenças ficam aqui.
• Workspace — um agrupamento de projetos dentro de uma org (por exemplo, uma equipe ou uma linha de produtos).
• Projeto — a unidade de trabalho: um design tipado (fpga ou embedded) com seus próprios requisitos, simulações, repositório e fase.

Tipos de projeto

Tipo	Para	Toolchains
fpga	Designs RTL / FPGA	RyuSim, Verilator, Icarus, Questa, Vivado xsim, Quartus
embedded	Firmware de MCU (ex.: STM32)	planejamento de pinos com CubeMX, Renode

Fases

Todo projeto avança por fases que moldam a UI e as ferramentas disponíveis:

Concept → Plan → Implement → Simulate → Verify

Obtenha ou defina a fase atual com suya project phase.

Ferramentas hospedadas na nuvem

Ferramentas pesadas rodam no backend do Subaya, não no seu laptop: Quartus, RyuSim, Renode, BitCrucible e um motor CubeMX headless. Você as conduz pela CLI e paga apenas pelos segundos de compute que usa — veja Cobrança e uso.

Autenticação

Dois modos, abordados em Autenticação e chaves de API:

• SUBAYA_API_KEY — para agentes e CI, sem navegador.
• suya auth login — fluxo OAuth de navegador para desenvolvedores humanos.