Add macos build for arm

.github/workflows/build.yml

@@ -25,9 +25,35 @@ jobs:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
 
-      - name: Build and Push Docker image -- finn-board
+      - name: Build and Push Docker image
         uses: docker/build-push-action@675965c0e16f1a0f94ecafff969d8c966f92c17b
         with:
           context: .
           push: true
           tags: git.joshuacoles.me/joshuacoles/revision-ui:latest
+
+  build-arm:
+    runs-on: macos-latest
+    container:
+      image: catthehacker/ubuntu:act-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v1
+
+      - name: Login to Docker
+        uses: docker/login-action@v1
+        with:
+          registry: git.joshuacoles.me
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      - name: Build and Push Docker image
+        uses: docker/build-push-action@675965c0e16f1a0f94ecafff969d8c966f92c17b
+        with:
+          context: .
+          push: true
+          tags: git.joshuacoles.me/joshuacoles/revision-ui:arm

.gitignore

@@ -37,3 +37,9 @@ yarn-error.log*
 # typescript
 *.tsbuildinfo
 next-env.d.ts
+
+# Private env files
+.env
+
+# Caddyfile for local development when testing weird deploys
+/Caddyfile

next.config.js

@@ -1,12 +1,6 @@
 /** @type {import('next').NextConfig} */
 const nextConfig = {
     output: 'standalone',
-    rewrites: async () => [
-        {
-            source: '/api/:path*',
-            destination: 'https://revision.joshuacoles.me/api/:path*',
-        },
-    ],
 }
 
 module.exports = nextConfig

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "tremor-dashboard",
+  "name": "revision-tracker",
   "version": "0.1.0",
   "private": true,
   "scripts": {
@@ -11,35 +11,40 @@
   },
   "dependencies": {
     "@heroicons/react": "^1.0.6",
-    "@tremor/react": "^3.12.0",
-    "@types/ramda": "^0.29.9",
+    "@tremor/react": "^3.13.4",
+    "@types/ramda": "^0.29.10",
     "date-fns": "^2.30.0",
     "heat-calendar": "^1.0.7",
+    "kysely": "^0.27.2",
     "next": "^14.1.0",
+    "pg": "^8.11.3",
     "ramda": "^0.29.1",
-    "react": "^18",
+    "react": "^18.2.0",
     "react-calendar-heatmap": "^1.9.0",
-    "react-date-heatmap": "^1.0.4",
-    "react-dom": "^18",
-    "react-tooltip": "^5.25.0",
-    "reaviz": "^15.2.1",
-    "swr": "^2.2.4"
+    "react-date-heatmap": "^1.0.5",
+    "react-dom": "^18.2.0",
+    "react-tooltip": "^5.26.1",
+    "reaviz": "^15.7.0",
+    "swr": "^2.2.4",
+    "zod": "^3.22.4"
   },
   "devDependencies": {
-    "@testing-library/jest-dom": "^6.1.5",
-    "@testing-library/react": "^14.1.2",
-    "@types/node": "^20",
-    "@types/react": "^18",
-    "@types/react-calendar-heatmap": "^1.6.6",
-    "@types/react-dom": "^18",
-    "autoprefixer": "^10.0.1",
-    "eslint": "^8",
+    "@testing-library/jest-dom": "^6.4.2",
+    "@testing-library/react": "^14.2.1",
+    "@types/node": "^20.11.17",
+    "@types/pg": "^8.11.0",
+    "@types/react": "^18.2.55",
+    "@types/react-calendar-heatmap": "^1.6.7",
+    "@types/react-dom": "^18.2.19",
+    "autoprefixer": "^10.4.17",
+    "eslint": "^8.56.0",
     "eslint-config-next": "14.0.4",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "postcss": "^8",
-    "tailwindcss": "^3.3.0",
+    "kysely-codegen": "^0.11.0",
+    "postcss": "^8.4.35",
+    "tailwindcss": "^3.4.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5"
+    "typescript": "^5.3.3"
   }
 }

src/app/OverviewPage.tsx

@@ -1,36 +0,0 @@
-import {SubjectComparisonCard} from "@/app/cards/subjectComparisonCard";
-import {CalendarOverviewCard} from "@/app/cards/calendarOverviewCard";
-import {OverviewConfig} from "@/app/overviewConfig";
-import {SubjectOverviewCard} from "@/app/cards/subjectOverviewCard";
-import {getData} from "@/app/fetchData";
-
-export default async function OverviewPage({config}: {
-    config: OverviewConfig
-}) {
-    const data = await getData(config);
-
-    return (
-        <main className="m-6">
-            <h1 className="text-3xl font-semibold text-slate-900 dark:text-white my-2">{config.title}</h1>
-
-            <div className="grid gap-5 grid-cols-1 sm:grid-cols-4">
-                {config.subjects.map((subject) => (
-                    <SubjectOverviewCard
-                        key={subject.projectId}
-                        projectId={subject.projectId}
-                        title={subject.title}
-                        data={data}
-                    />
-                ))}
-
-                <CalendarOverviewCard
-                    data={data}
-                    startTime={config.timePeriod.start}
-                    endTime={config.timePeriod.end}
-                />
-
-                <SubjectComparisonCard data={data}/>
-            </div>
-        </main>
-    )
-}

