add backend API routes

.env.example

@@ -1,4 +1,6 @@
 POSTGRES_USER=postgres
 POSTGRES_PASSWORD=postgres
+POSTGRES_DB=acm_website
+POSTGRES_HOST=db
 
-PORT=5001
+PORT=5001

.github/actions/setup/action.yml

@@ -0,0 +1,29 @@
+name: Setup
+description: "Setup Bun"
+
+inputs:
+  os:
+    description: "Runner OS"
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Setup Bun
+      uses: oven-sh/setup-bun@v1
+      with:
+        bun-version: latest
+
+    - name: Cache Bun dependencies
+      uses: actions/cache@v4
+      with:
+        path: ~/.bun/install/cache
+        key: ${{ inputs.os }}-bun-${{ hashFiles('**/bun.lockb') }}
+        restore-keys: |
+          ${{ inputs.os }}-bun-
+
+    - name: Install dependencies
+      shell: bash
+      run: |
+        cd server
+        bun install

.github/workflows/ci.yml

@@ -3,7 +3,7 @@ name: CI
 on:
   push:
     branches:
-      - '**' # currently run on all branches
+      - "**" # currently run on all branches
   pull_request:
     types: [opened, synchronize, reopened]
 
@@ -14,23 +14,9 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
+      - uses: ./.github/actions/setup
         with:
-          bun-version: latest
-
-      - name: Cache Bun dependencies
-        uses: actions/cache@v4
-        with:
-          path: ~/.bun/install/cache
-          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
-          restore-keys: |
-            ${{ runner.os }}-bun-
-
-      - name: Install dependencies
-        run: |
-          cd server
-          bun install
+          os: ${{ runner.os }}
 
       - name: Run tests
         run: |
@@ -41,24 +27,27 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
         with:
-          bun-version: latest
+          ref: ${{ github.event.pull_request.head.ref }}
 
-      - name: Cache Bun dependencies
-        uses: actions/cache@v4
+      - uses: ./.github/actions/setup
         with:
-          path: ~/.bun/install/cache
-          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
-          restore-keys: |
-            ${{ runner.os }}-bun-
+          os: ${{ runner.os }}
 
-      - name: Install dependencies
+      - name: Lint fix
         run: |
-          cd server
-          bun install
+          cd server/
+          bun lint --fix
+
+      - name: Commit lint fix
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          if ! git diff --exit-code > /dev/null
+          then
+            git commit -a -m "lint fix"
+            git push
+          fi
 
       - name: Run linter
         run: |
@@ -70,23 +59,9 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
-        with:
-          bun-version: latest
-
-      - name: Cache Bun dependencies
-        uses: actions/cache@v4
+      - uses: ./.github/actions/setup
         with:
-          path: ~/.bun/install/cache
-          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lockb') }}
-          restore-keys: |
-            ${{ runner.os }}-bun-
-
-      - name: Install dependencies
-        run: |
-          cd server
-          bun install
+          os: ${{ runner.os }}
 
       - name: Run typecheck
         run: |

.gitignore

@@ -1,3 +1,5 @@
 .env
 
 .DS_Store
+
+pg_password.txt

README.md

@@ -21,3 +21,16 @@ To shutdown the server and remove associated volume, run:
 ```sh
 docker compose -f docker-compose.dev.yml down -v
 ```
+
+## Documentation
+
+Generate the documentation with:
+
+```sh
+bun run docs
+```
+
+Show Docs
+```sh
+bun run docs:serve
+```

db-scripts/createdb.sql

@@ -1,4 +1,5 @@
-create database acm_website;
+SELECT 'CREATE DATABASE acm_website' 
+WHERE NOT EXISTS (SELECT FROM pg_database WHERE datname = 'acm_website')\gexec
 
 \c acm_website;
 
