feat: M0 monorepo skeleton with services, clients, deploy and CI

- api/openapi.yaml: contract with /healthz, /readyz, /api/v1/server-info
- services/api (Go): api with oapi-codegen strict server, goose migrations,
  readiness checks for Postgres/Redis; storage-agent stub with internal token
- services/recommender (Python, uv): FastAPI health/readiness/internal status,
  `pipu-rec serve` and `pipu-rec analyze` entrypoints
- packages: generated api-client, core (server URL + server check),
  i18n (ru/en + dictionary check), design-tokens (CSS vars + TS from tokens.json)
- apps/web: Vite + React shell showing server status, language switch
- apps/mobile: Expo (SDK 53) Android app with server connect screen
- deploy: Dockerfiles, compose (prod + dev), nginx template, install/update scripts
- .gitea/workflows: ci.yml and tag-based release.yml (images, signed APK, release)
- scripts/version.mjs: version and Android versionCode from git tag
- tests/fixtures/music/generate.sh: synthetic test library via ffmpeg
- docs: versionCode formula, OpenAPI 3.0.3, dev instructions in README

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

apps/mobile/app.config.ts

@@ -0,0 +1,26 @@
+import type { ConfigContext, ExpoConfig } from 'expo/config';
+
+// Версию проставляет CI из git-тега (scripts/version.mjs): PIPU_VERSION=1.2.3, PIPU_VERSION_CODE=10203.
+const version = process.env.PIPU_VERSION ?? '0.0.0';
+const versionCode = Number(process.env.PIPU_VERSION_CODE ?? '1');
+
+export default ({ config }: ConfigContext): ExpoConfig => ({
+  ...config,
+  name: 'Pipu Music',
+  slug: 'pipu-music',
+  scheme: 'pipu',
+  version,
+  orientation: 'portrait',
+  userInterfaceStyle: 'automatic',
+  newArchEnabled: true,
+  backgroundColor: '#05070D',
+  android: {
+    package: 'app.pipu.music',
+    versionCode,
+    edgeToEdgeEnabled: true,
+    allowBackup: false,
+    permissions: ['REQUEST_INSTALL_PACKAGES'],
+  },
+  platforms: ['android'],
+  extra: { versionCode },
+});

apps/mobile/index.ts

@@ -0,0 +1,5 @@
+import { registerRootComponent } from 'expo';
+
+import { App } from './src/App';
+
+registerRootComponent(App);

apps/mobile/metro.config.js

@@ -0,0 +1,4 @@
+// Expo SDK 52+ сам настраивает Metro для монорепо (watchFolders, nodeModulesPaths).
+const { getDefaultConfig } = require('expo/metro-config');
+
+module.exports = getDefaultConfig(__dirname);

apps/mobile/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@pipu/mobile",
+  "version": "0.0.0",
+  "private": true,
+  "main": "index.ts",
+  "scripts": {
+    "start": "expo start --dev-client",
+    "android": "expo run:android",
+    "prebuild": "expo prebuild --platform android --clean",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pipu/api-client": "workspace:*",
+    "@pipu/core": "workspace:*",
+    "@pipu/design-tokens": "workspace:*",
+    "@pipu/i18n": "workspace:*",
+    "expo": "~53.0.20",
+    "expo-constants": "~17.1.7",
+    "expo-status-bar": "~2.2.3",
+    "i18next": "^25.2.1",
+    "react": "19.0.0",
+    "react-i18next": "^15.5.3",
+    "react-native": "0.79.6"
+  },
+  "devDependencies": {
+    "@types/react": "~19.0.10"
+  }
+}

apps/mobile/src/App.tsx

@@ -0,0 +1,33 @@
+import { createI18n, pickLocale } from '@pipu/i18n';
+import { StatusBar } from 'expo-status-bar';
+import type { i18n as I18n } from 'i18next';
+import { useEffect, useState } from 'react';
+import { I18nextProvider } from 'react-i18next';
+import { ActivityIndicator, View } from 'react-native';
+
+import { ConnectScreen } from './ConnectScreen';
+import { colors } from './theme';
+
+export function App() {
+  const [i18n, setI18n] = useState<I18n | null>(null);
+
+  useEffect(() => {
+    const deviceLocale = Intl.DateTimeFormat().resolvedOptions().locale;
+    void createI18n(pickLocale([deviceLocale])).then(setI18n);
+  }, []);
+
+  if (!i18n) {
+    return (
+      <View style={{ flex: 1, alignItems: 'center', justifyContent: 'center', backgroundColor: colors.bg }}>
+        <ActivityIndicator color={colors.accent} />
+      </View>
+    );
+  }
+
+  return (
+    <I18nextProvider i18n={i18n}>
+      <StatusBar style="light" />
+      <ConnectScreen />
+    </I18nextProvider>
+  );
+}

apps/mobile/src/ConnectScreen.tsx

