ActaTempus is a sophisticated web application designed for efficient work hour management and tracking. Featuring a dual backend developed in Go and Dart alongside a modern Next.js frontend, ActaTempus emphasizes functional programming principles and streamlined user experience.

🚀 Features (Long-Term Goals)

✅ User Management: Registration, login, profile updates
✅ Time Tracking: Start/stop tracking, manual entries, and break management
✅ Project Management: Create and manage projects, tasks, and time entries
✅ Reporting: Generate daily/weekly reports and export as PDF/CSV
✅ Role-Based Access Control (RBAC): Fine-grained permission system

🏗️ Architecture

ActaTempus adheres to Domain-Driven Design (DDD) and Clean Architecture principles for a scalable and maintainable codebase.
The system is divided into four primary layers:

1️⃣ Domain Layer:

Contracts, definitions, and interfaces only.

2️⃣ Infrastructure Layer:

Database and external service integrations (e.g., Prisma with PostgreSQL).

3️⃣ Application Layer:

Business logic, services, and response handling.

4️⃣ Interface Layer:

External communication interfaces.

🛠️ Technology Stack

🎨 Frontend:

Next.js: React framework for SSR and SPA capabilities
Deno: Lightweight, secure runtime for development tooling
Dependencies:
- fp-ts: Functional programming in TypeScript
- @reactivex/rxjs: Reactive programming
- clsx: Conditional class handling
- lucide-react: Icon library
- next-intl: Internationalization

⚙️ Backend:

Go:

Prisma-Go: PostgreSQL ORM integration with Prisma

Dart:

Prisma-Dart: PostgreSQL ORM adapter for Dart

📦 Database:

PostgreSQL: Primary database
Prisma: Shared ORM schema across Dart and Go backends

📁 Directory Structure

backend-go/         # Go backend implementation
backend-dart/       # Dart backend implementation
frontend-next/      # Next.js frontend
docs/               # Documentation, specs, and design diagrams

📖 Getting Started

Prerequisites

All dependencies are bundled with the devcontainer. For manual setup, ensure you have:

Docker
Node.js
Go
Dart
PostgreSQL

🔧 Installation

Clone the repository:

git clone https://inf-git.th-rosenheim.de/studavrije7683/ws24-kp-avril.git
cd ws24-kp-avril

Use the devcontainer:
Place the repository on a Unix-native file system.
Otherwise you will experience severe performance issues. Launch it with Visual Studio Code:
```
code .
```

🖥️ Running ActaTempus

Frontend

cd frontend-next
# Install dependencies (if not using devcontainer)
deno task dev # Starts the UI on port 3000

Backend (Go)

cd backend-go
go run cmd/actatempus/main.go # Starts on port 8080

Backend (Dart)

cd backend-dart
dart run bin/backend_dart.dart # Starts on port 8080

🗄️ Database Management

ActaTempus uses Prisma ORM for database schema management and code generation across both backends.

Deploy the Schema

bunx prisma db push

Prisma Studio (UI)

bunx prisma studio

Code Generation

bunx prisma generate

🔧 Known Issues

🐛 Browser Extensions and Hydration

Some browser extensions (e.g., Grammarly) inject DOM attributes that cause SSR mismatches:

Example: <data-lt-installed="true">
Disable such extensions if issues occur.

🛣️ Roadmap

Phase 1: Initialize

✅ Define specifications
✅ Set up repository

Phase 2: Setup

✅ Frontend (Next.js, Deno)
✅ Backends (Dart & Go)
✅ Devcontainer

Phase 3: MVP Development

Build foundational backends in Go & Dart
Implement:
- ✅ Domain layer (Entities, Repositories)
- ✅ Application logic (Services, DTOs, JWT Authentication)
- ✅ Basic authorization

Phase 4: Web UI

🎨 Build frontend for:
- Timetracking
- Project management
- Reporting

🌐 Resources

Go Programming

The Zen of Go

Functional Programming in Go

IBM FP-Go Documentation

README.md Unescape Escape

⏰ ActaTempus: Time Tracking and Management System

🌟 Overview