Full-stack monorepo for nettsiden til echo – Linjeforeningen for informatikk ved Universitetet i Bergen.

Utviklet av frivillige informatikkstudenter fra undergruppen echo Webkom.

Tilbakemeldinger

Har du ingen tilbakemeldinger til nettsiden? Vi jobber hele tiden med å forbedre den, og setter stor pris på om du sier ifra om noe er feil, eller du har idéer til nye endringer!

Send oss gjerne en tilbakemelding via skjemaet på https://echo.uib.no/tilbakemelding, eller send oss en mail på webkom-styret@echo.uib.no.

Arkitektur

Denne full-stack monorepo-en består av flere applikasjoner og delte pakker:

+------------+     +--------------------------------------------------+
| uno-cron   |---->|  Storage                                         |
+------------+     |  +--------------------+  +-------------------+   |
                   |  | Postgres           |  | ProfilePictures   |   |
                   |  | (db)               |  | (bucket)          |   |
                   |  +--------------------+  +-------------------+   |
                   +--------------------------------------------------+
                              ^       ^                    ^
                              |       |                    |
                              |       +-----------+        |
                              |                   |        |
                      +--------------------+  +-------------------+
                      | web                |->| uno               |
                      +--------------------+  +-------------------+

Applikasjoner (/apps)

• web - Hovednettsiden bygget med Next.js 16, React 19 og Tailwind CSS
• uno - Vår Go backend, som inneholder to applikasjoner. Bygget med DDD og hexagonal arkitektur
  • web - HTTP REST API bygget med Chi-router
  • cron - Jobber som kjøres regelmessig. Deler pakker med Uno.
• cms - Sanity Studio for administrering av innhold på nettsiden

Delte pakker (/packages)

• db - Databaseskjemaer, migrasjoner og verktøy med Drizzle ORM og PostgreSQL
• sanity - Delte Sanity-spørringer og verktøy
• lib - Felles funksjoner og variabler for web og cms.
• email - E-postmaler med react-email
• seeder - Database seeding-verktøy

Testing (/playwright)

• End-to-end tester med Playwright for både API og web-applikasjoner

Hvordan kjøre?

1. Før du starter må du passe på at det følgende er installert:

   • pnpm
   • node (vi anbefaler siste LTS med fnm)
   • docker
   • go
   • cenv

2. Generer din .env med cenv

   cenv fix

3. Last ned "dependencies"

   pnpm install

4. Last ned go "dependencies"

   pnpm tools:install

5. Sette opp databasen

   pnpm db:setup

6. Synce og seede databasen

   pnpm seed

7. Start utviklingsmiljøet

   pnpm dev

Sidene som starter er:

• http://localhost:3000 for nettsiden
• http://localhost:3333 for Sanity Studio
• http://localhost:8000 for uno API-et vårt
• http://localhost:9001 for MinIO Studioet. Brukernavn og passord er, minioadmin / minioadmin.
• https://local.drizzle.studio for Drizzle Studio

NB: "Backenden" til Drizzle vil kjøre på http://localhost:4983.

Relaterte prosjekter

• cenv - Environment-fil-sjekker
• verv - Nettsiden for verving av nye studenter i undergrupper
• screen - Nettsiden for skjermen på lesesalen