src/app/api/route.ts

@@ -0,0 +1,21 @@
+import {NextRequest} from "next/server";
+
+import {getData} from "@/data/fetchData";
+import {periodMap} from "@/data/periods";
+
+export async function GET(request: NextRequest): Promise<Response> {
+    const period = request.nextUrl.searchParams.get('period');
+
+    if (period == null) {
+        return new Response('No period provided', {status: 400});
+    }
+
+    if (!periodMap.hasOwnProperty(period)) {
+        return new Response('Invalid period', {status: 400});
+    }
+
+    const config = periodMap[period as keyof typeof periodMap];
+    const data = await getData(config);
+
+    return Response.json(data)
+}

src/app/cards/calendarOverviewCard.tsx

@@ -1,81 +0,0 @@
-"use client";
-import {Card, Title} from "@tremor/react";
-import * as R from 'ramda';
-import * as dFns from 'date-fns';
-import CalendarHeatmap from 'react-calendar-heatmap';
-import 'react-calendar-heatmap/dist/styles.css';
-import '../calendar-styles.css'
-import {Tooltip} from 'react-tooltip';
-import {Data} from "@/app/fetchData";
-
-const dailyGoal = 4;
-const granularity = 4;
-
-function computeCompletionShade(value: number) {
-    const linearValue = Math.round((value / dailyGoal) * granularity);
-    if (linearValue == 0 && value > 0) return 1;
-    if (linearValue > granularity) return granularity;
-    return linearValue;
-}
-
-function useCalendarData(data: Data, initialDate: Date, endDate: Date) {
-    const timeEntries = data.timeEntries;
-
-    // Group by day, sum up seconds
-    const grouped = R.groupBy((entry) => {
-        return dFns.formatISO(dFns.startOfDay(dFns.parseISO(entry.start)));
-    }, timeEntries);
-
-    const summed = R.mapObjIndexed((entries) => {
-        return R.sum((entries ?? []).map((entry) => entry.duration))
-    }, grouped);
-
-    // Fill in missing days, hacky
-    dFns.eachDayOfInterval({
-        start: initialDate,
-        end: endDate,
-    }).forEach((date) => {
-        const key = dFns.formatISO(date);
-        if (summed[key] == undefined) {
-            summed[key] = 0;
-        }
-    })
-
-    return Object.entries(summed)
-        .map(([key, value]) => ({
-            date: dFns.parseISO(key),
-            count: value / (60 * 60),
-        }))
-}
-
-export function CalendarOverviewCard({
-                                         data,
-                                         startTime,
-                                         endTime
-                                     }: {
-    data: Data,
-    startTime: string,
-    endTime: string,
-}) {
-    const initialDate = dFns.parseISO(startTime);
-    const endDate = dFns.parseISO(endTime);
-    const calendarData = useCalendarData(data, initialDate, endDate);
-
-    return <Card className="col-span-1">
-        <Tooltip id="calendar-tooltip"/>
-        <Title>Overview</Title>
-        <CalendarHeatmap
-            showWeekdayLabels={true}
-            startDate={initialDate}
-            endDate={endDate}
-            values={calendarData}
-            classForValue={value => `color-github-${computeCompletionShade(value?.count ?? 0)}`}
-            tooltipDataAttrs={(value: any) => {
-                return value.date ? {
-                    'data-tooltip-id': `calendar-tooltip`,
-                    'data-tooltip-content': value.count ? `${dFns.format(value.date, 'EEE do')}: ${value.count.toFixed(2)} hours` : `${dFns.format(value.date, 'EEE do')}`
-                } : undefined
-            }}
-        />
-    </Card>
-}

src/app/fetchData.ts

