borbad.s5l.ru

Текущая ззадача

доработай design-documents.coffee, добавь мультиязычность в документы, и обнови описание всех хранимых объектов.

файл с правилами

https://gogs.osvoj.ru/s5l.ru/borbad.s5l.ru/raw/master/README.md

применяй правила:

оформление ссылок

a(href="[ссылка]") - не правильно router-link(to="[ссылка]") - не правильно app-link(to="[ссылка]") - правильно (должен быть подключен компанент: 'app-link': require 'app/shared/AppLink')

Корневой каталог и мета данные

Важно: мета данные добавляются через app/temp.coffe базовым тегоьм для vuejs является body, app/index.pug начинается с div, теги html, head, body ЗАПРЕЩЕНО использовать.

пример кода app/temp.coffee

# обязательно подключение глобальных массивов
globalThis.renderFns = require 'pug.json'
globalThis.stylFns   = require 'styl.json'

# подключение мета информации (строго в данном фиде)
document.head.insertAdjacentHTML 'beforeend','<meta charset="UTF-8">'
document.head.insertAdjacentHTML 'beforeend','<meta name="viewport" content="width=device-width, initial-scale=1.0">'
document.head.insertAdjacentHTML('beforeend','<title> Кохи Борбад - Концертный зал Душанбе</title>')

# Настройка tailwind
tailwind.config = require 'tailwind.config.js'

# подключение основных стилей
## tailwind
document.head.insertAdjacentHTML('beforeend','<style  type="text/tailwindcss"  page="main">'+stylFns['main.css']+'</style>')
## базовой стиль приложения
document.head.insertAdjacentHTML('beforeend','<style  type="text/tailwindcss"  page="root">'+stylFns['app/temp.styl']+'</style>')

# Маршруты
routes = [
  { path: '/', component: require 'app/pages/Home' }
  { path: '/events', component: require 'app/pages/Events' }
  { path: '/about', component: require 'app/pages/About' }
  { path: '/contacts', component: require 'app/pages/Contacts' }
]

# Глобальное определение vuejs приложения
app = Vue.createApp
  name: 'app'
  data: ()->
        return  {
            
            appState:
                events: []
                featuredEvents: []
                sliderEvents: []
                loading: true
                error: null
            modalState:           #управление модальными окнами
                isVisible: false
                component: null
                props: {}
            couchDBService: new CouchDBService()
        }
  beforeMount: ()->
        debug.log "start beforeMount"
        # определение контекста vuejs приложения как глобальной переменной _
        globalThis._ = @
        # все глобальные переменные необходимые для работы определяем в data
        # и получаем доступ через _.*
  render: (new Function '_ctx', '_cache', renderFns['app/temp.pug'])()
  mounted: ->{}
  methods: {}
  components:
      'themetoggle':    require 'app/shared/ThemeToggle'
      'multilevelmenu': require 'app/shared/MultiLevelMenu'
      'imageslider':    require 'app/shared/ImageSlider'
app.use(VueRouter.createRouter({
  routes: routes
  history: VueRouter.createWebHistory()
  scrollBehavior: (to, from, savedPosition) ->
    if savedPosition
      return savedPosition
    else
      return { x: 0, y: 0 }
}))

# подключаем в body ОБЯЗАТЕЛЬНО!!!
app.mount('body')

Привер кода index.coffee для компанентов/страниц

# Важно загрузка стилей компонента/страницы
document.head.insertAdjacentHTML('beforeend','<style type="text/tailwindcss"  page="Blog">'+stylFns['app/pages/Blog/index.styl']+'</style>')

module.exports =
    name: 'BlogPage'
    # ВАЖНО загрузка шаблона через рендер функцию
    render: (new Function '_ctx', '_cache', renderFns['app/pages/Blog/index.pug'])()
    data: ->
        posts: []
        loading: true
        error: null
    
    beforeMount: ->
        @loadBlogPosts()
    
    methods:
        loadBlogPosts: ->
            try
                @loading = true
                @posts = await AppDB.getBlogPosts(limit: 10)
                @loading = false
            catch error
                @error = "Ошибка загрузки постов: "+error
                @loading = false
    

определение функций в _deing документе

при обновлении документа учитывай версионность

    # Design документ для блог постов
    blog_posts:
        version: "1.1"
        views:
            # Все опубликованные блог посты
            published:
                map: ((doc) ->
                    if doc.type is 'blog_post' and doc.status is 'published'
                        emit(doc.created_at, doc)).toString()

определение шаблонов для слотов

