# Hacker Divergents — Clan Design v1

Status:

DESIGN APROVADO PARA IMPLEMENTAÇÃO INICIAL.

Este documento define a arquitetura oficial
de clãs do Hacker Divergents.

---

# 1. Conceito

Clã é uma organização persistente criada
e administrada por jogadores.

O clã pode possuir:

- membros
- cargos
- reputação
- treasury
- servidor
- infraestrutura
- upgrades
- missões
- bônus
- ranking
- histórico

---

# 2. Regra de liberdade

Participar de clã NÃO será obrigatório.

Jogador solo continua viável.

---

# 3. Solo Clan

Jogador solo também pode criar
seu próprio clã.

Isso permite acesso gradual a:

- servidor de clã
- upgrades
- estrutura coletiva

mesmo sem outros membros.

Naturalmente levará mais tempo
para desenvolver sozinho.

---

# 4. Uma associação principal

Regra atual:

um jogador pertence
a no máximo um clã por vez.

---

# 5. Estrutura existente

Já existem bases iniciais:

clans

player_clans

Papéis atuais:

leader

officer

member

---

# 6. Cargos oficiais iniciais

## Leader

Responsável pelo clã.

Pode:

- configurar clã
- gerenciar oficiais
- definir prioridades
- iniciar certos upgrades
- administrar servidor
- aceitar decisões estratégicas

---

## Officer

Pode ajudar na administração.

Permissões serão configuráveis
ou definidas por política.

---

## Member

Membro padrão.

Pode participar de:

- missões
- doações
- atividades
- bônus

---

# 7. Futuro de cargos

Poderemos adicionar futuramente:

security_officer

research_officer

treasurer

recruiter

Mas não inicialmente.

---

# 8. Criação

Criar clã poderá exigir:

- credits
- player level mínimo
- nome disponível

O custo final será balanceado posteriormente.

---

# 9. Nome

Nome de clã deve ser único.

---

# 10. Tag

Clã poderá possuir tag curta.

Exemplo:

[DVG]

---

# 11. Descrição

Clã pode possuir descrição pública.

---

# 12. Visibilidade

Tipos futuros:

open

application

invite_only

---

# 13. Open

Jogadores podem entrar
se houver espaço e requisitos.

---

# 14. Application

Jogador solicita entrada.

Leader/officer aprova.

---

# 15. Invite Only

Somente convite.

---

# 16. Capacidade

Clã poderá possuir limite de membros.

Capacidade pode aumentar através
de infraestrutura/upgrades.

---

# 17. Não começar gigante

Clãs novos devem possuir
capacidade relativamente pequena.

---

# 18. Server do clã

Cada clã poderá possuir
servidor coletivo.

Esse será um dos principais
sistemas de progressão coletiva.

---

# 19. Clan Server

Pode possuir:

- nível visual
- hardware
- services
- storage
- security
- intelligence
- development
- mining coordination
- network

---

# 20. Nível não cria poder sozinho

Regra igual aos demais servidores:

Level representa progresso.

Os atributos reais vêm de:

- hardware
- upgrades
- software
- serviços
- recursos

---

# 21. Árvore de clã

Áreas iniciais:

Development

Mining

Security

Intelligence

Storage

Network

Operations

---

# 22. Development Branch

Pode conceder:

- bônus de desenvolvimento
- redução pequena de custos
- capacidade de pesquisa
- slots futuros

---

# 23. Mining Branch

Pode conceder:

- coordenação de rigs
- eficiência operacional
- pool do clã
- monitoramento

---

# 24. Regra de mineração

Servidor de clã não cria hash
gratuitamente.

A produção continua dependendo
de hardware real dos jogadores
ou infraestrutura do clã.

---

# 25. Security Branch

Pode conceder:

- IDS
- logging
- monitoramento
- defesa do Clan Server
- integridade de logs

---

# 26. Intelligence Branch

Pode conceder:

- análise
- correlação
- ferramentas
- melhor informação coletiva

---

# 27. Storage Branch

Pode conceder:

- capacidade
- backups
- arquivos coletivos
- evidências
- recursos do clã

---

# 28. Network Branch

Pode conceder:

- bandwidth
- relays
- network services
- routes futuras