@@ -19,8 +20,8 @@ create table if not exists majors(
 );
 
 create table if not exists users(
-   id serial,
-   created_at timestamp not null default CURRENT_TIMESTAMP,
+   id text not null,
+   created_at timestamp not null,
    name text not null,
    email text not null,
    major text not null,
@@ -31,11 +32,30 @@ create table if not exists users(
    foreign key(major) references majors(name) on update cascade
 );
 
+create table if not exists session(
+   id text not null,
+   user_id text not null,
+   created_at timestamp not null,
+   active_expires BIGINT not null,
+   idle_expires BIGINT not null,
+   PRIMARY KEY(id),
+   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade on delete cascade
+);
+
+create table if not exists user_key(
+   id text not null,
+   user_id text not null,
+   hashed_password text,
+   PRIMARY KEY(id),
+   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade on delete cascade
+);
+
 create table if not exists equipment_rental_type(
    id serial,
    created_at timestamp not null default CURRENT_TIMESTAMP,
    name text not null,
-   price money not null,
+--   price money not null,
+   price numeric(10,2) not null,
    description text,
    PRIMARY KEY(id)
 );
@@ -50,61 +70,23 @@ create table if not exists equipment_item(
 
 create table if not exists equipment_rentals(
    item_id integer not null,
-   user_id integer not null,
+   user_id text,
    date_borrowed date not null default current_date,
    return_date date not null,
-   price money not null,
+--   price money not null,
+   price numeric(10,2) not null,
    condition equipment_condition_enum not null default 'ready',
    PRIMARY KEY(user_id, item_id),
    FOREIGN KEY(item_id) REFERENCES equipment_item(id) on update cascade,
-   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade
-);
-
-create table if not exists payments(
-   payment_id serial,
-   method text not null,
-   PRIMARY KEY(payment_id)
-);
-
-create table if not exists membership_plan(
-   id serial,
-   name text not null,
-   term membership_term_enum not null,
-   price integer not null,
-   PRIMARY KEY(id)
-);
-
-create table if not exists membership_requests(
-   id serial,
-   status membership_request_status_enum not null,
-   note text,
-   plan_id integer not null,
-   user_id integer not null,
-   PRIMARY KEY(id),
-   FOREIGN KEY(plan_id) REFERENCES membership_plan(id) on update cascade,
-   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade
-);
-
-create table if not exists membership(
-   id serial,
-   user_id integer not null,
-   start_date timestamp not null default CURRENT_TIMESTAMP,
-   end_date timestamp not null,
-   is_active boolean default true,
-   payment_id integer not null,
-   plan_id integer not null,
-   PRIMARY KEY(id),
-   FOREIGN KEY(plan_id) REFERENCES membership_plan(id),
-   FOREIGN KEY(payment_id) REFERENCES payments(payment_id),
-   FOREIGN KEY(user_id) REFERENCES users(id)
+   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade on delete set null
 );
 
 create table if not exists blacklist(
-   user_id integer not null,
+   user_id text not null,
    reason text not null,
    date_blacklisted timestamp not null default CURRENT_TIMESTAMP,
    PRIMARY KEY(user_id),
-   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade
+   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade on delete cascade
 );
 
 create table if not exists urls(
@@ -146,26 +128,26 @@ create table if not exists events_files(
    event_id integer not null,
    file_key text not null,
    primary key(event_id, file_key),
-   foreign key(event_id) references events(id) on update cascade,
-   foreign key(file_key) references files(key) on update cascade
+   foreign key(event_id) references events(id) on update cascade on delete cascade,
+   foreign key(file_key) references files(key) on update cascade on delete cascade
 );
 
 create table if not exists bookmarked_events(
-   user_id integer not null,
+   user_id text not null,
    event_id integer not null,
    bookmarked_date timestamp not null default CURRENT_TIMESTAMP,
    PRIMARY KEY(user_id, event_id),
-   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade,
-   FOREIGN KEY(event_id) REFERENCES events(id) on update cascade
+   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade on delete cascade,
+   FOREIGN KEY(event_id) REFERENCES events(id) on update cascade on delete cascade
 );
 
 create table if not exists subscribed_events(
-   user_id integer not null,
+   user_id text not null,
    event_id integer not null,
    subscribed_date timestamp not null default CURRENT_TIMESTAMP,
    PRIMARY KEY(user_id, event_id),
-   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade,
-   FOREIGN KEY(event_id) REFERENCES events(id) on update cascade
+   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade on delete cascade,
+   FOREIGN KEY(event_id) REFERENCES events(id) on update cascade on delete cascade
 );
 
 create table if not exists companies(
@@ -183,17 +165,17 @@ create table if not exists event_companies(
    event_id integer not null,
    company_id integer not null,
    PRIMARY KEY(event_id, company_id),
-   FOREIGN KEY(event_id) REFERENCES events(id),
-   FOREIGN KEY(company_id) REFERENCES companies(id)
+   FOREIGN KEY(event_id) REFERENCES events(id) on delete cascade,
+   FOREIGN KEY(company_id) REFERENCES companies(id) on delete cascade
 );
 
 create table if not exists subscribed_companies(
-   user_id integer not null,
+   user_id text not null,
    company_id integer not null,
    subscribed_date timestamp not null default CURRENT_TIMESTAMP,
    PRIMARY KEY(user_id, company_id),
-   FOREIGN KEY(user_id) REFERENCES users(id),
-   FOREIGN KEY(company_id) REFERENCES companies(id)
+   FOREIGN KEY(user_id) REFERENCES users(id) on delete cascade,
+   FOREIGN KEY(company_id) REFERENCES companies(id) on delete cascade
 );
 
 create table if not exists projects(
@@ -208,24 +190,26 @@ create table if not exists projects_files(
    project_id integer not null,
    file_key text not null,
    primary key(project_id, file_key),
-   foreign key(project_id) references projects(id) on update cascade,
-   foreign key(file_key) references files(key) on update cascade
+   foreign key(project_id) references projects(id) on update cascade on delete cascade,
+   foreign key(file_key) references files(key) on update cascade on delete cascade
 );
 
 create table if not exists interested_in_projects(
-   user_id integer not null,
+   user_id text not null,
    project_id integer not null,
    PRIMARY KEY(user_id, project_id),
-   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade,
-   FOREIGN KEY(project_id) REFERENCES projects(id) on update cascade
+   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade on delete cascade,
+   FOREIGN KEY(project_id) REFERENCES projects(id) on update cascade on delete cascade
 );
 
 create table if not exists officers(
    id serial,
+   user_id text not null,
    position officer_position_enum not null,
    linkedin text,
    photo text,
    PRIMARY KEY(id),
+   FOREIGN KEY(user_id) REFERENCES users(id) on update cascade on delete cascade,
    FOREIGN KEY(photo) REFERENCES files(key) on update cascade
 );
 
@@ -249,7 +233,7 @@ $$ language plpgsql
 stable
 returns null on null input;
 
-create or replace function is_user_alumni(user_id integer)
+create or replace function is_user_alumni(user_id text)
 returns boolean as $$
 declare
   user_grad_date date;