Skip to content

zerexei/software-engineering

Repository files navigation

Software Engineering Second Brain

Welcome to my Software Engineering Second Brain, a structured knowledge base for tracking production-ready patterns, architectural concepts, deployment blueprints, and developer agent workflows.


🧭 System Architecture & Directory Index

This repository is organized logically into primary engineering domains. Each domain contains nested folders and indices configured with standard YAML frontmatter for searchability.

/
├── 01_core-backend/                 # Fundamentals: Networking, APIs, Auth, Security
├── 02_frameworks/                   # Application Frameworks: FastAPI, Laravel
├── 03_data-layer/                   # Databases, Caching, Schema Design, Migrations
├── 04_system-design/                # Architecture Patterns, Caching, Scaling, Designs
├── 05_infrastructure/               # Linux, Cloud Services (AWS), Docker, CI/CD
├── 06_observability/                # Telemetry, Monitoring, Logs, LGTM Stack
├── 07_frontend/                     # Vue, React, Frontend-to-Backend Integration
├── 08_engineering-practices/        # Git Workflows, Testing, Design Patterns
├── 09_ai/                           # Developer Agent templates, workflows, & skills
└── 10_prep/                         # DSA Practice & Interview Preparation Trackers

🗂️ Domains

  • FastAPI — Python async patterns, dependency injection, and middleware.
  • Laravel — Service Container, Eloquent ORM, and background queues.
  • PostgreSQL — Query tuning, indexing strategies, and database ACID properties.
  • Redis — Caching structures, pub/sub mechanics, and memory configurations.
  • Database Design & Migrations — Normalization, sharding, replication, and migration patterns.
  • LGTM Stack — Loki (Logs), Grafana (UI), Tempo (Tracing), and Prometheus (Metrics).
  • Monitoring Patterns — Alert rules, golden signals, and aggregation strategies.

🤖 Companion Tooling & Execution

Contains guidelines, developer-agent context rules, skills, and runner prompts that guide AI pair programming.


⚡ Long-Term Maintenance Strategy

Every folder contains a local README.md styled with YAML Frontmatter for future search-indexing applications:

  1. Keep it Local: Put details in the sub-folder README.md first. Only spin off files (e.g. postgresql/indexing.md) if it grows past 300 lines.
  2. Standard Headings: Keep headings consistent (## ⚡ Quick Reference, ## 🧠 Core Concepts, ## 🛠️ Snippets & Recipes, ## 🔗 Curated Resources).
  3. Relative Links: Link relative paths (e.g. [FastAPI Async](../fastapi/README.md#async)) for optimal Markdown engine and local IDE navigation.

About

A software engineering second brain focused on backend systems AI-assisted workflow, distributed architecture, failure modes, and engineering decision-making.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Contributors