# gensource-w5

**Repository Path**: bundle/gensource-w5

## Basic Information

- **Project Name**: gensource-w5
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-02
- **Last Updated**: 2026-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 上海景点查询系统

本项目是一个前后端分离的上海景点查询和管理系统。

## 技术栈
- **前端 (`lab2-client`)**: React, TypeScript, Vite, Tailwind CSS, React Router
- **后端 (`lab2-server`)**: Node.js, Express, TypeScript, Prisma ORM, SQLite

## 目录结构
```text
.
├── lab2-client/        # 前端代码目录
├── lab2-server/        # 后端代码目录
├── data/               # 初始数据和图片资源
└── package.json        # 根目录环境配置脚本
```

## 环境要求
- Node.js (推荐 v18 或以上)
- npm

## 配置说明

由于项目中集成了基于大模型（Kimi）的“AI 自然语言查询”功能，以及其他的敏感配置，这些信息需要通过 `.env` 环境变量文件进行配置。`.env` 文件已被 `.gitignore` 忽略，因此其他开发人员在获取代码后需要手动创建。

1. 进入后端目录：
   ```bash
   cd lab2-server
   ```
2. 根据模板文件创建 `.env` 文件：
   ```bash
   cp .env.example .env
   ```
3. 打开 `.env` 文件，将 `MOONSHOT_API_KEY` 的值替换为您真实的 Kimi API Key（您可以在 [Moonshot 开放平台](https://platform.moonshot.cn/) 获取）。

## 测试环境快速启动指南

在项目根目录下执行以下步骤：

1. **依赖安装**
   该命令会同时安装根目录、前端和后端的依赖。
   ```bash
   npm run install:all
   ```

2. **数据库初始化**
   该命令会在后端生成 Prisma 客户端、运行数据库迁移，并自动填充测试数据（`seed`）。
   ```bash
   npm run db:setup
   ```

3. **启动应用**
   使用 `concurrently` 同时启动前端和后端开发环境。
   ```bash
   npm run dev
   ```

## 生产环境部署指南
> **TODO:** 待后续补充生产环境的构建与启动脚本说明。

## 后台管理账户信息
默认在 `db:setup` 时会创建以下初始管理员账户：
- **邮箱**: `admin@example.com`
- **密码**: `admin123`

### 如何修改管理员密码
如果需要重置或修改管理员密码，请进入 `lab2-server` 目录并执行相关脚本：
```bash
cd lab2-server
npx tsx scripts/reset-admin-password.ts <新密码>
```
*(注意：请将 `<新密码>` 替换为你想要设置的实际密码。)*

## 开发规范说明
1. **端口约定**: 在开发过程中，服务端和客户端使用的端口号必须保持不变。
   - **服务端**: 运行在 `3000` 端口
   - **客户端**: 运行在 `5173` 端口
2. **端口冲突**: 如果启动时发现端口被占用，请强制关闭占有端口的程序再试。