@@ -1,45 +0,0 @@
-"use server";
-
-import {OverviewConfig} from "@/app/overviewConfig";
-
-export interface Data {
-    projects: {
-        projectId: number,
-        name: string,
-        color: string,
-    }[],
-
-    timeEntries: {
-        projectId: number,
-        start: string,
-        end: string,
-        duration: number,
-        // description: string,
-    }[],
-}
-
-export async function getData(config: OverviewConfig) {
-    const projectIds = config.subjects.map((subject) => subject.projectId);
-    const projectResponse = await fetch(`https://revision.joshuacoles.me/api/project?select=raw_json&toggl_id=in.(${projectIds.join(',')})`);
-    const projects = await projectResponse.json();
-    const projectLensed = projects.map((project: any) => ({
-        projectId: project.raw_json.id,
-        name: project.raw_json.name,
-        color: project.raw_json.color,
-    }));
-
-    const timeEntriesResponse = await fetch(`https://revision.joshuacoles.me/api/time_entry?select=project_id,raw_json&project_id=in.(${projectIds.join(',')})&start=gt.${config.timePeriod.start}&start=lt.${config.timePeriod.end}`);
-    const timeEntries = await timeEntriesResponse.json();
-    const timeEntriesLensed = timeEntries.map((timeEntry: any) => ({
-        projectId: timeEntry.project_id,
-        start: timeEntry.raw_json.start,
-        end: timeEntry.raw_json.end,
-        duration: timeEntry.raw_json.seconds,
-        // description: timeEntry.raw_json.description,
-    }));
-
-    return {
-        projects: projectLensed,
-        timeEntries: timeEntriesLensed,
-    };
-}

src/app/overviewConfig.ts

@@ -1,40 +0,0 @@
-export interface OverviewConfig {
-    title: string,
-
-    subjects: {
-        title?: string,
-        projectId: number,
-    }[],
-
-    goalHours: number,
-
-    timePeriod: {
-        start: string,
-        end: string
-    },
-}
-
-export const semester1Revision: OverviewConfig = {
-    title: 'Semester 1 Revision',
-    goalHours: 4,
-    subjects: [
-        {
-            projectId: 195482340,
-        },
-        {
-            title: 'Measure Theory',
-            projectId: 195519024,
-        },
-        {
-            title: 'Quantum Mechanics',
-            projectId: 195518593,
-        },
-        {
-            projectId: 195754611,
-        }
-    ],
-    timePeriod: {
-        start: "2023-12-15T00:00:00.000Z",
-        end: "2024-01-25T00:00:00.000Z"
-    }
-}

src/app/page.tsx

@@ -1,6 +1,18 @@
-import OverviewPage from "@/app/OverviewPage";
-import {semester1Revision} from "@/app/overviewConfig";
+import Link from "next/link";
 
 export default function Home() {
-    return <OverviewPage config={semester1Revision}/>
+    return <main className="m-6 text-slate-900 dark:text-white">
+        <h1 className="text-3xl font-semibold my-2">Work Tracker</h1>
+
+        <ol>
+            <li>
+                <Link href="/sem1-revision" className={"text-blue-500 underline underline-offset-2"}>
+                    Semester 1 Revision
+                </Link>
+            </li>
+            <li>
+                <Link href="/sem2" className={"text-blue-500 underline underline-offset-2"}>Semester 2</Link>
+            </li>
+        </ol>
+    </main>
 }

src/app/sem1-revision/page.tsx

@@ -0,0 +1,5 @@
+import OverviewPageWrapper from "@/components/PageWrapper";
+
+export default function Home() {
+    return <OverviewPageWrapper period={'y5-s1-revision'}/>
+}

src/app/sem2/page.tsx

@@ -1,32 +1,5 @@
-import OverviewPage from "@/app/OverviewPage";
-import {OverviewConfig} from "@/app/overviewConfig";
-
-const semester2: OverviewConfig = {
-    title: 'Semester 2',
-    goalHours: 4,
-    subjects: [
-        {
-            projectId: 195754611,
-        },
-        {
-            projectId: 199383703,
-        },
-        {
-            projectId: 199383691,
-        },
-        {
-            projectId: 198859760,
-        },
-        {
-            projectId: 199383698,
-        },
-    ],
-    timePeriod: {
-        start: "2024-02-03T00:00:00.000Z",
-        end: "2024-05-10T00:00:00.000Z"
-    }
-}
+import OverviewPageWrapper from "@/components/PageWrapper";
 
 export default function Home() {
-    return <OverviewPage config={semester2}/>
+    return <OverviewPageWrapper period={'y5-s2'}/>
 }

src/app/utils.ts

@@ -1,4 +0,0 @@
-export const fetcher = (
-    input: string | URL | globalThis.Request,
-    init?: RequestInit,
-) => fetch(input, init).then(res => res.json())

src/components/Donut.tsx

