Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Bran258/drtc-fluvial-admin/llms.txt

Use this file to discover all available pages before exploring further.

DRTC Fluvial Admin is the official administrative panel for the Dirección Regional de Transportes y Comunicaciones (DRTC) of Amazonas, Peru. Built with Next.js 16 and React 19, it provides officials with a secure, modern interface to manage all aspects of fluvial (river) transport regulation — from vessel registration to appointment scheduling and public portal content.

Quick Start

Set up your local environment and access the admin panel in minutes

Authentication

Learn how login, session management, and token refresh work

Vessel Registration

Register and manage river vessels with the empadronamiento workflow

Appointments

Schedule, view, and manage citizen appointments for fluvial services

What you can do with DRTC Fluvial Admin

The panel is organized into four main functional areas:

Dashboard

Real-time statistics and KPI cards for operations overview

Fluvial Services

Empadronamiento, operation permits, and renewal workflows

Portal Web CMS

Manage public-facing tramite types and news articles

Developer Reference

Architecture, routing, shared components, and API client docs

Key features

  • JWT authentication with automatic silent token refresh — sessions stay active without interrupting staff workflows
  • Vessel registration (empadronamiento) — multi-step forms capturing owner data, vessel specs, and motor details with voice-guide accessibility
  • Appointment management — agenda view, appointment generation, and full appointment history
  • Interactive guided tours — built-in onboarding tours using driver.js for new staff members
  • Portal web CMS — manage public tramite listings and news articles displayed on the citizen-facing website
  • Document reception — receive, review, and track incoming document submissions

Getting started

1

Set up your environment

Install Node.js 18+ and pnpm, then clone the repository and install dependencies
2

Configure the backend URL

Set the NEXT_PUBLIC_API_URL environment variable to point to your NestJS backend
3

Run the development server

Execute pnpm dev to start the admin panel at http://localhost:3000
4

Log in with admin credentials

Navigate to /auth and sign in with your institutional email and password
DRTC Fluvial Admin requires a running NestJS backend. See the Backend Integration guide to configure the API connection.

Build docs developers (and LLMs) love