docs: rewrite README as portfolio overview

Author: ASDAlexey

README.md

@@ -1,59 +1,70 @@
-# Ngportfolio
+# Alexey Popov — Portfolio
 
-This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 22.0.3.
+**Tech Lead / Senior Angular Developer (NgRx)** · 14+ years · Web (SSR) · Smart TV · Mobile (Ionic) · Desktop (Tauri/Rust)
 
-## Development server
+🌐 **Live:** https://asdalexey.github.io/  ·  🇬🇧 [/en/](https://asdalexey.github.io/en/)  ·  🇷🇺 [/ru/](https://asdalexey.github.io/ru/)
 
-To start a local development server, run:
+This repository is my personal portfolio — and the site itself is the demo: a production-grade **Angular 22**
+application, fully bilingual, prerendered for SEO, and covered by tests at 100%.
 
-```bash
-ng serve
-```
+---
 
-Once the server is running, open your browser and navigate to `http://localhost:4200/`. The application will automatically reload whenever you modify any of the source files.
+## Highlights
 
-## Code scaffolding
+- **Angular 22** — standalone components, **zoneless** change detection, signals, `inject()`, strict TypeScript, OnPush everywhere.
+- **Bilingual (EN / RU)** — `@angular/localize` with prerendered `/en/` and `/ru/` builds, language switcher, browser-language redirect.
+- **SEO-first** — static prerendering (SSG), per-locale meta/Open Graph/Twitter, `hreflang` + canonical, JSON-LD (`Person` / `WebSite` / `ProfilePage`), `sitemap.xml`, `robots.txt`, OG image.
+- **100% test coverage** — Vitest + my own [`vitest-auto-spy`](https://www.npmjs.com/package/vitest-auto-spy) library (dogfooded).
+- **Lighthouse** — Accessibility, Best Practices and SEO at **100**; performance tuned with self-hosted fonts, inlined critical CSS and zero render-blocking third-party requests.
+- **Quality gates** — ESLint (+ custom local rules), Prettier, Stylelint, Husky hooks, madge (circular deps), jscpd.
+- **CI/CD** — GitHub Actions builds both locales and deploys to GitHub Pages.
 
-Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
+## Tech stack
 
-```bash
-ng generate component component-name
-```
+`Angular 22` · `TypeScript` · `RxJS` · `SCSS` · `@angular/localize` · `Vitest` · `vitest-auto-spy` ·
+`ESLint` · `Prettier` · `Stylelint` · `GitHub Actions` · `Bun`
 
-For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
+## Local development
 
 ```bash
-ng generate --help
+bun install
+bun run start          # http://localhost:4200/ (source locale, EN)
+bun run start:ru       # Russian locale
 ```
 
-## Building
-
-To build the project run:
+## Common scripts
 
 ```bash
-ng build
+bun run build          # production build, both locales, prerendered
+bun run assemble       # add redirect / sitemap / robots / og-image to dist
+bun run test:coverage  # Vitest with 100% coverage gate
+bun run check:code-quality   # prettier + eslint + stylelint
+bun run madge          # circular-dependency check
 ```
 
-This will compile your project and store the build artifacts in the `dist/` directory. By default, the production build optimizes your application for performance and speed.
-
-## Running unit tests
-
-To execute unit tests with the [Vitest](https://vitest.dev/) test runner, use the following command:
+## Project structure
 
-```bash
-ng test
 ```
-
-## Running end-to-end tests
-
-For end-to-end (e2e) testing, run:
-
-```bash
-ng e2e
+src/app/
+├── core/            # models + framework services (SEO, structured data, locale)
+├── features/portfolio/
+│   ├── sections/    # hero · about · experience · projects
+│   └── portfolio.component
+└── shared/
+    ├── components/  # nav · footer · language-switcher · cards · icon
+    └── data/        # locale-independent content
+src/locale/          # messages.ru.xlf
+seo/                 # robots.txt · sitemap.xml · root redirect
 ```
 
-Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
+## Deployment
+
+Pushing to `main` triggers [`.github/workflows/deploy.yml`](.github/workflows/deploy.yml): it builds the
+EN + RU locales, assembles the site root, and publishes to GitHub Pages (source: GitHub Actions).
 
-## Additional Resources
+## Contact
 
-For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
+- **GitHub:** [@ASDAlexey](https://github.com/ASDAlexey)
+- **LinkedIn:** [alexey-popov](https://www.linkedin.com/in/alexey-popov-7988a874/)
+- **Email:** ASDAlexey@yandex.ru
+- **Location:** Taganrog, Russia · UTC+3 · remote-first