saveinmed/frontend/docs/estrutura.md

Estrutura do Projeto

Este documento apresenta a árvore de diretórios do repositório e a responsabilidade de cada pasta.

Visão Geral

.
├── .env.example
├── README-old.md
├── README.md
├── docs/
│   ├── CODEX_STYLE_GUIDE.md
│   ├── codigo_completo.md
│   ├── collections/
│   └── estrutura.md
├── eslint.config.mjs
├── next-env.d.ts
├── next.config.ts
├── package-lock.json
├── package.json
├── postcss.config.mjs
├── public/
│   ├── file.svg
│   ├── globe.svg
│   ├── next.svg
│   ├── vercel.svg
│   └── window.svg
├── src/
│   ├── app/
│   ├── components/
│   ├── hooks/
│   ├── lib/
│   ├── modules/
│   ├── services/
│   └── styles/
└── tsconfig.json

Diretórios Principais

src/app

• Páginas: cada subpasta representa uma rota do App Router.
• API: dentro de src/app/api ficam as API Routes em Edge Runtime.
• layout.tsx: layout raiz usado em todas as páginas.

src/components

Componentes React compartilhados entre as páginas. Utilize PascalCase para os nomes de arquivos.

src/hooks

Hooks responsáveis por consumir os serviços e manipular estado local.

src/lib

Inicialização do SDK do Appwrite e outras bibliotecas externas.

src/modules

Funcionalidades escritas com o antigo Pages Router (ex.: módulo de faturas).

src/services

Abstrações de acesso ao Appwrite. Cada serviço implementa operações CRUD da respectiva coleção.

Convenções

• Componentes em src/components devem seguir PascalCase.tsx.
• Páginas e rotas usam nomes em kebab-case.
• Variáveis de ambiente obrigatórias estão listadas em .env.example.

Última atualização: 2025-07-15