name	best-practices
description	使用本仓库开发的最佳实践汇总，前后端都包含，在开发任何任务（代码开发）之前都需要参考该文档，做产品设计不需要参考该文档。
metadata	{"author":"blesstosam","version":"2026.04.06"}

页面样式实现遵循 Tailwind-first：优先使用 Tailwind utility class，仅在必要场景使用 <style scoped>（详见 references/tailwind-first.md）
如果要使用ant-design-vue里的组件，需要显示的引入，如import { Avatar } from 'ant-design-vue'
完成一个页面页面后，使用 critique skill 对刚实现的页面进行一次评估，如果有优化的地方根据优化点修复一版（只做一轮修复）
使用Vue3写前端逻辑的流程建议：先使用composables函数写数据逻辑，再写前端模板表达UI，最后组件引入composables函数把数据绑定到模板视图，组件里尽量不要处理业务逻辑
后端返回的时间为UTC时间，必须统一显示为东八区YYYY-MM-DD HH:mm:ss格式，禁止直接渲染toISOString()这类包含T/Z的UTC原始串

使用schema.prisma定义数据库模型
数据库字段使用下划线命名法，如created_time，映射到orm的字段要使用驼峰法，如createdTime
schema.prisma 里已定义的枚举，TypeScript 代码必须直接复用 Prisma 生成导出的 const/type（如 server/src/generated/prisma/client 或 enums），禁止在 TS 里重复定义同值常量或类型

Topic	Description	Reference
安装依赖	安装依赖遵循的规范	install-dep
图标选择	当前端仓库需要使用图标，包含图标库的选择、图标的选择、搜索	icon-suggest
ant-design-vue 组件库使用	ant-design-vue 组件库使用规范与决策指引	ant-design-vue
使用 Tailwind-first 原则	前端页面样式 Tailwind-first 约束与例外边界	tailwind-first
前端组件和逻辑拆分原则	Vue3 SFC(Single File Component)拆分最佳实践	vue-sfc-split
后端事务与批量写入、性能优化	事务内避免耗时操作、批处理导入与连接池保护规范	backend-transaction-batch-write
后端 Schema / DTO 约定	业务模块间 schema 复用、list schema、create schema、update schema 约定	backend-schema-dto