# Текущая ззадача
доработай design-documents.coffee, отслеживая его версию. с учетом изменений в правилах, допиши недостающие описания типов документов, добавь документ я настройками домена.
Добавь в документы, мульти доменое использование.
# применяй правила:
## оформление ссылок
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',''
document.head.insertAdjacentHTML 'beforeend',''
document.head.insertAdjacentHTML('beforeend','
Кохи Борбад - Концертный зал Душанбе')
# Настройка tailwind
tailwind.config = require 'tailwind.config.js'
# подключение основных стилей
## tailwind
document.head.insertAdjacentHTML('beforeend','')
## базовой стиль приложения
document.head.insertAdjacentHTML('beforeend','')
# Маршруты
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','')
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
## файл с правилами
https://gogs.osvoj.ru/s5l.ru/borbad.s5l.ru/raw/master/README.md
# общая структура проекта
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
}
## _desing документ для работы с данными
https://gogs.osvoj.ru/s5l.ru/borbad.s5l.ru/raw/master/scripts/design-documents.coffee