Проект Вече


  0. Как работать с документом
  ============================

Для написания этого текста используется формат txt2tags (http://txt2tags.org/), Который представляет из себя простой текст с минимальным форматированием. Для обозначения различных способов форматировния используется один из общепринятых способов обозначения форматировани: двойной подчерк - для обозначения подчёриквания, двойная косая черта для наклонного шрифта, двойная звёздочка - для жирного и так далее. Полное описание формата на русском языке можно посмотреть здесь (http://txt2tags.org/ru/markup-ru.html). К сожалению, на эту страницу нет ссылки с основного сайт. Или она очень хорошо закопана.

Для преобразования исходного документа в другие форматы (простой текст, HTML, PDF и другие) используется программа на языке Python - txt2tags (http://txt2tags.org/download.html). Практически во всех дистрибутивах Linux и дригих *nix интерпретатор этого языка уже установлен, да и сама эта программа может присутствовать в репозитарии, а пользователям Windows нужно будет скачать и установить интерпретатор. Например, с официального сайта (http://python.org/download/) разработчиков этого языка или бесплатную коммерческую версию ActivePython (http://www.activestate.com/activepython/downloads) с сайта ActiveState. Возможно, есть ещё какие-то, но я не искал - мне как-то без надобности.

Основным является документ README.t2t, остальные сохраняются только для удобства чтения. Для преобразования документа сразу во все форматы, сохраняемые в репозитарий, используется скрипт makedoc. Желающие могут добавть и другие варианты.

Обсуждение ведётся в рассылке veche@googlegroups.com (подписаться можно здесь (https://groups.google.com/group/veche)) и в ЖЖ автора проекта по тэгу veche (http://taris-marh.livejournal.com/tag/veche).


  1. Цели
  =======

Целью проекта является создание и поддержка площадки для общественного контроля над муниципальными структурами управления. На первом этапе предполагается создание возможности для отслеживания общественных слущаний, информация о которых усиленно закапывается в глубины сайта городской администрации вместо вывешивания на главной странице или на специальной странице, на которую ведёт ссылка с главной странице. Собственно, функцию это специальной страницы я и попытаюсь реализовать.


  2. Задачи
  =========

1. Публикация тем общественных слушаний (и вообще любых подобных проблем), полной сопутствующей информации (зеркалирование на сайт документов, аудио и видеозаписей), публикация новостей по слушаниям.
2. Хранение истории изменений всех относящихся к теме документов, чтобы можно было отслеживать телодвижения заинтересованных сторон.
3. Обеспечение возможности общения по заявленным слушаниям. Высказывания на сайте должно быть возможно с использованием OpenID.
4. Уведомления о новых собитиях.
5. Срочные уведомления в случае неожиданных изменений.
6. Предоставлять возможность голосования по проблеме. Желательно даже, чтобы оно имело какую-то юридически признанную форму, принимаемую к рассмотрению. То есть голосование поимённое, никаких безликих студентов, никаких выдуманных персонажей, только настоящие граждане, проживающие в городе. Город должен знать своих героев. Для голосования OpenID недостаточно, должна быть процедура однозначной идентификации личности. Фотография морды лица и развёрнутый паспорт в одном кадре? И привязка при голосовании к паспорту. Город же должен знать своих героев.


  3. Концепция хранения данных
  ============================

Основными объектами хранения являются:

- тема (слушание);
- документ, относящийся к теме;
- история документа;
- комментарии к документу;
- комментарии к теме  ;
- результаты голосования по  теме;
- история результатов голосования.

Вероятно, стоит сделать тему слушания разновидностью документа, не имеющего оригинала. Документ хранится одновременно в формате (X)HTML или txt2tags и в исходном формате (чаще всего, это doc/docx/rtf). Преобразование исходного документа в человекочитаемый формат произодится полностью автоматически, чтобы можно было иметь однозначные читаемые различия между версиями документа.

Каждый документ является заглавным сообщением темы обсуждения, таким образом получается что-то среднее между блогом и форумом. Каким-то образом надо срастить эту систему с форумом, чтобы можно было обсуждать и технические вопросы, не привязанные к конкретным темам.

Предлагаемая структура базы данных в том, что касается документов:

1. Тема - вопрос выставленный на слушание
    1. ID вопроса
    2. заголовок вопроса
    3. текст вопроса (t2t)
2. Документ. Содержит:
    1. представление документа для непосредственного отображение, чтения, сравнения (txt, html, txt2tags, что-то ещё?)
    2. ссылку на оригинал/сам документ в бинарном поле BLOB (пока неясно, как будет удобнее)
    3. ссылку родительский документ (тему)
    4. служебную информацию
3. Сообщение (комментарии, высказывания) по документу
    1. ссылка на родительский документ
    2. ссылка на родительское сообщение (опционально, только если предусматривать древовидную структуру комментариев)
    3. текст сообщения
4. История документа
    1. номер версии
    2. ссылка на последнюю версию документа (id)
    3. читаемое представление версии документа
    4. ссылка на версию документа (версия документа в исходном виде в BLOB)


  4. Пользовательский интерфейс
  =============================


	Главная страница
	================

На главной странице отображаются темы, с самыми поздними изменениями и новости. При внесении изменения в тему, комментарий к этому изменению автоматически отображается в виде новости (из него формируется новость). Так же там должны отображаться:

1. календарь;
2. поисковая форма;
3. рубрикатор;
4. ссылка на RSS/Atom агрегатор;
5. формы для подписки на рассылки по почте и SMS.

Тема состоит из заголовка, текстового описания ()


	Страница темы
	=============

1. заголовок темы;
2. краткое описание темы;
3. список основных документов;
4. ссылка на полный список документов, если их много;
5. последние события по теме (в том же формате, что и новости на главной, по сути, это те же новости, только выборочно, по теме);
6. последние комментарии по теме;



	Страница документа
	==================

Возможно в двух вариантах: документ в HTML + ссылка на сохранённый оригинал + ссылка на оригинальный документ на исходном месте или крактое описание документа и ссылки на HTML, оригинал, оригинал в исходном месте. Ссылка на оригинал в исходном месте в обоих случаях сопровождается статусом доступоности и изменений. Ссылка на сохранённый оригинал сопровождается номером версии, являющимся ссылкой на систему контроля версий.