@@ -0,0 +1,113 @@
+import { createApiClient } from '@pipu/api-client';
+import { checkServer, normalizeServerUrl, type ServerCheck } from '@pipu/core';
+import Constants from 'expo-constants';
+import { useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { ActivityIndicator, Pressable, StyleSheet, Text, TextInput, View } from 'react-native';
+
+import { colors, radius } from './theme';
+
+const appVersionCode = Number(Constants.expoConfig?.extra?.versionCode ?? 0);
+
+type State = { kind: 'idle' } | { kind: 'checking' } | { kind: 'invalid' } | ({ kind: 'done' } & ServerCheck);
+
+/** Экран подключения к серверу (docs/mobile.md). В M0 — только проверка /server-info. */
+export function ConnectScreen() {
+  const { t } = useTranslation();
+  const [address, setAddress] = useState('');
+  const [state, setState] = useState<State>({ kind: 'idle' });
+
+  async function onCheck() {
+    const baseUrl = normalizeServerUrl(address);
+    if (!baseUrl) {
+      setState({ kind: 'invalid' });
+      return;
+    }
+    setState({ kind: 'checking' });
+    const res = await checkServer(createApiClient({ baseUrl }), appVersionCode);
+    setState({ kind: 'done', ...res });
+  }
+
+  return (
+    <View style={styles.screen}>
+      <View style={styles.card}>
+        <Text style={styles.title}>{t('app.name')}</Text>
+        <Text style={styles.muted}>{t('app.tagline')}</Text>
+
+        <Text style={styles.label}>{t('server.address')}</Text>
+        <TextInput
+          value={address}
+          onChangeText={setAddress}
+          onSubmitEditing={onCheck}
+          placeholder="https://music.home.lan"
+          placeholderTextColor={colors.text3}
+          autoCapitalize="none"
+          autoCorrect={false}
+          keyboardType="url"
+          style={styles.input}
+        />
+
+        {state.kind === 'checking' && (
+          <View style={[styles.status, { backgroundColor: colors.surface2 }]}>
+            <ActivityIndicator color={colors.text2} />
+            <Text style={{ color: colors.text2 }}>{t('server.checking')}</Text>
+          </View>
+        )}
+        {state.kind === 'invalid' && <Status ok={false} text={t('server.invalid_address')} />}
+        {state.kind === 'done' && state.status === 'ok' && (
+          <Status ok text={t('server.online', { version: state.info.version })} />
+        )}
+        {state.kind === 'done' && state.status === 'unsupported_app' && (
+          <Status ok={false} text={t('server.unsupported_app')} />
+        )}
+        {state.kind === 'done' && state.status === 'offline' && <Status ok={false} text={t('server.offline')} />}
+
+        <Pressable onPress={onCheck} style={({ pressed }) => [styles.button, pressed && { opacity: 0.85 }]}>
+          <Text style={styles.buttonText}>{t('server.check')}</Text>
+        </Pressable>
+      </View>
+    </View>
+  );
+}
+
+function Status({ ok, text }: { ok: boolean; text: string }) {
+  return (
+    <View style={[styles.status, { backgroundColor: ok ? colors['ok-soft'] : colors['danger-soft'] }]}>
+      <Text style={{ color: ok ? colors.ok : colors.danger, fontWeight: '500' }}>{text}</Text>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  screen: { flex: 1, backgroundColor: colors.bg, justifyContent: 'center', padding: 16 },
+  card: {
+    gap: 12,
+    padding: 24,
+    borderRadius: radius.xl,
+    backgroundColor: colors.surface,
+    borderWidth: 1,
+    borderColor: colors.line2,
+  },
+  title: { color: colors.text, fontSize: 26, fontWeight: '600' },
+  muted: { color: colors.text2, lineHeight: 21 },
+  label: { color: colors.text2, fontSize: 13, fontWeight: '500', marginTop: 8 },
+  input: {
+    height: 48,
+    paddingHorizontal: 14,
+    borderRadius: radius.md,
+    backgroundColor: colors.surface2,
+    borderWidth: 1,
+    borderColor: colors.line2,
+    color: colors.text,
+    fontSize: 15,
+  },
+  status: { flexDirection: 'row', alignItems: 'center', gap: 8, padding: 12, borderRadius: 10 },
+  button: {
+    height: 48,
+    borderRadius: radius.md,
+    backgroundColor: colors.accent,
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+  buttonText: { color: '#fff', fontWeight: '600', fontSize: 15 },
+});

apps/mobile/src/theme.ts

@@ -0,0 +1,5 @@
+import { tokens } from '@pipu/design-tokens';
+
+// Пока только тёмная тема; переключение тем — вместе с профилем (M5).
+export const colors = tokens.color.dark;
+export const radius = tokens.radius;

apps/mobile/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["index.ts", "app.config.ts", "src"]
+}