saveinmed/frontend/docs/estrutura.md

Estrutura do Projeto

Documento complementar ao guia canonico em docs/arquitetura-atual.md.

Visao geral

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.