Dbservice

A Phoenix-based database service application with LiveView UI for data imports and comprehensive API documentation.

Quick Start

To set up this project locally, visit the installation steps.

Development

Running the Application

For macOS users:

./start_server_macos.sh

For Windows/Linux users or manual setup:

mix phx.server

Visit localhost:4000 to access the application.

Note: macOS users can also use the convenient alias dbservice from anywhere in the terminal.

API Documentation

Access the Swagger documentation at: http://localhost:4000/docs/swagger/index.html

Note: The macOS startup script automatically generates Swagger documentation. Windows/Linux users should run mix phx.swagger.generate once before accessing the API docs. For more details about API documentation setup, see API Documentation Guide.

Database Management

For database operations like fetching data from production/staging:

macOS/Linux users:

./utils/fetch-data.sh

Windows users:

bash utils/fetch-data.sh

See Database Utils Guide for setup and configuration.

Documentation

• Installation Guide - Complete setup instructions
• Deployment Guide - Production deployment guidelines
• API Documentation - REST API documentation with Phoenix Swagger

Learn More

• Phoenix Framework: https://www.phoenixframework.org/
• Guides: https://hexdocs.pm/phoenix/overview.html
• Documentation: https://hexdocs.pm/phoenix
• Community Forum: https://elixirforum.com/c/phoenix-forum
• Source Code: https://github.com/phoenixframework/phoenix