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