chore: consolidate documentation — delete status/fix/progress cruft

Before: 335 tracked .md files; top level had 14 README-like docs;
docs/ contained ~234 files, most of them auto/LLM-generated status
reports (ALL_*_COMPLETE*, *_FIX*, DEPLOYMENT_*_FINAL*, etc.).

After: 132 tracked .md files. Repo now has exactly five top-level
docs: README.md, QUICKSTART.md, RUNBOOK.md, CONTRIBUTING.md,
CHANGELOG.md (moved up from docs/).

Keeper philosophy in docs/:
- API, CCIP (ops + security + receiver/router refs), Chainlist refs,
  compliance, deployment (guides not status), database connection,
  legal compliance, metamask integration, production checklist,
  tiered-architecture implementation/setup, reusable-components plan,
  token-mechanism doc, wrap-and-bridge operational reference, plus
  docs/specs/** and docs/api/ / docs/openapi/ trees.

Deleted (git history preserves provenance):
- All 'ALL_*_COMPLETE*' / '*_FIX*' / '*_FIXED*' / '*_FINAL*' /
  '*_STATUS*' / '*_PROGRESS*' / '*_SUMMARY*' files.
- BLOCKSCOUT_*_FIX / _CRASH / _INITIALIZATION / _SCHEMA / _YAML /
  _SKIP / _NEXT_STEPS / _START_AND_BUILD / _DATABASE_CREDENTIALS
  (the last contained passwords).
- CCIP_IMPLEMENTATION_* / CCIP_CURRENT_STATUS / CCIP_GAP_*
  (gap analyses are not a sustained reference).
- NPMPLUS_CREDENTIALS_GUIDE.md (contained creds).
- LETSENCRYPT_CONFIGURATION_GUIDE.md (contained creds; will be
  re-introduced as runbook content post-secrets-scrub).
- docs/diagnostic-reports/, docs/feature-flags/ (run-time artifacts).

README.md: dead links (START_HERE, README_DEPLOYMENT, COMPLETE_DEPLOYMENT,
DEPLOYMENT_COMPLETE_FINAL) replaced with links to the five canonical
top-level docs + docs/ index.
This commit is contained in:
2026-04-18 18:56:17 +00:00
parent e1c3b40cb0
commit 40c9af678f
205 changed files with 8 additions and 37633 deletions

View File

@@ -1,82 +0,0 @@
# Skip Migrations - Just Start Blockscout
## Problem
The `Explorer.Release.migrate()` function is not available in the eval context, causing the container to restart repeatedly.
## Solution
Since the database tables already exist (verified earlier), we can skip migrations and just start Blockscout directly.
## Commands
```bash
cd /opt/blockscout
# Update docker-compose.yml to just start (no migrations)
python3 << 'PYTHON'
with open('docker-compose.yml', 'r') as f:
lines = f.readlines()
new_lines = []
i = 0
while i < len(lines):
line = lines[i]
# Check if this is a command line
if 'command:' in line:
indent = len(line) - len(line.lstrip())
# Replace with simple start command
new_lines.append(' ' * indent + 'command: bin/blockscout start\n')
i += 1
# Skip the list items (- sh, -c, etc.)
while i < len(lines) and lines[i].strip().startswith('-'):
i += 1
continue
new_lines.append(line)
i += 1
with open('docker-compose.yml', 'w') as f:
f.writelines(new_lines)
print("✅ Updated to just start (no migrations)")
PYTHON
# Verify
grep -A 1 "command:" docker-compose.yml
# Restart
docker-compose down blockscout
docker-compose up -d blockscout
# Check status
sleep 30
docker ps | grep blockscout
docker logs blockscout 2>&1 | tail -30
```
## Why This Works
1. **Tables already exist**: We verified that `migrations_status`, `blocks`, and `transactions` tables exist
2. **Migrations were run**: The tables wouldn't exist if migrations hadn't been run previously
3. **Release module unavailable**: The `Explorer.Release` module is only available in certain contexts, not in regular eval
## Alternative: If Migrations Are Needed Later
If you need to run migrations in the future, you can:
1. Use a one-off container:
```bash
docker run --rm \
--network host \
-e DATABASE_URL=postgresql://blockscout:blockscout@localhost:5432/blockscout \
blockscout/blockscout:latest \
bin/blockscout eval "Application.ensure_all_started(:explorer); Explorer.Release.migrate()"
```
2. Or connect to the running container and run migrations manually:
```bash
docker exec -it blockscout bin/blockscout remote
# Then in the remote console:
Explorer.Release.migrate()
```
But for now, since tables exist, just starting Blockscout should work.