---

# 29. Operations Branch

Pode conceder:

- mais membros
- mais missões
- melhor organização
- capacidade administrativa

---

# 30. Upgrades coletivos

Upgrades podem exigir:

- credits da treasury
- fragments
- recursos
- pré-requisitos
- nível do servidor
- upgrade anterior

---

# 31. Treasury

O clã possuirá treasury.

Treasury pertence ao CLÃ.

Não ao Leader.

---

# 32. Treasury recebe

- doações
- recompensas de Clan Missions
- receitas futuras específicas

---

# 33. Treasury gasta

- upgrades
- manutenção
- energia
- services
- Clan Server
- infrastructure

---

# 34. Retirada direta

Inicialmente NÃO permitir.

Isso evita transformar
Clan Treasury em transferência
livre entre jogadores.

---

# 35. Leader não pode sacar

Importante.

Mesmo Leader utiliza treasury
somente através de operações
válidas do clã.

---

# 36. Doações

Regra oficial já definida:

cada jogador pode realizar
no máximo 5 doações por dia.

---

# 37. Motivo do limite

Controlar:

- abuso
- transferência indireta
- progressão excessivamente rápida
- automação

---

# 38. Donation Count

O limite é por quantidade
de operações de doação.

Não necessariamente por item.

---

# 39. Limite de valor

Também poderemos definir
limites por valor futuramente
caso seja necessário.

---

# 40. Tipos de doação

Podem incluir:

credits

fragments

hardware futuro

resources futuros

---

# 41. Credits Donation

Move créditos:

player
↓
clan treasury

Não cria moeda.

---

# 42. Fragment Donation

Move fragmentos:

player
↓
clan resources

---

# 43. Hardware Donation

Futuro.

Poderá mover equipamento
para infraestrutura do clã.

---

# 44. Doação não é marketplace

Não existe:

comprador

vendedor

preço

É contribuição.

---

# 45. Marketplace entre membros

Regra oficial:

membros do MESMO clã
não podem negociar entre si
através do marketplace P2P
para:

- hardware
- fragments

---

# 46. Validação

Essa regra deve ser validada
ANTES de:

- débito
- crédito
- transferência

---

# 47. Objetivo

Reduzir:

- lavagem de créditos virtual
- manipulação de mercado
- transferências artificiais

---

# 48. Diferenciar doação

Membros podem colaborar
através do sistema de clã.

Mas não através de venda
simulada entre si.

---

# 49. Ações ofensivas internas

Regra oficial:

ações ofensivas contra membro
do próprio clã são PERMITIDAS.

---

# 50. Exemplo

Jogador A e Jogador B
pertencem ao mesmo clã.

Jogador A pode instalar
Mining Parasite na rig
do Jogador B.

---

# 51. Motivo

Cria:

- confiança
- paranoia
- política interna
- investigação
- conflito
- histórias

---

# 52. Clan não equivale a zona segura

Pertencer ao mesmo clã
não gera imunidade automática.

---

# 53. Antivirus

Mesmo dentro do clã:

somente dono da máquina
pode executar antivírus nela.

---

# 54. Digital Forensics

Mesmo dentro do clã:

somente dono da máquina
pode realizar forense nela.

---

# 55. Exemplo de situação

Clan Member:

"Minha mineração caiu."

Outro membro:

"Deve ser a GPU."

😂

Antivirus:

Mining Parasite detected.

Source attribution:

pending.

---

# 56. Consequência social

O sistema técnico não precisa
proibir traição.

O próprio clã pode reagir:

- expulsar
- reduzir cargo
- marcar membro
- criar regras próprias

---

# 57. Clan Logs

Clã deve possuir histórico administrativo.

Exemplos:

member joined

member left

member kicked

donation

upgrade

mission completed

role changed

---

# 58. Não registrar segredos ofensivos automaticamente

Clan log não deve revelar
que um membro infectou outro
simplesmente porque ambos
estão no mesmo clã.

Isso destruiria a investigação.

---

# 59. Clan Mission

Clã poderá possuir missões próprias.

---

# 60. Daily Clan Missions

Regra planejada:

missões diárias.

---

# 61. Exemplos

Produza X mineração.

Complete X contratos.

