# sample-opencode

**Repository Path**: pulind/sample-opencode

## Basic Information

- **Project Name**: sample-opencode
- **Description**: 这是一个opencode编程样例
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-23
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# sample-project

最小入口：

- 开发规范（唯一来源）：`AGENTS.md`
- 项目文档：见本文「项目文档（docs/）」

## 项目文档（docs/）

> 说明：`docs/` 用于存放项目过程相关文档（需求记录、设计、验证证据、回滚方案等）；开发规范请参考 `AGENTS.md`。

### 目录

- `docs/inbox/`：原始需求与输入
- `docs/registry/`：编号索引表（R/F/B）
- `docs/modules/`：模块与领域设计
- `docs/features/`：Feature 交付单元（设计/验证/证据）
- `docs/bugs/`：Bug 修复单元（复现/根因/修复/证据）
- `docs/gate/releases/`：上线证据快照
- `docs/rollback/`：回滚与安全网

### 常用入口

- 需求索引：`docs/registry/requirements.md`
- Feature 索引：`docs/registry/features.md`
- Bug 索引：`docs/registry/bugs.md`
- Releases：`docs/gate/releases/`
- Feature 模板：`docs/features/TEMPLATE/`
- Bug 模板：`docs/bugs/TEMPLATE/`

## 运行

### 后端

```bash
cd backend
mvn test
mvn spring-boot:run
```

示例接口：`GET http://localhost:8080/api/health`

示例数据接口（MyBatis Plus + H2）：`GET http://localhost:8080/api/demo-users/1`

### 前端

```bash
cd frontend
npm install
npm run dev
```

前端环境依赖：Node.js（建议 LTS）与 npm。

开发时 `/api` 代理到 `VITE_API_BASE_URL`（默认 `http://localhost:8080`）。

## 启动脚本

- 后端：`scripts/backend-dev.sh` 或 `scripts/backend-dev.cmd`
- 前端：`scripts/frontend-dev.sh` 或 `scripts/frontend-dev.cmd`
- 联调一键启动：`scripts/dev.sh` 或 `scripts/dev.cmd`