用途:在 Grey Haven 代码库中编写或审查代码时,应用其生产模板中的 TypeScript/React 与 Python/FastAPI 编码标准,也可用于修复 lint/格式化错误、从模板搭建新项目、配置 Prettier/ESLint/Ruff、创建数据库 schema 及实现多租户功能。
主要能力:提供 EXAMPLES.md(可复制示例)、REFERENCE.md(完整配置与规则说明)、templates/(起始文件)、checklists/(代码审查清单)等配套文档导航。
TypeScript/React(基于 cvi-template,TanStack Start + React 19):行宽 90,缩进 2 空格,双引号,必须分号,始终尾随逗号,ESLint 务实(允许 any 与未使用变量),路径别名 ~/ 映射 ./src/*。命名:变量/函数 camelCase,组件 PascalCase,常量 UPPER_SNAKE_CASE,类型/接口 PascalCase。
Python/FastAPI(基于 cvi-backend-template,FastAPI + SQLModel):行长 130,缩进 4 空格,所有函数必须有类型提示,Ruff 自动修复。命名:函数/变量 snake_case,类 PascalCase,常量 UPPER_SNAKE_CASE,布尔字段以 is_ 或 has_ 前缀。
数据库字段:两种语言 schema 中列名一律 snake_case,不可协商。多租户:每张表须含 tenant_id(DB 为 snake_case,TS 代码为 tenantId),UUID 外键指向 tenants 表,始终建索引,使用 RLS 策略,仓储模式所有查询按 tenant_id 过滤。
使用方式:Python 命令前必须先激活虚拟环境:source .venv/bin/activate,用于运行 pytest、pre-commit、task 命令及任何 Python 脚本。提交前运行 pre-commit 钩子。
限制:规范仅针对 Grey Haven 代码库与上述模板;其他项目是否适用暂未提供。具体配置内容需查阅 REFERENCE.md,本资料未完整列出。