@@ -0,0 +1,96 @@
+import * as R from "ramda";
+import DonutTooltip from "@/components/DonutTooltip";
+import './donut-styles.css'
+
+export type DonutChartData = {
+    label: string;
+    colour: string;
+    value: number;
+}[];
+
+export function Donut({
+                          data,
+                          centerLabel,
+                          formatter,
+                          hoverSuffix
+                      }: {
+    data: DonutChartData,
+    formatter: (value: number) => string,
+    centerLabel: string,
+    hoverSuffix: string,
+}) {
+    const radius = 100 / (2 * Math.PI);
+    const backgroundColour = "#d2d3d4";
+
+    const preppedData = R.sortBy(R.compose(R.negate, R.prop('value')), data);
+    const total = R.sum(R.pluck('value', preppedData));
+    const normalisingFactor = 100 / total;
+
+    return (
+        <>
+            <DonutTooltip/>
+            <svg width="100%" height="100%" viewBox="0 0 42 42" className="donut">
+                {/* The hole in the middle of the donut */}
+                <circle
+                    className="donut-hole"
+                    cx="21"
+                    cy="21"
+                    r={radius}
+                    fill="#fff"
+                />
+
+                {/* The ring in the background of the donut, if it was not 100% full */}
+                <circle
+                    className="donut-ring"
+                    cx="21"
+                    cy="21"
+                    r={radius}
+                    fill="transparent"
+                    stroke={backgroundColour}
+                    strokeWidth="3"
+                />
+
+                {
+                    preppedData.map((segment, index, array) => {
+                        const {
+                            label,
+                            colour,
+                            value
+                        } = segment;
+                        const precedingSegments = array.slice(0, index);
+                        const offset = precedingSegments.reduce((acc, segment) => acc + segment.value, 0);
+
+                        return (
+                            <circle
+                                data-tooltip-id="donut-tooltip"
+                                data-tooltip-content={`${label}: ${formatter(value)}${hoverSuffix}`}
+                                data-tooltip-place="top"
+
+                                key={index}
+                                className="donut-segment"
+                                cx="21"
+                                cy="21"
+                                r={radius}
+                                fill="transparent"
+                                stroke={colour}
+                                strokeWidth="3"
+                                strokeDasharray={`${value * normalisingFactor} ${100 - value * normalisingFactor}`}
+                                strokeDashoffset={100 - (offset * normalisingFactor) + 25}
+                                style={{outline: 'none'}}
+                            />
+                        )
+                    })
+                }
+
+                <g className="chart-text" style={{ userSelect: 'none'}}>
+                    <text x="50%" y="50%" className="chart-number">
+                        {formatter(total)}
+                    </text>
+                    <text x="50%" y="50%" className="chart-label">
+                        {centerLabel}
+                    </text>
+                </g>
+            </svg>
+        </>
+    );
+}

src/components/DonutTooltip.tsx

@@ -0,0 +1,7 @@
+'use client';
+
+import {Tooltip} from "react-tooltip";
+
+export default function DonutTooltip() {
+    return <Tooltip id="donut-tooltip"/>
+}

src/components/HeatMap.tsx

