Initial commit

.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Build and Deploy
+on:
+  push:
+    branches: [ master ]
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/[email protected]
+
+      - name: Install and Build
+        uses: ammaraskar/sphinx-action@master
+        with:
+          pre-build-command: |
+            apt-get update -y
+            apt-get install -y latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended rinohtype
+            pip install myst-parser
+          build-command: |
+            sphinx-build -M html . _build
+            sphinx-build -M rinoh . _build
+          docs-folder: "."
+
+      - name: Deploy HTML
+        uses: JamesIves/[email protected]
+        with:
+            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+            BRANCH: gh-pages
+            FOLDER: _build/html
+            SINGLE_COMMIT: true
+
+      - name: Deploy PDF
+        uses: JamesIves/[email protected]
+        with:
+            GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+            BRANCH: pdfs
+            FOLDER: _build/rinoh
+            SINGLE_COMMIT: true

.gitignore

@@ -0,0 +1 @@
+_build/**

CNAME

@@ -0,0 +1 @@
+docs.unicontsoft.com

Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

blog/000-index.md

@@ -0,0 +1,8 @@
+# Блог
+
+```{toctree}
+:glob:
+:reversed:
+
+*
+```

blog/20240219-test.md

@@ -0,0 +1,18 @@
+# Как да използваме Dreem POS в локална мрежа
+
+```{warning}
+ВАЖНО! Unicontsoft не поддържа подобна настройка на системата! Описанието и стъпките по-долу са FYI (само за информация)!
+```
+
+Приемаме че имате Windows локална мрежа с компютри POS-PC и DREEM-PC и искате Dreem POS на първата машина (POS-PC) да използва базата данни на Dreem Personal на другата машина (DREEM-PC).
+
+ 1. Уверете се, че на POS-PC можете да отваряте и копирате файлове от машина DREEM-PC
+    - ако машините са в domain, използвайте потребител от domain-а
+    - ако машините са в workgroup, настройка Sharing and security model for local accounts трябва да е Classic – local users authenticate as themselves и паролата на текущия потребител на POS-PC трябва да съвпада с паролата на същия потрелител на DREEM-PC
+    - във firewall.cpl в раздел Exceptions трябва да е разрешен File and Print Sharing
+ 2. След това се уверете, че на двете машини има инсталирана еднаква последна реализация на Dreem Personal
+
+На POS-PC трябва да настроите пренасочващ псевдоним с име ucs-instance, който ще се използва от Dreem Pos за да достъпва базата данни на Dreem Personal
+
+ 1. На POS-PC от Start->Run стартирайте cliconfg.exe (На 64-битови OS стартирайте C:\Windows\SysWOW64\cliconfg.exe) 
+ 2. В раздел Alias на Client Network Utility създавайте нов псевдоним ucs-instance (виж т.1 на графиката) по Named Pipes (виж т.2) и го насочете към инстанция DREEM-PC\UCS (виж т.3)

conf.py

@@ -0,0 +1,76 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = "Dreem User's Manual"
+copyright = "2024 by Unicontsoft"
+author = "Unicontsoft"
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = ['myst_parser']
+
+templates_path = ['_templates']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+master_doc = "index"
+language = 'bg'
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = 'sphinx_book_theme'
+# html_logo = "_static/logo-wide.svg"
+html_title = "Unicontsoft Dreem"
+html_copy_source = True
+# html_favicon = "_static/logo-square.svg"
+html_last_updated_fmt = ""
+
+html_static_path = ['_static']
+
+html_theme_options = {
+    "path_to_docs": "manual",
+    "repository_url": "https://github.com/Unicontsoft/Docs",
+    "use_repository_button": True,
+    "navigation_with_keys" : True,
+    # "home_page_in_toc": True,
+    "use_edit_page_button": True,
+    "use_source_button": True,
+    "use_issues_button": True,
+    # "use_repository_button": True,
+    "use_download_button": True,
+    "use_sidenotes": True,
+    "show_toc_level": 6,
+    "collapse_navigation": False,
+}
+
+
+# -- Options for rinohtype PDF output -------------------------------------
+# , logo='_static/rinohtype_logo.pdf'
+rinoh_documents = [
+    dict(doc='manual/000-index', target='manual', title='Ръководство на потребителя', subtitle='версия 1.5',
+         author='Униконт Софт ООД', toctree_only=False,
+         template='manual.rtt'),
+]
+
+myst_enable_extensions = [
+    "amsmath",
+    "attrs_inline",
+    "colon_fence",
+    "deflist",
+    "dollarmath",
+    "fieldlist",
+    "html_admonition",
+    "html_image",
+    # "linkify",
+    "replacements",
+    "smartquotes",
+    "strikethrough",
+    "substitution",
+    "tasklist",
+]

index.md

@@ -0,0 +1,17 @@
+# Документация
+
+ - [Ръководство на потребителя](manual/000-index.md)
+ - [Блог](blog/000-index.md)
+
+## Индекси
+
+```{eval-rst}
+* :ref:`genindex`
+* :ref:`search`
+```
+
+```{toctree}
+:hidden:
+manual/000-index.md
+blog/000-index.md
+```

make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=.
+set BUILDDIR=_build
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.https://www.sphinx-doc.org/
+	exit /b 1
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

manual.rts

@@ -0,0 +1,30 @@
+[STYLESHEET]
+name=MyStyle
+base=sphinx
+
+[VARIABLES]
+mono_typeface=TeX Gyre Cursor
+serif_typeface=DejaVu Serif
+sans_typeface=Roboto
+
+[heading level 1]
+page_break=any
+
+[heading level 3]
+page_break=none
+
+[inline image]
+padding_top = 0.5cm
+padding_bottom = 0.25cm
+
+[admonition]
+space_above = 0.25cm
+space_below = 0.25cm
+padding_top = 0.25cm
+padding_bottom = 0.5cm
+padding_left = 0.5cm
+padding_right = 0.5cm
+
+[centered]
+base=default
+text_align=CENTER

manual.rtt

@@ -0,0 +1,32 @@
+[TEMPLATE_CONFIGURATION]
+name = Manual Configuration
+template = book
+
+parts =
+    title
+    ;front_matter
+    contents
+    ;back_matter
+stylesheet = manual.rts
+language = bg
+
+[SectionTitles]
+contents = 'Съдържание'
+
+[AdmonitionTitles]
+caution = 'Внимание!'
+warning = 'Внимание'
+tip = ''
+
+[VARIABLES]
+paper_size = A4
+
+[front_matter]
+page_number_format = lowercase roman
+end_at_page = left
+
+[contents]
+page_number_format = number
+
+[title_page]
+top_margin = 2cm

manual/000-index.md

@@ -0,0 +1,24 @@
+# Ръководство за потребителя
+
+Настоящото ръководство има за цел да запознае и помогне на потребителите при работа със програмен продукт *Dreem Enterprise*. Информацията е представена така, че да отговори на най-често задаваните въпроси, които възникват в процеса на работа със системата.
+Информацията е структурирана в следните теми:
+
+ - [Описания](001-ref/000-index.md)
+ - [Процедури](002-proc/000-index.md)
+ - [Справки](003-rep/000-index.md)
+
+В темата *Описания* включва обобщаваща информация за работа с номенклатури, документи и процедури в системата.
+
+В раздел *Процедури* се разглеждат различни казуси, процеси и въпроси, възникващи при практическото приложение на системата в организацията.
+
+Ролята на третия раздел - *Справки* е да представи начина на работа с най–често използваните справки, за да се улесни работата на потребителите .
+
+```{toctree}
+:caption: Съдържание
+:maxdepth: 3
+:includehidden:
+:numbered:
+001-ref/000-index.md
+002-proc/000-index.md
+003-rep/000-index.md
+```

manual/001-ref/000-index.md

@@ -0,0 +1,29 @@
+```{only} html
+[Нагоре](../000-index)
+```
+
+# Описания
+
+В темата *Описания* включва обобщаваща информация за работа с номенклатури, документи и процедури в системата.
+
+ - [Номенклатури](001-nomenclatures/000-index.md)
+ - [Покупки и продажби](002-sales-purchases/000-index.md)
+ - [Складови документи](003-warehouse-documents/000-index.md)
+ - [Плащания](004-payments/000-index.md)
+ - [Счетоводство](005-accounting/000-index.md)
+ - [Дълготрайни активи](006-assets/000-index.md)
+ - [ТРЗ](007-payroll-documents/000-index.md)
+ - [Права и настройки](008-settings/000-index.md)
+
+```{toctree}
+:maxdepth: 1
+:hidden:
+001-nomenclatures/000-index.md
+002-sales-purchases/000-index.md
+003-warehouse-documents/000-index.md
+004-payments/000-index.md
+005-accounting/000-index.md
+006-assets/000-index.md
+007-payroll-documents/000-index.md
+008-settings/000-index.md
+```

manual/001-ref/001-nomenclatures/000-index.md

@@ -0,0 +1,14 @@
+```{only} html
+[Нагоре](../000-index)
+```
+
+# Номенклатури
+
+Модул Номенклатури предназначен за управление и достъп на номенклатурите в системата. В него се създават, актуализират и изтриват всички същности в системата – контрагенти, продукти и материали, валутни курсове, ценови листи, търговски отстъпки, дълготрайни активи и други.
+
+За да започнете работа със системата трябва първо да се създадат задължително номенклатурите: продуктите, материалите и услугите, с които търгувате и контрагентите, с които имате отношения.
+
+```{toctree}
+:glob: true
+*
+```

manual/001-ref/001-nomenclatures/001-contragents.md

@@ -0,0 +1,35 @@
+```{only} html
+[Нагоре](000-index)
+```
+
+# Контрагенти
+
+В системата под **Контрагенти** се разбират всички доставчици и клиенти, юридически и физически лица, складове, банки и 
+държавни институции. Няма отделна номенклатура за доставчиците и клиентите, но за да се разграничават се използват 
+*Категории контрагенти*.
+
+Нов контрагент се създава по следния начин:
+
+ 1) От модул **Номенклатури >> Контрагенти** чрез натискане на десен бутон на мишката върху списъка с контрагенти, 
+    трябва да изберете **Нов контрагент**. Отваря се празна форма **Контрагент** за въвеждане на данни.
+
+    ![Форма контрагент](901-contratent-form.png){ align=center }
+
+ 2) Въведете:
+
+    В секция **Основни**:
+    - **Наименование** – въвеждате наименованието на контрагента;
+    - **Адрес** – записвате адресa на контрагента;
+    - **Тип** – от какъв тип е контрагентът – избирате юридическо или физическо лице. Типовете контрагенти се въвеждат
+      предварително в системата от **Номенклатури >> Референтни номенклатури >> Търговска система >> Типове
+      контрагенти**.
+    - **ДДС No** – записвате ДДС номера на контрагента. Реквизитът е задължителен само в случаите, когато контрагента
+      е данъчно регистриран;
+    - **Ид No** – Идентификационен номер. Записвате идентификационния номер (булстат) на контрагента;
+    - **Категория** – от бутона с трите точки избирате към коя категория принадлежи контрагентът;
+
+    В секция Списъци:
+    - **Персони** – попълвате името на персоната, която е материално отговорно лице;
+
+ 3) **Запис и изход**
+