Doe X recursos.

Recupere fragmentos.

Analise determinados servidores.

---

# 62. Cuidado com missão obrigatória

Daily Mission não deve
transformar jogo em obrigação diária.

---

# 63. Recompensas

Podem incluir:

- Clan XP
- treasury credits
- resources
- temporary bonus

---

# 64. Clan XP

Pode representar
progresso coletivo.

---

# 65. Clan Level

Pode liberar:

- upgrades
- member capacity
- missions
- server features

---

# 66. Novamente

Clan Level é gate/progress indicator.

Não substitui infraestrutura real.

---

# 67. Bônus

Bônus de clã devem ser moderados.

Exemplos:

+2% development efficiency

+3% mining coordination

+5% storage

---

# 68. Evitar bônus absurdos

Não queremos:

Clan Level 50

+300% mining.

---

# 69. Solo viability

Bônus de clã são vantagem.

Não obrigação.

Jogador solo ainda consegue
acessar todo o núcleo do jogo.

---

# 70. Clan specialization

Clãs poderão escolher
especializações.

Exemplo:

Research Clan

Mining Clan

Intelligence Clan

Security Clan

Balanced Clan

---

# 71. Especialização não precisa ser permanente

Futuramente pode haver respec
com custo/cooldown.

---

# 72. Ranking

Rankings possíveis:

reputation

missions

server development

mining

research

security

---

# 73. Ranking global

Não precisa existir
em todas as categorias.

---

# 74. Ranking não deve premiar somente riqueza

Importante.

---

# 75. Clan Reputation

Clã poderá possuir
reputação própria.

---

# 76. Facção e clã

Ações coletivas podem
alterar reputação
com facções NPC.

---

# 77. Exemplo

Clã ataca constantemente
NetCore.

NetCore Clan Reputation:

hostile

---

# 78. Isso pode afetar membros

Alguns efeitos podem ocorrer
no nível coletivo.

Outros individualmente.

---

# 79. Guerra de clãs

Futuro.

Não implementar na primeira versão.

---

# 80. Clan PvP

A infraestrutura criada
já deverá permitir expansão futura.

---

# 81. Espionagem

Como ações ofensivas internas
são permitidas,
espionagem entre clãs poderá
ser interessante futuramente.

---

# 82. Infiltração social

Um jogador poderia entrar
em um clã rival.

Isso é comportamento social
emergente.

Não precisamos criar
sistema especial inicialmente.

---

# 83. Convites

Precisaremos futuramente de:

clan_invitations

---

# 84. Applications

Possível tabela:

clan_applications

---

# 85. Roles

Estrutura atual pode ser expandida.

---

# 86. Role permissions

Futuro:

clan_role_permissions

---

# 87. Não exagerar no começo

leader

officer

member

é suficiente.

---

# 88. Clan Server Hardware

Pode utilizar hardware
adquirido pelo clã.

---

# 89. Clan Inventory

Precisaremos futuramente
de inventário coletivo.

---

# 90. Clan Inventory não é inventário pessoal

Itens doados deixam de pertencer
ao jogador.

---

# 91. Withdrawal de hardware

Inicialmente pode ser proibido
ou muito controlado.

---

# 92. Motivo

Evitar:

doa item

outro jogador retira

contornando restrição do marketplace.

---

# 93. Melhor regra inicial

Itens doados ao clã:

só podem ser:

- instalados em infraestrutura
- consumidos em upgrades

Não devolvidos diretamente
a membros.

---

# 94. Isso cria sink real

Bom para economia.

---

# 95. Fragmentos doados

Mesma possibilidade.

Podem ser usados para:

- Clan Research
- upgrades
- projetos

Não revendidos individualmente.

---

# 96. Clan Research

Futuro.

O clã poderá realizar
projetos coletivos.

---

# 97. Projeto exemplo

Advanced Traffic Analysis

Requer:

TRAFFIC x20

NETWORK x15

credits

tempo

---

# 98. Resultado

Bônus coletivo
ou infraestrutura liberada.

---

# 99. Clan Project

Pode ser diferente
de upgrade instantâneo.

---

# 100. Projetos coletivos

Podem criar objetivos
de médio prazo.

---

# 101. Clan Server Status

