# 交付项目管理系统

**Repository Path**: ai-smart-workshop/project-release-manager

## Basic Information

- **Project Name**: 交付项目管理系统
- **Description**: 产品发布项目管理系统
本系统面向需要跟踪已交付集成/部署项目版本迭代场景的团队，采用「产品 → 交付项目 → 迭代版本」三级数据模型，覆盖从产品建档、项目立项、版本发布到统计分析的全流程管理。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-28
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Product Release Manager

An internal system for tracking version iterations of delivered integration/deployment projects.

## Overview

The system uses a three-level data model — **Product → Delivery Project → Iteration Version** — covering the full workflow from product registration, project kick-off, version release, to statistics and reporting.

Core capabilities:

- **Product & project management** — maintain product catalogs, organize delivery projects by customer/owner, with status flow and search/filter
- **Version iteration tracking** — record planned and actual release progress for each project, distinguish version types and release status
- **Visual statistics** — version status distribution, release trends, and product comparison charts powered by ECharts
- **Operation audit** — every create/update/delete is logged for traceability

Designed to be lightweight and easy to deploy: embedded H2 database, fully localized static resources (works offline), single-JAR startup.

## Tech Stack

- **Backend**: Spring Boot 2.7.18 + Java 8 + MyBatis-Plus 3.5.5
- **Database**: H2 embedded file database (no installation required)
- **Frontend**: native HTML/CSS/JavaScript (no framework dependency)
- **Charts**: ECharts 5.5.0 (bundled locally)

## Requirements

- JDK 8+
- Maven 3.6+

## Quick Start

Development mode:

```bash
mvn spring-boot:run
```

Visit http://localhost:8080

Build and run:

```bash
mvn clean package -DskipTests
java -jar target/project-release-manager-1.0.0.jar
```

Default port is 8080 (configurable in `application.yml`).

## Default Account

| Username | Password |
|----------|----------|
| admin | admin123 |

Created automatically on first startup; change it in the User Management page.

## Data Storage

Data is stored in `data/release-manager.mv.db` under the working directory. Back up this file to back up all data.

## API

All endpoints are prefixed with `/api/v1/`:

| Endpoint | Description |
|----------|-------------|
| `POST /api/v1/users/login` | User login |
| `GET/POST/PUT/DELETE /api/v1/products` | Product management |
| `GET/POST/PUT/DELETE /api/v1/projects` | Project management |
| `GET/POST/PUT/DELETE /api/v1/versions` | Version management |
| `GET /api/v1/logs` | Operation logs |
| `GET /api/v1/statistics/overview` | Overview statistics |
| `GET /api/v1/statistics/products` | Product statistics |
| `GET /api/v1/statistics/versions/status` | Version status distribution |
| `GET /api/v1/statistics/versions/trend` | Version release trend |