Merge branch 'main' of https://gitea.tpsoft.org/TPsoft.org/BugReport

pridane poznamky,
pridana konfiguracia pre DEV a PROD,

backend/src/Init.php

@@ -4,6 +4,7 @@ require __DIR__ . '/../vendor/autoload.php';
 
 use \Exception;
 use \TPsoft\DBmodel\DBmodel;
+use \TPsoft\BugreportBackend\Maintenance;
 
 global $dbh;
 
@@ -14,20 +15,6 @@ if (Configuration::DB_TYPE == 'mysql') {
 } else {
 	throw new Exception('Unknown database type');
 }
-/*
-$dbh->tables = [
-	'reports' => [
-		'name' => 'reports',
-		'primary_key_name' => 'report_id',
-		'allow_attributes' => [
-			'report_id' => 'varchar()',
-			'report_title' => 'varchar()',
-			'report_description' => 'varchar()',
-			'report_status' => 'varchar()',
-			'report_group' => 'varchar()',
-			'report_priority' => 'varchar()',
-			'created_dt' => 'varchar()',
-		],
-	],
-];
-*/
+
+$maintenance = new Maintenance($dbh);
+$maintenance->database();

backend/src/Maintenance.php

@@ -0,0 +1,81 @@
+<?php
+
+namespace TPsoft\BugreportBackend;
+
+class Maintenance extends \TPsoft\DBmodel\Maintenance
+{
+
+	public function database()
+	{
+		if (!$this->existsTable('options')) {
+			$this->checkDBTable('options', '
+				`key` VARCHAR(255) NOT NULL PRIMARY KEY,
+				`value` VARCHAR(255) NOT NULL
+			');
+			$this->dbver(1);
+		}
+		$dbver = $this->dbver();
+		if ($dbver == 1) {
+			$this->checkDBTable('reports', '
+				`report_id` INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+				`report_title` varchar(255) DEFAULT NULL,
+				`report_description` text DEFAULT NULL,
+				`report_status` int(11) DEFAULT NULL,
+				`report_group` varchar(255) NOT NULL,
+				`report_priority` int(11) DEFAULT NULL,
+				`ordnum` int(11) DEFAULT NULL,
+				`created_dt` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP
+			');
+			$this->dbver(2);
+			$dbver = 2;
+		}
+		if ($dbver == 2) {
+			$this->checkDBTable('attachments', '
+				`attachment_id` INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+				`report_id` int(11) NOT NULL,
+				`attachment_type` varchar(255) DEFAULT NULL,
+				`attachment_content` text DEFAULT NULL,
+				`created_dt` datetime DEFAULT NULL,
+				`updated_dt` datetime DEFAULT NULL
+			');
+			$this->dbver(3);
+			$dbver = 3;
+		}
+	}
+
+	protected function settings(string $key, ?string $value = null): string|false
+	{
+		if (is_null($value)) {
+			return $this->dbh->getOne(sprintf('SELECT `value` FROM `options` WHERE `key` = %s', $this->dbh->quote($key)));
+		} else {
+			$db_type = $this->dbh->getDBtype();
+			switch ($db_type) {
+				case 'mysql':
+					return $this->dbh->query(sprintf(
+						'INSERT INTO `options` (`key`, `value`) VALUES (%s, %s) ON DUPLICATE KEY UPDATE `value` = %s',
+						$this->dbh->quote($key),
+						$this->dbh->quote($value),
+						$this->dbh->quote($value)
+					)) !== false;
+					break;
+				case 'sqlite':
+					return $this->dbh->query(sprintf(
+						'INSERT INTO `options` (`key`, `value`) VALUES (%s, %s) ON CONFLICT(`key`) DO UPDATE SET `value` = %s',
+						$this->dbh->quote($key),
+						$this->dbh->quote($value),
+						$this->dbh->quote($value)
+					)) !== false;
+					break;
+				default:
+					new \Exception('Unknown DB type: ' . $db_type);
+					return false;
+					break;
+			}
+		}
+	}
+
+	protected function dbver(?string $ver = null)
+	{
+		return $this->settings('version', $ver);
+	}
+}

doc/notes.txt

@@ -0,0 +1,21 @@
+projekt/
+│
+├── backend/                  # PHP časť (API, logika, DB)
+│   ├── public/               # root pre webserver (index.php, assets)
+│   │   └── index.php
+│   ├── src/                  # zdrojový PHP kód (kontroléry, modely, služby)
+│   ├── vendor/               # Composer balíčky (gitignore!)
+│   ├── composer.json
+│   └── composer.lock
+│
+├── frontend/                 # Vue časť
+│   ├── src/                  # Vue komponenty, views, store
+│   ├── public/               # statické súbory (favicon, index.html template)
+│   ├── dist/                 # build výstup (gitignore!) → deploy do backend/public
+│   ├── package.json
+│   ├── package-lock.json
+│   └── vite.config.js / vue.config.js
+│
+├── docker/ (voliteľné)       # ak používaš Docker (Nginx, PHP-FPM, Node build)
+│
+└── README.md

frontend/.env.development

@@ -0,0 +1 @@
+VITE_BACKENDAPI_URL="https://192.168.0.101/BugReport/backend/public/API.php"

frontend/.env.production

@@ -0,0 +1 @@
+VITE_BACKENDAPI_URL="/API.php"

frontend/src/App.vue

@@ -2,7 +2,7 @@
 	<div id="header">
 		<div class="logo">
 			<router-link to="/">
-				<img src="/public/bugreport.svg" height="48" width="48" />
+				<img src="/bugreport.svg" height="48" width="48" />
 			</router-link>
 			<router-link to="/">
 				<h1>Bug Report</h1>

frontend/src/assets/css/style.css

@@ -462,6 +462,36 @@ button:focus-visible,
 	padding: 10px;
 	text-align: justify;
 }
+#api ul li {
+	margin-bottom: 5px;
+}
+#api .param-type {
+	background-color: var(--color-bg0);
+	margin: 0px;
+	padding: 2px 5px;
+	text-align: center;
+	border-radius: 5px;
+	margin-left: 10px;
+}
+#api .param-optional {
+	background-color: var(--color-bg1);
+	margin: 0px;
+	padding: 2px 5px;
+	text-align: center;
+	border-radius: 5px;
+	margin-left: 10px;
+}
+#api .param-default {
+	background-color: var(--color-bg2);
+	margin: 0px;
+	padding: 2px 5px;
+	text-align: center;
+	border-radius: 5px;
+	margin-left: 10px;
+}
+#api .param-doc {
+	color: var(--color-text3);
+}
 
 /* ----------------------------------------------------
    07 - ABOUT

frontend/src/views/API.vue

@@ -24,51 +24,42 @@
 			<h4>Parametre</h4>
 			<p v-if="Object.keys(action.params).length == 0">
 				<font-awesome-icon :icon="['fas', 'circle-info']" />
-				&nbsp;
-				Ziadne parametre
+				&nbsp; Ziadne parametre
 			</p>
 			<ul>
-				<li v-for="(param_desc, param_name) in action.params" :key="param_name">
-					<strong>{{ param_name }}</strong>
-					&ndash;
-					{{ param_desc }}
+				<li v-for="param in action.params" :key="param_name">
+					<strong>{{ param.name }}</strong>
+					<span class="param-type">{{ param.type }}</span>
+					<span v-if="param.optional" class="param-optional">optional</span>
+					<span v-if="param.default != null" class="param-default">{{
+						param.default
+					}}</span>
+					<br />
+					<span class="param-doc">{{ param.doc }}</span>
 				</li>
 			</ul>
+			<p>
+				<strong>Return</strong>
+				<span class="param-type">{{ action.return }}</span>
+			</p>
 		</div>
 	</div>
 </template>
 
-<script>
+<script setup>
+import { onMounted, ref } from "vue";
 import backend from "../backend";
 
-export default {
-	name: "API",
-	components: {},
-	data() {
-		return {
-			api_endpoint: backend.endpont,
-			help: {
-				actions: {
-					help: {
-						name: "help",
-						description: "This help",
-						params: {
-							foo: "bar",
-						},
-					},
-				},
-			},
-		};
-	},
-	mounted() {
-		this.loadHelp();
-	},
-	methods: {
-		loadHelp() {
-			backend.help().then((response) => {
-				this.help = response;
-			});
-		},
-	},
-};
+const api_endpoint = ref(backend.endpont);
+const help = ref({ actions: {} });
+
+onMounted(() => {
+	loadHelp();
+});
+
+function loadHelp() {
+	backend.help().then((response) => {
+		help.value = response;
+	});
+}
 </script>

frontend/vite.config.js

@@ -25,6 +25,10 @@ export default defineConfig(({ command, mode }) => {
 			__IS_BUILD__: JSON.stringify(isBuild),
 			__IS_DEV__: JSON.stringify(isDev),
 		},
+		server: {
+			host: true,
+			port: 5173
+		},
 		build: {
 			outDir: "dist",
 			chunkSizeWarningLimit: 1000, // zvýšenie limitu na 1000 kB