SuperAPI AI 工具集

project-structure

编程与开发

查看项目

更新于 10-16 05:50

技能介绍

用途:该技能定义 Grey Haven Studio 的标准化项目结构,供创建新项目、整理既有项目文件、重构目录布局、决定新文件放置位置以及新人了解项目规范时使用。

主要能力:前端基于 cvi-template(TanStack Start、React 19、Drizzle、Better-auth),约定 src/routes 文件式路由、src/lib 下的 components、server、config、middleware、hooks、utils、types,以及 migrations 与 tests(unit、integration、e2e)。后端基于 cvi-backend-template(FastAPI、SQLModel、Alembic),约定 app 下 routers、services、db(models、repositories、session)、schemas、middleware、core、utils,以及 tests、alembic、Taskfile.yml 等。

必要用法与约定:TypeScript 导入始终使用 ~/* 路径别名;前端组件用 PascalCase,路由用小写加连字符,服务端函数用 camelCase,数据库 schema 字段用 snake_case。组件内部顺序为导入、类型、组件、状态钩子、查询、事件处理器、JSX。后端模块用 snake_case,模型类用 PascalCase,测试文件加 test_ 前缀;导入顺序为标准库、第三方、本地。仓库层包含 tenant_id 过滤以实现租户隔离,分层为 Routers → Services → Repositories → Models。

限制:文中仅说明本地开发环境变量以 .env / .env.example 管理、配置使用 Doppler,未提供具体安装与运行命令、依赖版本或部署步骤;价格、收费与平台支持情况暂未提供。