Добавлен русский перевод README и контекста проекта
This commit is contained in:
parent
15fe67e028
commit
371140ce3d
258
QWEN.md
258
QWEN.md
|
|
@ -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/`
|
||||||
- 支持的语言:简体中文、繁体中文、英文、德语、法语、越南语、日语、西班牙语、葡萄牙语
|
- Поддерживаемые языки: упрощенный китайский, традиционный китайский, английский, немецкий, французский, вьетнамский, японский, испанский, португальский, русский
|
||||||
- 语言选择可在用户偏好中配置
|
- Выбор языка можно настроить в пользовательских предпочтениях
|
||||||
Loading…
Reference in a new issue