@@ -0,0 +1,159 @@
+import React from "react";
+import * as dFns from "date-fns";
+import * as R from 'ramda';
+
+interface DateValue {
+    date: Date;
+    count: number;
+}
+
+interface Props {
+    startDate: Date;
+    endDate: Date;
+    data: DateValue[];
+    className?: string;
+    goal: number;
+    penaliseOvertime?: boolean;
+}
+
+function GitHubCalendarHeatmap({
+                                   startDate,
+                                   endDate,
+                                   data,
+                                   className,
+                                   goal,
+                                   penaliseOvertime = false,
+                               }: Props) {
+    const numDays = dFns.differenceInDays(endDate, startDate);
+
+    // Calculate the number of weeks in the range
+    const numWeeks = Math.ceil(numDays / 7);
+
+    // Calculate the size of each square in the heatmap and the padding between each square
+    const squareSize = 15;
+    const padding = 2;
+    const weekTotalPadding = 10; // Extra padding for the week total row
+    const totalWidth = numWeeks * (squareSize + padding);
+    const totalHeight = 8 * (squareSize + padding) + weekTotalPadding; // Added an extra row for week total
+
+    // Goal times for the daily and weekly squares
+    const dayGoalTime = goal;
+    const weekGoalTime = 5 * dayGoalTime;
+
+    const getColorForValue = (value: number, goalTime: number, zeroColor: string): string => {
+        const buckets = [
+            {
+                min: -Infinity,
+                max: 0,
+                color: zeroColor,
+            },
+            {
+                min: 0,
+                max: 0.40,
+                color: '#d6e685',
+            },
+            {
+                min: 0.40,
+                max: 0.50,
+                color: '#8cc665',
+            },
+            {
+                min: 0.50,
+                max: 0.90,
+                color: '#44a340',
+            },
+            {
+                min: 0.90,
+                // If penalising overtime, the max is 1.125, otherwise it's infinity (ie this is the last bucket)
+                max: penaliseOvertime ? 1.125 : Infinity,
+                color: '#1e6823',
+            },
+            {
+                min: 1.125,
+                max: 1.25,
+                color: '#f59e0b'
+            },
+            {
+                min: 1.25,
+                max: Infinity,
+                color: '#ef4444'
+            },
+        ];
+
+        const linearValue = value / goalTime;
+        return R.find(minMax => minMax.min < linearValue && linearValue <= minMax.max, buckets)!.color;
+    };
+
+    const getWeekTotal = (weekIndex: number): number => {
+        const weekStart = dFns.addWeeks(dFns.startOfWeek(startDate, {weekStartsOn: 1}), weekIndex);
+
+        return data.filter(dv => dFns.isSameWeek(dv.date, weekStart, {weekStartsOn: 1}))
+            .reduce((total, {count}) => total + count, 0);
+    };
+
+    const dateValues: DateValue[] = dFns.eachDayOfInterval({
+        start: startDate,
+        end: endDate,
+    }).map((date) => {
+        const foundData = data.find(
+            ({date: dataDate}) => dFns.isEqual(dFns.startOfDay(date), dFns.startOfDay(dataDate))
+        );
+
+        return {
+            date,
+            count: foundData ? foundData.count : 0,
+        }
+    });
+
+    return (
+        <svg width="100%" height="100%" viewBox={`0 0 ${totalWidth} ${totalHeight}`} className={className}>
+            {dateValues.map(({
+                                 date,
+                                 count
+                             }) => {
+                const weekIndex = dFns.differenceInCalendarWeeks(date, startDate, {weekStartsOn: 1});
+
+                const dayOfWeek = (date.getDay() + 6) % 7;
+                const x = weekIndex * (squareSize + padding);
+                const y = dayOfWeek * (squareSize + padding);
+                const color = getColorForValue(count, dayGoalTime, dFns.isWeekend(date) ? '#d4d4d4' : '#eeeeee');
+
+                return (
+                    <rect
+                        key={date.toISOString()}
+                        x={x}
+                        y={y}
+                        width={squareSize}
+                        height={squareSize}
+                        fill={color}
+                        data-tooltip-id={`calendar-tooltip`}
+                        data-tooltip-content={count ? `${dFns.format(date, 'EEE do')}: ${count.toFixed(2)} hours` : `${dFns.format(date, 'EEE do')}`}
+                    />
+                );
+            })}
+
+            {Array(numWeeks).fill(0)
+                .map((_, weekIndex) => {
+                    const x = weekIndex * (squareSize + padding);
+                    const y = 7 * (squareSize + padding) + weekTotalPadding; // Position for the week total
+                    const count = getWeekTotal(weekIndex);
+                    const color = getColorForValue(count, weekGoalTime, '#eeeeee');
+
+                    return (
+                        <rect
+                            key={`week-total-${weekIndex}`}
+                            x={x}
+                            y={y}
+                            width={squareSize}
+                            height={squareSize}
+                            fill={color}
+                            data-tooltip-id={`calendar-tooltip`}
+                            data-tooltip-content={count ? `Week total ${count.toFixed(2)} hours` : ``}
+                        />
+                    );
+                })}
+        </svg>
+    );
+}
+
+export default GitHubCalendarHeatmap;

src/components/OverviewPage.tsx

@@ -0,0 +1,59 @@
+"use client";
+
+import {SubjectComparisonCard} from "@/components/cards/subjectComparisonCard";
+import {CalendarOverviewCard} from "@/components/cards/calendarOverviewCard";
+import {SubjectOverviewCard} from "@/components/cards/subjectOverviewCard";
+import useSWR from "swr";
+import {Data, OverviewConfig} from "@/data/fetchData";
+import {PeriodKey} from "@/data/periods";
+
+function useData(periodKey: PeriodKey, initialData: Data = {
+    projects: [],
+    timeEntries: [],
+}): Data {
+    const {data} = useSWR(periodKey, async () => {
+        const res = await fetch(`/api?period=${periodKey}`);
+        const json = await res.json();
+        return json as Data;
+    });
+
+    return data ?? initialData;
+}
+
+
+export default function OverviewPage({
+                                         config,
+                                         initialData
+                                     }: {
+    config: OverviewConfig,
+    initialData?: Data,
+}) {
+    const data = useData(config.periodKey, initialData);
+
+    return (
+        <main className="m-6">
+            <h1 className="text-3xl font-semibold text-slate-900 dark:text-white my-2">{config.title}</h1>
+
+            <div className="grid gap-5 grid-cols-1 sm:grid-cols-2 lg:grid-cols-4">
+                {config.subjects.map((subject) => (
+                    <SubjectOverviewCard
+                        key={subject.projectId}
+                        projectId={subject.projectId}
+                        title={subject.title}
+                        data={data}
+                    />
+                ))}
+
+                <CalendarOverviewCard
+                    data={data}
+                    goal={config.goalHours}
+                    penaliseOvertime={config.penaliseOvertime}
+                    startTime={config.timePeriod.start}
+                    endTime={config.timePeriod.end}
+                />
+
+                <SubjectComparisonCard data={data}/>
+            </div>
+        </main>
+    )
+}

