From f65a7b56565dc7c05d4108f089c1a94601c6b9c5 Mon Sep 17 00:00:00 2001
From: Sergej Kern <sergej.kern@konoma.ch>
Date: Tue, 20 Jan 2026 18:36:02 +0100
Subject: [PATCH] initial commit

---
 .gitignore                |  50 +++++++++++++++++
 ADR-000-requirements.adoc |  42 ++++++++++++++
 README.md                 | 113 ++++++++++++++++++++++++++++++++++++++
 3 files changed, 205 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 ADR-000-requirements.adoc
 create mode 100644 README.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e83c416
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,50 @@
+# Environment variables
+.env
+
+# Docker
+docker-compose.override.yml
+
+# Backend
+backend/bin/
+backend/obj/
+backend/*.db
+backend/*.db-shm
+backend/*.db-wal
+backend/.vs/
+backend/.vscode/
+backend/*.user
+backend/*.suo
+
+# Frontend
+frontend/node_modules/
+frontend/dist/
+frontend/.vscode/
+frontend/.idea/
+
+# IDEs
+.vs/
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# OS
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# Build artifacts
+*.dll
+*.exe
+*.pdb
+*.cache
diff --git a/ADR-000-requirements.adoc b/ADR-000-requirements.adoc
new file mode 100644
index 0000000..0c61feb
--- /dev/null
+++ b/ADR-000-requirements.adoc
@@ -0,0 +1,42 @@
+= dalex-todo-proto
+:toc: left
+:toclevels: 3
+
+== Overview
+
+A prototype for the dalex-todo application.
+
+Vue3 frontend with Tailwind CSS and TypeScript.
+
+ASP.NET Core Minimal APIs .net 10 backend with SQLite database.
+
+Keycloak authentication.
+
+Keycloak server is https://terminus.bluelake.cloud/
+
+The keycloak realm is "dalex-immo-dev" and the client id is "dalex-proto".
+
+frontend and backend and the db are dockerized.
+
+frontend shall run an port 3030, backend shall run on port 5050.
+
+each user shall have its own todos.
+
+user must be able to see the list of todos, be able to add new todos, be able to edit and delete todos. user must be able to mark todos as completed. each todo has a created and done timestamp.
+
+todos that are old but not done shall be listed on top. done todos shall be listed at the bottom.
+todos that were done last week or older shall be not appear on the first page, but shall be accessible via a button "show older todos".
+
+every single page must be protected by Keycloak authentication.
+
+when done, run the docker compose up and check if the application is running.
+
+== Deployment
+
+The dockers must be deployed to gitea server to https://brokkr.robotico.dev/dalex/-/packages via python script.
+
+== Development
+
+We expect a .env file to be present in the root directory. It contains PUBLISH_TOKEN with access to the gitea server. The .env file must never be overwritten.
+a .gitignore must be created and include relevant filters for this project.
+Readme.md must contain techstack on top.
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5b85d13
--- /dev/null
+++ b/README.md
@@ -0,0 +1,113 @@
+# Dalex Todo Prototype
+
+A full-stack todo application with Vue3 frontend and ASP.NET Core backend, secured with Keycloak authentication.
+
+## Features
+
+- **Frontend**: Vue3 with TypeScript and Tailwind CSS
+- **Backend**: ASP.NET Core 9.0 Minimal APIs with SQLite
+- **Authentication**: Keycloak integration
+- **Containerization**: Docker and Docker Compose
+
+## Prerequisites
+
+- Docker and Docker Compose
+- Keycloak server (configured at https://terminus.bluelake.cloud/)
+
+## Getting Started
+
+### Running with Docker Compose
+
+1. Clone the repository
+2. Run the application:
+
+```bash
+docker-compose up --build
+```
+
+3. Access the application:
+   - Frontend: http://localhost:3030
+   - Backend API: http://localhost:5050
+
+### Development Mode
+
+#### Backend
+
+```bash
+cd backend
+dotnet restore
+dotnet run
+```
+
+#### Frontend
+
+```bash
+cd frontend
+npm install
+npm run dev
+```
+
+## Architecture
+
+### Backend (ASP.NET Core)
+
+- Minimal APIs architecture
+- SQLite database for data persistence
+- JWT authentication via Keycloak
+- RESTful API endpoints for CRUD operations
+
+### Frontend (Vue3)
+
+- TypeScript for type safety
+- Tailwind CSS for styling
+- Keycloak-js for authentication
+- Axios for API calls
+
+## API Endpoints
+
+- `GET /api/todos/recent` - Get recent todos (excludes completed todos older than 1 week)
+- `GET /api/todos` - Get all todos
+- `POST /api/todos` - Create a new todo
+- `PUT /api/todos/{id}` - Update a todo
+- `DELETE /api/todos/{id}` - Delete a todo
+
+All endpoints require authentication.
+
+## Todo Features
+
+- Add, edit, and delete todos
+- Mark todos as completed with timestamps
+- Sort todos: incomplete (older first) at top, completed at bottom
+- Filter: Hide completed todos older than 1 week (show via button)
+- Each user has their own todos (multi-tenant)
+
+## Configuration
+
+### Keycloak
+
+The application is configured to use Keycloak at `https://terminus.bluelake.cloud/` with:
+- Realm: `dalex-immo-dev`
+- Client ID: `dalex-proto`
+
+### Ports
+
+- Frontend: 3030
+- Backend: 5050
+
+## License
+
+MIT
+
+## Deployment
+
+For deploying Docker images to the Gitea package registry at https://brokkr.robotico.dev/dalex/-/packages, see [DEPLOYMENT.md](DEPLOYMENT.md).
+
+## Development
+
+Before deployment, create a `.env` file in the project root:
+
+```bash
+PUBLISH_TOKEN=your_gitea_token_here
+```
+
+See `.env.example` for template. The `.env` file is git-ignored and will never be overwritten.