znt/QWEN.md

禅道PMS контекст проекта

Взаимодействие

Всегда отвечайте на русском языке.

Обзор проекта

ZenTao PMS (система управления проектами) — это программное обеспечение с открытым исходным кодом, разработанное ZenTao Software (Циндао) Co., Ltd. Это первое в Китае开源 программное обеспечение для управления проектами, предназначенное для охвата основных процессов управления проектами, от управления продуктами и проектами до управления качеством, управления документацией, управления организацией и офисного управления.

Основные характеристики

• Построен на основе PHP-фреймворка ZenTao
• Поддерживает несколько методологий управления проектами: Scrum, Waterfall и Kanban
• Полный функционал включает управление продуктами, управление проектами, управление качеством, управление документацией
• Поддержка нескольких языков (китайский, английский, немецкий, французский и др.)
• Богатые модули включают визуализацию данных, метрики, DevOps, управление документами, автоматизированное тестирование
• Версия 21.7.5 (согласно файлу VERSION)

Архитектура

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/              # Корневая директория веб-сервера
└── README.md         # Документация проекта

Сборка и запуск

Предварительные требования

• PHP 8.1 или выше
• База данных MySQL
• Веб-сервер Apache или Nginx

Процесс сборки

Проект использует Makefile для сборки:

1. Очистка среды сборки: make clean
2. Сборка приложения: make или make all
3. Создание пакета: make package
4. Создание дистрибутива: make pms

Процесс сборки:

• Копирует необходимые файлы в директорию zentaopms
• Обрабатывает и сжимает ресурсы JavaScript/CSS
• Устанавливает соответствующие разрешения
• Создает дистрибутивные пакеты (ZIP, tar.xz)

Установка

1. Распакуйте дистрибутивный пакет в директорию веб-сервера
2. Настройте параметры базы данных в config/my.php (скопируйте из config/config.php)
3. Перейдите к веб-интерфейсу и следуйте инструкциям мастера установки
4. Если не установлено, система автоматически перенаправит на install.php

Запуск в среде разработки

1. Поместите исходный код в корневую директорию веб-сервера
2. Настройте веб-сервер для обслуживания PHP-файлов
3. Убедитесь, что следующие директории доступны для записи:
   • tmp/
   • www/data/
   • config/
   • extension/

Запуск в производственной среде

1. Соберите дистрибутивный пакет с помощью make pms
2. Распакуйте на производственном сервере
3. Установите соответствующие разрешения для директорий
4. Настройте подключение к базе данных в config/my.php
5. Получите доступ через веб-браузер для завершения установки

Конфигурация

Основная конфигурация

Основная конфигурация находится в config/config.php, важные настройки включают:

• Настройки подключения к базе данных
• Конфигурация маршрутизации запросов
• Настройки языка и темы оформления
• Настройки безопасности
• Ограничения на загрузку файлов

Пользовательская конфигурация

Создайте config/my.php для переопределения настроек по умолчанию:

• Скопируйте из config/config.php
• Измените настройки подключения к базе данных
• Отрегулируйте другие конфигурации по мере необходимости

Конфигурация базы данных

Таблицы базы данных определены как константы в config/zentaopms.php:

• Префикс таблиц: по умолчанию zt_
• Более 100 таблиц для различных функций
• Схема определена в db/zentao.sql

Правила разработки

Структура кода

• Следует 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}
• Пользовательские маршруты API могут быть определены в config/routes.php

Доступ к базе данных

• Использует пользовательский паттерн DAO (объект доступа к данным)
• Определен в lib/base/dao/
• Пример: $this->dao->select('*')->from(TABLE_USER)->where('id')->eq($id)->fetch()

Тестирование

• Тесты находятся в test/ в директориях модулей

Основные модули

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 и интеграции

• RESTful API через api.php
• Поддержка вебхуков для интеграции
• Поддержка GitLab, Gogs, Gitea, Jenkins, SonarQube
• Интеграция Xuanxuan для обмена сообщениями

Безопасность

• Валидация и фильтрация ввода
• Защита от XSS
• Защита от CSRF
• Предотвращение SQL-инъекций через DAO
• Ограничения на загрузку файлов

Интернационализация

• Поддержка нескольких языков, языковые файлы в /module/{module}/lang/
• Поддерживаемые языки: упрощенный китайский, традиционный китайский, английский, немецкий, французский, вьетнамский, японский, испанский, португальский, русский
• Выбор языка можно настроить в пользовательских предпочтениях