# 快速开始 ## 环境要求 - Node.js 18+ - npm / yarn / pnpm / bun - Git ## 安装步骤 ### 1. 克隆项目 ```bash git clone cd novalon-website ``` ### 2. 安装依赖 ```bash npm install ``` ### 3. 配置环境变量 ```bash cp .env.example .env.local ``` 编辑`.env.local`文件，配置必要的环境变量： ```env # 数据库 DATABASE_URL=file:./data/dev.db # NextAuth NEXTAUTH_SECRET=your-secret-key-here NEXTAUTH_URL=http://localhost:3000 # 管理员 ADMIN_EMAIL=admin@novalon.cn ADMIN_PASSWORD=your-secure-password # 邮件服务（可选） RESEND_API_KEY=your_resend_api_key COMPANY_EMAIL=contact@novalon.cn # 站点URL NEXT_PUBLIC_SITE_URL=http://localhost:3000 ``` ### 4. 初始化数据库 ```bash npm run db:push npm run db:seed ``` ### 5. 启动开发服务器 ```bash npm run dev ``` 访问 http://localhost:3000 ## 项目结构 ``` novalon-website/ ├── src/ # 源代码 │ ├── app/ # Next.js App Router │ ├── components/ # React组件 │ ├── lib/ # 工具函数 │ ├── db/ # 数据库 │ ├── hooks/ # 自定义Hooks │ └── contexts/ # React Context ├── e2e/ # E2E测试 ├── docs/ # 项目文档 ├── scripts/ # 脚本文件 ├── config/ # 配置文件 ├── public/ # 静态资源 └── package.json # 项目配置 ``` ## 开发指南 ### 代码规范项目使用ESLint和TypeScript进行代码检查： ```bash npm run lint # 代码检查 npm run type-check # 类型检查 ``` ### 测试运行测试： ```bash npm run test # 运行E2E测试 npm run test:smoke # 运行冒烟测试 npm run test:unit # 运行单元测试 ``` ### 代码质量门禁项目配置了自动化质量门禁，确保代码提交前通过所有质量检查。 #### 质量检查 - **代码风格检查**: ESLint - **提交信息规范**: commitlint - **代码覆盖率检查**: Jest #### 提交规范使用Conventional Commits规范： ``` ():