SkyStore

SkyStore is a modern web application for managing astronomical observation data and assets. It provides a hierarchical organization system with organizations, projects, and flights to effectively manage astronomical observations and their associated data.

Features

• Organizations: Create and manage organizations to group related astronomical projects
• Projects: Organize work into projects within organizations
• Flights: Create observation flights with detailed metadata
• Asset Management: Upload and manage observation data and images
• Modern UI: Built with React and Mantine UI components for a great user experience

Tech Stack

• Frontend: React with TypeScript, Mantine UI components, Vite
• Backend: Bun, Elysia.js
• Storage: MinIO for object storage
• Database: Redis Stack
• Development: Moon for task running and workspace management
• Containerization: Docker and Docker Compose

Prerequisites

• Node.js 18+ or Bun 1.0+
• Docker and Docker Compose
• Moon (optional, for workspace management)

Getting Started

1. Clone the repository:

   git clone https://github.com/yourusername/SkyStore.git
   cd SkyStore

2. Install dependencies:

   # If using Moon
   moon run :install
   
   # If using Bun directly
   cd web && bun install
   cd ../app && bun install

3. Start the development environment:

   # Using Moon (recommended)
   moon run :dev
   
   # Or manually:
   docker compose up -d  # Start Redis and MinIO
   cd app && bun run dev  # Start backend
   cd web && bun run dev  # Start frontend

4. Access the application:

   • Web UI: http://localhost:5173
   • Backend API: http://localhost:3000
   • MinIO Console: http://localhost:9001 (credentials: minioadmin/minioadmin)
   • Redis Insight: http://localhost:8001

Project Structure

SkyStore/
├── app/                 # Backend application
│   ├── src/
│   │   ├── routes/     # API routes
│   │   └── types/      # TypeScript types
├── web/                 # Frontend application
│   ├── src/
│   │   ├── components/ # React components
│   │   ├── pages/      # Page components
│   │   └── api/        # API client
├── docker-compose.yml   # Docker services configuration
└── .moon/              # Moon workspace configuration

Development

• The project uses Moon for task running and workspace management
• Hot reloading is enabled for both frontend and backend
• TypeScript is used throughout for type safety
• Mantine UI components for consistent design

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

[Add your license here]

Port Mappings

The following ports are used by the application:

Port	Internal Port	Container	Description
4150	80	web	Web App Frontend
4151	4000	app	REST API Backend
4152	5432	postgres	PostgreSQL Database
4154	4317	otel-collector	OpenTelemetry Collector (gRPC)
4155	4318	otel-collector	OpenTelemetry Collector (HTTP)
4156	9000	clickhouse	ClickHouse Database (TCP)
4157	8123	clickhouse	ClickHouse Database (HTTP)
4158	9181	clickhouse	ClickHouse Database (Keeper)
4159	6060	query-service	SigNoz Query Service
4160	3301	frontend	SigNoz Frontend
4161	3000	nodeodm	NodeODM Processing Service
4162	6379	redis	Redis Database
4163	8001	redis	RedisInsight UI
4164	9000	minio	MinIO API
4165	9001	minio	MinIO Console