Добавлен русский перевод README и контекста проекта

This commit is contained in:
mzhoot 2026-04-28 11:15:46 +03:00
parent 15fe67e028
commit 371140ce3d

258
QWEN.md
View file

@ -1,183 +1,183 @@
# 禅道PMS项目上下文 # 禅道PMS контекст проекта
## 交互 ## Взаимодействие
始终用中文回复。 Всегда отвечайте на русском языке.
## 项目概述 ## Обзор проекта
禅道PMS项目管理系统是由禅道软件青岛有限公司开发的开源项目管理软件。它是中国第一个开源项目管理软件旨在覆盖从产品和项目管理到质量管理、文档管理、组织管理和办公管理的主要项目管理流程。 ZenTao PMS (система управления проектами) — это программное обеспечение с открытым исходным кодом, разработанное ZenTao Software (Циндао) Co., Ltd. Это первое в Китае开源 программное обеспечение для управления проектами, предназначенное для охвата основных процессов управления проектами, от управления продуктами и проектами до управления качеством, управления документацией, управления организацией и офисного управления.
### 主要特性 ### Основные характеристики
- 基于禅道PHP框架构建 - Построен на основе PHP-фреймворка ZenTao
- 支持多种项目管理方法论Scrum、瀑布和看板 - Поддерживает несколько методологий управления проектами: Scrum, Waterfall и Kanban
- 全面的功能包括产品管理、项目管理、质量管理、文档管理 - Полный функционал включает управление продуктами, управление проектами, управление качеством, управление документацией
- 多语言支持(中文、英文、德语、法语等) - Поддержка нескольких языков (китайский, английский, немецкий, французский и др.)
- 丰富的模块包括数据可视化、度量、DevOps、文档资产管理、自动化测试 - Богатые модули включают визуализацию данных, метрики, DevOps, управление документами, автоматизированное тестирование
- 版本21.7.5根据VERSION文件 - Версия 21.7.5 (согласно файлу VERSION)
### 架构 ### Архитектура
禅道采用模块化MVC架构 ZenTao использует модульную MVC-архитектуру:
- **框架**:位于`/framework`的自定义PHP框架 - **Фреймворк**: пользовательский PHP-фреймворк, расположенный в `/framework`
- **模块**:位于`/module`的功能模块(如产品、项目、执行、缺陷、任务等) - **Модули**: функциональные модули в `/module` (например, продукт, проект, исполнение, дефект, задача и т.д.)
- **数据库**基于MySQL模式在`/db/zentao.sql`中定义 - **База данных**: на основе MySQL, схема определена в `/db/zentao.sql`
- **Web界面**:位于`/www`的基于PHP的Web应用程序 - **Веб-интерфейс**: веб-приложение на PHP, расположенное в `/www`
- **配置**:位于`/config`的集中配置 - **Конфигурация**: централизованная конфигурация в `/config`
## 项目结构 ## Структура проекта
``` ```
zentaopms/ zentaopms/
├── api/ # API相关文件 ├── api/ # Файлы, связанные с API
├── bin/ # 可执行二进制文件/脚本 ├── bin/ # Исполняемые двоичные файлы/скрипты
├── config/ # 配置文件 ├── config/ # Файлы конфигурации
├── db/ # 数据库模式文件 ├── db/ # Файлы схемы базы данных
├── doc/ # 文档 ├── doc/ # Документация
├── extension/ # 扩展模块 ├── extension/ # Расширения
├── framework/ # 核心框架文件 ├── framework/ # Основные файлы фреймворка
├── lib/ # 库文件 ├── lib/ # Библиотеки
├── misc/ # 杂项文件 ├── misc/ # Различные файлы
├── module/ # 应用模块 ├── module/ # Модули приложения
├── sdk/ # 软件开发工具包 ├── sdk/ # Комплекты для разработки ПО
├── tmp/ # 临时文件 ├── tmp/ # Временные файлы
├── www/ # Web根目录 ├── www/ # Корневая директория веб-сервера
└── README.md # 项目文档 └── README.md # Документация проекта
``` ```
## 构建和运行 ## Сборка и запуск
### 先决条件 ### Предварительные требования
- PHP 8.1或更高版本 - PHP 8.1 или выше
- MySQL数据库 - База данных MySQL
- Apache或Nginx Web服务器 - Веб-сервер Apache или Nginx
### 构建过程 ### Процесс сборки
项目使用Makefile进行构建 Проект использует Makefile для сборки:
1. **清理构建环境**`make clean` 1. **Очистка среды сборки**: `make clean`
2. **构建应用程序**`make`或`make all` 2. **Сборка приложения**: `make` или `make all`
3. **创建包**`make package` 3. **Создание пакета**: `make package`
4. **创建分发版**`make pms` 4. **Создание дистрибутива**: `make pms`
构建过程: Процесс сборки:
- 将必要文件复制到`zentaopms`目录 - Копирует необходимые файлы в директорию `zentaopms`
- 处理和压缩JavaScript/CSS资源 - Обрабатывает и сжимает ресурсы JavaScript/CSS
- 设置适当权限 - Устанавливает соответствующие разрешения
- 创建分发包ZIP、tar.xz - Создает дистрибутивные пакеты (ZIP, tar.xz)
### 安装 ### Установка
1. 将分发包解压到Web服务器目录 1. Распакуйте дистрибутивный пакет в директорию веб-сервера
2. 在`config/my.php`中配置数据库设置(从`config/config.php`复制) 2. Настройте параметры базы данных в `config/my.php` (скопируйте из `config/config.php`)
3. 访问Web界面并按照安装向导操作 3. Перейдите к веб-интерфейсу и следуйте инструкциям мастера установки
4. 如果未安装,系统将自动重定向到`install.php` 4. Если не установлено, система автоматически перенаправит на `install.php`
### 开发环境运行 ### Запуск в среде разработки
1. 将源代码放置在Web服务器的文档根目录中 1. Поместите исходный код в корневую директорию веб-сервера
2. 配置Web服务器以服务PHP文件 2. Настройте веб-сервер для обслуживания PHP-файлов
3. 确保以下目录可写: 3. Убедитесь, что следующие директории доступны для записи:
- `tmp/` - `tmp/`
- `www/data/` - `www/data/`
- `config/` - `config/`
- `extension/` - `extension/`
### 生产环境运行 ### Запуск в производственной среде
1. 使用`make pms`构建分发包 1. Соберите дистрибутивный пакет с помощью `make pms`
2. 解压到生产服务器 2. Распакуйте на производственном сервере
3. 设置目录的适当权限 3. Установите соответствующие разрешения для директорий
4. 在`config/my.php`中配置数据库连接 4. Настройте подключение к базе данных в `config/my.php`
5. 通过Web浏览器访问以完成安装 5. Получите доступ через веб-браузер для завершения установки
## 配置 ## Конфигурация
### 主配置 ### Основная конфигурация
主配置在`config/config.php`中,重要设置包括: Основная конфигурация находится в `config/config.php`, важные настройки включают:
- 数据库连接设置 - Настройки подключения к базе данных
- 请求路由配置 - Конфигурация маршрутизации запросов
- 语言和主题设置 - Настройки языка и темы оформления
- 安全设置 - Настройки безопасности
- 文件上传限制 - Ограничения на загрузку файлов
### 自定义配置 ### Пользовательская конфигурация
创建`config/my.php`来覆盖默认设置: Создайте `config/my.php` для переопределения настроек по умолчанию:
- 从`config/config.php`复制 - Скопируйте из `config/config.php`
- 修改数据库连接设置 - Измените настройки подключения к базе данных
- 根据需要调整其他配置 - Отрегулируйте другие конфигурации по мере необходимости
### 数据库配置 ### Конфигурация базы данных
数据库表在`config/zentaopms.php`中定义为常量: Таблицы базы данных определены как константы в `config/zentaopms.php`:
- 表前缀:默认为`zt_` - Префикс таблиц: по умолчанию `zt_`
- 超过100个表用于不同功能 - Более 100 таблиц для различных функций
- 模式在`db/zentao.sql`中定义 - Схема определена в `db/zentao.sql`
## 开发规范 ## Правила разработки
### 代码结构 ### Структура кода
- 遵循MVC模式包含模型、视图和控制器 - Следует MVC-паттерну с моделями, представлениями и контроллерами
- 模块组织在`/module/{module}/`目录中 - Модули организованы в директориях `/module/{module}/`
- 每个模块通常包含: - Каждый модуль обычно содержит:
- `model.php`:业务逻辑 - `model.php`: бизнес-логика
- `control.php`:控制器动作 - `control.php`: действия контроллера
- `view/`:模板文件 - `view/`: файлы шаблонов
- `lang/`:语言文件 - `lang/`: языковые файлы
- `js/`模块特定的JavaScript - `js/`: JavaScript для конкретного модуля
- `css/`模块特定的CSS - `css/`: CSS для конкретного модуля
### 路由 ### Маршрутизация
- 默认路由:`index.php?m={module}&f={method}` - Маршрут по умолчанию: `index.php?m={module}&f={method}`
- PATH_INFO路由`index.php/{module}-{method}` - Маршрутизация PATH_INFO: `index.php/{module}-{method}`
- 可在`config/routes.php`中自定义API路由 - Пользовательские маршруты API могут быть определены в `config/routes.php`
### 数据库访问 ### Доступ к базе данных
- 使用自定义DAO数据访问对象模式 - Использует пользовательский паттерн DAO (объект доступа к данным)
- 定义在`lib/base/dao/`中 - Определен в `lib/base/dao/`
- 示例:`$this->dao->select('*')->from(TABLE_USER)->where('id')->eq($id)->fetch()` - Пример: `$this->dao->select('*')->from(TABLE_USER)->where('id')->eq($id)->fetch()`
### 测试 ### Тестирование
- 测试位于模块目录下的`test/`中 - Тесты находятся в `test/` в директориях модулей
## 主要模块 ## Основные модули
禅道具有广泛的模块结构: ZenTao имеет обширную модульную структуру:
- **产品管理**product、story、productplan、release - **Управление продуктами**: product, story, productplan, release
- **项目管理**project、execution、task、build - **Управление проектами**: project, execution, task, build
- **质量管理**bug、testcase、testtask、testsuite - **Управление качеством**: bug, testcase, testtask, testsuite
- **文档管理**doc、doclib - **Управление документацией**: doc, doclib
- **组织管理**company、dept、user、group - **Управление организацией**: company, dept, user, group
- **DevOps**repo、job、compile、mr - **DevOps**: repo, job, compile, mr
- **报表**report、pivot、chart - **Отчеты**: report, pivot, chart
- **管理**admin、custom、extension - **Администрирование**: admin, custom, extension
## API和集成 ## API и интеграции
- 通过`api.php`提供RESTful API - RESTful API через `api.php`
- Webhooks支持集成 - Поддержка вебхуков для интеграции
- 支持GitLab、Gogs、Gitea、Jenkins、SonarQube - Поддержка GitLab, Gogs, Gitea, Jenkins, SonarQube
- Xuanxuan集成用于消息传递 - Интеграция Xuanxuan для обмена сообщениями
## 安全 ## Безопасность
- 输入验证和过滤 - Валидация и фильтрация ввода
- XSS防护 - Защита от XSS
- CSRF防护 - Защита от CSRF
- 通过DAO防止SQL注入 - Предотвращение SQL-инъекций через DAO
- 文件上传限制 - Ограничения на загрузку файлов
## 国际化 ## Интернационализация
- 多语言支持,语言文件在`/module/{module}/lang/`中 - Поддержка нескольких языков, языковые файлы в `/module/{module}/lang/`
- 支持的语言:简体中文、繁体中文、英文、德语、法语、越南语、日语、西班牙语、葡萄牙语 - Поддерживаемые языки: упрощенный китайский, традиционный китайский, английский, немецкий, французский, вьетнамский, японский, испанский, португальский, русский
- 语言选择可在用户偏好中配置 - Выбор языка можно настроить в пользовательских предпочтениях