快速开始

5 分钟启动开发环境，开始使用 TSystems 开发你的产品。

最小环境要求

Node.js：v22.18.0+（原生支持 TypeScript，无需编译）
数据库：MySQL / MariaDB 数据库

1. 克隆项目

bash

git clone <仓库地址>
cd systems

2. 配置环境变量

项目根目录下有以下环境文件：

文件	用途
`.env`	基础环境变量（数据库、密钥等）
`.env.int`	集成环境配置
`.env.pre`	预发布环境配置
`.env.production`	生产环境配置

确保 .env 中的数据库配置正确：

text

# 数据库配置示例
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=systems

3. 安装依赖

bash

npm run ready

4. 创建你的第一个产品 SPA 应用

在 apps/ 下创建新的 SPA 应用（假定目录名为 example）
执行 npm run dev，然后本地访问 http://localhost:9000/example 即可访问到新建的 SPA 应用。
在 src/models/ 中定义数据表结构
在 typings/ 中定义类型
在 migrations/ 中创建数据库迁移文件
在 src/services/ 中编写业务逻辑
在 src/controllers/ 中创建控制器
在 src/routes/ 中注册新路由
执行 npm run lint 进行代码检测
执行 npm run buildAndDeploy 发布到正式环境
访问 https://www.<你的域名.com>/example 即可访问 SPA 应用

5. 创建产品落地页应用

在 apps-home/ 目录下创建同名（这里是 example）的产品落地页 SSG 应用
执行 cross-env TASKS=ssg:example node --run dev 开始开发
执行 npm run lint 进行代码检测
执行 npm run buildAndDeploy:ssg 发布落地页应用
访问 https://example.<你的域名.com> 即可访问到产品落地页 SSG 应用（需要对应的域名解析）