Skip to content

MadWorldNL/Umiko

CI Pipeline Quality Gate Status

Umiko

A hobby project powered by Claude Code AI, focused on experimenting with new tech, smart ideas, and fun side-quests. Learning by building and enjoying the process.

Note: Parts of this project are generated by AI and reviewed by me. Other parts are built by me directly.

Umiko (海子) is Japanese for "child of the sea" — because like the ocean, this project is vast, full of surprises, and occasionally makes waves.

Features

No features have been implemented yet. The following functionality is planned:

Planned

  • CV (Curriculum Vitae) — Administrators can create, edit, and view CVs through the admin portal. Users can view CVs through the user portal.

Getting Started

Install Guide

Prerequisites

Running the application

Start all services via the Aspire orchestrator:

dotnet run --project source/MadWorldNL.Umiko.Aspire

This will spin up the API, message bus, web portals, and all backing services (PostgreSQL, RabbitMQ, Keycloak) automatically.

Usage Guide

Once the Aspire orchestrator is running, the following services are available:

Service Development URL Production URL
Aspire Dashboard https://localhost:17105 None
API https://localhost:7115 https://api.oscarveldman.eu
Bus https://localhost:7109 https://bus.oscarveldman.eu
Admin Portal https://localhost:7209 https://admin.oscarveldman.eu
User Portal https://localhost:7292 https://www.oscarveldman.eu

Backing Services

Aspire automatically starts and configures the following backing services:

  • PostgreSQL — Relational database with pgAdmin for management
  • RabbitMQ — Message broker with management plugin enabled
  • Keycloak — Identity and access management server

Credentials for these services are managed via Aspire secret parameters and pre-configured for local development.

API Documentation

Interactive API documentation is available in development mode via Scalar:

  • API: https://localhost:7115/scalar/v1
  • Bus: https://localhost:7109/scalar/v1

License

MIT © Oscar Veldman

About

A hobby project powered by Claude Code AI, focused on experimenting with new tech, smart ideas, and fun side-quests. Learning by building and enjoying the process.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors