Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
166 lines
5.9 KiB
Markdown
166 lines
5.9 KiB
Markdown
[English](README.md) | Francais | [中文](README.zh.md)
|
|
|
|
# SecuBox Meta Cataloger
|
|
|
|
Systeme de bibliotheque virtuelle qui agregue les sites MetaBlogizer, les applications Streamlit et d'autres services dans un catalogue unifie organise par **Livres Virtuels** thematiques.
|
|
|
|
## Presentation
|
|
|
|
```
|
|
+---------------------------------------------------------------+
|
|
| META CATALOGER |
|
|
| "Bibliotheque Virtuelle SecuBox" |
|
|
+---------------------------------------------------------------+
|
|
| LIVRES VIRTUELS (collections auto-generees) |
|
|
| |-- Divination & I-Ching |
|
|
| | |-- lldh360.maegia.tv (Oracle HERMES-360) |
|
|
| | +-- yijing.gk2.secubox.in |
|
|
| |-- Visualisations Interactives |
|
|
| | +-- wall.maegia.tv (MAGIC-CHESS-360) |
|
|
| |-- Donnees & Analytique |
|
|
| | +-- control.gk2.secubox.in (SecuBox Control) |
|
|
| +-- Publications & Blogs |
|
|
| +-- gandalf.maegia.tv |
|
|
+---------------------------------------------------------------+
|
|
```
|
|
|
|
## Commandes CLI
|
|
|
|
```bash
|
|
# Synchronisation complete du catalogue (scan + index + assignation livres + generation landing)
|
|
metacatalogctl sync
|
|
|
|
# Scanner une source specifique
|
|
metacatalogctl scan # Toutes les sources
|
|
metacatalogctl scan metablogizer # Sites MetaBlogizer uniquement
|
|
metacatalogctl scan streamlit # Applications Streamlit uniquement
|
|
|
|
# Gestion de l'index
|
|
metacatalogctl index list # Lister toutes les entrees indexees
|
|
metacatalogctl index show <id> # Afficher les details d'une entree
|
|
metacatalogctl index refresh # Reconstruire l'index
|
|
|
|
# Livres virtuels
|
|
metacatalogctl books list # Lister tous les livres avec le nombre d'entrees
|
|
metacatalogctl books show <book-id> # Afficher le contenu d'un livre
|
|
|
|
# Recherche
|
|
metacatalogctl search <query> # Recherche plein texte dans le catalogue
|
|
|
|
# Maintenance
|
|
metacatalogctl status # Afficher les statistiques du catalogue
|
|
metacatalogctl landing # Regenerer uniquement la page d'accueil
|
|
```
|
|
|
|
## Configuration UCI
|
|
|
|
La configuration se trouve dans `/etc/config/metacatalog` :
|
|
|
|
```uci
|
|
config metacatalog 'main'
|
|
option enabled '1'
|
|
option data_dir '/srv/metacatalog'
|
|
option auto_scan_interval '3600'
|
|
option landing_path '/www/metacatalog/index.html'
|
|
|
|
# Sources de contenu
|
|
config source 'metablogizer'
|
|
option enabled '1'
|
|
option type 'metablogizer'
|
|
option path '/srv/metablogizer/sites'
|
|
|
|
config source 'streamlit'
|
|
option enabled '1'
|
|
option type 'streamlit'
|
|
option config '/etc/config/streamlit-forge'
|
|
|
|
# Definitions des livres virtuels
|
|
config book 'divination'
|
|
option name 'Divination & I-Ching'
|
|
option icon '🔮'
|
|
option color '#cc00ff'
|
|
option description 'Outils oraculaires et systemes divinatoires'
|
|
list keywords 'iching'
|
|
list keywords 'oracle'
|
|
list keywords 'divination'
|
|
list domain_patterns 'lldh'
|
|
list domain_patterns 'yijing'
|
|
|
|
config book 'visualization'
|
|
option name 'Visualisations Interactives'
|
|
option icon '🎮'
|
|
option color '#00ff88'
|
|
list keywords 'canvas'
|
|
list keywords 'animation'
|
|
list domain_patterns 'wall'
|
|
```
|
|
|
|
## Structure des Fichiers
|
|
|
|
```
|
|
/etc/config/metacatalog # Configuration UCI
|
|
/usr/sbin/metacatalogctl # Outil CLI
|
|
/srv/metacatalog/
|
|
|-- index.json # Index principal du catalogue
|
|
|-- books.json # Livres virtuels avec entrees
|
|
|-- entries/ # Fichiers JSON individuels par entree
|
|
| |-- lldh360-maegia-tv.json
|
|
| +-- ...
|
|
+-- cache/ # Cache de scan
|
|
/www/metacatalog/
|
|
|-- index.html # Page d'accueil (theme prisme Tao)
|
|
+-- api/
|
|
|-- index.json # API : toutes les entrees
|
|
+-- books.json # API : tous les livres
|
|
```
|
|
|
|
## Livres Virtuels par Defaut
|
|
|
|
| ID | Nom | Icone | Mots-cles |
|
|
|----|-----|-------|-----------|
|
|
| divination | Divination & I-Ching | 🔮 | iching, oracle, hexagram, yijing, bazi |
|
|
| visualization | Visualisations Interactives | 🎮 | canvas, animation, 3d, game |
|
|
| analytics | Donnees & Analytique | 📊 | dashboard, data, analytics, metrics |
|
|
| publications | Publications & Blogs | 📝 | blog, article, press, news |
|
|
| security | Outils de Securite | 🛡️ | security, waf, firewall, crowdsec |
|
|
| media | Medias & Divertissement | 🎬 | video, audio, streaming, media |
|
|
|
|
## Assignation Automatique
|
|
|
|
Les entrees sont automatiquement assignees aux livres selon :
|
|
- **Mots-cles** : Comparaison avec le titre, la description et les mots-cles extraits
|
|
- **Motifs de domaine** : Comparaison avec le nom de domaine de l'entree
|
|
|
|
Configurez les regles dans UCI :
|
|
```bash
|
|
uci add_list metacatalog.divination.keywords='tarot'
|
|
uci add_list metacatalog.divination.domain_patterns='tarot'
|
|
uci commit metacatalog
|
|
metacatalogctl sync
|
|
```
|
|
|
|
## Integration Cron
|
|
|
|
La synchronisation automatique horaire est configuree via `/etc/cron.d/metacatalog` :
|
|
```
|
|
0 * * * * root /usr/sbin/metacatalogctl sync --quiet >/dev/null 2>&1
|
|
```
|
|
|
|
## Acces API
|
|
|
|
La page d'accueil et les APIs JSON sont disponibles a :
|
|
- Landing : `https://secubox.in/metacatalog/`
|
|
- Entrees : `https://secubox.in/metacatalog/api/index.json`
|
|
- Livres : `https://secubox.in/metacatalog/api/books.json`
|
|
|
|
## Dependances
|
|
|
|
- `jsonfilter` - Parsing JSON (libubox)
|
|
- `coreutils-stat` - Horodatages des fichiers
|
|
|
|
## Integration
|
|
|
|
- **MetaBlogizer** : Scanne automatiquement `/srv/metablogizer/sites/` pour les sites publies
|
|
- **Streamlit Forge** : Lit `/etc/config/streamlit-forge` pour les definitions d'apps
|
|
- **HAProxy** : Verifie le statut SSL/WAF des vhosts pour les infos d'exposition
|