Zvono Admin - Pawnshop Management System

🌐 Select language:

• English
• Čeština

Table of Contents

• About
• Features
• Technologies
• Installation
• Development Commands
  • Basic Commands
  • Application Commands
  • Building Commands
  • Clean Commands
  • Maintenance Commands
• Project Structure
• Contributing
• License

About

Internal application for managing customers and pawns in a pawnshop. Primarily intended for internal use by employees.

Features

• Customer management
• Pawn tracking
• PDF contract generation
• Document storage and printing
• Role-based access (admin/employee)

Technologies

• Frontend: Expo SDK 52, React Native Web, Expo Router
• Styling: Nativewind (Tailwind for React Native)
• Backend: AppWrite (Auth, Database, Storage)
• PDF generation: @react-pdf/renderer
• Desktop version: Electron
• State management: Zustand
• Testing: Jest, React Testing Library

Installation

1. Install dependencies:

   npm install

2. Start the development server:

   npm start

Development Commands

Všechny příkazy spouštějte z kořenového adresáře projektu.

Basic Commands

• Start development server:

  bun run dev

• Run linter na všechny balíčky:

  bun run lint

• Opravit lint problémy automaticky:

  bun run lint:fix

• Spustit kontrolu typů:

  bun run type-check

• Spustit testy:

  bun run test

• Naformátovat kód:

  bun run format

Application Commands

• Spustit vývojový server pro Expo aplikaci:

  bun run apps:expo

• Spustit vývojový server pro webovou aplikaci:

  bun run apps:web

• Spustit Expo aplikaci na iOS:

  cd apps/expo-app && bun run ios

• Spustit Expo aplikaci na Androidu:

  cd apps/expo-app && bun run android

• Spustit Expo aplikaci na webu:

  cd apps/expo-app && bun run web

Building Commands

• Build všech balíčků a aplikací:

  bun run build

• Build pouze sdílených balíčků:

  bun run packages:build

• Build Expo aplikace pro web:

  cd apps/expo-app && bun run build

• Build pro Android:

  cd apps/expo-app && bun run build:android

• Build pro iOS:

  cd apps/expo-app && bun run build:ios

Clean Commands

• Vyčistit všechny workspaces:

  bun run clean

• Vyčistit vše včetně globálních složek:

  bun run clean:all

• Vyčistit node_modules ve všech workspaces:

  bun run clean:deps

• Vyčistit dist složky ve všech workspaces:

  bun run clean:dist

• Vyčistit .turbo složky:

  bun run clean:turbo

• Vyčistit .expo složky:

  bun run clean:expo

Maintenance Commands

• Zkontrolovat zastaralé balíčky:

  bun outdated

• Aktualizovat všechny balíčky (interaktivně):

  bun update

• Zkontrolovat změny před aktualizací:

  bun run update:check

• Instalace balíčku do konkrétního workspace:

  bun add <balíček> --cwd <workspace-path>
  # Příklad:
  bun add zod --cwd apps/expo-app

Struktura projektu

zvono/
├── apps/                    # Aplikace
│   ├── expo-app/            # Expo mobilní aplikace
│   ├── web-app/             # Webová aplikace
│   └── docs/                # Dokumentace
├── packages/                # Sdílené balíčky
│   ├── shared/              # Sdílené utility a funkce
│   ├── components/          # Sdílené React komponenty
│   ├── tsconfig/            # Sdílené TypeScript konfigurace
│   └── eslint-config/       # Sdílené ESLint konfigurace
├── patches/                 # Patch-package patches
├── turbo.json               # Konfigurace Turborepo
└── package.json             # Kořenový package.json

Příspěvky

I když se jedná primárně o osobní projekt, příspěvky jsou vítány. Podívejte se prosím na naše Pokyny pro přispívání pro více informací.

Licence

Tento projekt je licencován pod licencí MIT - podrobnosti viz soubor LICENSE.