Estados:

online

offline

maintenance

degraded

overloaded

compromised

---

# 102. Clan Server pode ser atacado

Futuro.

Será um alvo valioso.

---

# 103. Segurança

Clan Server pode possuir:

Firewall

IDS

Antivirus

Logging

Forensics

---

# 104. Owner rule

Precisaremos adaptar
o conceito de "owner"
para Clan Server.

---

# 105. Administração autorizada

Ao contrário de máquina pessoal,
Clan Server poderá permitir
ações defensivas para membros
com permissão.

---

# 106. Isso não altera regra pessoal

Máquina pessoal:

somente dono roda Antivirus.

Clan Server:

autorizações coletivas próprias.

---

# 107. Importante

Essa distinção deve ficar explícita
durante implementação futura.

---

# 108. Clan Relay

Clã poderá possuir relays.

---

# 109. Clan Route Infrastructure

Pode oferecer aos membros:

- rotas
- bandwidth
- serviços

---

# 110. Risco coletivo

Se relay do clã for queimado,
múltiplos membros podem ser afetados.

---

# 111. SafeNet

SafeNet poderá futuramente
correlacionar infraestrutura
compartilhada.

---

# 112. Isso cria risco

Usar relay poderoso do clã
é conveniente.

Mas todos utilizando o mesmo
relay geram padrões.

---

# 113. Clan Intelligence

Pode ajudar a detectar
esse risco.

---

# 114. Clan Treasury Events

Todas movimentações devem gerar histórico.

---

# 115. Atomicidade

Donation:

ou completa inteira

ou rollback.

---

# 116. Idempotência

Repetir requisição
não duplica doação.

---

# 117. Daily Donation Limit

Controle deve estar no backend.

Nunca depender do frontend.

---

# 118. Horário

Limite diário deve utilizar
uma regra consistente de dia
no backend.

---

# 119. Futuramente

Podemos preferir janela móvel
ou dia UTC.

Definir na implementação.

---

# 120. Clan creation transaction

Criação deve ser atômica.

Criar:

clan

membership leader

event

---

# 121. Clan disband

Futuro.

Requer tratamento especial
de treasury/inventory/server.

---

# 122. Não implementar cedo

Antes precisamos estabilizar
criação e progressão.

---

# 123. Leader leaving

Leader não pode simplesmente
sair sem:

transferir liderança

ou

dissolver clã.

---

# 124. Officer promotion

Apenas Leader
ou política autorizada.

---

# 125. Member removal

Leader/officer autorizado.

---

# 126. Kick cooldown

Futuro possível.

---

# 127. Clan Application Requirements

Podem incluir:

player level

reputation

manual approval

---

# 128. Clan Description

Pode mostrar:

specialization

members

level

reputation

---

# 129. Informação privada

Treasury detalhada
pode ser visível
somente para membros.

---

# 130. Security details

Clan Server security
não deve ser publicamente
visível em detalhes.

---

# 131. Reconnaissance

Rivais precisam investigar.

---

# 132. Clan Mission participation

Pode registrar contribuição
individual.

---

# 133. Contribution Score

Pode existir para:

- transparência
- ranking interno

Mas não precisa
virar moeda.

---

# 134. Evitar exploração

Jogadores não devem conseguir
farmar infinitamente
missão fácil do clã.

---

# 135. Clan Mission cooldown

Pode existir.

---

# 136. Clan Daily Reset

Daily Missions terão
ciclo controlado.

---

# 137. Não forçar presença diária

Missões podem acumular parcialmente
ou simplesmente renovar.

Balancear depois.

---

# 138. Upgrades

Árvore inicial sugerida:

Clan Core
│
├── Operations
│
├── Development
│
├── Mining
│
├── Security
│
├── Intelligence
│
├── Storage
│
└── Network

---

# 139. Clan Core I

Libera:

servidor básico

treasury

missões básicas

---

# 140. Operations I

Pode liberar:

+ membros

+ mission slot

---

# 141. Development I

Pode liberar:

pequeno bônus de desenvolvimento

---

# 142. Mining I

Pode liberar:

Mining Control Service

---

# 143. Security I

Pode liberar:

Clan Firewall

---

# 144. Intelligence I

