GitDiagram 使用教程
1. 项目目录结构及介绍
GitDiagram项目的目录结构如下:
gitdiagram/
├── .github/
├── backend/
│ ├── app/
│ ├── docker-compose.yml
│ └── start-database.sh
├── docs/
├── public/
├── src/
│ ├── components.json
│ ├── docker-compose.yml
│ ├── drizzle.config.ts
│ ├── next.config.js
│ ├── package.json
│ ├── pnpm-lock.yaml
│ ├── postcss.config.js
│ ├── prettier.config.js
│ ├── start-database.sh
│ ├── tailwind.config.ts
│ └── tsconfig.json
├── .env.example
├── LICENSE
├── README.md
└── ...
.github/
:存放GitHub Actions相关的配置文件。backend/
:后端代码目录,包含FastAPI应用。docs/
:文档目录,可用于存放项目文档。public/
:公共静态文件目录。src/
:源代码目录,包含前端代码。.env.example
:环境变量配置文件示例。LICENSE
:项目许可证文件。README.md
:项目说明文件。
2. 项目的启动文件介绍
后端启动
后端使用Docker容器启动,位于backend/
目录下的docker-compose.yml
文件定义了服务。
启动后端服务的命令:
docker-compose up --build -d
启动数据库的命令:
chmod +x start-database.sh
./start-database.sh
前端启动
前端使用pnpm进行管理,位于src/
目录下的package.json
定义了启动脚本。
启动前端的命令:
pnpm dev
启动后,前端将在localhost:3000
上运行。
3. 项目的配置文件介绍
环境变量配置
项目使用.env.example
文件作为环境变量配置的示例。在实际部署时,需要将.env.example
复制为.env
文件,并根据实际情况填写相应的环境变量。
环境变量包括但不限于:
ANTHROPIC_API_KEY
:Anthropic API密钥。GITHUB_TOKEN
:GitHub个人访问令牌(如果需要访问私有仓库)。
前端配置
前端配置文件主要位于src/
目录下,以下是几个重要的配置文件:
next.config.js
:Next.js的配置文件。tailwind.config.ts
:Tailwind CSS的配置文件。postcss.config.js
:PostCSS的配置文件。
后端配置
后端配置文件主要位于backend/
目录下,以下是几个重要的配置文件:
docker-compose.yml
:定义了后端服务的Docker容器配置。drizzle.config.ts
:Drizzle ORM的配置文件。
确保在修改任何配置文件后,重新启动相应的服务以应用更改。