мета-данные страницы
Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия Следующая версия Следующая версия справа и слева | ||
|
документация_агбис [13.01.2020 10:25] Анисютин |
документация_агбис [16.04.2020 10:38] void [Использование Wiki] |
||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| - | ====== Документация в системе АГБИС ====== | + | ====== Документация Компании АГБИС ====== |
| ===== Принципы документирования ===== | ===== Принципы документирования ===== | ||
| Строка 9: | Строка 9: | ||
| ===== Основные понятия ===== | ===== Основные понятия ===== | ||
| + | **Проект** - это обособленный набор услуг, программных модулей или товаров, которые компания предоставляет своим клиентам.\\ | ||
| **База данных** - это средство описания некоторых бизнес процессов.\\ | **База данных** - это средство описания некоторых бизнес процессов.\\ | ||
| - | **Проект** - это отдельный программный модуль для выполнения группы бизнес процессов.\\ | ||
| **Документацией базы данных** называется совокупность документов, описывающих настройку и выполнение бизнес процессов.\\ | **Документацией базы данных** называется совокупность документов, описывающих настройку и выполнение бизнес процессов.\\ | ||
| + | **Сотрудник компании** - работник компании, в том числе сотрудник технической поддержки или программист.\\ | ||
| + | **Партнер компании** - сторонняя организация, имеющая партнерские договоренности с нашей компанией на выполнение каких-то услуг нашим клиентам или поставку им товаров.\\ | ||
| + | **Администратор** - работник организации клиента или сторонний специалист (в том числе сотрудник компании-партнера), выполняющий функции настройки и администрирования проектов.\\ | ||
| - | ===== Документация бизнес процесса ===== | ||
| - | |||
| - | **[[руководство_пользователя|Руководство пользователя]]** - документация, которая помогает пользователю выполнить бизнес процесс в раках настроенной системы.\\ | ||
| - | **[[:руководство_администратора|Руководство администратора]]** - документация, которая помогает администратору системы выполнить настройку системы.\\ | ||
| - | **[[:руководство_тп|Руководство технической поддержки]]** - документация, которая доступна сотрудникам технической поддержки компании АГБИС, но недоступна администраторам клиентов.\\ | ||
| - | **[[:руководство_разработчика|Руководство разработчика]]** - документация, которая помогает разработчику дорабатывать систему.\\ | ||
| ===== Документация проекта ===== | ===== Документация проекта ===== | ||
| + | С помощью документации по проекту клиенты должны понять цель проекта, решаемые им задачи и способ как технически и организационно эти задачи выполняются. В документацию по проекту должны входить разделы по настройке технических средств (для сотрудников компании или для администраторов / ответственных лиц клиентов). Также в документацию могут входить разделы, посвященные внутренним аспектам реализации технических средств, описание внутренней реализации программных модулей, базы данных и т.д.\\ | ||
| + | Основная страница проекта должна быть в открытом доступе, но может содержать внутри себя тэги, ограничивающий просмотр той или иной информации.\\ | ||
| - | **Руководство администратора** - инструкции по настройке модуля\\ | + | Разделы и подразделы документации проекта, базовая структура:\\ |
| - | **Руководство разработчика** - список задействованных программных модулей и описание механизмов доступа к данным.\\ | + | **Общая информация**\\ |
| + | Текст, посвященный общей информации о проекте, должен находиться непосредственно на странице проекта.\\ | ||
| + | Подразделы:\\ | ||
| + | __Цель проекта__ - кратко описываем зачем проект вообще нужен и какие задачи клиента решает. Здесь же можно описать преимущества и почему клиент должен выбрать именно наше решение.\\ | ||
| + | __Текущий статус__ - проект запущен или нет.\\ | ||
| + | __Роли в проекте__ - сотрудники компании и какие задачи по проекту они выполняют.\\ | ||
| + | __Миссия проекта__ - более полное описание принципов проекта и его решений.\\ | ||
| + | __Цены__ - базовые принципы ценообразования, цены или ссылки на коммерческие предложения.\\ | ||
| + | **Запуск и сопровождение**\\ | ||
| + | Разделы документации, посвященные запуску проектов в работу и их последующему сопровождению. Основным принципом проектов должна быть их простота настройки, чтобы клиентам не требовалось обращаться в техническую поддержку компании. Желательно все моменты запуска описывать в общем доступе в разделе для администраторов. Все руководств должны находиться на отдельных страницах. Это нужно для того, чтобы можно было отправить ссылку непосредственно на страницу по некоторой теме.\\ | ||
| + | [[:руководство_администратора|Руководство администратора]] - документация, которая помогает администратору / сотруднику компании выполнить настройку системы.\\ | ||
| + | [[:руководство_тп|Руководство технической поддержки]] - документация, которая доступна сотрудникам технической поддержки компании АГБИС, но недоступна администраторам клиентов.\\ | ||
| + | |||
| + | **Пользовательская документация**\\ | ||
| + | **[[:руководство_пользователя|Руководство пользователя]]** - документация, которая помогает пользователю выполнить бизнес процесс в рамках настроенной системы.\\ | ||
| + | |||
| + | **Документация для программистов**\\ | ||
| + | **[[:руководство_разработчика|Руководство разработчика]]** - документация, которая помогает разработчику разрабатывать и дорабатывать систему.\\ | ||
| + | |||
| + | <alert warning> | ||
| + | Страницы всех документов проекта, ведущие на отдельные страницы, должны вверху страницы содержать ссылку на общую страницу по проекту.\\ | ||
| + | </alert> | ||
| + | <code> | ||
| + | В названии страниц не должно быть цифр в начале названия. | ||
| + | В названии страниц обязательно должно фигурировать имя проекта, например [[:Руководство администратора Агбис Клиент|Руководство администратора]]. | ||
| + | </code> | ||
| + | |||
| + | |||
| + | При создании новых проектов можно брать базовый шаблон из [[internal:Базовый шаблон страницы проекта]].\\ | ||
| ===== Источники документов ===== | ===== Источники документов ===== | ||
| Строка 54: | Строка 81: | ||
| [[:синтаксис_wiki|Синтаксис Wiki]]\\ | [[:синтаксис_wiki|Синтаксис Wiki]]\\ | ||
| + | [[:drafio_plugin|Пример drawio (диаграммы)]]\\ | ||
| [[:как_создавать_страницы_права_доступа|Как создавать страницы, права доступа]]\\ | [[:как_создавать_страницы_права_доступа|Как создавать страницы, права доступа]]\\ | ||
| [[:изменения_в_документации|Изменения в документации]]\\ | [[:изменения_в_документации|Изменения в документации]]\\ | ||
| - | |||