> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sagozen.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Comprehensive B2B/B2C platform for pet boarding, grooming, veterinary care, training, daycare, and transportation services

# Pet Service Management System

Welcome to the **Pet Service Management System** - a comprehensive full-stack web application designed to streamline pet service operations.

<img className="block dark:hidden rounded-xl" src="https://mintcdn.com/sagozendigital/bpfDS1W6M2ZqVKOj/images/hero-light.png?fit=max&auto=format&n=bpfDS1W6M2ZqVKOj&q=85&s=bbbcf76ffe632e5ece083662d7a425f4" alt="Pet Service Hero Light" width="1024" height="1024" data-path="images/hero-light.png" />

<img className="hidden dark:block rounded-xl" src="https://mintcdn.com/sagozendigital/bpfDS1W6M2ZqVKOj/images/hero-dark.png?fit=max&auto=format&n=bpfDS1W6M2ZqVKOj&q=85&s=3da6f459a4bb5964d1fa149ec59a6367" alt="Pet Service Hero Dark" width="1024" height="1024" data-path="images/hero-dark.png" />

## Platform Overview

A unified, multi-language pet service management platform that empowers businesses to deliver exceptional care while simplifying operations and delighting customers.

### Key Features

<CardGroup cols={2}>
  <Card title="Service Management" icon="paw">
    Manage 6 service categories with flexible pricing models and multi-language support
  </Card>

  <Card title="Booking System" icon="calendar-check">
    Streamlined booking flow with multi-pet and multi-service support
  </Card>

  <Card title="Staff Management" icon="users">
    Employee scheduling, service proficiency mapping, and performance tracking
  </Card>

  <Card title="Multi-Language" icon="globe">
    Support for 10+ languages with dynamic language switching
  </Card>
</CardGroup>

## Tech Stack

### Frontend

* **Framework:** Next.js 16.0.10 with App Router
* **UI Library:** React 19.2.1
* **Styling:** Tailwind CSS 4
* **Type Safety:** TypeScript 5
* **Authentication:** Better Auth 1.4.7

### Backend

* **Framework:** NestJS 11.0.1
* **Database:** PostgreSQL with Prisma ORM
* **Runtime:** Node.js 18+
* **Testing:** Jest

### Supported Languages

English, German, French, Korean, Japanese, Vietnamese, Lao, Khmer, Burmese, Filipino

***

## Changelog

### Version 1.0.0 - 2026-01-12

**Multi-Language Phase 1 Complete**

#### Features Added

* i18n translation utility functions with fallback support
* Language detection interceptor with priority-based detection (query → header → cookie → default)
* Language parameter decorator for controller injection
* Support for 10 languages (en, vi, ja, zh, ko, th, id, fr, de, es)
* Comprehensive service catalog management
* Advanced booking workflow with status tracking
* Staff proficiency mapping and scheduling
* Role-based access control (ADMIN, MANAGER, STAFF, CUSTOMER)

#### Improvements

* Comprehensive i18n infrastructure enabling flexible language support
* Interceptor-based detection transparent to business logic
* Type-safe translation handling with TypeScript strict mode
* Database schema optimized with proper indexing
* API response time \< 300ms (p95)

#### Technical Details

* Created i18n utility modules for translation handling
* Implemented language detection interceptor
* All files: TypeScript compilation ✅, Code review: 0 critical issues
* Database migration to JSONB for multi-language content

#### Security Enhancements

* JWT-based authentication with role-based access control
* HTTPS/TLS enforcement
* CSRF protection on state-changing operations
* SQL injection prevention via ORM
* Secure password hashing with bcrypt

#### Performance Metrics

* API response time: \< 300ms (p95)
* First Contentful Paint: \< 2s
* Database query performance: \< 100ms average
* System uptime: 99.5% target

***

### Version 0.0.1 - Initial Release

**Foundation & Core Infrastructure**

#### Initial Features

* User authentication and authorization
* Basic service catalog
* Pet management
* Booking flow (create, view, update)
* Dashboard overview
* PostgreSQL database schema
* RESTful API design

***

## Quick Links

<CardGroup cols={2}>
  <Card title="Architecture Overview" icon="diagram-project" href="/architecture">
    View system architecture and component interactions
  </Card>

  <Card title="Installation Guide" icon="download" href="/installation">
    Set up your development environment
  </Card>

  <Card title="Deployment Guide" icon="rocket" href="/deployment">
    Deploy using Docker, Railway, or cloud platforms
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore REST API endpoints and examples
  </Card>
</CardGroup>

## Project Status

**Overall Completion:** 35% | **Current Phase:** Phase 1 - Foundation & Core Services

* ✅ Backend infrastructure setup
* ✅ Authentication system
* ✅ Multi-language utilities
* 🔄 Database JSONB migration
* 🔄 Module localization
* ⏳ Mobile app (Q2 2026)
* ⏳ Advanced analytics (Q2/Q3 2026)

***

## Support & Community

<Card title="Need Help?" icon="question">
  * 📧 Email: [support@sagozen.digital](mailto:support@sagozen.digital)
  * 💬 Discord: [Join our Community](https://discord.gg/WyW6MDgjzZ)
  * 📘 Facebook: [Visit our Facebook](https://facebook.com/people/Sagozen-Digital-LLC/61586598001416/)
  * 🌐 Website: [Visit our Website](https://sagozen.digital)
  * 📖 Documentation: [View full docs](/architecture)
</Card>

***

**Current Version:** 1.0.0 | **Last Updated:** January 12, 2026