template(#body) - не правильно template(v-slot:body) - не правильно template([body]) - правильно

async в методах

async loadData: -> - не правильно loadData: -> - правильно

Радота с кодом

всегда приводи полный листинг файлов при форматировании кода для отделения логических блоков используй 4 пробела (" ") следи за строгим соблюдением синтаксиса используемых языков (coffeescript, pug, stylus) в pug не используй многострочные вычисляемые атрибуты

работа с консолью и текстовыми константами/переменными используй конкатенацию (СТРОГО! ВАЖНО!)

используй для вывода в консоль debug.log console.log "переменная temp = #{temp}" - не правильно debug.log "переменная temp = "+temp - правильно

shareUrl = "https://twitter.com/intent/tweet?text=#{text}" - не правильно shareUrl = "https://twitter.com/intent/tweet?text="+text - правильно

"#{@baseUrl}/#{@dbName}/_all_docs?include_docs=true" - не правильно @baseUrl+"/"+@dbName+"/_all_docs?include_docs=true" - правильно

Цвета и управление темами

во всех *.styl файлах используй цвета в виде переменных, определённых в файле tailwind.config.js

Стили

все глобальный настройки стилей, пиши в app/temp.styl в остальных файлах, строго стили необходимые только для данного компаонента

Расположение статических файлов/изображений

img(src="/images/hall-interior.jpg") - не правильно img(src="/assets/[domenName]/hall-interior.jpg") - правильно

стиль написания классов

.container.mx-auto.px-4 - не правильно div(class="container.mx-auto px-4") - правильно

не используй вызовы

Vue = require 'vue' VueRouter = require 'vue-router'

• Подключение осуществлено глобально через файл doc.json

git ВАЖНО

для анализа кода бери версии файлов СТРОГО из репозитария: https://gogs.osvoj.ru/s5l.ru/borbad.s5l.ru/src/master , корневой каталог vue/ от него идут пути к файлам пример: в коде -> app/temp.coffee, в репозитарии -> vue/app/temp.coffee

Общее описание

Универсаньная CMS для работы с couchdb как бекендом. CMS мультидоменная и мультиязычная. мультидоменность во все view через поле domain

общая структура проекта

app/ ├── tailwind.config.js (настройка тем и Tailwind CSS) ├── temp.pug (основной layout) ├── temp.coffee (инициализация Vue и роутера) ├── temp.styl (стили которые сложно или не удобно сделать на Tailwind CSS или стили к однотипным элементам на stylus) ├── core/ - Каталог для хранения coffee файлов частей ядра системы, для улучшения чтения temp.coffee | ├── CouchdbClass.coffee | ... ├── page/ | ├── Home/ (главная страница) | | ├── index.coffee | | ├── index.pug | | ├── index.styl | ├── [другие_страницы]/ | ├── index.coffee | ├── index.pug | ├── index.styl └── shared/

 ├── ThemeToggle/
 |      ├── index.coffee
 |      ├── index.pug
 |      ├── index.styl
 ├── MultiLevelMenu/
 |      ├── index.coffee
 |      ├── index.pug
 |      ├── index.styl
 ├── ImageSlider/
 |      ├── index.coffee
 |      ├── index.pug
 |      ├── index.styl
 ├── ModalWindow/
 |      ├── index.coffee
 |      ├── index.pug
 |      ├── index.styl
 ├── FormValidator/
 |      ├── index.coffee
 |      ├── index.pug
 |      ├── index.styl
 ├── FilterSort/
        ├── index.coffee
        ├── index.pug
        ├── index.styl

Структура хранимых данных

Базовый объект "Запись блога"

coffee {

_id: String                    # Уникальный идентификатор
type: 'blog_post'              # Тип записи
title: String                  # Заголовок
content: String                # Основной текст в Markdown
excerpt: String                # Краткое описание
image: String                  # Главное изображение
tags: Array[String]            # Теги для категоризации
author: String                 # Автор записи
status: 'published' | 'draft'  # Статус публикации
created_at: ISOString          # Дата создания
updated_at: ISOString          # Дата обновления
views: Number                  # Количество просмотров

}

Наследник "Слайд"

coffee {

_id: String
type: 'slide'
title: String
content: String                # Markdown контент
image: String                  # Фоновое изображение
order: Number                  # Порядок отображения
active: Boolean                # Активен ли слайд
button_text: String            # Текст кнопки
button_link: String            # Ссылка кнопки
created_at: ISOString
updated_at: ISOString

}

Наследник "Мероприятие"

coffee {

_id: String
type: 'event'
title: String
content: String                # Markdown описание мероприятия
event_date: ISOString          # Дата и время мероприятия
end_date: ISOString            # Дата и время окончания
location: String               # Место проведения
price: Number                  # Стоимость билета
currency: String               # Валюта (TJS, USD, etc.)
available_tickets: Number      # Количество доступных билетов
total_tickets: Number          # Общее количество билетов
image: String                  # Изображение мероприятия
gallery: Array[String]         # Галерея изображений
tags: Array[String]            # Теги (концерт, выставка, etc.)
status: 'upcoming' | 'ongoing' | 'completed' | 'cancelled'
registration_required: Boolean # Требуется ли регистрация
created_at: ISOString
updated_at: ISOString

}

Пример документа настроек домена

domainSettingsExample =

_id: "domain_settings_borbad_s5l_ru"
type: "domain_settings"
domain: "borbad.s5l.ru"
name: "Кохи Борбад - Концертный зал Душанбе"
description: "Официальный сайт концертного зала Борбад"
active: true
priority: 1
theme: "borbad"
languages: ["ru", "en", "tj"]
default_language: "ru"
timezone: "Asia/Dushanbe"
currency: "TJS"
settings:
    seo:
        title_template: "{page} - Кохи Борбад"
        description: "Концертный зал Борбад - культурный центр Душанбе"
        keywords: ["концерты", "мероприятия", "Душанбе", "культура"]
    social:
        facebook: "https://facebook.com/borbad"
        instagram: "https://instagram.com/borbad"
        twitter: "https://twitter.com/borbad"
    contact:
        address: "г. Душанбе, пр. Рудаки 22"
        phone: "+992 37 123-45-67"
        email: "info@borbad.s5l.ru"
created_at: new Date().toISOString()
updated_at: new Date().toISOString()

Пример документа страницы

pageExample =

_id: "page_about_borbad"
type: "page"
domain: "borbad.s5l.ru"
title: "О нас - Кохи Борбад"
slug: "about"
content: "# О концертном зале Борбад\n\nИстория и описание нашего зала..."
excerpt: "Информация о концертном зале Борбад в Душанбе"
image: "/assets/borbad.s5l.ru/about.jpg"
meta_title: "О нас - Концертный зал Борбад"
meta_description: "Узнайте больше о концертном зале Борбад в Душанбе"
status: "published"
order: 2
template: "default"
created_at: new Date().toISOString()
updated_at: new Date().toISOString()

Пример документа меню

menuExample =

_id: "menu_main_borbad"
type: "menu"
domain: "borbad.s5l.ru"
name: "Главное меню"
location: "header"
active: true
items: [
    {
        title: "Главная"
        url: "/"
        order: 1
        target: "_self"
    }
    {
        title: "Мероприятия"
        url: "/events"
        order: 2
        target: "_self"
    }
    {
        title: "О нас"
        url: "/about"
        order: 3
        target: "_self"
    }
    {
        title: "Контакты"
        url: "/contacts"
        order: 4
        target: "_self"
    }
]
created_at: new Date().toISOString()
updated_at: new Date().toISOString()

Пример документа пользователя

userExample =

_id: "user_admin_1"
type: "user"
email: "admin@borbad.s5l.ru"
name: "Администратор"
role: "admin"
active: true
permissions: [
    "read"
    "write"
    "delete"
    "admin"
]
profile:
    avatar: "/assets/borbad.s5l.ru/avatars/admin.jpg"
    phone: "+992 37 123-45-67"
    position: "Системный администратор"
settings:
    language: "ru"
    notifications: true
created_at: new Date().toISOString()
updated_at: new Date().toISOString()
last_login: new Date().toISOString()

Пример документа заказа

orderExample =

_id: "order_2024_001"
type: "order"
domain: "borbad.s5l.ru"
user_id: "user_customer_1"
status: "completed"
total: 1500
currency: "TJS"
items: [
    {
        product_id: "event_ticket_1"
        name: "Билет на симфонический концерт"
        quantity: 2
        price: 500
        total: 1000
    }
    {
        product_id: "product_1"
        name: "Футболка с логотипом"
        quantity: 1
        price: 500
        total: 500
    }
]
customer_info:
    name: "Иван Иванов"
    email: "ivan@example.com"
    phone: "+992 123-45-67"
payment_info:
    method: "card"
    transaction_id: "txn_123456"
    status: "paid"
created_at: new Date().toISOString()
updated_at: new Date().toISOString()

Пример документа аудита

auditExample =

_id: "audit_2024_001"
type: "audit_log"
user_id: "user_admin_1"
action: "create"
resource_type: "blog_post"
resource_id: "blog_post_1"
description: "Создана новая запись блога"
ip_address: "192.168.1.1"
user_agent: "Mozilla/5.0..."
created_at: new Date().toISOString()

_desing документ для работы с данными

https://gogs.osvoj.ru/s5l.ru/borbad.s5l.ru/raw/master/scripts/design-documents.coffee