sr-cardoso-frontend
Sr Cardoso的React/Vite/PWA前端。在编辑页面、组件、钩子、预约流程、管理员面板、API REST消费和移动优先UX时使用。
📖 中文导读:Sr Cardoso的React/Vite/PWA前端。在编辑页面、组件、钩子、预约流程、管理员面板、API REST消费和移动优先UX时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: sr-cardoso-frontend description: Frontend React/Vite/PWA do Sr Cardoso. Use quando editar paginas, componentes, hooks, fluxo de agendamento, painel admin, consumo de API REST e UX mobile-first.
Sr Cardoso Frontend
Overview
Executar tarefas no frontend web (cliente e admin) mantendo fluxo mobile-first, PT-BR e contratos com a API.
Entradas e rotas
- Partir de
apps/web/src/App.tsx(rotas) eapps/web/src/main.tsx. - Fluxo cliente:
apps/web/src/pages/BookingPage.tsx,apps/web/src/pages/SuccessPage.tsx,apps/web/src/pages/CancelBookingPage.tsx. - Fluxo admin: paginas em
apps/web/src/pages/admin/*.
API e dados
- Usar
apps/web/src/lib/api.tspara chamadas REST. - Usar
apps/web/src/lib/api-compat.tsapenas para compatibilidade legada. - Nao usar Firebase SDK no frontend.
Estado e storage
- Usar
apps/web/src/hooks/useBookingState.tsxpara estado do booking. - Respeitar chaves de storage:
sr-cardoso-booking-state,sr_admin_token,sr_remembered_customer. - Usar
apps/web/src/hooks/useAuth.tspara sessao admin.
Constantes e branding
- Usar
apps/web/src/utils/constants.tspara IDs, labels e timezone. - Usar
apps/web/src/hooks/useBranding.tspara logo e cache.
UI e UX
- Manter strings em PT-BR.
- Manter timezone
America/Sao_Paulo. - Respeitar regras de horario e schedule do barbeiro.
- Manter layout admin em
apps/web/src/components/admin/AdminLayout.tsx. - Manter indicador offline em
apps/web/src/components/OfflineIndicator.tsx.
PWA
- Ajustar manifest e assets em
apps/web/vite.config.ts.