66 lines
1.6 KiB
Markdown
66 lines
1.6 KiB
Markdown
# 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.
|