src/components/PageWrapper.tsx

@@ -0,0 +1,13 @@
+"use server";
+
+import OverviewPage from "@/components/OverviewPage";
+import {getData} from "@/data/fetchData";
+import {PeriodKey, periodMap} from "@/data/periods";
+
+export default async function OverviewPageWrapper({period}: {
+    period: PeriodKey
+}) {
+    const config = periodMap[period];
+    const data = await getData(config);
+    return <OverviewPage config={config} initialData={data}/>;
+}

src/components/cards/calendarOverviewCard.tsx

@@ -0,0 +1,51 @@
+import {Card, Title} from "@tremor/react";
+import * as R from 'ramda';
+import * as dFns from 'date-fns';
+import {Tooltip} from 'react-tooltip';
+import {Data} from "@/data/fetchData";
+import HeatMap from "@/components/HeatMap";
+
+function useCalendarData(data: Data) {
+    const timeEntries = data.timeEntries;
+
+    // Group by day, sum up seconds
+    const grouped = R.groupBy((entry) => {
+        return dFns.formatISO(dFns.startOfDay(dFns.parseISO(entry.start)));
+    }, timeEntries);
+
+    const summed = R.mapObjIndexed((entries) => {
+        return R.sum((entries ?? []).map((entry) => entry.duration))
+    }, grouped);
+
+    return Object.entries(summed)
+        .map(([key, value]) => ({
+            date: dFns.parseISO(key),
+            count: value / (60 * 60),
+        }))
+}
+
+export function CalendarOverviewCard({
+                                         data,
+                                         goal,
+                                         penaliseOvertime,
+                                         startTime,
+                                         endTime,
+                                     }: {
+    data: Data,
+    goal: number,
+    penaliseOvertime?: boolean,
+    startTime: string,
+    endTime: string,
+}) {
+    const initialDate = dFns.parseISO(startTime);
+    const endDate = dFns.parseISO(endTime);
+    const calendarData = useCalendarData(data);
+
+    return <Card className="col-span-1">
+        <Tooltip id="calendar-tooltip"/>
+        <Title>Semester Overview</Title>
+        <div className="m-2">
+            <HeatMap startDate={initialDate} endDate={endDate} data={calendarData} goal={goal} penaliseOvertime={penaliseOvertime}/>
+        </div>
+    </Card>
+}

src/components/cards/subjectComparisonCard.tsx

@@ -1,24 +1,20 @@
-"use client";
-
-import {Card, DonutChart, Title} from "@tremor/react";
+import {Card, Title} from "@tremor/react";
 import * as R from "ramda";
-import {Data} from "@/app/fetchData";
+import {Data} from "@/data/fetchData";
+import {Donut, DonutChartData} from "@/components/Donut";
 
