# zhuatech-devops

**Repository Path**: zhuatech/zhuatech-devops

## Basic Information

- **Project Name**: zhuatech-devops
- **Description**: 知华科技企业级 DevOps 开源平台 · 上海如静知华信息科技有限公司 · https://www.zhuatech.cn/
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[简体中文](README.md) | **English**

## Update: business batch validation

An authenticated CSV preflight workspace now validates the project-specific contract, duplicate business keys and cross-field rules. It reports physical row numbers, supports templates, and escapes spreadsheet formulas on export. Decimal values remain strings. This is read-only: it does **not** import records, approve transactions or certify the complete application for production. See [the field contract and API guide](docs/BATCH-PREFLIGHT.md).

# ZhuaTech DEVOPS

> A source-available enterprise project by [ZhuaTech](https://www.zhuatech.cn/en.html) for developer productivity, integration, automation, and platform operations.

ZhuaTech DEVOPS provides a practical, self-hosted foundation for developer productivity, integration, automation, and platform operations. It is designed for engineering, integration, platform, QA, and operations teams, with clear business records, controlled workflows, operational visibility, and auditable actions.

This repository is intended for learning, technical evaluation, and non-commercial collaboration. The included implementation, tests, database resources, and container configuration provide a reproducible starting point for further enterprise adaptation.

**Search topics:** enterprise devops, self-hosted devops, Java Spring Boot enterprise software, digital transformation.


## Update: Canary error-rate delta and sample floor

This release adds an authenticated, structured batch workspace at `/operations.html`, backed by project-specific deterministic calculations, explicit validation, explainable decisions, and CSV/JSON exports. Decimal values are preserved exactly; no external model call is made.

Results are **read-only decision support**, not approvals or posted transactions. The feature does not send payments, sign contracts, destroy records, or control devices, and does not certify the whole application for production. See [the calculation contract and API guide](docs/OPERATIONS-REVIEW.md).
## Solution Overview

- **Primary users:** Engineering, integration, platform, QA, and operations teams.
- **Deployment model:** Self-hosted, with container-based local deployment where supported.
- **Governance baseline:** Role-aware operations, validation, approval boundaries, exception handling, and auditability.
- **Production boundary:** Review security, identity, backup, observability, capacity, and compliance controls before production use.

## Business Coverage

- **Governed workspace and configuration** — Manage governed workspace and configuration with ownership, validation, and explicit lifecycle states.
- **Execution and automation workflows** — Coordinate execution and automation workflows through controlled workflows and approval gates.
- **Validation, testing, and quality gates** — Track validation, testing, and quality gates metrics, exceptions, deadlines, and follow-up actions.
- **Environment and release controls** — Preserve environment and release controls evidence in searchable, traceable operational history.
- **Metrics, logs, and operational evidence** — Expose metrics, logs, and operational evidence in role-aware user and administration workspaces.
- **Extensible API and connector boundaries** — Connect extensible api and connector boundaries to external systems through configurable integration boundaries.

## Implementation Stack

**Technology stack:** Java 21 · Spring Boot · Vue 3 · Vite · MySQL 8 · Docker Compose

### Repository Layout

- `backend/` — Java backend, domain services, APIs, validation, and automated tests
- `frontend/` — responsive user and administration interfaces
- `docs/` — architecture, operations, screenshots, and supporting documentation
- `compose.yaml` — local multi-service orchestration

## Local Deployment

```bash
docker compose up -d --build
```

- Review `compose.yaml` before changing published ports, storage paths, or production credentials.

## Verification

Run the checks supported by this repository before changing or deploying it:

```bash
cd backend && mvn test
cd frontend && npm ci && npm run build
```

## Interface Preview

### Product Overview

![Product Overview](docs/images/product-overview.svg)

### Workflow

![Workflow](docs/images/workflow.svg)

## Security and Production Readiness

- Never commit real passwords, API keys, tokens, certificates, customer data, or production connection strings.
- Replace all local demonstration credentials and secrets before deployment.
- Apply least privilege, tenant isolation, backup and restore drills, monitoring, rate limiting, and vulnerability management.
- Please report security issues privately through the contact channels below instead of publishing sensitive details.

## Usage and Commercial Licensing

Copyright © 2026 Shanghai Rujing Zhihua Information Technology Co., Ltd.

This project is a publicly available source edition intended solely for personal learning, technical research, and non-commercial communication. Commercial use, paid delivery, resale, hosted commercial services, and commercial derivative distribution require prior written authorization from the copyright holder.

Third-party dependencies remain subject to their respective licenses. Review the repository `LICENSE` and `NOTICE` files before use.

## Commercial Licensing and Enterprise Services

For commercial licensing, private deployment, enterprise customization, software outsourcing, implementation services, FDE outsourcing, OPC technical support, or AI transformation consulting, contact ZhuaTech:

- Email: [han@zhuatech.cn](mailto:han@zhuatech.cn)
- Email: [jack@zhuatech.cn](mailto:jack@zhuatech.cn)
- [WhatsApp: +86 17521234993](https://wa.me/8617521234993)
- Website: [https://www.zhuatech.cn/en.html](https://www.zhuatech.cn/en.html)

## About ZhuaTech

[ZhuaTech](https://www.zhuatech.cn/en.html) is operated by Shanghai Rujing Zhihua Information Technology Co., Ltd. We support small and medium-sized enterprises with digital transformation, AI adoption, enterprise software implementation, custom development, software project outsourcing, FDE services, OPC integration, and long-term technical support.