chore: add unittest project and setup

Author: yaroslav8765

tests/Taskfile.yaml

@@ -0,0 +1,6 @@
+version: '3'
+tasks:
+  start_app:
+    desc: "Start the application server for testing"
+    cmds:
+      - "cd application && pnpm migrate:local && pnpm install && pnpm start"

tests/application/.dockerignore

@@ -0,0 +1,2 @@
+node_modules
+.db.sqlite

tests/application/.env.local

@@ -0,0 +1,14 @@
+ADMINFORTH_SECRET=123
+NODE_ENV=development
+SQLITE_URL=sqlite://migrations/prisma/sqlite/.db.sqlite
+SQLITE_FILE_URL=file:.db.sqlite
+
+CH_MIGRATIONS_HOME=./migrations/clickhouse_migrations
+CH_MIGRATIONS_HOST=localhost:28124/demo
+CH_MIGRATIONS_USER=demo
+CH_MIGRATIONS_PASSWORD=demo
+
+AWS_REGION=eu-central-1
+AWS_BUCKET_NAME=tmpbucket-adminforth
+AWS_ACCESS_KEY_ID=your_access_key_id
+AWS_SECRET_ACCESS_KEY=your_secret_access_key

tests/application/.env.prod

@@ -0,0 +1,3 @@
+NODE_ENV=production
+DATABASE_URL=sqlite:////code/db/.db.sqlite
+PRISMA_DATABASE_URL=file:/code/db/.db.sqlite

tests/application/.gitignore

@@ -0,0 +1,8 @@
+# Dependency directories
+node_modules/
+
+# dotenv environment variable files
+.env
+
+.db.sqlite
+db

tests/application/Dockerfile

@@ -0,0 +1,8 @@
+
+FROM devforth/node20-pnpm:latest
+WORKDIR /code/
+ADD package.json pnpm-lock.yaml pnpm-workspace.yaml /code/
+RUN pnpm i  
+ADD . /code/
+RUN pnpm exec adminforth bundle
+CMD ["sh", "-c", "pnpm migrate:prod && pnpm prod"]

tests/application/README.md

@@ -0,0 +1,50 @@
+## Starting the application
+
+Install dependencies:
+
+```bash
+pnpm i
+```
+
+Migrate the database:
+
+```bash
+pnpm migrate:local
+```
+
+Start the server:
+
+```bash
+pnpm dev
+```
+
+## Changing schema
+
+Open `schema.prisma` and change schema as needed: add new tables, columns, etc (See [Prisma schema reference](https://www.prisma.io/docs/reference/tools-and-interfaces/prisma-schema)).
+
+Run the following command to generate a new migration and apply it instantly in local database:
+
+```bash
+pnpm makemigration --name <name_of_changes>
+```
+
+Your colleagues will need to pull the changes and run `pnpm migrate:local` to apply the migration in their local database.
+
+## Deployment tips
+
+You have Dockerfile ready for production deployment. You can test the build with:
+
+```bash
+docker build -t application-image .
+docker run -p 3500:3500 -e ADMINFORTH_SECRET=123 -v $(pwd)/db:/code/db application-image
+```
+
+To set non-sensitive environment variables in production, use `.env.prod` file.
+For sensitive variables, use direct docker environment variables or secrets from your vault.
+
+## Documentation
+
+- [Customizing AdminForth Branding](https://adminforth.dev/docs/tutorial/Customization/branding/)
+- [Custom Field Rendering](https://adminforth.dev/docs/tutorial/Customization/customFieldRendering/)
+- [Hooks](https://adminforth.dev/docs/tutorial/Customization/hooks/)
+- [Custom Pages](https://adminforth.dev/docs/tutorial/Customization/customPages/)

tests/application/api.ts

@@ -0,0 +1,13 @@
+import { Express, Request, Response } from "express";
+import { IAdminForth } from "adminforth";
+export function initApi(app: Express, admin: IAdminForth) {
+  app.get(`${admin.config.baseUrl}/api/hello/`,
+    async (req: Request, res: Response) => {
+      const allUsers = await admin.resource("adminuser").list([]);
+      res.json({
+        message: "Hello from AdminForth API!",
+        users: allUsers,
+      });
+    }
+  );
+}