Pode liberar:

Traffic Analysis Service

---

# 145. Storage I

Pode liberar:

Clan Storage

---

# 146. Network I

Pode liberar:

Clan Relay Slot

---

# 147. Tier II+

Exigirá:

- Clan Level
- treasury
- resources
- branch anterior

---

# 148. Escolha estratégica

Clã pequeno não deve
conseguir maximizar tudo rapidamente.

---

# 149. Clan build

Um clã pode investir primeiro em:

Mining

Outro:

Intelligence

Outro:

Development

---

# 150. Cooperação

Isso aumenta identidade
de cada grupo.

---

# 151. Future specialization bonus

Depois poderemos permitir
uma especialização oficial.

Não agora.

---

# 152. Economia

Clan Treasury é
um dos principais sinks
do mid/endgame.

---

# 153. Energia

Clan Server pode consumir
credits da treasury.

---

# 154. Saldo insuficiente

Pode causar:

degraded

ou

serviços desativados.

---

# 155. Não destruir clã por dívida

Sem créditos:

infraestrutura perde funções.

Não desaparece.

---

# 156. Recovery

Membros podem:

doar

completar Clan Missions

reduzir serviços

---

# 157. Member activity

Não exigir atividade obrigatória.

---

# 158. Inactive member

Pode permanecer.

Administração decide remover.

---

# 159. Clan progression

Progressão deve ser mais lenta
que progressão individual.

É objetivo de longo prazo.

---

# 160. Banco futuro

Possíveis tabelas:

clan_invitations

clan_applications

clan_treasury

clan_treasury_transactions

clan_donations

clan_daily_donation_counters

clan_servers

clan_inventory

clan_upgrade_catalog

clan_upgrades

clan_mission_templates

clan_missions

clan_mission_contributions

clan_events

---

# 161. ClanService

Gerencia:

- criação
- entrada
- saída
- cargos

---

# 162. ClanTreasuryService

Gerencia:

- credits
- transactions
- spending

---

# 163. ClanDonationService

Gerencia:

- limite diário
- resources
- atomicidade

---

# 164. ClanServerService

Gerencia:

- servidor
- recursos
- estado

---

# 165. ClanUpgradeService

Gerencia:

- árvores
- requisitos
- compra

---

# 166. ClanMissionService

Gerencia:

- missão
- progresso
- recompensa

---

# 167. ClanPermissionService

Futuro.

Centraliza autorização.

---

# 168. Integração com marketplace

Marketplace consulta:

ClanService

antes da venda.

---

# 169. Integração com Security

Não bloquear ataque
porque pertence ao mesmo clã.

---

# 170. Integração com Mining Parasite

Same clan:

PERMITIDO.

---

# 171. Integração com SafeNet

Infraestrutura coletiva
pode criar correlações futuras.

---

# 172. Integração com NPC

Clãs podem ter reputação
com facções.

---

# 173. Integração com Missions

NPCs podem oferecer
Clan Contracts.

---

# 174. Integração com Economy

Treasury e infrastructure
criam sinks.

---

# 175. Integração com Software

Clan Research pode futuramente
melhorar desenvolvimento.

---

# 176. Integração com Server

Clan Server utiliza
o Servers Design v1.

---

# 177. Princípio oficial

Clã oferece:

cooperação

infraestrutura

progressão coletiva

vantagem estratégica

mas não elimina:

risco

conflito

economia

investigação

---

# 178. Segundo princípio

Mesmo dentro do clã:

confiança continua sendo
um recurso social.

---

# 179. Terceiro princípio

Clã não deve ser
uma máquina de transferir
itens gratuitamente entre membros.

Colaboração deve acontecer
através de sistemas próprios.

---

# 180. Quarto princípio

Jogador solo continua viável.

Clã melhora possibilidades.

Não define se alguém
pode ou não jogar.

---

# 181. Próximo documento

WORLD & PROGRESSION DESIGN V1

Precisamos consolidar:

- início do jogador
- mapa/rede virtual
- descoberta de servidores
- dificuldade
- regiões/facções
- early game
- midgame
- endgame
- nível
- experiência
- reputação
- conteúdo desbloqueado
- tutorial integrado ao mundo