-function useBreakdownData(data: Data): {
-    name: string,
-    value: number,
-    colour: string
-}[] {
+function useBreakdownData(data: Data): DonutChartData {
     const sorted = R.sortBy(R.prop('projectId'), data.timeEntries);
     const grouped = R.groupWith(R.eqBy(R.prop('projectId')), sorted);
 
     return grouped
         .map((entries) => {
             const project = data.projects.find(p => p.projectId === entries[0].projectId)!;
+            const totalDuration = (entries).map((entry) => entry.duration).reduce((a, b) => a + b, 0);
 
             return ({
-                name: project.name,
-                value: (entries).map((entry) => entry.duration).reduce((a, b) => a + b, 0),
+                label: project.name,
+                value: (totalDuration / (60 * 60)),
                 colour: project.color,
             });
         })
@@ -30,20 +26,15 @@ export function SubjectComparisonCard({
     data: Data,
 }) {
     const breakdownData = useBreakdownData(data);
-    const colours = breakdownData.map((entry) => entry.colour);
-
-    const valueFormatter = (number: number) => `${(number / (60 * 60)).toFixed(2)} hours`;
 
     return (
         <Card className="col">
             <Title>Relative Breakdown</Title>
-            <DonutChart
-                className="mt-6"
+            <Donut
                 data={breakdownData ?? []}
-                category="value"
-                index="name"
-                valueFormatter={valueFormatter}
-                colors={colours}
+                formatter={v => v.toFixed(2)}
+                centerLabel={"hours"}
+                hoverSuffix={"h"}
             />
         </Card>
     )

src/components/cards/subjectOverviewCard.tsx

@@ -1,5 +1,5 @@
 import {Card, Metric, Text, Title} from "@tremor/react";
-import {Data} from "@/app/fetchData";
+import {Data} from "@/data/fetchData";
 
 export function SubjectOverviewCard({
                                         title,

src/components/donut-styles.css

@@ -0,0 +1,19 @@
+.chart-text {
+    font: 16px/1.4em "Montserrat", Arial, sans-serif;
+    fill: #000;
+    transform: translateY(0.25em);
+}
+
+.chart-number {
+    font-size: 0.6em;
+    line-height: 1;
+    text-anchor: middle;
+    transform: translateY(-0.25em);
+}
+
+.chart-label {
+    font-size: 0.2em;
+    text-transform: uppercase;
+    text-anchor: middle;
+    transform: translateY(0.7em);
+}

src/data/database.ts

@@ -0,0 +1,76 @@
+import {DB as Database} from './db' // this is the Database interface we defined earlier
+import {Pool} from 'pg'
+import {Kysely, PostgresDialect} from 'kysely'
+import * as fs from "node:fs";
+import {z} from 'zod';
+
+type Env = z.infer<typeof envSchema>;
+const envSchema = z.object({
+    POSTGRES_DB: z.string(),
+    POSTGRES_HOST: z.string(),
+    POSTGRES_PORT: z.string().transform((val, ctx) => {
+        const parsed = parseInt(val);
+        if (isNaN(parsed)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "Not a number",
+            });
+
+            return z.NEVER;
+        }
+        return parsed;
+    }),
+
+    POSTGRES_USER: z.string().optional(),
+    POSTGRES_USER_FILE: z.string().optional(),
+    POSTGRES_PASSWORD: z.string().optional(),
+    POSTGRES_PASSWORD_FILE: z.string().optional(),
+}).refine(
+    env => env.POSTGRES_USER || env.POSTGRES_USER_FILE,
+    {
+        message: "Either POSTGRES_USER or POSTGRES_USER_FILE must be set",
+        path: ["POSTGRES_USER", "POSTGRES_USER_FILE"],
+    }
+).refine(
+    env => env.POSTGRES_PASSWORD || env.POSTGRES_PASSWORD_FILE,
+    {
+        message: "Either POSTGRES_PASSWORD or POSTGRES_PASSWORD_FILE must be set",
+        path: ["POSTGRES_PASSWORD", "POSTGRES_PASSWORD_FILE"],
+    }
+);
+
+const buildTime = process.env.NEXT_PHASE === 'phase-production-build';
+const env = buildTime ? 'build-time' : envSchema.parse(process.env);
+
+function fileOrEnv(fileKey: keyof Env, valueKey: keyof Env): string | undefined {
+    if (env == 'build-time') {
+        return undefined;
+    }
+
+    const file: string = env[fileKey] as string;
+
+    if (file && fs.existsSync(file)) {
+        return fs.readFileSync(file, 'utf8');
+    }
+
+    return env[valueKey] as string;
+}
+
+function getCredentials() {
+    return {
+        user: fileOrEnv('POSTGRES_USER_FILE', 'POSTGRES_USER'),
+        password: fileOrEnv('POSTGRES_PASSWORD_FILE', 'POSTGRES_PASSWORD'),
+    }
+}
+
+export const db = env === 'build-time' ? null : new Kysely<Database>({
+    dialect: new PostgresDialect({
+        pool: new Pool({
+            database: env.POSTGRES_DB,
+            host: env.POSTGRES_HOST,
+            port: env.POSTGRES_PORT,
+            ...getCredentials(),
+            max: 10,
+        })
+    }),
+})

src/data/db.d.ts

@@ -0,0 +1,69 @@
+import type {ColumnType} from "kysely";
+
+export type Generated<T> = T extends ColumnType<infer S, infer I, infer U>
+    ? ColumnType<S, I | undefined, U>
+    : ColumnType<T, T | undefined, T>;
+
+export type Int8 = ColumnType<string, bigint | number | string, bigint | number | string>;
+
+export type Json = ColumnType<JsonValue, string, string>;
+
+export type JsonArray = JsonValue[];
+
+export type JsonObject = {
+    [K in string]?: JsonValue;
+};
+
+export type JsonPrimitive = boolean | number | string | null;
+
+export type JsonValue = JsonArray | JsonObject | JsonPrimitive;
+
+export type Timestamp = ColumnType<Date, Date | string, Date | string>;
+
+export interface Client {
+    archived: boolean;
+    at: Timestamp;
+    id: number;
+    name: string;
+    server_deleted_at: Timestamp | null;
+    workspace_id: number;
+}
+
+export interface Project {
+    active: boolean;
+    client_id: number | null;
+    color: string;
+    id: Generated<number>;
+    name: string;
+    raw_json: Json;
+    server_created_at: Timestamp;
+    server_deleted_at: Timestamp | null;
+    server_updated_at: Timestamp;
+    toggl_id: Int8;
+    workspace_id: Int8;
+}
+
+export interface TimeEntry {
+    description: string;
+    id: Generated<number>;
+    project_id: Int8 | null;
+    raw_json: Json;
+    server_deleted_at: Timestamp | null;
+    server_updated_at: Timestamp;
+    start: Timestamp;
+    stop: Timestamp;
+    tags: Generated<Json>;
+    toggl_id: Int8;
+}
+
+export interface TogglPortalSeaqlMigrations {
+    applied_at: Int8;
+    version: string;
+}
+
+export interface DB {
+    client: Client;
+    project: Project;
+    time_entry: TimeEntry;
+    toggl_portal_seaql_migrations: TogglPortalSeaqlMigrations;
+}

src/data/fetchData.ts

@@ -0,0 +1,80 @@
+"use server";
+
+import {db} from "@/data/database";
+import * as dFns from "date-fns";
+import {PeriodKey} from "@/data/periods";
+
+export interface Data {
+    projects: {
+        projectId: number,
+        name: string,
+        color: string,
+    }[],
+
+    timeEntries: {
+        projectId: number,
+        start: string,
+        end: string,
+        duration: number,
+        // description: string,
+    }[],
+}
+
+export interface OverviewConfig {
+    title: string,
+    periodKey: PeriodKey,
+
+    subjects: {
+        title?: string,
+        projectId: number,
+    }[],
+
+    goalHours: number,
+    penaliseOvertime?: boolean,
+
+    timePeriod: {
+        start: string,
+        end: string
+    },
+}
+
+export async function getData(config: OverviewConfig): Promise<Data> {
+    // If we're in build-time, we don't have access to the database
+    if (!db) {
+        return {
+            projects: [],
+            timeEntries: [],
+        }
+    }
+
+    console.log('fetching data from SQL')
+
+    let projectIds = config.subjects.map((subject) => subject.projectId.toString());
+
+    const projects = await db.selectFrom('project')
+        .select(['toggl_id', 'name', 'color'])
+        .where('toggl_id', 'in', projectIds)
+        .execute()
+
+    const timeEntries = await db.selectFrom('time_entry')
+        .select(['project_id', 'start', 'stop'])
+        .where('project_id', 'in', projectIds)
+        .where('start', '>', dFns.parseISO(config.timePeriod.start))
+        .where('start', '<', dFns.parseISO(config.timePeriod.end))
+        .execute();
+
+    return {
+        projects: projects.map((project) => ({
+            projectId: parseInt(project.toggl_id),
+            name: project.name,
+            color: project.color,
+        })),
+
+        timeEntries: timeEntries.map((timeEntry) => ({
+            projectId: parseInt(timeEntry.project_id!),
+            start: dFns.formatISO(timeEntry.start),
+            end: dFns.formatISO(timeEntry.stop),
+            duration: dFns.differenceInSeconds(timeEntry.stop, timeEntry.start)
+        })),
+    }
+}

src/data/periods.ts

@@ -0,0 +1,61 @@
+import {OverviewConfig} from "@/data/fetchData";
+
+export const semester1Revision: OverviewConfig = {
+    title: 'Semester 1 Revision',
+    periodKey: 'y5-s1-revision',
+    goalHours: 4,
+    subjects: [
+        {
+            projectId: 195482340,
+        },
+        {
+            title: 'Measure Theory',
+            projectId: 195519024,
+        },
+        {
+            title: 'Quantum Mechanics',
+            projectId: 195518593,
+        },
+        {
+            projectId: 195754611,
+        }
+    ],
+    timePeriod: {
+        start: "2023-12-15T00:00:00.000Z",
+        end: "2024-01-25T00:00:00.000Z"
+    }
+}
+
+export const semester2: OverviewConfig = {
+    title: 'Semester 2',
+    periodKey: 'y5-s2',
+    goalHours: 6,
+    penaliseOvertime: true,
+    subjects: [
+        {
+            projectId: 195754611,
+        },
+        {
+            projectId: 199383703,
+        },
+        {
+            projectId: 199383691,
+        },
+        {
+            projectId: 198859760,
+        },
+        {
+            projectId: 199383698,
+        },
+    ],
+    timePeriod: {
+        start: "2024-02-03T00:00:00.000Z",
+        end: "2024-05-10T00:00:00.000Z"
+    }
+}
+
+export type PeriodKey = keyof typeof periodMap;
+export const periodMap = {
+    'y5-s1-revision': semester1Revision,
+    'y5-s2': semester2,
+}