# Estrutura do Projeto

Documento complementar ao guia canonico em [docs/arquitetura-atual.md](./arquitetura-atual.md).

## Visao geral

```text
frontend/
|-- docs/
|-- public/
|-- src/
|   |-- app/
|   |-- components/
|   |-- contexts/
|   |-- hooks/
|   |-- lib/
|   |-- pages/
|   |-- services/
|   |-- stores/
|   |-- types/
|   `-- utils/
|-- package.json
`-- tsconfig.json
```

## Diretorios principais

### `src/app`

Rotas do App Router e paginas legadas ainda em transicao. O fluxo ativo usa `API_V1_BASE_URL` para chamadas HTTP diretas.

### `src/components`

Componentes React reutilizaveis compartilhados entre paginas, layouts e fluxos de autenticacao, catalogo e pedidos.

### `src/contexts`

Contextos globais de aplicacao, especialmente autenticacao, empresa e carrinho.

### `src/hooks`

Hooks de composicao para leitura de sessao, estados locais e integracao com servicos.

### `src/lib`

Helpers compartilhados, base URL da API, utilitarios de autenticacao e compatibilidades legadas.

### `src/pages`

Fluxo Vite/React Router ainda presente no repositorio. E legado ativo em partes do workspace, mas nao deve ser tratado como fonte unica sem validar a rota em uso.

### `src/services`

Clientes HTTP e servicos de dominio. Preferir API principal; referencias a BFF/Appwrite nesses arquivos indicam legado em transicao.

### `src/stores`

Stores Zustand para carrinho, UI e estados persistidos.

### `src/types`

Tipos TypeScript compartilhados entre componentes, hooks e servicos.

### `src/utils`

Helpers pequenos de formatacao, autenticacao, parsing e suporte de UI.